> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/team/okta-sso.md).

# Configuração de SSO do Okta

Configure single sign-on da Okta para o AirOps com OAuth 2.0/OIDC.

Configure o Okta como o seu fornecedor de início de sessão único para que os membros do workspace possam iniciar sessão no AirOps com as credenciais do Okta. Este guia abrange a criação de uma aplicação web OIDC no Okta, a cópia das credenciais do cliente e dos URLs dos endpoints e a adição desses valores ao AirOps.

{% hint style="info" %}
O SSO do AirOps com Okta usa OAuth 2.0/OIDC. No Okta, crie uma aplicação web que use o fluxo Authorization Code.
{% endhint %}

## Como Configurar

### Crie a integração da aplicação Okta

1. No Okta, vá para **Aplicações**.
2. Clique em **Criar integração da aplicação**.
3. Selecione **OIDC - OpenID Connect** como método de início de sessão.
4. Selecione **Aplicação web** como tipo de aplicação.
5. Clique em **Seguinte**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5acd08ed533ed75bd4f08c42931bf162047da317%2Fokta-sso-01-create-app-integration.png?alt=media" alt="Create an Okta OIDC app integration for AirOps"><figcaption><p>Crie uma integração de aplicação OIDC no Okta.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-38ddb66ef7d132b7d739ffffa56ef0382e68f6e7%2Fokta-sso-02-web-app-settings.png?alt=media" alt="Select Web Application as the Okta application type"><figcaption><p>Selecione Aplicação web como tipo de aplicação do Okta.</p></figcaption></figure>

### Configure as definições da aplicação Okta

Configure estas definições na **Definições gerais** etapa do assistente de criação, ou mais tarde no separador **Geral** . As aplicações web OIDC não têm um separador Single Sign On; esse separador só aparece em aplicações SAML.

1. Conjunto **Nome da integração da aplicação** para `AirOps`.
2. Em **INICIAR SESSÃO**, defina **URIs de redirecionamento de início de sessão** para `https://app.airops.com/users/auth/okta/callback`.
3. Em **Origens de confiança**, defina **URIs base** para `https://app.airops.com`.
4. Em **Atribuições**, escolha os utilizadores ou grupos que devem aceder ao AirOps.
5. Clique em **Guardar**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0fbbdb6f69d1ded2eb8ffb8e9ca68a03a9cce4ee%2Fokta-sso-03-assignments.png?alt=media" alt="Configure Okta assignments for the AirOps application"><figcaption><p>Atribua a aplicação AirOps aos utilizadores ou grupos que precisam de acesso.</p></figcaption></figure>

### Escolha os endpoints do servidor de autorização do Okta

O AirOps pede os URLs dos endpoints diretamente. Escolha o servidor de autorização do Okta que a sua organização usa e depois copie os URLs correspondentes para o AirOps.

Use o servidor de autorização da organização se a sua organização Okta não tiver um servidor de autorização personalizado. Estes URLs usam o seu domínio Okta sem `/oauth2/default`.

| Campo do AirOps                      | URL do servidor de autorização da organização           |
| ------------------------------------ | ------------------------------------------------------- |
| **URL de autorização**               | `https://your-okta-domain.okta.com/oauth2/v1/authorize` |
| **URL do token**                     | `https://your-okta-domain.okta.com/oauth2/v1/token`     |
| **URL de informações do utilizador** | `https://your-okta-domain.okta.com/oauth2/v1/userinfo`  |

Use um servidor de autorização personalizado apenas quando a sua organização Okta tiver um configurado. As organizações de desenvolvimento do Okta muitas vezes incluem o `predefinido` servidor de autorização personalizado, mas algumas organizações de produção não.

| Campo do AirOps                      | URL do servidor de autorização personalizado                    |
| ------------------------------------ | --------------------------------------------------------------- |
| **URL de autorização**               | `https://your-okta-domain.okta.com/oauth2/default/v1/authorize` |
| **URL do token**                     | `https://your-okta-domain.okta.com/oauth2/default/v1/token`     |
| **URL de informações do utilizador** | `https://your-okta-domain.okta.com/oauth2/default/v1/userinfo`  |

{% hint style="info" %}
Se o administrador do Okta lhe fornecer um ID de servidor de autorização personalizado diferente de `predefinido`, substitua `predefinido` nos URLs do servidor de autorização personalizado por esse ID.
{% endhint %}

### Configure o Okta no AirOps

1. Inicie sessão no AirOps em `https://app.airops.com`.
2. Navegue até **Definições → Início de sessão único**.
3. Na **Fornecedores de SSO** na página, clique em **Configurar** na **Okta** linha.
4. Introduza as credenciais de cliente do Okta e os URLs dos endpoints.
5. Clique em **Adicione**.

Para editar uma configuração existente do Okta, abra **Ações → Atualizar credenciais** na **Okta** linha, atualize os campos e clique em **Atualizar**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-52e5516ca5c67143addd0c976ee7719f9fe1cbb9%2Fokta-sso-05-airops-sso-settings.png?alt=media" alt="Open Single Sign On settings in AirOps"><figcaption><p>Abra as definições de Início de sessão único no AirOps.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9507d6efe79b99cd8e76266c8135c2e0db744897%2Fokta-sso-06-airops-fields.png?alt=media" alt="Enter Okta SSO configuration fields in AirOps"><figcaption><p>Introduza os valores de configuração de SSO do Okta no AirOps.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4143ef01e037ed23bd8f468cf8e91c14d41c8ac0%2Fokta-sso-07-airops-save.png?alt=media" alt="Save the Okta SSO configuration in AirOps"><figcaption><p>Guarde a configuração de SSO do Okta.</p></figcaption></figure>

## Parâmetros

| Campo                                | Valor                                                                                                                                                                                                           |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID do cliente**                    | No Okta, navegue até **Aplicações → A sua aplicação** e copie o **ID do cliente**.                                                                                                                              |
| **Segredo do cliente**               | No Okta, navegue até **Aplicações → A sua aplicação** e copie o **Segredo do cliente**.                                                                                                                         |
| **Site**                             | O seu domínio Okta sem um caminho de servidor de autorização, como `https://dev-123456.okta.com`.                                                                                                               |
| **URL de autorização**               | O endpoint de autorização para o servidor de autorização do Okta que escolheu, como `https://your-okta-domain.okta.com/oauth2/v1/authorize` ou `https://your-okta-domain.okta.com/oauth2/default/v1/authorize`. |
| **URL do token**                     | O endpoint do token para o servidor de autorização do Okta que escolheu, como `https://your-okta-domain.okta.com/oauth2/v1/token` ou `https://your-okta-domain.okta.com/oauth2/default/v1/token`.               |
| **URL de informações do utilizador** | O endpoint userinfo para o servidor de autorização do Okta que escolheu, como `https://your-okta-domain.okta.com/oauth2/v1/userinfo` ou `https://your-okta-domain.okta.com/oauth2/default/v1/userinfo`.         |

## Função predefinida para membros provisionados

A criação e reativação SCIM do Okta usam a função predefinida do Okta configurada no workspace. A restauração de uma adesão removida através do SSO do Okta também usa a predefinição atual do fornecedor. Se não estiver configurada nenhuma predefinição, o AirOps recorre a **Administrador**.

Os membros ativos existentes mantêm as funções atribuídas. Alterar a predefinição não atualiza adesões anteriores, por isso reveja-as separadamente se devessem usar uma função diferente.

## Entrar com o Okta

Depois de guardar a configuração do Okta, termine a sessão no AirOps e vá para `https://app.airops.com/users/sign_in`.

Selecione **Entrar com o Okta**, introduza o seu **slug do workspace do AirOps**, e clique em **Prosseguir**. Este é o slug do seu workspace do AirOps, não o seu domínio Okta nem o slug do Okta. Pode encontrá-lo nas definições do seu workspace do AirOps.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-af68b8b8d29d28ef625a097a0233b48711c4556b%2Fokta-sso-08-workspace-slug.png?alt=media" alt="Find the workspace slug in AirOps settings"><figcaption><p>Encontre o slug do seu workspace nas definições do AirOps.</p></figcaption></figure>

{% hint style="info" %}
Para evitar introduzir manualmente o slug do workspace, use `https://app.airops.com/users/sign_in?okta-workspace-slug=YOUR_WORKSPACE_SLUG`.
{% endhint %}

## Guia em vídeo

{% embed url="<https://www.loom.com/share/40208396fcba439fae71392b26090a0c?sid=4fe81aec-2a8c-401e-90c0-764cd2ed4644>" %}


---

# 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.airops.com/docs/pt/o-seu-espaco-de-trabalho/team/okta-sso.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.