Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Índice


Visão geral


O TOTVS Fluig Plataforma possui integração nativa com o TOTVS Identity, no entanto, essas configurações possuem algumas especificidades que detalharemos nessa documentação.


Pré-requisitos



Configurando o aplicativo Fluig


01. Acionar o menu Aplicativos.

02. Localizar oaplicativo Fluig na lista.

03. Acionar o aplicativo e obter o applicationId.

04. O aplicativo Fluig de escolha deve possuir o applicationId 42.

05. Realizar a Integração da plataforma com o Identity.


Habilitando o modo de provisionamento no aplicativo Fluig


01. Acionar o menu Aplicativos.

02. Localizar oaplicativo Fluig na lista.

03. Acionar o aplicativo e obter o applicationId.

04. O aplicativo Fluig de escolha deve possuir o applicationId 42.

04. Acionar a opção Clonar para criar um novo aplicativo com as mesmas propriedades do atual.

05. Habilitar o Modo de Provisionamento Fluig.

Nota
titleAtenção

Não se deve habilitar o modo de provisionamento no aplicativo Fluig com applicationId 42, pois trata-se da integração nativa com o Identity. Para ativar o modo de provisionamento, é necessário clonar o aplicativo, obrigatoriamente. Descumprir essa recomendação ocasionará erros na integração.


Exemplificando os termos contexto e empresa


Informações
titleImportante

01. Contexto: É o cadastro da empresa dentro do Identity, como se fosse a abertura de uma conta. Por padrão, são criados dois contextos: produção (*.fluigidentity.com) e homologação (*.customerfi.com), ambos com o mesmo Administrador Corporativo.

Não é necessário nenhuma configuração extra para que o usuário acesse os contextos, basta apenas aceitar o convite enviado por e-mail e definir a senha de login.

O Administrador Corporativo consegue cadastrar diversos sistemas através dos protocolos de autenticação de mercado (Thick, Plugin, SAML e Executável SAML). Esses sistemas serão os Aplicativos dentro do Identity, por exemplo, Fluig, RM, Protheus, Datasul, Jira, etc.

02. Empresa (ou tenant): Acriação da empresa é realizada no Fluig utilizando o usuário wcmadmin. Nesse caso, a configuração da empresa é fundamental, pois definirá as principais características na plataforma, tais como seu administrador, volume, etc.

É possível adicionar mais de uma empresa em uma mesma instalação do Fluig. Cada empresa será identificada com um código (ou tenant), escolhido pelo próprio administrador.

01. Para fins didáticos, vamos considerar que a empresa EXEMPLAR S. A. possui dois contextos criados no Identity (produção e homologação). As URLs de acesso são:


02. No Identity, é permitido adicionar quantos aplicativos Fluig houver necessidade, tanto em produção (exemplar.fluigidentity.com), como em homologação (exemplar.customerfi.com). Entretanto,cada contextodo Identity suporta a integração com apenas uma empresa (ou tenant) do Fluig. 


03. Ainda utilizando um exemplo hipotético, a empresa EXEMPLAR S. A. possui duas instalações do Fluig. Sua equipe interna definiu uma instalação como ambiente de produção, e a outra, como ambiente de homologação. As URLs de acesso e seus respectivos IPs são:


04.Fluig Produção possui três empresas cadastradas com os códigos (ou tenants) 1, 2 e 3. Na prática, trata-se de uma única instalação Fluig, com 3 empresas e 3 códigos distintos:


05. Já o Fluig Homologação possui duas empresas cadastradas com os códigos (ou tenants) A e B. Na prática, trata-se de uma única instalação Fluig, com 2 empresas e 2 códigos distintos:


Cenários possíveis de integração 


01. Cenário de integração Produção x Produção:

a) Se você quiser realizar a integração do Fluig Produção (https://xpto.fluig.com) com o contexto XPTO Produção (xpto.fluigidentity.com), você não conseguirá cadastrar as empresas 1, 2 e 3 e precisará escolher qual empresa que você deseja realizar a integração, disponível na documentação: 


b) Agora vamos supor que você queira realizar a integração do Fluig Produção (https://xpto.fluig.com) da seguinte forma:

Nesse cenário, você consegue realizar a integração das empresas 1 e 3 porque os contextos no Identity são diferentes.

c) Em um último cenário, caso você deseje habilitar UMA empresa do seu Fluig Produção e UMA empresa do seu Fluig Testes em um mesmo contexto, também funciona. Pois você terá duas instalações do Fluig, em servidores diferentes e utilizando o mesmo contexto no Identity. Na prática, ficaria da seguinte maneira:

O mesmo contexto para o Identity XPTO Homologação (xpto.customerfi.com), mas utilizando duas instalações distintas do Fluig com IP's diferentes (IP: 198.166.58.5) e (IP: 183.198.72.1).


4. Autenticação em múltiplas empresas:


Quando a instalação do Fluig possuir múltiplas empresas e, uma ou mais empresas tiverem a integração com o Identity habilitada, será feita a autenticação por contexto. 


Na autenticação por contexto, o usuário deverá acessar o Fluig através da URL com o código da empresa, por exemplo, https://xpto.fluig.com/portal/1/home, para que o Fluig identifique em qual empresa o usuário está se autenticando.


Caso não seja informado o código da empresa na URL, será apresentada a página de seleção de empresa para que o usuário informe o código antes de prosseguir com a autenticação.


A URL de acesso com o código da empresa é válida somente para o acesso à plataforma Fluig, e não deve ser adicionada na configuração do aplicativo no TOTVS Identity.  No Identity permanece a URL normal, que é: https://xpto.fluig.com/portal/idp.