> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-oidc/aws-cognito-oidc-configuracao.md).

# AWS Cognito - OIDC - Configuração

{% hint style="success" %}

#### Credenciais de Usuário Obrigatórias

\[**Usuário Flosum**] - **Administrador do Sistema** Função
{% endhint %}

{% hint style="success" %}

#### 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.
{% endhint %}

## ![](https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) 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.

{% hint style="info" %}
Para instruções mais gerais sobre como adicionar um Provedor de Identidade, consulte o artigo a seguir.

* [Adicionando um provedor de identidade (SSO)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
  {% endhint %}

{% hint style="warning" %}

#### 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.
{% endhint %}

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

{% hint style="warning" %}
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.
{% endhint %}

{% stepper %}
{% step %}

### Criar User Pool do AWS Cognito

1. Acesse o **Console de Gerenciamento da AWS** e navegue até o **serviço Cognito**.&#x20;
2. Selecione **Gerenciar pools de usuários**.&#x20;
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.&#x20;
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.&#x20;
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.&#x20;

   <div align="left"><figure><img src="https://lh5.googleusercontent.com/VrEigrVn_qHOOVG78O96BmwWZtHsQC2g_HF1Kb-p9DHrI2A97IJnD0bV0sb3O7NAI5c3BOQNrXntiv9eH-P_f9e1KDvff1DabFRmQoe20D_27Iqd_v2dNfKHE4IOHifQB3mXj_bp_OLW2c9l" alt="" width="563"><figcaption></figcaption></figure></div>
6. Depois de definir os atributos necessários, clique em **Próxima etapa** para salvar suas configurações.
   {% endstep %}

{% step %}

### Configurando políticas

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

   <div align="left"><figure><img src="https://lh6.googleusercontent.com/TlUHlReogVC74GD12VbRBr3S6NyPZN_auoA8wb7WdMJqoo4KCvhcpgmtfkdT4FgH1YTmflUYLu4rUDmbGjPUo5UlhqF_p42IERIDvwKdXdiS2UAmqRTJOlxaVIloHDJzq4-uxFhEoCoTDhw9" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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.&#x20;
2. Clique **Próxima etapa** para salvar suas configurações.

   <div align="left"><figure><img src="https://lh6.googleusercontent.com/JCtcza0AHiQoH2DrdSzJEFqL40XDbkVhCoPSZBbmxZ-m7yH486IilOlqqoI0Ijtm1vV_nXPcDa_u3RMSdGSrJIRIfpOcf5IFWMbU5MAKnJxd7YpsmM8OuFUrjby_J9sZrWvssJuXodUPeI9b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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.&#x20;

   <div align="left"><figure><img src="https://lh4.googleusercontent.com/p8HDSG-2n_7jHhpe0aM7u46G7fRNXqbwjCeW9arIkKYClXm7S76kOZ3BqUCT5dTusz8vCyWXiU4theC1p-z9EsX08iEOwV9xnIm2CFNYqVBaB_sLPg3CZSGWQpLGilqVHQzsMquhYaxglVUO" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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**.&#x20;
4. Edite as configurações para corresponder à captura de tela abaixo.
5. Clique **Próxima etapa** para salvar suas configurações.&#x20;

   <div align="left"><figure><img src="https://lh5.googleusercontent.com/mO6HsG5hIak9alvEimEb6oGOnNS04UzsoAao1wGZCyqVCkf8EZl8Kq8s1UUeQgcVAh3yyNiZNOZ80ylRfKmXhTtKpp61CRkhq494tmgySc2FMU0wkm20DXSY8Lb1f6LH8H0BDd3VdV9UiqIp" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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.
   {% endstep %}

{% step %}

### 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.&#x20;

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

   <div align="left"><figure><img src="https://lh3.googleusercontent.com/1DlPH2O3OuUJYZr1iu3UT2IFI0WCzzwshDrsIIBTo9_nU5nfzSR-xnP8Q-waLx1OO8ciHZt2XfP907uflygDRz4J38TL9SHb7jnb3RenaeMHWRy1aQuWOwNsbRIhzLJ4RWqC4K7G33mXbkk0" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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.&#x20;

   <div align="left"><figure><img src="https://lh6.googleusercontent.com/puQp5uimq39Qyxg6OXnc-2WsDmudmQW5LZWtrKkfTmlLQ4RpXPf-0uTd_eo9Fkvze9h1IhekEZvxz8l3sjfgyWdCT2dwZkIZmeCdDb1aMAqdTU2bOxMYeayJOy_UVfdxeWEyweI4GKL2n7Dx" alt="" width="563"><figcaption></figcaption></figure></div>
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.

{% tabs %}
{% tab title="URLs dos Estados Unidos" %}

<table><thead><tr><th width="180">Flosum Cloud App</th><th>URL de callback</th></tr></thead><tbody><tr><td>Configurações Globais</td><td>https://global-us.flosum.app/api/v1/oauth/callback</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-us.flosum.app/api/v1/oauth/callback</td></tr><tr><td>DevOps</td><td>https://devops-us.flosum.app/api/v1/oauth/callback</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Alemanha" %}

<table><thead><tr><th width="180">Flosum Cloud App</th><th>URL de callback</th></tr></thead><tbody><tr><td>Configurações Globais</td><td>https://global-de.flosum.app/api/v1/oauth/callback</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-de.flosum.app/api/v1/oauth/callback</td></tr><tr><td>DevOps</td><td>https://devops-de.flosum.app/api/v1/oauth/callback</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs do Japão" %}

<table><thead><tr><th width="180">Flosum Cloud App</th><th>URL de callback</th></tr></thead><tbody><tr><td>Configurações Globais</td><td>https://global-jp.flosum.app/api/v1/oauth/callback</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-jp.flosum.app/api/v1/oauth/callback</td></tr><tr><td>DevOps</td><td>https://devops-jp.flosum.app/api/v1/oauth/callback</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Austrália" %}

<table><thead><tr><th width="180">Flosum Cloud App</th><th>URL de callback</th></tr></thead><tbody><tr><td>Configurações Globais</td><td>https://global-au.flosum.app/api/v1/oauth/callback</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-au.flosum.app/api/v1/oauth/callback</td></tr><tr><td>DevOps</td><td>https://devops-au.flosum.app/api/v1/oauth/callback</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

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

{% tabs %}
{% tab title="URLs dos Estados Unidos" %}

<table><thead><tr><th width="180">Aplicativo Flosum Cloud</th><th>URL de logout</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-us.flosum.app/api/v1/oauth/login</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-us.flosum.app/api/v1/oauth/login</td></tr><tr><td>DevOps</td><td>https://devops-us.flosum.app/api/v1/oauth/login</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Alemanha" %}

<table><thead><tr><th width="180">Aplicativo Flosum Cloud</th><th>URL de logout</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-de.flosum.app/api/v1/oauth/login</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-de.flosum.app/api/v1/oauth/login</td></tr><tr><td>DevOps</td><td>https://devops-de.flosum.app/api/v1/oauth/login</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs do Japão" %}

<table><thead><tr><th width="180">Aplicativo Flosum Cloud</th><th>URL de logout</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-jp.flosum.app/api/v1/oauth/login</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-jp.flosum.app/api/v1/oauth/login</td></tr><tr><td>DevOps</td><td>https://devops-jp.flosum.app/api/v1/oauth/login</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Austrália" %}

<table><thead><tr><th width="180">Aplicativo Flosum Cloud</th><th>URL de logout</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-au.flosum.app/api/v1/oauth/login</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-au.flosum.app/api/v1/oauth/login</td></tr><tr><td>DevOps</td><td>https://devops-au.flosum.app/api/v1/oauth/login</td></tr></tbody></table>
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Recupere o ISSUER\_BASE\_URL

{% hint style="info" %}
Você precisará do valor **ISSUER\_BASE\_URL** ao criar o Provedor de Identidade nas Configurações globais do Flosum.
{% endhint %}

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>`.&#x20;

   <div align="left"><figure><img src="https://lh6.googleusercontent.com/zsWrLhvp05cCmhOZK7lX1vxgy1Hfe04OcI_HBOLlgRnd5q738Kz3aHPpFOTEEBrN8xaCCFMKHtAu6OhUuJ72R03EV_sX9Embgni5z26EmA1HxdZITDswWgbZ9AK3TIrVyHTjWB-y2OkFKcYG" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Recupere ISSUER\_CLIENT\_ID e ISSUER\_CLIENT\_SECRET

{% hint style="info" %}
Você precisará do valor **ISSUER\_CLIENT\_ID** e **ISSUER\_CLIENT\_SECRET** valores ao criar o Provedor de Identidade nas Configurações globais do Flosum.
{% endhint %}

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.
   {% endstep %}

{% step %}

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

{% tabs %}
{% tab title="URLs dos Estados Unidos" %}

<table><thead><tr><th width="180">App Flosum Cloud</th><th>URL de retorno</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-us.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-us.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-us.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Alemanha" %}

<table><thead><tr><th width="180">App Flosum Cloud</th><th>URL de retorno</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-de.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-de.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-de.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs do Japão" %}

<table><thead><tr><th width="180">App Flosum Cloud</th><th>URL de retorno</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-jp.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-jp.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-jp.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs da Austrália" %}

<table><thead><tr><th width="180">App Flosum Cloud</th><th>URL de retorno</th></tr></thead><tbody><tr><td>Configurações globais</td><td>https://global-au.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Backup e Arquivo</td><td>https://backup-au.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-au.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

## Criar Provedor de Identidade nas Configurações Globais

{% stepper %}
{% step %}

### 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)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
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**      |

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FIiZb0PKnqtRhaTNpVxjh%2FAwsCognitoOidcConfig-CreateIdentityProvider-01.png?alt=media&amp;token=c3e0cb85-2935-4e9d-9635-808839e7c364" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Salvar e testar

{% hint style="info" %}
Para instruções sobre como fazer login com SSO, veja o artigo a seguir.

* [Fazendo login com SSO](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/fazendo-login-com-sso.md)
  {% endhint %}

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.&#x20;

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FGvKim2Ukj224V8EpfFH4%2FAwsCognitoOidcConfig-CreateIdentityProvider-02.png?alt=media&amp;token=9acc8fbf-e76d-4915-b9e2-3e07a039de9b" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-oidc/aws-cognito-oidc-configuracao.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
