> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Aprenda a configurar Rich Authorization Requests (RAR) para un servidor de recursos.
# Configurar Rich Authorization Requests (RAR)
Con [Rich Authorization Requests (RAR)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-rar), los clientes pueden solicitar y obtener datos de autorización granular de propietarios de recursos, como los usuarios finales, durante el [Flujo de código de autorización con Pushed Authorization Requests (PAR)](/es/docs/get-started/authentication-and-authorization-flow/authorization-code-flow/authorization-code-flow-with-par) y el [Flujo de autenticación de canal secundario iniciado por el cliente](/es/docs/get-started/authentication-and-authorization-flow/client-initiated-backchannel-authentication-flow).
Rich Authorization Requests usa el parámetro `authorization_details`. Este parámetro acepta un arreglo JSON de objetos que puede incluir información detallada sobre la autorización solicitada, como los recursos o las acciones específicas a las que el cliente quiere acceder en nombre del usuario.
Puede renderizar los `authorization_details` solicitados para el usuario de una de estas formas:
* En el navegador, mediante una [pantalla de consentimiento personalizada](#set-customized-consent-prompt)
* En una aplicación móvil al usar notificaciones push con el [SDK de Auth0 Guardian o la aplicación Auth0 Guardian](/es/docs/secure/multi-factor-authentication/auth0-guardian)
Para configurar Rich Authorization Requests para un servidor de recursos, debe:
1. [Registrar tipos de `authorization_details`](#register-authorization_details-types) para el servidor de recursos.
2. [Configurar las políticas de acceso a la API](#configure-the-api-access-policies) para permitir que su aplicación solicite esos tipos.
3. [Establecer la pantalla de consentimiento personalizada](#set-customized-consent-prompt) para renderizar `authorization_details`.
4. [Opcional: Configurar la política de consentimiento para el servidor de recursos](#optional-configure-consent-policy-for-the-resource-server).
## Registrar tipos de `authorization_details`
Cada objeto del arreglo JSON debe tener un campo `type`, que describe la estructura del objeto. Un arreglo `authorization_details` puede contener varias entradas del mismo `type`.
### Aplicación Auth0 Guardian
Si usa la aplicación Auth0 Guardian, el valor del parámetro `authorization_details` debe tener un solo objeto en el array, y ese objeto debe ajustarse al siguiente esquema de Auth0:
| Campo | Descripción | Ejemplo |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `type` | Especifica el tipo de solicitud de autorización:
- `urn:auth0:schemas:authorization-details`: El URN de Auth0 indica que la solicitud usará el esquema de Auth0.
- `v1`: La versión del esquema.
- `user-profile`: Valor proporcionado por el cliente que indica que la solicitud es para información del perfil de usuario.
| `urn:auth0:schemas:authorization-details:v1:user-profile` |
| `instruction` | Un mensaje legible para el usuario para que apruebe la solicitud. | `Apruebe la solicitud.` |
| `properties` | Un objeto JSON que contiene los atributos o claim específicos del usuario que se solicitan. Cada clave (por ejemplo, `email`, `full_name`) representa un campo concreto del perfil de usuario:
- `display`: Un valor booleano que determina si la propiedad debe mostrarse al usuario en el cuadro de diálogo de consentimiento. Si es `true`, se mostrará; si es `false`, es una propiedad solo interna que no está pensada para que el usuario la vea.
- `name`: El nombre legible para humanos de la propiedad (por ejemplo, "Dirección de correo electrónico").
- `display_order`: Un entero que determina el orden en que las propiedades se mostrarán en el cuadro de diálogo de consentimiento.
- `description`: Una explicación breve y opcional del propósito de la propiedad.
- `value`: El valor real de la propiedad (por ejemplo, "[user@example.com](mailto:user@example.com)", "John Doe"). El tipo de datos puede variar (cadena, entero, booleano, etc.).
| `"properties": { "stringPropertyForDisplay": { "display": true, "name": "A String:", "display_order": "1", "value": "Value 1"} }` |
A continuación, se muestra un ejemplo del tipo `authorization_details` con el esquema de Auth0:
```json lines theme={null}
{
"type": "urn:auth0:schemas:authorization-details:v1:user-profile",
"instruction": "An instruction to the user",
"properties": {
"stringPropertyForDisplay": {
"display": true,
"name": "A String:",
"display_order": 1,
"value": "Value 1"
},
"numericPropertyForDisplay": {
"display": true,
"name": "A Number:",
"display_order": 2,
"description": "An optional description",
"value": 100.00
},
"booleanPropertyForDisplay": {
"display": true,
"name": "A Boolean:",
"display_order": 3,
"value": true
},
"hiddenProperty": {
"display": false,
"value": "This value should not be displayed"
}
}
}
```
### Otros canales de notificación
El tipo `authorization_details` no necesita usar el esquema de Auth0 si no estás usando la aplicación Auth0 Guardian. Si muestras `authorization_details` mediante una pantalla de consentimiento personalizada o tu propia aplicación móvil personalizada con el SDK de Auth0 Guardian, se aplican los siguientes requisitos:
* Máximo de 5 KB
* Debe ser un JSON válido
* Debe ser un array de objetos
* Máximo de 5 entradas en el array
* Cada objeto debe tener una propiedad `type` (prerregistrada en la API)
* Máximo de 10 propiedades por objeto
* La longitud máxima de los nombres de las propiedades es de 255 caracteres
* La longitud máxima del valor de una propiedad es de 255 caracteres
* Máximo de 5 niveles de objetos anidados
* Los nombres de las propiedades solo pueden contener los siguientes caracteres: `a-zA-Z0-9_.-`
A continuación se muestra un ejemplo de `authorization_details` de tipo `money_transfer` que no usa el esquema de Auth0. Contiene los siguientes campos de objeto:
* `instructedAmount`: El importe en USD que se transferirá.
* `sourceAccount`: La cuenta bancaria de origen desde la que se transferirá el dinero.
* `destinationAccount`: La cuenta bancaria de destino a la que se transferirá el dinero.
* `beneficiary`: El destinatario de la transferencia de dinero.
* `subject`: El asunto de la transferencia de dinero.
```json lines theme={null}
{
"type": "money_transfer",
"instructedAmount": {"amount": 2500, "currency": "USD"},
"sourceAccount": "xxxxxxxxxxx1234",
"destinationAccount": "xxxxxxxxxxx9876",
"beneficiary": "Hanna Herwitz",
"subject": "A Lannister Always Pays His Debts"
}
```
Debe registrar tipos de `authorization_details` para un servidor de recursos, lo cual es similar a registrar alcances permitidos. Puede registrar tipos de `authorization_details` con el [Auth0 Dashboard](https://manage.auth0.com/) o la [Management API](https://auth0.com/docs/api/management/v2).
Para agregar `authorization_details` en el Auth0 Dashboard:
1. Vaya a [Auth0 Dashboard > Applications > APIs](https://manage.auth0.com/#/apis).
2. Seleccione la pestaña **Permissions**.
3. En **Add an Authorization Details type**, puede agregar varios tipos de `authorization_details` para su servidor de recursos. Introduzca un tipo de `authorization_details`.
4. Seleccione la opción **+Add**.
Puede ver los tipos de `authorization_details` de su servidor de recursos en **List of Authorization Details Types**:
Para registrar tipos de `authorization_details` en un servidor de recursos existente, realice una solicitud `PATCH` al endpoint [Update a resource server](https://auth0.com/docs/api/management/v2/resource-servers/patch-resource-servers-by-id).
El siguiente ejemplo de código agrega los tipos `payment_initiation` y `money_transfer` a `authorization_details` para un servidor de recursos:
```bash lines theme={null}
curl --location --request PATCH 'https://$tenant/api/v2/resource-servers/$resource-server-id' \
--header 'Authorization: Bearer $management_access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
"authorization_details": [{"type": "payment_initiation"}, {"type": "money_transfer"}]
}'
```
Para crear un nuevo servidor de recursos con un tipo de `authorization_details` registrado, realice una solicitud `POST` al endpoint `/resource-servers`.
La siguiente solicitud `POST` crea un nuevo servidor de recursos con el tipo `payment_initiation` en `authorization_details`:
```bash lines theme={null}
curl --location --request POST 'https://$tenant/api/v2/resource-servers' \
--header 'Authorization: Bearer $management_access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Payments API",
"identifier": "https://payments.api/",
"authorization_details": [{"type": "payment_initiation"}]
}'
```
## Configure las políticas de acceso a la API
[Políticas de acceso a la API para aplicaciones](/es/docs/get-started/apis/api-access-policies-for-applications) controlan qué aplicaciones pueden acceder a sus APIs y qué alcances o tipos de `authorization_details` tienen permitidos.
Puede consultar la política actual de su API mediante la Management API. Haga una solicitud `GET` al endpoint [Obtener un servidor de recursos](https://auth0.com/docs/api/management/v2/resource-servers/get-resource-servers-by-id) y revise la propiedad `subject_type_authorization` en la respuesta:
```bash lines theme={null}
curl --location --request GET 'https://$tenant/api/v2/resource-servers/$resource-server-id' \
--header 'Authorization: Bearer $management_access_token' \
--header 'Content-Type: application/json'
```
La propiedad `subject_type_authorization` admite valores para `client.policy` y `user.policy`:
* Si el valor de la política es `allow_all`, las aplicaciones o los usuarios pueden solicitar todos los tipos de `authorization_details` registrados para la API.
* Si el valor de la política es `require_client_grant`, cada tipo de `authorization_details` debe estar permitido explícitamente por el client grant de esa aplicación.
* Si el valor de la política es `deny_all`, ninguna aplicación ni ningún usuario pueden solicitar ninguno de los tipos de `authorization_details` registrados para la API.
Para obtener más información sobre cómo administrar los client grants de las aplicaciones, consulte [Acceso de aplicaciones a las API: Client Grants](/es/docs/get-started/applications/application-access-to-apis-client-grants) .
## Configurar una pantalla de consentimiento personalizada
Puede renderizar los `authorization_details` de una solicitud de autorización enriquecida en la pantalla de consent. Para ello, configure la pantalla `customized-consent` con los partials de plantilla adecuados.
Puede configurar la pantalla de consentimiento personalizada con Auth0 CLI o Management API.
### Auth0 CLI
Para configurar los partials personalizados de consent, ejecute el comando `auth0 ul customize` con los indicadores adecuados en su terminal:
```bash lines theme={null}
auth0 ul customize
```
Para obtener más información, consulte la [documentación para personalizar Universal Login de Auth0](https://auth0.github.io/auth0-cli/auth0_universal-login_customize.html).
### Management API
Para configurar los partials personalizados de consent, realiza una solicitud `PUT` al endpoint `/prompts/customized-consent/partials`:
```bash lines theme={null}
curl --location --request PUT "https://$tenant/api/v2/prompts/customized-consent/partials" \
--header "Authorization: Bearer $management_access_token" \
--header "Content-Type: application/json" \
--data '{
"customized-consent": {
"form-content": "Operation Details
Transaction Type
{{ transaction.params.authorization_details[0].type }}
Amount
{{ transaction.params.authorization_details[0].instructedAmount.amount }} {{ transaction.params.authorization_details[0].instructedAmount.currency }}
Recipient
{{ transaction.params.authorization_details[0].beneficiary }}
Destination Account
{{ transaction.params.authorization_details[0].destinationAccount }}
"
}
}'
```
La plantilla de consent personalizada renderiza `authorization_details` en la siguiente pantalla de consent que Auth0 muestra al usuario final:
En el [flujo de notificaciones por correo electrónico con CIBA y RAR](/es/docs/get-started/authentication-and-authorization-flow/client-initiated-backchannel-authentication-flow/email-notifications-with-ciba), debe personalizar la pantalla de consent para mostrar al usuario las pantallas de aprobación o rechazo:
Para obtener más información sobre cómo personalizar la pantalla de consent, consulte:
* [Personalizar las páginas de Universal Login](/es/docs/customize/login-pages/universal-login/customize-templates)
* [Personalizar Universal Login con el editor sin código](/es/docs/customize/login-pages/universal-login/customize-themes)
* [Configurar partials para una pantalla en la documentación de la API](/es/docs/api/management/v2/prompts/put-partials)
## Opcional: Configurar la política de consentimiento para el servidor de recursos
La política de consentimiento del servidor de recursos determina si Auth0 almacena los valores de `authorization_details` y los pone a disposición de las aplicaciones móviles cuando se envía una notificación push.
Consulte el comportamiento de la política de consentimiento estándar de Auth0 para una solicitud que contiene `authorization_details`:
| Flujo | Notificación push enviada | Comportamiento |
| ------------------------------------------------------------------ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cualquiera | No | Se muestra la pantalla de consentimiento personalizada. |
| Flujo de código de autorización con PAR | Sí | No se muestra ninguna pantalla de consentimiento. El consentimiento debe mostrarse en la aplicación móvil que recibe el desafío de notificación push.
Si se usa la aplicación Auth0 Guardian, mostrará automáticamente `authorization_details` al usuario.
Si se usa una aplicación móvil personalizada, `authorization_details` se puede recuperar mediante el SDK de Auth0 Guardian. |
| Flujo de autenticación de canal secundario iniciado por el cliente | Sí | Si se usa la aplicación Auth0 Guardian para autorizar la solicitud CIBA, `authorization_details` se recuperará automáticamente y se mostrará.
Si se usa una aplicación móvil personalizada para autorizar la solicitud CIBA, `authorization_details` se puede recuperar mediante el SDK de Auth0 Guardian.
Si la solicitud CIBA se autoriza mediante un enlace web (por ejemplo, desde un correo electrónico), se mostrará la pantalla de consentimiento personalizada.
Los clientes pueden optar por activar una notificación push como segundo factor para la solicitud CIBA cuando el usuario la aprueba mediante un enlace web; en ese caso, el comportamiento es el mismo que el anterior. La aplicación Auth0 Guardian vuelve a mostrar automáticamente `authorization_details` al usuario, mientras que las aplicaciones móviles personalizadas pueden optar por recuperar `authorization_details` mediante el SDK de Auth0 Guardian. |
Los clientes también pueden establecer `consent_policy` en `transactional-authorization-with-mfa`, que tiene el siguiente comportamiento:
| Flujo | Notificación push enviada | Comportamiento |
| ------------------------------------------------------------------ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Flujo de código de autorización con PAR | No | Se muestra la pantalla de consentimiento personalizada. |
| Flujo de código de autorización con PAR | Sí | No se muestra ninguna pantalla de consentimiento. La solución del cliente debe mostrar el consentimiento en su propia interfaz de usuario. Auth0 asignará un ID único a la solicitud y lo expondrá en la Post-Login Action como `event.transaction.linking_id`, junto con `event.transaction.requested_authorization_details`.
Si se usa la aplicación Auth0 Guardian, NO se mostrarán `authorization_details`.
Si se usa una aplicación móvil personalizada, la notificación push incluirá `linking_id`, lo que permitirá a los desarrolladores recuperar `authorization_details` desde sus propias API si es necesario. |
| Flujo de autenticación de canal secundario iniciado por el cliente | Cualquiera | El flujo CIBA no es compatible con la política de consentimiento `transactional-authorization-with-mfa` |
Puede configurar la política de consentimiento para un servidor de recursos con el [Auth0 Dashboard](https://manage.auth0.com/) o la [Management API](https://auth0.com/docs/api/management/v2).
Configure la política de consentimiento en la configuración de su API mediante el Auth0 Dashboard.
1. Vaya a [Auth0 Dashboard > Applications > APIs](https://manage.auth0.com/#/apis).
2. Seleccione la pestaña **Settings**.
3. En **Access Settings**, elija la política de consentimiento **Standard**.
4. Guarde los cambios.
Para establecer la política de consentimiento de un servidor de recursos o una API mediante la Management API, envíe una solicitud `PATCH` al endpoint [Update a resource server](https://auth0.com/docs/api/management/v2/resource-servers/patch-resource-servers-by-id). En la solicitud `PATCH`, establezca `consent_policy` en `standard`:
```bash wrap lines theme={null}
curl --location --request PATCH 'https://$tenant/api/v2/resource-servers/$resource-server-id' \
--header 'Authorization: Bearer $management_access_token' \
--header 'Content-Type: application/json' \
--data-raw '{ "consent_policy": "standard" }'
```