> 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/auth0-oidc-configuracao.md).

# Auth0 - 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 Auth0 usando OpenID Connect (OIDC) com o Flosum Cloud Apps para habilitar o Single Sign-On (SSO) para um login contínuo.

{% 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

* **Configurar aplicativo Auth0**
* **Adicionar URLs de callback**
* **Crie um Provedor de Identidade com as Configurações globais do Flosum**
* **Teste o SSO**

## Configurando o Auth0 para o Flosum Cloud Apps

Esta seção mostra como configurar um aplicativo Auth0 para funcionar com o Flosum Cloud Apps para SSO.

{% hint style="warning" %}
Observe que as instruções para aplicativos Auth0 podem não refletir a versão mais recente. Algumas telas, nomes de campos e etapas podem ter mudado.
{% endhint %}

{% stepper %}
{% step %}

### Configurar aplicativo no Auth0

1. Faça login na sua conta Auth0.
2. Clique em **Aplicativos** na barra lateral esquerda e, em seguida, clique em **Aplicativos**.

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FomnigYvY4E4F48xh3wxC%2FAuth0Setup-S01-01.png?alt=media&amp;token=b0027c85-595b-4fa5-8d08-52ce8d319c95" alt=""><figcaption></figcaption></figure></div>
3. Clique em **App padrão** para abrir a tela do App padrão.

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F1MaPpR3sugGZcgddLZuh%2FAuth0Setup-S01-02.png?alt=media&amp;token=108cb236-47a9-47e9-ada0-fccdbc08c37b" alt="" width="545"><figcaption></figcaption></figure></div>
4. Copie a **Domínio**, **ID do cliente**, e **Segredo do cliente** valores para criar um provedor de identidade nas Configurações Globais do Flosum.
   {% endstep %}

{% step %}

### Adicionar URLs de callback

1. Clique no **Configurações** .
2. Em **URLs de callback permitidas** 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.

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FlUTgoT5hR3slZeLNU6LR%2FAuth0Setup-S01-03.png?alt=media&amp;token=b3abf8b5-c3f5-46ce-ba00-0734151f1c2b" alt=""><figcaption></figcaption></figure></div>

{% 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 nas Configurações Globais

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 do seu aplicativo Auth0 para a seção OpenID Information. A tabela explica quais campos do Auth0 devem ser inseridos em quais campos do Flosum. A captura de tela final mostra um provedor de identidade concluído para um aplicativo OIDC do Auth0.

Os campos do Auth0 são encontrados em: **Auth0 -> App padrão -> Configurações -> Informações básicas**

| Campo do Flosum        | Campo do Auth0           |
| ---------------------- | ------------------------ |
| **ID do cliente**      | **ID do cliente**        |
| **Segredo do cliente** | **Segredo do cliente**   |
| **Emissor**            | `https://` + **Domínio** |

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FrmX0ZPRXgUouMlH6G1eR%2FAuth0Setup-CreateIdentityProvider-01.png?alt=media&amp;token=536005e8-3a36-4414-9e93-9d397c06278d" 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%2Fy19T52NShfgsh5O0sKcn%2FAuth0Setup-CreateIdentityProvider-02.png?alt=media&amp;token=7c54c63e-6928-496e-96ed-7dd4704fa33c" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FToj56imIEMIUdhQZkJMB%2FAuth0Setup-S03-03.png?alt=media&amp;token=0b2c641c-fb7d-4147-9b72-53f25894bfb9" alt="" width="269"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Se, após inserir suas credenciais, você encontrar o erro “**IdP attribute given\_name is undefined**”, adicione os seguintes atributos ao usuário na sua conta Auth0.

* `given_name`
* `family_name`
  {% endhint %}
  {% endstep %}
  {% endstepper %}

## Auth0 - Criar usuário e adicionar atributos

Se você estiver recebendo um erro ao tentar fazer login no Backup & Archive com suas credenciais Auth0, você precisa criar um usuário e adicionar os `given_name` e `family_name` atributos a esse usuário.

{% stepper %}
{% step %}

### Criar usuário e adicionar atributos

{% hint style="info" %}
Se você já for um usuário existente, pode adicionar atributos pulando as etapas 1 e 2 desta seção.
{% endhint %}

1. Na sua conta Auth0, clique em **Gerenciamento de usuários** na barra lateral esquerda e, em seguida, clique em **Usuários**.

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/jGieDyPNFSHI5mTiWUkx/rtaImage" alt=""><figcaption></figcaption></figure>
2. Clique em **Criar usuário** e preencha os campos obrigatórios.
3. Abra seu usuário e clique em **JSON bruto** .&#x20;
4. Anote o seu **user\_id**, porque você precisará dele mais adiante no processo.

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/733VcyIwresF2GlGG5Ht/rtaImage" alt=""><figcaption></figcaption></figure>
5. Clique em **Aplicativo** na barra lateral esquerda e, em seguida, clique em **APIs**.

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/zudbVc7VcNN28LlnrcG8/rtaImage" alt=""><figcaption></figcaption></figure>
6. Clique em **API de Gerenciamento do Auth0**.
7. Clique no **Teste** .

   <div align="left"><figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/MqRFhBx8tw4NcsfDMs2D/rtaImage" alt="" width="563"><figcaption></figcaption></figure></div>
8. Clique em **Criar e autorizar aplicativo de teste**.
9. Clique no **Explorador da API** aba e clique em **Criar e autorizar aplicativo de teste**.
10. Anote o **Token**, pois você precisará dele mais adiante no processo.

    <div align="left"><figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/vitukU0KDNwKgugdEdqs/rtaImage" alt="" width="563"><figcaption></figcaption></figure></div>
11. Clique em **Documentação** no canto superior direito da sua tela para abrir [Documentação do Auth0](https://auth0.com/docs).

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/WkNSHVe9dZGqDcGxgRKv/rtaImage" alt=""><figcaption></figcaption></figure>
12. Clique em **APIs do Auth0**.
13. Clique em **Explorador da API de Gerenciamento** na barra lateral esquerda.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/METFuADxEhqPQZY6rvs2/rtaImage" alt=""><figcaption></figcaption></figure>
14. Clique em **Usuários** na barra lateral esquerda e, em seguida, clique em **Atualizar um usuário**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/htpHtJF88mbqRNU90MtG/rtaImage" alt=""><figcaption></figcaption></figure>
15. Clique em **Definir token da API** no canto superior direito da sua tela e, em seguida, cole o valor do token salvo anteriormente na janela modal para autorização.&#x20;
16. O botão Definir token da API agora deve exibir **Autorizado**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/Aujhq6QaCcZqLAKYHTFa/rtaImage" alt=""><figcaption></figcaption></figure>
17. Inserir em **caminho: id** o valor do ID do usuário que você salvou anteriormente, e exclua todas as linhas, exceto **given\_name** e **family\_name**. Preencha o significado dessas linhas conforme necessário.&#x20;
18. Clique em **Endpoint de teste**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/TQ9lbBsxdWVvT3hfuiy9/rtaImage" alt=""><figcaption></figcaption></figure>
19. Você deve receber um código de resposta **200**. Se você não receber um código de resposta 200, aparecerá uma mensagem identificando o problema. Problemas comuns podem ser um token ou ID de usuário incorretos.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/e2vy1dwDF8gdq0zItUls/rtaImage" alt=""><figcaption></figcaption></figure>
20. Clique em **Usuários** na barra lateral esquerda e clique na **JSON bruto** aba. “**given\_name**” e “**family\_name**” devem ser adicionados.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/Pcr2053LShUl0OhKzAlf/rtaImage" alt=""><figcaption></figcaption></figure>
21. Retorne ao Flosum Backup & Archive e faça login.
    {% 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/auth0-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.