AWS Cognito - OIDC - Configuração

Credenciais de Usuário Obrigatórias

[Usuário Flosum] - Administrador do Sistema Função

Aviso importante

As instruções neste artigo cobrem um aplicativo de terceiros e podem não refletir a versão mais recente. Use estas instruções como um guia para concluir a tarefa, mas esteja ciente de que algumas telas, nomes de campos e etapas podem ter sido alterados.

Visão geral

Este guia explica como integrar o AWS Cognito usando OpenID Connect (OIDC) com o Flosum Cloud Apps para habilitar o Single Sign-On (SSO) para um login sem interrupções.

Para instruções mais gerais sobre como adicionar um Provedor de Identidade, consulte o artigo a seguir.

• Adicionando um provedor de identidade (SSO)

Hospedado pelo Cliente

Clientes que hospedam os Aplicativos Flosum em sua própria infraestrutura terão uma URL personalizada para fazer login em seus aplicativos. Ao usar esta documentação, substitua qualquer URLs Hospedadas pelo Flosum pelas suas próprias URLs.

Resumo das etapas envolvidas

• Crie um pool de usuários com o AWS Cognito
• Determine a URL do emissor
• Obtenha o ID do cliente e o segredo do cliente
• Configure a URL de redirecionamento
• Crie um Provedor de Identidade com as Configurações globais do Flosum
• Teste o SSO

Configurando o AWS Cognito para o Flosum Cloud Apps

Esta seção mostra como configurar um User Pool do AWS Cognito para funcionar com o Flosum Cloud Apps para SSO.

Observe que as instruções do AWS Cognito podem não refletir a versão mais recente. Algumas telas, nomes de campos e etapas podem ter sido alterados.

1

Criar User Pool do AWS Cognito

1. Acesse o Console de Gerenciamento da AWS e navegue até o serviço Cognito.
2. Selecione Gerenciar pools de usuários.
3. Na seção de pools de usuários, clique no botão Criar um pool de usuários Você será solicitado a nomear seu novo pool.
4. Depois de nomear seu pool, selecione Definir configurações passo a passo. Esta seção permite definir os parâmetros de login dos seus usuários.
5. Selecione os atributos mostrados na captura de tela abaixo. Esses atributos determinam as informações que você coletará dos usuários durante o registro.

   
6. Depois de definir os atributos necessários, clique em Próxima etapa para salvar suas configurações.

2

Configurando políticas

1. Selecione as configurações para corresponder aos seus requisitos de segurança.
2. Clique Próxima etapa.

   

3

Configuração de MFA e verificação

1. Selecione as configurações de autenticação multifator e verificação com base nas suas necessidades de segurança.
2. Clique Próxima etapa para salvar suas configurações.

   

4

Personalizações de mensagens

1. Edite as mensagens de verificação para atender às suas necessidades.
2. Clique Próxima etapa para salvar suas configurações.

   

5

Configuração dos clientes do aplicativo

1. Ignore as Tags e Dispositivos etapas.
2. Configure os clientes do aplicativo.
3. Clique Adicione um cliente do aplicativo.
4. Edite as configurações para corresponder à captura de tela abaixo.
5. Clique Próxima etapa para salvar suas configurações.

   

6

Finalizar o User Pool

1. Na etapa de Revisão verifique se todas as configurações estão corretas.
2. Se tudo estiver correto, clique em Criar pool para finalizar a criação do pool de usuários.

7

Defina o nome de domínio

A próxima etapa é criar um Nome de domínio para o pool de usuários que você criou.

1. Navegue até a guia Nome de domínio tab.
2. Insira o seu prefixo de domínio.
3. Clique Verificar disponibilidade.
4. Se o domínio estiver disponível, clique em Salvar alterações.

   

8

Configurar as configurações do cliente do aplicativo

1. Navegue até configurações do cliente do aplicativo e atualize-as para corresponder às configurações mostradas na captura de tela abaixo.

   
2. Em URL(s) de retorno campo, adicione a URL da sua região para cada Flosum Cloud App que você deseja usar com SSO. Consulte a tabela abaixo para obter as URLs da sua região.

URLs dos Estados Unidos

Flosum Cloud App	URL de callback
Configurações Globais	https://global-us.flosum.app/api/v1/oauth/callback
Backup e Arquivo	https://backup-us.flosum.app/api/v1/oauth/callback
DevOps	https://devops-us.flosum.app/api/v1/oauth/callback

URLs da Alemanha

Flosum Cloud App	URL de callback
Configurações Globais	https://global-de.flosum.app/api/v1/oauth/callback
Backup e Arquivo	https://backup-de.flosum.app/api/v1/oauth/callback
DevOps	https://devops-de.flosum.app/api/v1/oauth/callback

URLs do Japão

Flosum Cloud App	URL de callback
Configurações Globais	https://global-jp.flosum.app/api/v1/oauth/callback
Backup e Arquivo	https://backup-jp.flosum.app/api/v1/oauth/callback
DevOps	https://devops-jp.flosum.app/api/v1/oauth/callback

URLs da Austrália

Flosum Cloud App	URL de callback
Configurações Globais	https://global-au.flosum.app/api/v1/oauth/callback
Backup e Arquivo	https://backup-au.flosum.app/api/v1/oauth/callback
DevOps	https://devops-au.flosum.app/api/v1/oauth/callback

1. Em URL(s) de logout campo, adicione a URL da sua região para cada Flosum Cloud App que você deseja usar com SSO. Consulte a tabela abaixo para obter as URLs da sua região.

URLs dos Estados Unidos

Aplicativo Flosum Cloud	URL de logout
Configurações globais	https://global-us.flosum.app/api/v1/oauth/login
Backup e Arquivo	https://backup-us.flosum.app/api/v1/oauth/login
DevOps	https://devops-us.flosum.app/api/v1/oauth/login

URLs da Alemanha

Aplicativo Flosum Cloud	URL de logout
Configurações globais	https://global-de.flosum.app/api/v1/oauth/login
Backup e Arquivo	https://backup-de.flosum.app/api/v1/oauth/login
DevOps	https://devops-de.flosum.app/api/v1/oauth/login

URLs do Japão

Aplicativo Flosum Cloud	URL de logout
Configurações globais	https://global-jp.flosum.app/api/v1/oauth/login
Backup e Arquivo	https://backup-jp.flosum.app/api/v1/oauth/login
DevOps	https://devops-jp.flosum.app/api/v1/oauth/login

URLs da Austrália

Aplicativo Flosum Cloud	URL de logout
Configurações globais	https://global-au.flosum.app/api/v1/oauth/login
Backup e Arquivo	https://backup-au.flosum.app/api/v1/oauth/login
DevOps	https://devops-au.flosum.app/api/v1/oauth/login

9

Recupere o ISSUER_BASE_URL

Você precisará do valor ISSUER_BASE_URL ao criar o Provedor de Identidade nas Configurações globais do Flosum.

1. Navegue até Gerenciar pools de usuários no AWS Cognito.
2. Selecione o User Pool que você criou e, em seguida, acesse Configurações gerais.
3. Observe o ISSUER_BASE_URL, que segue o formato: https://cognito-idp.<região>.amazonaws.com/<userPoolId>.

   

10

Recupere ISSUER_CLIENT_ID e ISSUER_CLIENT_SECRET

Você precisará do valor ISSUER_CLIENT_ID e ISSUER_CLIENT_SECRET valores ao criar o Provedor de Identidade nas Configurações globais do Flosum.

1. Navegue até Gerenciar pools de usuários no AWS Cognito.
2. Selecione o User Pool que você criou e, em seguida, clique em clientes do aplicativo.
3. Observe o ISSUER_CLIENT_ID, encontrado em App client id.
4. Observe o ISSUER_CLIENT_SECRET, encontrado em App client secret.

11

Definir URL de redirecionamento

1. Em URL de redirecionamento campo, adicione a URL da sua região para cada Flosum Cloud App que você deseja usar com SSO. Consulte a tabela abaixo para obter as URLs da sua região.

URLs dos Estados Unidos

App Flosum Cloud	URL de retorno
Configurações globais	https://global-us.flosum.app/api/v1/auth/login/open-id
Backup e Arquivo	https://backup-us.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-us.flosum.app/api/v1/auth/login/open-id

URLs da Alemanha

App Flosum Cloud	URL de retorno
Configurações globais	https://global-de.flosum.app/api/v1/auth/login/open-id
Backup e Arquivo	https://backup-de.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-de.flosum.app/api/v1/auth/login/open-id

URLs do Japão

App Flosum Cloud	URL de retorno
Configurações globais	https://global-jp.flosum.app/api/v1/auth/login/open-id
Backup e Arquivo	https://backup-jp.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-jp.flosum.app/api/v1/auth/login/open-id

URLs da Austrália

App Flosum Cloud	URL de retorno
Configurações globais	https://global-au.flosum.app/api/v1/auth/login/open-id
Backup e Arquivo	https://backup-au.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-au.flosum.app/api/v1/auth/login/open-id

Criar Provedor de Identidade nas Configurações Globais

1

Criar Provedor de Identidade

Siga as instruções gerais no artigo abaixo para começar a criar um Provedor de Identidade OIDC.

1. Adicionando um provedor de identidade (SSO)

2. Preencha o Informações básicas seção.

   1. Selecione OPEN_ID para o provedor de identidade Tipo.
3. Preencha o Informações do botão seção.
4. (Opcional) Preencha o Informações do grupo seção.

Preencha os campos de informações OpenID

Copie as informações da sua aplicação AWS Cognito para a seção de Informações OpenID. A tabela explica quais valores do AWS Cognito inserir em quais campos do Flosum. A captura de tela final mostra um provedor de identidade concluído para uma aplicação OIDC do AWS Cognito.

Os valores na coluna Valor do AWS Cognito são uma combinação de valores do seu aplicativo AWS Cognito. A obtenção desses valores é explicada nas seções acima.

Campo do Flosum	Valor do AWS Cognito
ID do cliente	ISSUER_CLIENT_ID
Segredo do cliente	ISSUER_CLIENT_SECRET
Emissor	ISSUER_BASE_URL

2

Salvar e testar

Para instruções sobre como fazer login com SSO, veja o artigo a seguir.

• Fazendo login com SSO

1. Clique Salvar para salvar o provedor de identidade.
2. Para testar, abra uma janela anônima.
3. Comece a fazer login nas Configurações Globais com o nome do seu locatário.
4. Se o provedor de identidade foi configurado com sucesso, você deverá ver o botão SSO que você criou.