> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/astro/admin/configuracoes.md).

# Configurações

Em **Configurações**, você personaliza o **Astro** para a sua empresa: contexto, ferramentas liberadas, segurança de acesso e login corporativo.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F2cPwMwnGAm666bgcIvAE%2FCaptura%20de%20Tela%202026-10-09%20a%CC%80s%2019.23.22.png?alt=media&amp;token=6e749d1d-7b14-4baf-8322-b6df4592ac83" alt=""><figcaption></figcaption></figure>

Acompanhe, a seguir, os recursos disponíveis:

### Contexto da empresa <a href="#contexto-da-empresa" id="contexto-da-empresa"></a>

O contexto da empresa é aplicado a todas as conversas do workspace, para que o **Astro** responda considerando a realidade do seu negócio.

Para definir o contexto, siga os seguintes passos:

1. Na seção **Contexto da empresa**, descreva a empresa, os produtos, os clientes e os concorrentes.
2. Clique em **Salvar**.

{% hint style="warning" %}
**Importante:** não inclua senhas, dados pessoais ou informações confidenciais no contexto, pois ele é enviado em todas as conversas.
{% endhint %}

### Ferramentas de uso <a href="#ferramentas-de-uso" id="ferramentas-de-uso"></a>

Nesta seção, você define quais ferramentas cada perfil de usuário pode utilizar.

Para configurar as ferramentas, siga os seguintes passos:

1. Na seção **Ferramentas de uso**, clique no seletor **Perfil** e escolha o perfil desejado (ex.: **USER**).
2. Ative ou desative as ferramentas: **Pesquisa na web**, **Análise de arquivos**, **Interpretador de código**, **Memórias**, **Experts** e **Marketplace de Experts**.
3. Clique em **Salvar**.

{% hint style="info" %}
Para liberar ou bloquear recursos para uma equipe específica, leia [Configurar permissões de uso, em Equipes.](https://docs.skyone.cloud/astro/admin/equipes.md)
{% endhint %}

### Segurança <a href="#seguranca" id="seguranca"></a>

As opções de segurança são aplicadas a todos os usuários do workspace:

* **Exigir autenticação em duas etapas (2FA):** quem ainda não tiver 2FA precisará cadastrá-la no próximo login. As sessões já abertas não são afetadas.
* **Login por código por e-mail:** permite que os usuários entrem com um código enviado por e-mail.

{% hint style="info" %}
A opção **Login por código por e-mail** exige um serviço de e-mail configurado no servidor. Sem ele, a opção não aparece.
{% endhint %}

### Login corporativo (SSO) <a href="#login-corporativo-sso" id="login-corporativo-sso"></a>

Com o login corporativo, as pessoas entram no **Astro** pelo provedor de identidade (IdP) da sua empresa.

{% hint style="danger" %}
**Importante:** somente contas que já existem no **Astro** conseguem entrar pelo SSO. Adicione os usuários antes de ativar o login corporativo.
{% endhint %}

#### Configurar o SSO com OpenID Connect <a href="#configurar-o-sso-com-openid-connect" id="configurar-o-sso-com-openid-connect"></a>

Para configurar o login corporativo, siga os seguintes passos:

1. Em **Protocolo**, selecione **OpenID Connect**.
2. No campo **URL do issuer**, informe o endereço do seu provedor de identidade. A descoberta das configurações acontece em `<issuer>/.well-known/openid-configuration`.
3. Preencha o **Client ID** gerado no provedor de identidade.
4. Em **Client secret**, clique em **Trocar** e informe o segredo do cliente.
5. Mantenha **Usar PKCE** ativado se o cliente for público, sem segredo.
6. Revise os campos **Escopo**, **Claim do e-mail** e **Claim do nome**. Os valores padrão são `openid profile email`, `email` e `name`.
7. Se desejar, altere o **Rótulo do botão** (padrão: **Entrar com login corporativo**) e informe a **URL do logo do botão**.
8. Em **Domínios de e-mail permitidos**, informe os domínios aceitos, separados por vírgula.
9. Clique em **Salvar**.

{% hint style="info" %}
O **Client secret** é guardado de forma cifrada e nunca mais é exibido. Para manter o segredo atual, não altere o campo.
{% endhint %}

{% hint style="info" %}
Se o campo **Domínios de e-mail permitidos** ficar vazio, qualquer domínio é aceito.
{% endhint %}

#### Cadastrar o Astro no provedor de identidade <a href="#cadastrar-o-astra-no-provedor-de-identidade" id="cadastrar-o-astra-no-provedor-de-identidade"></a>

Na seção **URLs para cadastrar no provedor de identidade**, copie os valores exibidos e cadastre-os na aplicação do seu IdP antes de testar a conexão:

* **Redirect URI do OpenID Connect:** para o protocolo OpenID Connect.
* **Assertion consumer service (ACS) do SAML** e **Entity ID do SAML:** para o protocolo SAML 2.0.

Clique no ícone de copiar ao lado de cada valor.

#### Testar e ativar o SSO <a href="#testar-e-ativar-o-sso" id="testar-e-ativar-o-sso"></a>

Para ativar o login corporativo, siga os seguintes passos:

1. Clique em **Testar conexão** e aguarde o resultado.
2. Ative a opção **Ativar SSO**. O botão de login corporativo passa a aparecer na tela de entrada.
3. Se desejar, ative **Exigir SSO para usuários** para que todos entrem apenas pelo login corporativo.

{% hint style="info" %}
A opção **Exigir SSO para usuários** só fica disponível depois de ativar o SSO e de um teste de conexão bem-sucedido.
{% endhint %}


---

# 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.skyone.cloud/astro/admin/configuracoes.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.
