> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Guía de SSO con Okta

> Conecta el Dashboard con Okta para SSO mediante la configuración de una aplicación SAML 2.0

Esta guía explica cómo conectar Yuno con Okta mediante SAML 2.0.

## Requisitos previos

* Una cuenta de Okta
* Privilegios de administrador en Okta para administrar la configuración de SSO y crear aplicaciones (crearás la aplicación SAML para Yuno en el paso 1 que aparece más abajo; no es necesario que exista una aplicación de antemano)
* Acceso al [Dashboard de Yuno](https://dashboard.y.uno/)

**1. Crea una aplicación SAML en Okta**

En Okta, ve a:

**Applications → Create App Integration → SAML 2.0 → Next**

Elige un nombre para tu aplicación y, si quieres, sube un logo. Luego verás el formulario de configuración de SAML.

![Formulario SAML Settings de Okta que muestra los campos Single sign-on URL y Audience URI (SP Entity ID) que se deben completar con valores de Yuno](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/okta-sso-guide/image1.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=5ac88793b28d72116794f9b8f33954be)

**2. Configura los ajustes de SAML con los valores de Yuno**

Abre el Dashboard de Yuno, haz clic en tu imagen de perfil y luego abre **Security**.  Ve a la pestaña **Single Sign-On (SSO)**, haz clic en **Set up** y reúne esta información:

* Identifier (Entity ID)
* Assertion Consumer Service URL

Copia estos valores en el formulario SAML de Okta:

* **Audience URI (SP Entity ID)** → Identifier (Entity ID)
* **Single sign-on URL** → Assertion Consumer Service URL

Haz clic en **Next**, luego marca la opción **This is an internal app…** y termina la configuración.

![Paso 3 del asistente de creación de aplicaciones de Okta con la casilla 'This is an internal app that we have created' seleccionada antes de hacer clic en Finish](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/okta-sso-guide/image2.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=f3240b8b8b103e9ad58fba3d8aa433db)

**3. Exporta y sube el XML de metadatos**

En Okta, busca la **Metadata URL** en la configuración de la aplicación y ábrela. Guarda el archivo como `metadata.xml`.

Luego, en el Dashboard de Yuno:

1. Sube el archivo `metadata.xml` en **Yuno configuration → Option A: Upload metadata XML**
2. Espera la confirmación **Upload completed**
3. Haz clic en **Save**

![Pantalla de configuración de SSO del Dashboard de Yuno que muestra la Option A con el archivo XML de metadatos subido correctamente](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/okta-sso-guide/image3.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=6091f686fdeb0a772bc4fa16ae11003c)

También puedes tomar la información que aparece en la **Option B** e ingresarla manualmente.

**4. Asigna usuarios en Okta (opcional)**

Una vez completada la configuración, puedes asignar usuarios o grupos de Okta a la aplicación para que puedan iniciar sesión con SSO.

## Solución de problemas

Si no puedes configurar la conexión de SSO o tienes problemas después de la configuración inicial:

* Yuno requiere **respuestas SAML firmadas**, verifica que:
  * Tanto la respuesta SAML como la aserción estén firmadas
  * El algoritmo de firma configurado en Okta sea **SHA-256**
  * El certificado usado para la firma coincida con el incluido en los metadatos
* Revisa los logs de SSO en el Dashboard de Yuno, en **Security → Single sign-on (SSO)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.