Autenticar
Administrar usuarios
Personalizar
Auth0 AI
PlataformaEsta API está diseñada para personas que se sienten cómodas trabajando con API RESTful. Si prefiere un enfoque más guiado, consulte nuestros Quickstarts o nuestras Bibliotecas.
URL base
https://{yourDomain}
Métodos de autenticación
- Token de acceso OAuth2
- ID de cliente y aserción de cliente (aplicaciones confidenciales)
- ID de cliente y Secreto del cliente (aplicaciones confidenciales)
- ID de cliente (aplicaciones públicas)
- Autenticación mTLS (aplicaciones confidenciales)
Token de acceso OAuth2
Authorization con el esquema de autenticación Bearer.
Un ejemplo es el endpoint Get User Info. En este caso, obtiene un Token de acceso al autenticar a un usuario y, a continuación, puede realizar una solicitud al endpoint Get User Info usando ese token en el encabezado Authorization para recuperar el perfil del usuario.
ID de cliente y aserción de cliente
client_assertion_type con el valor urn:ietf:params:oauth:client-assertion-type:jwt-bearer y un parámetro client_assertion con su aserción firmada. Consulte Private Key JWT para ver ejemplos.
ID de cliente y Secreto del cliente
Authorization, con el esquema de autenticación Basic. Para generar el valor de tu credencial, concatena tu ID de cliente y tu Secreto del cliente, separados por dos puntos (:), y codifícalo en Base64.
Un ejemplo es el endpoint para revocar el Token de actualización. Esta opción está disponible solo para aplicaciones confidenciales (como las aplicaciones que pueden almacenar credenciales de forma segura sin exponerlas a terceros no autorizados).
ID de cliente
Autenticación con mTLS
- La clave de API del dominio personalizado como encabezado
cname-api-key. - El certificado del cliente como encabezado
client-certificate. - El estado de verificación de la CA del certificado del cliente como encabezado
client-certificate-ca-verified. Para obtener más información, consulte Reenviar la solicitud.
Parámetros
GET https://{yourDomain}/some-endpoint?param=value¶m=value
En las solicitudes POST, los parámetros que no se incluyan en la URL deben codificarse como JSON con un Content-Type de application/json:
curl --request POST --url 'https://{yourDomain}/some-endpoint' --header 'content-type: application/json' --data '{"param": "value", "param": "value"}'
Una excepción es el flujo de inicio de sesión único (SSO) iniciado por el IdP con SAML, que usa tanto un parámetro de cadena de consulta como un valor
x-www-form-urlencoded.Ejemplos de código
- Solicitud HTTP
- Comando de cURL
- JavaScript: según el endpoint, cada fragmento puede usar la biblioteca Auth0.js, código de Node.js o JavaScript simple
application/json.
Pruebas
Depurador de la API de autenticación
Configurar conexiones
- En la pestaña Configuration, configura los campos Application (selecciona la aplicación que quieras usar para la prueba) y Connection (el nombre de la conexión social que se va a usar).
- Copia la Callback URL y añádela a Allowed Callback URLs en Application Settings.
- En la pestaña OAuth2 / OIDC, selecciona OAuth2 / OIDC Login.
Opciones del endpoint
- Sin contraseña: En la pestaña OAuth2 / OIDC, establezca Username en el número de teléfono del usuario si
connection=sms, o en el correo electrónico del usuario siconnection=email, y Password en el código de verificación del usuario. Haga clic en Resource Owner Endpoint. - SSO de SAML: En la pestaña Other Flows, seleccione SAML.
- WS-Federation: En la pestaña Other Flows, seleccione WS-Federation.
- Cierre de sesión: En la pestaña Other Flows, seleccione Logout o Logout (Federated) para cerrar también la sesión del usuario en el Proveedor de identidad.
- Inicio de sesión heredado: En la pestaña OAuth2 / OIDC, establezca los campos ID Token, Token de actualización e ID de cliente de destino. Haga clic en Delegation.
- Delegación heredada: En la pestaña OAuth2 / OIDC, establezca Username y Password. Haga clic en Resource Owner Endpoint.
- Resource Owner heredado: En la pestaña OAuth2 / OIDC, establezca Username y Password y, a continuación, seleccione Resource Owner Endpoint.
Flujos de autenticación
- Flujo de código de autorización: En la pestaña OAuth2 / OIDC, establezca el campo Authorization Code con el code que obtuvo de Authorization Code Grant y Code Verifier con la clave. Haga clic en OAuth2 Code Exchange.
- Flujo de código de autorización + PKCE: En la pestaña OAuth2 / OIDC, establezca el campo Authorization Code con el code que obtuvo de Authorization Code Grant y Code Verifier con la clave. Haga clic en OAuth2 Code Exchange.
- Flujo de credenciales de cliente: En la pestaña OAuth2 / OIDC, seleccione OAuth2 Client Credentials.
Errores
4xx, puede asumir que se trata de una solicitud incorrecta de su parte.
Los errores 5xx sugieren un problema del lado de Auth0, por lo que, en este caso, consulte la página de estado de Auth0 y @auth0status en Twitter para comprobar el estado de nuestros sistemas.
En cualquier otro caso, puede usar nuestras opciones de soporte.
Limitación de velocidad
429 Too Many Requests con el siguiente mensaje: Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
Para obtener más información sobre la limitación de velocidad, consulte la política de límites de velocidad de la API de Auth0.
Tenga en cuenta que, para las conexiones de base de datos, Auth0 limita ciertos tipos de intentos repetidos de inicio de sesión en función de la cuenta de usuario y la dirección IP. Para obtener más información, consulte Límites de velocidad en la autenticación con usuario/contraseña.