Índice
Plataforma
Produto: TOTVS Fluig Plataforma integrado ao TOTVS Identity
Versão: 1.5.11 ou superior
Tipo de API: WCMAdminTenantRest
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:
name | type | description | constraints |
---|---|---|---|
configurationToken | query | identity application configuration token (Ex: "NDI6Om4zbTQxMG52MHkyNXd5cmExNDE2OTQ1MjE0OTM3"). | |
enableIdentity | query | ('true' to enable / 'false' to disable). Default: false. | boolean |
identityUrl | query | Identity Base URL | |
useJustInTimeProvisioning | query | to 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.
name | type | description |
---|---|---|
tenantId | query | Identificador da empresa |
tenantCode | query | Có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:
(HOST)/api/public/admin/tenant/identityConfig/v2?configurationToken=TOKEN&enableIdentity=true&identityUrl=https://DOMINIO.IDENTITY/&useJustInTimeProvisioning=true
Exemplo de requisição usando wcmadmin:
(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:
{ "content": "Fluig Identity has been enabled with success", "message": null }
ou
{ "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.