Índice

Integração com o Fluig Identity

...

...

Passo 1: Instalação e configuração do Fluig

• Se você ainda não possui o Fluig instalado e configurado, acesse a página de Instalação para saber como instalar o produto.
• Após concluir a instalação do Fluig, faça login com o usuário wcmamin para criar a empresa. Se tiver dúvidas sobre a senha de acesso desse usuário entre em contato com o Suporte Fluig.

• Durante a criação da empresa você deverá informar um email, login e senha para o usuário administrador. O email deve ser o mesmo que será utilizado pelo administrador do Identity.

• Agora solicite a criação do contexto do Identity à equipe de suporte através de um chamado (https://suporte.fluig.com/chamados). No chamado você deve passar as seguintes informações:

• • Nome do administrador da empresa;

  • Email do administrador (o mesmo email do administrador da empresa do Fluig);

  • Nome do contexto do Identity (geralmente o nome da empresa);

  • Domínio (exemplo: minhaempresa)
• Quando o contexto do Identity for criado você será notificado e poderá continuar com a configuração do Passo 2.

...

Passo 2: Download dos certificados do Identity

• Acesse o Identity com o usuário administrador;

• No menu superior direito clique no primeiro ícone e em seguida em Configuração (Figura 1);

• Acesse a aba Segurança (Figura 2);

  • Na área Rest API v2 clique em Baixar a Chave Privada;

  • Renomeie o arquivo para identityApiV2Key.pk8;

  • Salve o arquivo na pasta “certs” no volume da empresa. A pasta deve ser criada manualmente no volume, por exemplo C:\Volume_Fluig\certs.

  • Na área Certificado SAML clique em Baixar certificado X.509;

  • O certificado deve ser colocado dentro da pasta “cert”. Essa pasta deve ser criada na raíz de instalação do Fluig, por exemplo C:\Fluig\cert.

Image Removed

Figura 1

Image Removed

Figura 2

...

Passo 3: Configuração do aplicativo Fluig no Identity

• No Identity acesse o menu superior direito, clique no primeiro ícone e em seguida em Aplicativos;

• Busque por Fluig e clique sobre ele;

• Acesse a aba Configurações e clique em Editar Configurações (Figura 3);

• • No campo Domínio informe o endereço do Fluig conforme o exemplo a seguir e salve;

• • • Exemplo: http://ENDERECO_FLUIG:PORTA/portal/idp

• Clique em Baixar Metadados do IDP e salve o arquivo em qualquer diretório. Ele será utilizado no próximo passo.

Image Removed

...

Passo 4: Configurando o Fluig

• Bloco de código
  language html/xml
  <simple name="java:global/totvs/idp/apiClientKey" value="<REST_API_V2_CLIENT_ID>"/>

...

4º Passo: Configurar Aplicativo

• Acesse o painel administrativo do Identity (botão caixa de ferramentas, no lado direito superior da tela).
• Selecione a opção Aplicativos, e selecione a aplicação Fluig.
• Selecione a opção Configurações.
• Selecione a opção editar, e modifique o campo "Domínio". Fluig para o seu domínio completo (http://<Host>:<Port>/portal/idp).

...

Figura 1.3 - Configuração do Identity

Pré-requisitos

...

• Possuir o TOTVS Fluig Plataforma em atualização 1.6.x ou superior instalado e configurado conforme as orientações do Guia de Instalação fluig. O endereço de acesso à plataforma será solicitado durante a configuração da integração com o TOTVS Identity.

• Solicitar um contexto no Identity ao suporte, conforme as orientações da página Criação de Conta no Identity.

• Possuir uma empresa cadastrada no Fluig.

• Caso já existam usuários cadastrados na empresa do Fluig que será sincronizada, deve-se garantir que todos estes usuários possuam um endereço de e-mail cadastrado e que este endereço seja válido e único, ou seja, não tenha sido usado no cadastro de outro usuário.

Configurar a integração com o Identity

...

De posse dos dados de acesso ao contexto no Identity e um usuário administrador, é possível iniciar a integração com o Fluig.

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/8kIaZcD0J-U" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>

Enviar usuários do Fluig para o Identity

Âncora
enviar enviar

...

Para criar contas no Identity para usuários previamente existentes na empresa do Fluig, está disponível nas propriedades da empresa a opção Enviar usuários. Ao utilizar este recurso, as contas do usuário no Fluig e no Identity serão vinculadas automaticamente.

Múltiplas Empresas

...

Quando a instalação do TOTVS Fluig Plataforma possui 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, http://meufluig.com/portal/empresa1, 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 (vide abaixo) para que o usuário informe o código antes de prosseguir com a autenticação.

Image Added

Em empresas cuja integração com o Identity está habilitada, o usuário será direcionado para a página de login do Identity. Nas demais a página padrão de login do Fluig será carregada para autenticação.

Consultar token de integração

...

Image Added Veja o vídeo

Para consultar o token de integração, siga os passos abaixo:

01. Acessar o contexto criado no Identity, por exemplo, https://[suaempresa].fluigidentity.com, com as credenciais do administrador.

02. Acionar o menu Aplicativos.

03. Acionar Fluig na lista de aplicativos. É possível localizá-lo utilizando o campo Pesquisar no canto superior esquerdo.

04. Na aba Visão geral, acionar Token de Configuração e copiar o valor do token.

<!-- Hotjar Tracking Code for http://tdn.totvs.com/display/fb -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:1280165,hjsv:6};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>

<script>
	$("b:contains('oculto')").parent().parent().hide();
</script>

<script>
	$("b:contains('oculto')").parent().parent().hide();
</script>

Esta informação, também deve ser inserida na propriedade global/totvs/idp/acsUR do arquivo standalone.xml. Após a url acrescente "/ACS".

<simple name="java:global/totvs/idp/acsURL" value="http://<Host>:<Port>/portal/idp/ACS"/>

...

5º Passo: Configurar URL do aplicativo

• Acesse o Identity, com um usuário administrador da empresa, posicione o cursor sobre a guia de gerenciamento no canto superior direito da tela e clique sobre a opção Aplicativos:

...

• Busque pelo aplicativo Fluig e clique sobre seu nome:

...

Figura 1.6 - Configuração do Identity

• • Abra o arquivo procure pelo parâmetro "Location" e copie o valor deste.
    OBS: A busca retornará duas referências ao termo Location, somente o primeiro endereço deverá ser informado no idpdestination.

...

• • Abra o arquivo standalone.xml, disponível em <Diretório de instalação>\<jboss>\standalone\configuration\.

• Note que <jboss> é "jboss-as-7.2.0.Final" no Fluig 1.0 e "jboss" da versão 1.1 em diante.

...

<simple name="java:global/totvs/idp/idpDestination" value="https://<contexto>.fluigidentity.com/cloudpass/SPInitPost/receiveSSORequest/<id_empresa>/<id_aplicativo>" />

...

6º Passo: Configuração do certificado

...

<simple name="java:global/totvs/idp/certificateFile" value="C:\FluigFinal\certs\empresa.fluigidentity.com.crt" />

...

Configure também a propriedade ignoreSSLValidation, se necessário. Esta propriedade é detalhada no anexo 1.

<simple name="java:global/totvs/idp/ignoreSSLValidation" value="true" />

...

Configuração do Identity para atualização a partir da versão 1.3

...

...

• • Acesse o Identity, e faça login com o administrador da empresa.
  • Acesse o painel administrativo do Identity (botão caixa de ferramentas, no lado direito superior da tela, entre o botão do launch pad e o botão de perfil).
  • Selecione a opção “Configuration”, nesta tela faça o download:
    
    • Chave privada para acesso a API V2 "Download Private Key".
      -Salve esta chave no do volume do Tenant, dentro da pasta "certs" com o nome de "identityApiV2Key.pk8".

Image Removed

Figura 2.1 - Configuração do Identity

• • Copie o Cliente ID, e informe posteriormente no arquivo standalone.xml. Para mais informações sobre o parâmetro acompanhe o Anexo I.

    Bloco de código
    language html/xml
    <simple name="java:global/totvs/idp/apiClientKey" value="<REST_API_V2_CLIENT_ID>"/>

Configurações no standalone.xml do Fluig

É necessário adicionar o parâmetro "java:global/totvs/idp/domain" no arquivo standalone.xml ao atualizar para o Fluig 1.1.1 (nas versões 1.1.0 ou inferiores);

Segue abaixo o detalhamento das configurações do Identity no standalone.xml, caso seja necessário:

	
	<simple name="java:global/totvs/idp/enabled" value="true"/> 
	<simple name="java:global/totvs/idp/ignoreSSLValidation" value="true"/> 
	<simple name="java:global/totvs/idp/justInTimeProvisioning" value="true"/> 
	<simple name="java:global/totvs/idp/clockSkew" value="60"/> 
	<simple name="java:global/totvs/idp/spIssuerName" value="TotvsLabs"/> 
	<simple name="java:global/totvs/idp/providerName" value="TotvsLabs"/> 
	<simple name="java:global/totvs/idp/spProtocolBinding" value="HttpPost"/> 
	<simple name="java:global/totvs/idp/idpProtocolBinding" value="HttpPost"/> 
	<simple name="java:global/totvs/idp/acsURL" value="http://<HOST_FLUIG>:<PORTA>/portal/idp/ACS"/> 
	<simple name="java:global/totvs/idp/idpDestination" value="https://<IP_CLOUDPASS>/cloudpass/SPInitPost/receiveSSORequest/<CODIGO SSO>"/> 
	<simple name="java:global/totvs/idp/homePageURL" value="https://<HOST>/cloudpass/"/> 
	<simple name="java:global/totvs/idp/apiURL" value="https://<HOST>/"/> 
	<simple name="java:global/totvs/idp/certificateFile" value="C:/fluig2/identity/certificateName.crt"/> 
	<simple name="java:global/totvs/idp/nameIdFormat" value="transient"/> 
	<simple name="java:global/totvs/idp/idpIssuerName" value="TotvsLabs"/> 
	<simple name="java:global/totvs/idp/idpCertIssuerName" value="TotvsLabs"/> 
	<simple name="java:global/totvs/idp/authorization" value="<CHAVE_DE_AUTORIZACAO>"/> 
	<simple name="java:global/totvs/idp/domain" value="<DOMINIO_UTILIZADO_NO_IDENTITY>"/> 
	<simple name="java:global/totvs/idp/apiClientKey" value="<REST_API_V2_CLIENT_ID>"/>
 

...