Árvore de páginas

Índice


Plataforma

Produto: TOTVS Fluig Plataforma integrado ao TOTVS Identity

Versão: 1.5.11 ou superior


Ocorrência

Como realizar a configuração de autenticação do TOTVS Fluig Plataforma com o TOTVS Identity através da API Pública?


Solução

É possível realizar a integração do Identity com a plataforma através da API Pública.

1. O primeiro passo, é autenticar-se na plataforma com um usuário administrador (pode ser wcmadmin).

2. Em seguida, deve-se chamar o endpoint [URL fluig]/api/public/admin/tenant/identityConfig/v2.

3. O método que deve ser utilizado é do tipo POST e os parâmetros a serem informados são:

nametypedescriptionconstraints
configurationTokenqueryidentity application configuration token (Ex: "NDI6Om4zbTQxMG52MHkyNXd5cmExNDE2OTQ1MjE0OTM3").
enableIdentityquery('true' to enable / 'false' to disable). Default: false.boolean
identityUrlqueryIdentity Base URL
useJustInTimeProvisioningqueryto provisioning users (true / false). Default: false.boolean

Estes parâmetros podem ser obtidos nas configurações do aplicativo "Fluig" no Identity.


Para realizar a configuração utilizando o wcmadmin é necessário que seja informado também o código da empresa e o ID da empresa.

nametypedescription
tenantId
queryIdentificador da empresa
tenantCodequeryCódigo da empresa.

Estes parâmetros podem ser obtidos nas configurações da própria empresa na plataforma Fluig.


Exemplo de requisição usando administrador de empresa:

Request
(HOST)/api/public/admin/tenant/identityConfig/v2?configurationToken=TOKEN&enableIdentity=true&identityUrl=https://DOMINIO.IDENTITY/&useJustInTimeProvisioning=true

Exemplo de requisição usando wcmadmin:

Request
(HOST)/api/public/admin/tenant/identityConfig/v2?configurationToken=TOKEN&enableIdentity=true&identityUrl=https://DOMINIO.IDENTITY/&useJustInTimeProvisioning=true&tenantId=1&tenantCode=CODIGOEMPRESA


O retorno é um application/json:

Retorno de ativação da integração
{
    "content": "Fluig Identity has been enabled with success",
    "message": null
}

ou

Retorno de desativação da integração
{
    "content": "Fluig Identity has been disabled with success",
    "message": null
}

As alterações serão aplicadas imediatamente, não sendo necessário reiniciar o servidor.