Histórico da Página
Í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
- Possuir um contexto criado no Identity, conforme as orientações da página Criação de Conta no Identity.
- Possuir o Fluig instalado, configurado e atualizado, conforme as orientações do Guia de Instalação fluig e do Guia de atualização da plataforma.
- Pretensão de realizar a Integração da plataforma com o Identity.
- Pretensão de habilitar o Modo de Provisionamento Fluig (opcional).
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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:
- Produção: exemplar.fluigidentity.com
- Homologação: exemplar.customerfi.com
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:
- Fluig Produção: https://exemplar-prod.fluig.com (IP: 100.11.0.1)
- Fluig Homologação: https://exemplar-homol.fluig.com (IP: 200.22.0.2)
04. O 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:
- Empresa 1: https://exemplar-prod.fluig.com/portal/1/home
- Empresa 2: https://exemplar-prod.fluig.com/portal/2/home
- Empresa 3: https://exemplar-prod.fluig.com/portal/3/home
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:
- Empresa A: https://exemplar-homol.fluig.com/portal/A/home
- Empresa B: https://exemplar-homol.fluig.com/portal/B/home
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:
- Fluig Produção - Empresa 1 (https://xpto.fluig.com/portal/1/home) + contexto XPTO Produção (xpto.fluigidentity.com)
- Fluig Produção - Empresa 3 (https://xpto.fluig.com/portal/3/home) + contexto XPTO Homologação (xpto.customerfi.com)
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:
- Fluig Produção - Empresa 2 (https://xpto.fluig.com/portal/2/home) + contexto XPTO Homologação (xpto.customerfi.com)
- Fluig Testes - Empresa A (https://xptotst.fluig.com/portal/A/home) + contexto XPTO Homologação (xpto.customerfi.com)
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.