Saltar al contenido principal
GET /userinfo Dado el Token de acceso de Auth0 obtenido durante el inicio de sesión, este endpoint devuelve el perfil de un usuario. Este endpoint solo funcionará si se concedió openid como scope para el Token de acceso. La información del perfil del usuario incluida en la respuesta depende de los alcances solicitados. Por ejemplo, un scope de solo openid puede devolver menos información que un scope de openid profile email.

​
Notas

  • El script de ejemplo de auth0.js usa la versión 8 de la biblioteca. Si usa la versión 7 de auth0.js, consulte esta guía de referencia.
  • El método parseHash de auth0.js requiere que sus tokens estén firmados con RS256 en lugar de HS256.
  • Para devolver user_metadata u otra información personalizada desde este endpoint, agregue un claim personalizado al token de ID con una Action. Para obtener más información, consulte Claims del perfil del usuario y scope.
  • Este endpoint devolverá tres encabezados de respuesta HTTP con datos relevantes sobre sus límites de tasa:
    • X-RateLimit-Limit: Número de solicitudes permitidas por minuto.
    • X-RateLimit-Remaining: Número de solicitudes disponibles. Cada nueva solicitud reduce este número en 1. Por cada minuto transcurrido, se vuelve a agregar una solicitud, por lo que este número aumenta en 1 cada vez.
    • X-RateLimit-Reset: Tiempo restante hasta que se restablezca el límite de tasa (X-RateLimit-Limit). El valor se expresa en segundos de época UTC.
  • El claim Email devuelve una instantánea del correo electrónico en el momento de iniciar sesión.
  • Los claims estándar (distintos de email) devuelven el valor más reciente (a menos que el valor provenga de un IdP externo).
  • Los claims personalizados siempre devuelven el valor más reciente del claim.
  • Para acceder a los valores más actualizados de email o de los claims personalizados, debe obtener nuevos tokens. Puede iniciar sesión mediante autenticación silenciosa (donde el parámetro prompt de su llamada al endpoint authorize es igual a none).
  • Para acceder a los valores más actualizados de los claims estándar que se cambiaron mediante un IdP externo (por ejemplo, si el usuario cambió su dirección de correo electrónico en Facebook), debe obtener nuevos tokens. Vuelva a iniciar sesión con el IdP externo, pero no mediante autenticación silenciosa.

​
Más información

​
Parámetros

​
access_token
string
requerido
​
DPoP
string
Una prueba DPoP para la solicitud. Es opcional y solo se requiere si la aplicación utiliza Demonstrating Proof-of-Possession.

​
Respuesta

EstadoDescripción
200Perfil de usuario obtenido correctamente.
401No autorizado: token de acceso no válido o ausente.