> 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/espanol/admin/configuracion.md).

# Configuración

En **Configuración**, personalizas **Astro** para tu empresa: contexto, herramientas habilitadas, seguridad de acceso e inicio de sesión corporativo.

A continuación, conoce los recursos disponibles:

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

El contexto de la empresa se aplica a todas las conversaciones del workspace, para que **Astro** responda teniendo en cuenta la realidad de tu negocio.

Para definir el contexto, sigue estos pasos:

1. En la sección **Contexto de la empresa**, describe la empresa, los productos, los clientes y los competidores.
2. Haz clic en **Guardar**.

{% hint style="warning" %}
**Importante:** no incluyas contraseñas, datos personales ni información confidencial en el contexto, ya que se envía en todas las conversaciones.
{% endhint %}

### Herramientas de uso <a href="#herramientas-de-uso" id="herramientas-de-uso"></a>

En esta sección, defines qué herramientas puede usar cada perfil de usuario.

Para configurar las herramientas, sigue estos pasos:

1. En la sección **Herramientas de uso**, haz clic en el selector **Perfil** y elige el perfil deseado (p. ej.: **USER**).
2. Activa o desactiva las herramientas: **Búsqueda en la web**, **Análisis de archivos**, **Intérprete de código**, **Memorias**, **Experts** y **Marketplace de Experts**.
3. Haz clic en **Guardar**.

{% hint style="info" %}
Para habilitar o bloquear recursos para un equipo específico, lee [Configurar permisos de uso, en Equipos.](https://docs.skyone.cloud/espanol/admin/equipos.md)
{% endhint %}

### Seguridad <a href="#seguridad" id="seguridad"></a>

Las opciones de seguridad se aplican a todos los usuarios del workspace:

* **Exigir autenticación en dos pasos (2FA):** quien todavía no tenga 2FA deberá configurarla en el próximo inicio de sesión. Las sesiones ya abiertas no se ven afectadas.
* **Inicio de sesión con código por correo:** permite que los usuarios ingresen con un código enviado por correo.

{% hint style="info" %}
La opción **Inicio de sesión con código por correo** requiere un servicio de correo configurado en el servidor. Sin él, la opción no aparece.
{% endhint %}

### Inicio de sesión corporativo (SSO) <a href="#inicio-de-sesion-corporativo-sso" id="inicio-de-sesion-corporativo-sso"></a>

Con el inicio de sesión corporativo, las personas ingresan a **Astro** mediante el proveedor de identidad (IdP) de tu empresa.

{% hint style="danger" %}
**Importante:** solo las cuentas que ya existen en **Astro** pueden ingresar mediante SSO. Agrega a los usuarios antes de activar el inicio de sesión corporativo.
{% endhint %}

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

Para configurar el inicio de sesión corporativo, sigue estos pasos:

1. En **Protocolo**, selecciona **OpenID Connect**.
2. En el campo **URL del issuer**, ingresa la dirección de tu proveedor de identidad. La detección de la configuración se realiza en `<issuer>/.well-known/openid-configuration`.
3. Completa el **Client ID** generado en el proveedor de identidad.
4. En **Client secret**, haz clic en **Cambiar** e ingresa el secreto del cliente.
5. Mantén **Usar PKCE** activado si el cliente es público, sin secreto.
6. Revisa los campos **Alcance**, **Claim del correo** y **Claim del nombre**. Los valores predeterminados son `openid profile email`, `email` y `name`.
7. Si lo deseas, cambia la **Etiqueta del botón** (predeterminada: **Ingresar con inicio de sesión corporativo**) e ingresa la **URL del logo del botón**.
8. En **Dominios de correo permitidos**, ingresa los dominios aceptados, separados por comas.
9. Haz clic en **Guardar**.

{% hint style="info" %}
El **Client secret** se guarda cifrado y no se vuelve a mostrar. Para mantener el secreto actual, no modifiques el campo.
{% endhint %}

{% hint style="info" %}
Si el campo **Dominios de correo permitidos** queda vacío, se acepta cualquier dominio.
{% endhint %}

#### Registrar **Astro** en el proveedor de identidad <a href="#registrar-astra-en-el-proveedor-de-identidad" id="registrar-astra-en-el-proveedor-de-identidad"></a>

En la sección **URL para registrar en el proveedor de identidad**, copia los valores mostrados y regístralos en la aplicación de tu IdP antes de probar la conexión:

* **Redirect URI de OpenID Connect:** para el protocolo OpenID Connect.
* **Assertion consumer service (ACS) de SAML** y **Entity ID de SAML:** para el protocolo SAML 2.0.

Haz clic en el ícono de copiar junto a cada valor.

#### Probar y activar el SSO <a href="#probar-y-activar-el-sso" id="probar-y-activar-el-sso"></a>

Para activar el inicio de sesión corporativo, sigue estos pasos:

1. Haz clic en **Probar conexión** y espera el resultado.
2. Activa la opción **Activar SSO**. El botón de inicio de sesión corporativo pasa a aparecer en la pantalla de ingreso.
3. Si lo deseas, activa **Exigir SSO a los usuarios** para que todos ingresen solo mediante el inicio de sesión corporativo.

{% hint style="info" %}
La opción **Exigir SSO a los usuarios** solo está disponible después de activar el SSO y de una prueba de conexión exitosa.
{% 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/espanol/admin/configuracion.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.
