> ## 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.

> Conozca los alcances y claims utilizados con el protocolo OpenID Connect (OIDC).

# Alcances de OpenID Connect

Este documento analiza los alcances incluidos en el protocolo de autenticación <Tooltip tip="OpenID: Estándar abierto de autenticación que permite a las aplicaciones verificar la identidad de los usuarios sin recopilar ni almacenar información de inicio de sesión." cta="Ver glosario" href="/es/docs/glossary?term=OpenID">OpenID</Tooltip> Connect (OIDC). Para obtener más información sobre OIDC, consulte [el protocolo OpenID Connect](/es/docs/authenticate/protocols/openid-connect-protocol).

Una aplicación utiliza los alcances de OpenID Connect (OIDC) durante la autenticación para autorizar el acceso a los datos de un usuario, como su nombre y su imagen. Cada scope devuelve un conjunto de atributos del usuario, que se denominan claims. Los alcances que una aplicación debe solicitar dependen de los atributos del usuario que necesite. Una vez que el usuario autoriza los alcances solicitados, los claims se devuelven en un <Tooltip tip="ID Token: Credencial destinada al propio cliente, en lugar de al acceso a un recurso." cta="Ver glosario" href="/es/docs/glossary?term=ID+Token">ID Token</Tooltip> y también están disponibles a través del [endpoint `/userinfo`](/es/docs/api/authentication/user-profile/get-user-info).

Por ejemplo, supongamos que ha creado una aplicación web tradicional, la ha registrado en Auth0 y la ha configurado para permitir que un usuario inicie sesión con un username y una contraseña. Una vez que el usuario inicie sesión en su aplicación, quiere generar y enviar automáticamente un correo electrónico de bienvenida personalizado que incluya su nombre.

1. Un usuario hace clic en **Iniciar sesión** en su aplicación.
2. Su aplicación redirige al usuario al Servidor de autorización de Auth0 (endpoint `/authorize`) e incluye los siguientes alcances:

   * `openid` (obligatorio; para indicar que la aplicación pretende usar OIDC para verificar la identidad del usuario)
   * `profile` (para que pueda personalizar el correo electrónico con el nombre del usuario)
   * `email` (para saber adónde enviar el correo electrónico de bienvenida)
3. El Servidor de autorización de Auth0 redirige al usuario a la pantalla de inicio de sesión.
4. El usuario se autentica y ve una página de consentimiento en la que se enumeran los alcances que Auth0 otorgará a su aplicación, incluido el acceso a la información de su perfil y a su dirección de correo electrónico.
5. El usuario acepta y autoriza a su aplicación a tener este nivel de acceso a la información que Auth0 almacena sobre él.
6. Su aplicación ahora tiene acceso a la información del perfil del usuario y a su dirección de correo electrónico.

<div id="standard-claims">
  ## Claims estándar
</div>

Los claims estándar están pensados para proporcionar a una aplicación información del usuario, como nombre, correo electrónico e imagen, y están predefinidos para el protocolo OIDC. Estos claims se devuelven en un ID Token y también están disponibles a través del [`endpoint /userinfo`](/es/docs/api/authentication/user-profile/get-user-info).

También puede crear claims personalizados, es decir, claims que usted define, controla y agrega a un token mediante [Auth0 Actions](/es/docs/customize/actions/actions-overview). Para obtener más información, consulte [JSON Web Token Claims](/es/docs/secure/tokens/json-web-tokens/json-web-token-claims).

El scope básico (y obligatorio) para OIDC es `openid`, que indica que una aplicación tiene la intención de usar el protocolo OIDC para verificar la identidad de un usuario. Además, una aplicación puede solicitar alcances adicionales si enumera los nombres de los alcances solicitados en el parámetro `scope`, separados por espacios.

A continuación se enumeran los claims estándar incluidos en los alcances más utilizados, pero para obtener una lista completa de los claims estándar disponibles, consulte [OIDC specification: Standard Claims on openid.net](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims). Para obtener una lista completa de alcances, consulte [OIDC specification: Requesting Claims Using Scope Values on openid.net](https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims).

| Alcance   | Claims                                                                                                                                                                                                                                                                                                                        |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `openid`  | (obligatorio) Devuelve el claim `sub`, que identifica de forma única al usuario. En un ID Token, también estarán presentes los claims `iss`, `aud`, `exp`, `iat` y `at_hash`. Para obtener más información sobre los claims del ID Token, consulte [ID Token Structure](/es/docs/secure/tokens/id-tokens/id-token-structure). |
| `profile` | Devuelve claims que representan información básica del perfil, incluidos `name`, `family_name`, `given_name`, `middle_name`, `nickname`, `picture` y `updated_at`.                                                                                                                                                            |
| `email`   | Devuelve el claim `email`, que contiene la dirección de correo electrónico del usuario, y `email_verified`, que es un valor booleano que indica si la dirección de correo electrónico fue verificada por el usuario.                                                                                                          |

Para ver un ejemplo de cómo solicitar claims estándar para su aplicación, consulte [Sample Use Cases: alcances and Claims](/es/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims).

<div id="learn-more">
  ## Más información
</div>

* [Ejemplos de casos de uso: alcances y claims](/es/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims)
* [alcances](/es/docs/get-started/apis/scopes)
* [Crear claims personalizadas](/es/docs/secure/tokens/json-web-tokens/create-custom-claims)
