Árvore de páginas

Versões comparadas

Chave

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

Índice


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.
  • Possuir uma empresa cadastrada no Fluig.
Nota

Tanto para o cadastro da empresa no Fluig quanto para a criação do contexto no Identity é necessário definir um administrador. O endereço de e-mail deste administrador deve ser o mesmo para ambos os casos.

  • 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.

Painel
titleoculto

Esse procedimento foi repassado ao artigo https://centraldeatendimento.fluig.com/hc/pt-br/articles/360024961374 (Como integrar a plataforma ao Identity)

Caso seja feita alguma alteração, lembrar de repassar a esse artigo.


Configurar a integração com o Identity

...

Nota
titleImportante!

Para realizar a integração com o Identity, recomendamos que o ambiente fluig esteja em HTTPS. Acesse nossa documentação e confira mais detalhes e informações sobre a configuração HTTPS da plataforma.

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

Painel
titleoculto

Esse procedimento foi repassado ao artigo https://centraldeatendimento.fluig.com/hc/pt-br/articles/360024961374 (Como integrar a plataforma ao Identity)

Caso seja feita alguma alteração, lembrar de repassar a esse artigo.

Índice

Índice
outlinetrue
exclude.*ndice
stylenone

 

Integração com o Identity

 

Passo 2: Configuração do aplicativo fluig no Identity

  • Acesse o Identity com o usuário administrador;

  • 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 opção Configurações, clique na aba Entrar e então na opção Editar (Figura 1);

Image Removed

Figura 1

  • Clique na aba Visão Geral e copie o token de configuração, que se encontra na opção Token de Configuração. Ele será utilizado no próximo passo.

 

Image Removed

Figura 2

Passo 3: Habilitação da autenticação com o Identity

  • Efetue a autenticação no fluig utilizando o usuário wcmadmin, e então acesse Painel de Controle  ► WCM ► Empresas.

  • Selecione a empresa que deseja habilitar a autenticação com o Identity e então clique na opção Editar.
  • A tela de edição de empresa será apresentada. Acesse a aba Autenticação.

    Image Removed

    Figura 3

    Habilite a autenticação via Identity assinalando a opção Acessar com Identity e informe os seguintes parâmetros:

  • URL: A URL do Identity que será utilizado;
  • Token: Token de configuração do aplicativo fluig (obtido anteriormente no passo 2);
  • Provisionamento Just in Time: Se esta opção estiver assinalada, todo usuário do Identity que efetuar login no fluig será criado sob demanda caso ainda não exista no fluig.

    Image Removed

    Figura 4

    • Após as configurações, é necessário clicar no botão Ações e em seguida em Testar conexão. Será exibida uma mensagem informando se a conexão foi realizada com sucesso ou se ocorreu algum erro.

    • Para confirmar, clique no botão Salvar.

     

     

    Deck of Cards
    startHiddenfalse
    effectDuration0.5
    historyfalse
    idsamples
    effectTypefade

    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.

     

    Card
    label
    defaulttrue
    effectDuration0.5
    id1
    labelPasso 1
    effectTypefade
    Nota
    titleAtenção

    Se você já tiver uma empresa cadastrada, verifique o endereço do usuário administrador. O e-mail deve ser o mesmo que será utilizado pelo administrador do Identity. Nesse caso, prossiga com a configuração de integração e no final verifique a documentação para Provisionar usuários do fluig no Identity. 

     

    • Durante a criação da empresa você deverá informar um e-mail, login e senha para o usuário administrador. O e-mail 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); OBS: Não deve ser criado no Identity, empresas em que o subdomínio possua underline (_).

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

     

    Card
    effectDuration0.5
    id2
    labelPasso 2
    effectTypefade
    Card
    effectDuration0.5
    id3
    labelPasso 3
    effectTypefade
    Nota

    Existem dois parâmetros necessários para o correto funcionamento da integração com o Identity. Em <FLUIG>\jboss\bin, acesse o arquivo standalone.conf(.bat) e certifique-se que o parâmetro file.encoding esteja com o valor utf8 o parâmetro jsse.enableSNIExtension com o valor false, conforme abaixo:

    Bloco de código
    languagehtml/xml
    JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8 -Djsse.enableSNIExtension=false"

    Após adicionar ou alterar estes parâmetros o servidor de aplicação do fluig deve ser reiniciado para que as alterações tenham efeito.

    Página de Experiências de Uso

    Ao clicar Salvar, será criada uma página chamada "Aplicativos" no menu principal, essa página possui as widgets de User Experience e de Analytics para exemplo.

    Image Removed

    Os 3 primeiros slots são para widgets de Menu unificado (Acesso Centralizado) aonde será exibido na ordem (Geral, Favoritos, Mais Acessados), o slot inferior a esquerda é Consulta Rápida e o inferior a Direita Widget Analytics.

    Exemplo das Widgets configuradas:

    Acesso Centralizado

    Image Removed

    Consulta Rápida

    Image Removed

    Analytics

    Image Removed

    • Você pode configurar as widgets editando a página, colocando suas preferências
      • As widgets de Menu unificado (Acesso Centralizado) já vem configuradas caso seu ERP já esteja conectado ao identity.
      • A de Consulta rápida e a de Analytics é necessário editar a página para configurar.
    • Caso não deseje a página ou não use User Experience você pode excluir a mesma em Painel de controle > WCM > Minhas Páginas, e desativar o parâmetro USER-EXPERIENCE-ACTIVE para false editando as propriedades da empresa.

    Pronto! O fluig está integrado com o Identity, já sendo possível acessar o fluig com o Identity.

    Autenticação por Contexto

    Quando a instalação do fluig for multi-empresa e uma ou mais empresas possuírem a autenticação via Identity habilitada, se faz necessário a autenticação por contexto

    Na autenticação por contexto o usuário deve acessar o fluig usando a URL com o código da empresa, por exemplo http://meufluig.com/portal/empresa, para que o fluig identifique em qual empresa o usuário está se autenticando. Se a empresa que o usuário está se autenticando possuir o Identity habilitado, ocorrerá o redirecionamento para o Identity. Caso contrário, se a empresa que o usuário está se autenticando não está com o Identity habilitado, a tela de login do fluig é exibida para o usuário informar seus dados de autenticação.

     

    Image Removed

    Passo 1


    O primeiro procedimento da integração é preencher a URL de acesso ao Fluig no aplicativo Fluig do Identity.

    • Acessar o contexto criado no Identity, por exemplo, https://[suaempresa].fluigidentity.com, com as credenciais do administrador.
    • Acionar o menu Aplicativos.
    • Acionar Fluig na lista de aplicativos. É possível localizá-lo utilizando o campo Pesquisar no canto superior esquerdo.
    • Selecionar a aba Entrar.
    • Acionar Editar localizado no canto superior direito.

    Image Added


    Card
    labelPasso 2


    • Informar o endereço de acesso ao Fluig no campo Domínio.
    • Marcar a opção Sincronizar login SAML com e-mail do AD (Recomendado).
    • Acionar Salvar no final da página.
    Informações

    Ao acessar o aplicativo Fluig pelo Identity, o usuário será direcionado para o endereço informado neste campo (Domínio), portanto ele precisa ser preenchido com a URL da aplicação Fluig.

    Image Added


    Card
    labelPasso 3


    Em seguida, deve-se copiar o token do aplicativo.

    • Selecionar a aba Visão Geral.
    • Acionar Token de Configuração.
    • Copiar o valor do token, pois será utilizado posteriormente para configuração da empresa no Fluig (Passo 5).

    Image Added


    Card
    labelPasso 4


    A partir de agora, a configuração será realizada no fluig.

    • Acessar o Fluig com o usuário wcmadmin.
    • Acessar o Painel de Controle → agrupador WCMEmpresas.
    • Assinalar a empresa desejada e acionar Editar.
    Nota

    Para cada contexto do Identity é suportada a integração com apenas uma empresa do Fluig.

    Image Added

    Card
    labelPasso 5


    • Acessar a aba Autenticação.
    • Assinalar a opção "Deseja habilitar o acesso com Identity?"
    • Informar o token de configuração obtido no Passo 3.

    Image Added

    Dica
    titleIntegração entre o Fluig No-Code e Fluig Plataforma

    Nesta página é possível habilitar o botão para ativação da integração entre o Fluig No-Code e Fluig Plataforma, caso o usuário tenha o pacote adquirido. Para saber mais a respeito desta integração, acesse a documentação sobre a Ativação da oferta TOTVS Fluig No-Code. 

    O usuário também poderá observar os Parâmetros do Identity nesta mesma página.

    Card
    labelPasso 6


    • Para garantir que os dados informados estão corretos e a conexão com o Identity está disponível, acionar AçõesTestar conexão.
    • Se a mensagem "Conexão com o servidor do Identity realizada com sucesso" for apresentada, a configuração está correta e pode ser concluída.
    • Acionar Salvar. A empresa exibirá o status "Habilitado" na coluna Identity da página Empresas.
    Dica
    titleE os usuários?

    Após a integração, é possível enviar os usuários cadastrados no Fluig automaticamente para o contexto da empresa no Identity ou adicioná-los manualmente.

    Image Added


    Painel
    titleoculto
    Card
    labelVídeo
    HTML
    <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.

    Painel
    titleoculto

    Esse procedimento foi repassado ao artigo https://centraldeatendimento.fluig.com/hc/pt-br/articles/360024961374 (Como integrar a plataforma ao Identity)

    Caso seja feita alguma alteração, lembrar de repassar a esse artigo.

    Deck of Cards
    historyfalse
    idenviar
    Card
    labelPasso 1


    • Acionar AçõesEnviar usuários.

    Image Added


    Informações
    iconfalse
    Expandir
    titleCondições de preenchimento do campo idp_id no banco de dados do TOTVS Fluig Plataforma

    A rotina de integração das contas no Fluig e Identity funciona de acordo com as seguintes condições:

    01. Se no banco de dados do Fluig, o registro do usuário já tiver o campo idp_id preenchido, ele não será sincronizado.

    02. Se o idp_id não estiver preenchido, o usuário será enviado ao Identity:

    2.1 Caso o e-mail deste usuário já esteja cadastrado em uma conta no domínio do cliente no Identity, o seu ID é preenchido na coluna idp_id da tabela fdn_usertenant.

    2.2 Caso o e-mail deste usuário já esteja cadastrado em uma conta no Identity, mas atrelado a um outro domínio, ele também será adicionado ao domínio do cliente e o seu ID é preenchido na coluna idp_id da tabela fdn_usertenant.

    2.3 Se ele não estiver cadastrado em nenhum domínio, o usuário é criado no Identity, vinculado ao domínio do cliente e o seu ID é preenchido na coluna idp_id da tabela fdn_usertenant.

    Card
    labelPasso 2


    Uma vez utilizado o recurso Enviar usuários, é possível verificar quais contas foram efetivamente criadas e integradas no Identity através do log de envio.

    • Acionar AçõesExportar log de envio.

    Image Added


    Card
    labelPasso 3


    • Será gerado um arquivo CSV contendo as colunas login, e-mail, data de envio e o status da operação de criação do usuário.

    Image Added


    Card
    labelPasso 4


    • Os usuários enviados são automaticamente atrelados ao aplicativo Fluig no Identity.

    Image Added


    Card
    labelPasso 5


    • Quando o processo for terminado, os usuários enviados poderão acessar o Fluig pelo Identity.
    • A senha destes usuários no Identity será composta da seguinte forma: [primeiro nome com a primeira letra maiúscula]@123. Por exemplo:

    Nome do usuário: John Steel

    Login no Identity: [email protected]

    Senha no Identity: John@123

    • Se um usuário enviado pelo Fluig possuir uma conta prévia no Identity, sua senha de acesso não será alterada.
    • Caso o primeiro nome do usuário possua 13 caracteres ou mais, a senha será criada usando apenas os 12 primeiros caracteres do nome + @123. Por exemplo, se o nome do usuário for Joriscleidson, a senha gerada será Joriscleidso@123.
    • Se o primeiro nome do usuário for muito curto, o Fluig irá adicionar números ao final da senha até atingir o tamanho mínimo exigido pelo Identity (8 caracteres). Por exemplo, se o nome da usuária for Lu, a senha gerada será Lu@12345.
    • Os usuários podem alterar a senha do Identity através da página Meu Perfil a qualquer momento.
    Nota
    titleAtenção!

    Caso tenha alguma dúvida durante esse processo, verifique a documentação IDE - Por que novos usuários não são provisionados no fluig?.


    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.

    Nota

    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 é: http://meufluig.com/portal/idp.


    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.

    Nota
    titleAviso

    Cada contexto do Identity suporta a integração com apenas uma empresa do Fluig. As demais empresas de uma mesma instalação do Fluig não poderão ser integradas ao mesmo contexto do Identity.


    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.

    02Acionar 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.


    Painel
    titleoculto

    Página Aplicativos para widgets de Experiências de Uso


    Após a configuração da integração entre Fluig e Identity, uma página chamada Aplicativos será automaticamente criada e incluída no menu principal do Fluig. Essa página contém os widgets de Experiência de Uso e Analytics dispostos no seguinte layout:

    Image Added

    Os 3 primeiros slots destinam-se às widgets de Acesso Centralizado, exibidas nesta ordem: Geral, Favoritos e Mais Acessados. O slot inferior à esquerda destina-se ao widget de Consulta Rápida e o inferior à direita apresenta o widget Analytics.

    Deck of Cards
    historyfalse
    idA
    Card
    id1
    labelAcesso centralizado


    • Os widgets de Acesso Centralizado serão automaticamente configurados caso um ERP já esteja integrado ao Identity.

    Image Added


    Card
    id2
    labelConsulta rápida


    • Para configurar o widget de Consulta Rápida, é necessário editar a página e seguir os procedimentos descritos na documentação Widgets de Experiência de Uso.

    Image Added


    Card
    id3
    labelAnalytics


    • Para configurar o widget Analytics, é necessário editar a página e seguir os procedimentos descritos na documentação Widgets de Experiência de Uso.

    Image Added


    Nota
    iconfalse
    Expandir
    titleDesativar página Aplicativos e Experiências de Uso

    Para que a página Aplicativos não seja exibida no menu principal do Fluig, deve-se acessar o Painel de controle → agrupador WCMMinhas Páginas e excluir a página.

    Para desabilitar as Experiências de Uso, deve-se acessar as propriedades da empresa através do Painel de Controle do usuário wcmadmin (agrupador WCMEmpresasEditarCadastrar dados adicionais) e alterar o valor do parâmetro USER-EXPERIENCE-ACTIVE para false.

    HTML
    <!-- 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>
    
    HTML
    <script>
    	$("b:contains('oculto')").parent().parent().hide();
    </script>

    ...