> ## 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.
# Solicitud para crear una cuenta conectada
> Inicia un flujo de autorización para vincular la cuenta del usuario autenticado con un proveedor de identidad externo.
export const Scopes = ({scopes = []}) => {
return
Scopes
{"Los alcances definen los permisos y los niveles de acceso para las solicitudes a la API y los tokens de autenticación."}
;
};
## OpenAPI
````yaml es/docs/oas/myaccount/myaccount-api-oas.json POST /connected-accounts/connect
openapi: 3.1.0
info:
description: >-
La API My Account de Auth0 proporciona un conjunto específico de endpoints
para que los usuarios administren la información de su propia cuenta. Los
clientes pueden usar estas APIs para crear experiencias de autoservicio en
sus aplicaciones o añadir progresivamente datos a una cuenta de usuario.
La API My Account funciona en el contexto del usuario que ha iniciado sesión
y puede usarse directamente en aplicaciones de cara al usuario.
:::tip Uso del dominio de Auth0 frente al dominio personalizado
La API My Account admite el uso de su dominio canónico de Auth0 o de su
dominio personalizado, pero debe usar el mismo durante todo el proceso, lo
que incluye:
- Obtener un token de acceso
- Establecer el valor de audiencia
- Llamar al endpoint de la API My Account
Para obtener más información, consulte [Custom
Domains](https://auth0.com/docs/customize/custom-domains).
:::
## Activar la API My Account
Puede activar la API My Account para su inquilino en el Auth0 Dashboard:
1. Vaya a Authentication > APIs.
2. Busque el banner de la API MyAccount.
3. Seleccione Activate.
De forma predeterminada, la API My Account se crea con las siguientes
políticas de acceso a la API de la aplicación:
`require_client_grant` para flujos de usuario
`deny_all` para flujos de cliente (de máquina a máquina)
Para que una aplicación acceda a la API My Account en nombre del usuario,
debe crear explícitamente un client grant para esa aplicación, lo que le
permite definir los alcances máximos que la aplicación puede solicitar. Como
alternativa, puede cambiar la política de los flujos de acceso de usuario a
allow_all, lo que permite que cualquier aplicación de su inquilino solicite
cualquier alcance de la API My Account.
Como la API My Account expone información y operaciones sensibles, Auth0 no
recomienda usar allow_all para los flujos de acceso de usuario. Debe seguir
el principio de privilegio mínimo con la API My Account para garantizar que
las aplicaciones solo obtengan acceso a lo que realmente necesitan y así
minimizar los posibles riesgos de seguridad.
Los permisos finales concedidos a la aplicación estarán determinados por la
intersección entre los alcances permitidos por la política de acceso a la
API de la aplicación, los permisos de control de acceso basado en roles
(RBAC) asignados al usuario final y cualquier consentimiento otorgado por el
usuario (si corresponde).
:::info Flujos admitidos
No puede actualizar la política de API de la aplicación para el acceso de
cliente a la API My Account, lo que significa que no puede acceder a la API
My Account mediante el flujo de credenciales del cliente.
:::
Para obtener más información sobre cómo administrar las políticas de acceso
a la API de la aplicación y los client grants asociados, consulte
[Application Access to APIs: Client
Grants](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants).
## Obtener un token de acceso
Puede obtener un token de acceso para la API My Account de la misma manera
que obtendría un token de acceso para una de sus propias APIs.
:::info
Si va a permitir que la API My Account realice operaciones sensibles (como
registrar un método de autenticación), le recomendamos encarecidamente que
use [autenticación
escalonada](https://auth0.com/docs/secure/multi-factor-authentication/step-up-authentication)
para aplicar políticas de seguridad adicionales mediante [autenticación
multifactor
(MFA)](https://auth0.com/docs/secure/multi-factor-authentication).
:::
Si usa Universal Login, consulte los siguientes artículos:
- [Llame a su API mediante el Flujo de código de
autorización](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow/call-your-api-using-the-authorization-code-flow)
- [Llame a su API mediante el Flujo de código de autorización con
PKCE](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce/call-your-api-using-the-authorization-code-flow-with-pkce)
Si usa inicio de sesión integrado, consulte los siguientes artículos:
- [Llame a su API mediante el flujo de contraseña del propietario del
recurso](https://auth0.com/docs/get-started/authentication-and-authorization-flow/resource-owner-password-flow/call-your-api-using-resource-owner-password-flow)
- [Flujo Login con la API nativa de claves de
acceso](https://auth0.com/docs/native-passkeys-api#login-flow)
## Ejemplos
### Universal Login con flujo de código de autorización
**Paso 1: Solicitar código de autorización**
```
curl --request GET \
--url 'https://{yourDomain}/authorize?response_type=code&client_id={yourClientId}&redirect_uri=%7ByourRedirectUri%7D&scope=create%3Ame%3Aauthentication_methods&offline_access=&audience=https%3A%2F%2F{yourDomain}%2Fme%2F'
```
**Paso 2: Intercambiar el código por un token de acceso**
```
curl --request POST \
--url 'https://{yourDomain}/oauth/token' \
--header 'content-type: application/json' \
--data '{"grant_type": "authorization_code","client_id": "{yourClientId}","client_secret": "{yourClientSecret}","code": "{yourAuthorizationCode}","redirect_uri": "{yourRedirectUri}","audience": "{yourAudience}","scope": "create:me:authentication_methods","offline_access": ""}'
```
### Inicio de sesión integrado con claves de acceso nativas
**Paso 1: Solicitar desafío de inicio de sesión**
```
curl --request POST \
--url 'https://{yourDomain}/passkey/challenge' \
--header 'content-type: application/json' \
--data '{"client_id": "{yourClientId}"}'
```
**Paso 2: Autenticar a un usuario existente**
```
curl --request POST \
--url 'https://{yourDomain}/oauth/token' \
--header 'content-type: application/json' \
--data '{ "grant_type": "urn:okta:params:oauth:grant-type:webauthn", "client_id": "{yourClientId}", "scope": "create:me:authentication_methods offline_access", "audience": "https://{yourDomain}/me/", "auth_session": "{sessionIdFromTheFirstRequest}", "authn_response": "{authenticatorResponse}"}'
```
title: My Account
version: '1.0'
servers:
- url: https://{host}/me/v1
variables:
host:
default: auth0.auth0.com
description: Nombre de host personalizado o canónico
security: []
tags:
- description: Factores
name: factors
x-displayName: Factors
- description: Cuentas conectadas
name: connected-accounts
x-displayName: Connected Accounts
- description: Métodos de autenticación
name: authentication-methods
x-displayName: Authentication Methods
- description: Consentimientos
name: consents
x-displayName: Consents
paths:
/connected-accounts/connect:
post:
tags:
- connected-accounts
summary: Crear una solicitud de cuenta conectada
description: >-
Inicia un flujo de autorización para vincular la cuenta del usuario
autenticado con un proveedor de identidad externo.
operationId: createConnectedAccountRequest
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConnectedAccountsRequestContent'
required: true
responses:
'201':
$ref: '#/components/responses/CreateConnectedAccountsResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'415':
$ref: '#/components/responses/UnsupportedMediaType'
'429':
$ref: '#/components/responses/TooManyRequests'
security:
- Bearer-DPoP:
- create:me:connected_accounts
x-codeSamples: []
components:
schemas:
CreateConnectedAccountsRequestContent:
additionalProperties: false
dependentRequired:
code_challenge:
- code_challenge_method
description: >-
Cuerpo de la solicitud para crear una solicitud de vinculación de
cuentas.
properties:
authorization_params:
$ref: '#/components/schemas/AuthorizationParams'
code_challenge:
description: El desafío de código PKCE derivado del code verifier.
maxLength: 128
minLength: 43
type: string
code_challenge_method:
const: S256
description: >-
El método utilizado para derivar el desafío de código. Obligatorio
cuando se proporciona code_challenge.
type: string
connection:
description: >-
El nombre de la conexión con la que se vinculará la cuenta (por
ejemplo, 'google-oauth2', 'facebook').
maxLength: 128
minLength: 1
type: string
redirect_uri:
description: >-
El URI al que se redirigirá una vez completado el proceso de
conexión.
format: uri
maxLength: 2048
type: string
scopes:
description: >-
Define los permisos que el cliente solicita al Proveedor de
identidad. Debe incluir los alcances estándar usados para
identificar al usuario (por ejemplo, 'openid', 'email', 'profile'),
el scope necesario para obtener tokens de actualización si hace
falta (por ejemplo, 'offline_access') y cualquier alcance
personalizado que el cliente necesite para acceder a recursos
protegidos.
example:
- openid
- offline_access
- read:tasks
- write:tasks
items:
maxLength: 255
minLength: 1
type: string
maxItems: 100
minItems: 1
type: array
uniqueItems: true
state:
description: >-
Un valor opaco que se usa para mantener el estado entre la solicitud
y el callback.
maxLength: 4096
minLength: 1
type: string
required:
- connection
- redirect_uri
type: object
AuthorizationParams:
additionalProperties: false
description: >-
Parámetros de autorización que se enviarán al Proveedor de identidad
(IdP) subyacente durante la solicitud de autorización. Estos parámetros
influyen en cómo el IdP procesa el flujo de autorización y qué permisos
se solicitan.
properties:
acr_values:
description: >-
Especifica los valores deseados de Authentication Context Class
Reference, que indican el nivel de autenticación requerido (por
ejemplo, multifactor o sin contraseña). El Proveedor de identidad
(IdP) puede aplicar un nivel de garantía específico en función de
estos valores.
maxLength: 1024
minLength: 1
type: string
audience:
description: >-
Define el destinatario previsto del token de acceso, lo que
normalmente indica para quién está destinado el token (por ejemplo,
un identificador de API).
maxLength: 512
minLength: 1
type: string
display:
$ref: '#/components/schemas/DisplayEnum'
id_token_hint:
description: >-
Proporciona un id_token emitido previamente al IdP. Puede usarse
para indicar qué usuario se está autenticando o para facilitar
solicitudes de cierre de sesión.
maxLength: 4096
minLength: 1
type: string
login_hint:
description: >-
Proporciona una indicación sobre el identificador del usuario (como
una dirección de correo electrónico o un username) para completar
previamente el formulario de inicio de sesión.
maxLength: 255
minLength: 1
type: string
max_age:
description: >-
Indica el tiempo máximo (en segundos) transcurrido desde la última
autenticación del usuario. Si se supera, el IdP obliga al usuario a
volver a autenticarse.
maximum: 2147483647
minimum: 0
type: integer
prompt:
$ref: '#/components/schemas/PromptEnum'
resource:
description: >-
Especifica a qué servidor de recursos solicita acceso el cliente (se
usa en los indicadores de recursos de OAuth 2.0).
maxLength: 512
minLength: 1
type: string
ui_locales:
description: >-
Sugiere los idiomas preferidos para la interfaz de usuario, enviados
como una lista de etiquetas de idioma BCP47 separadas por espacios
(por ejemplo, 'en', 'es', 'fr').
maxLength: 100
minLength: 2
pattern: ^[a-zA-Z]{2}(-[a-zA-Z]{2})?(\s[a-zA-Z]{2}(-[a-zA-Z]{2})?)*$
type: string
title: Authorization Parameters
type: object
CreateConnectedAccountsResponseContent:
additionalProperties: false
properties:
auth_session:
description: El identificador de la sesión de autenticación.
maxLength: 64
type: string
connect_params:
$ref: '#/components/schemas/ConnectParams'
connect_uri:
description: El URI base para iniciar el flujo de conexión de cuentas.
format: uri
type: string
expires_in:
description: La cantidad de segundos hasta que expire el ticket.
minimum: 1
type: integer
required:
- connect_uri
- auth_session
- connect_params
- expires_in
type: object
ErrorResponse:
additionalProperties: false
properties:
detail:
type: string
status:
type: number
title:
type: string
type:
type: string
validation_errors:
items:
$ref: '#/components/schemas/ValidationError'
type: array
required:
- type
- status
- title
- detail
type: object
DisplayEnum:
description: >-
Sugiere cómo debe el IdP mostrar la interfaz de autenticación al
usuario.
enum:
- page
- popup
- touch
- wap
PromptEnum:
description: >-
Controla si el IdP debe solicitar al usuario la autenticación o el
consentimiento.
enum:
- none
- login
- consent
- select_account
ConnectParams:
additionalProperties: false
description: Parámetros que se usarán con el URI de conexión.
properties:
ticket:
description: El identificador del ticket que se usará con el URI de conexión.
type: string
required:
- ticket
type: object
ValidationError:
additionalProperties: false
properties:
detail:
type: string
field:
type: string
pointer:
type: string
source:
type: string
required:
- detail
type: object
responses:
CreateConnectedAccountsResponse:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConnectedAccountsResponseContent'
description: Solicitud de conexión de cuenta creada correctamente
headers:
x-ratelimit-limit:
$ref: '#/components/headers/XRateLimitLimitHeader'
x-ratelimit-remaining:
$ref: '#/components/headers/XRateLimitRemainingHeader'
x-ratelimit-reset:
$ref: '#/components/headers/XRateLimitResetHeader'
BadRequest:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Entrada no válida según el esquema.
Unauthorized:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: No autorizado.
Forbidden:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Prohibido.
UnsupportedMediaType:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Tipo de contenido no compatible.
TooManyRequests:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Demasiadas solicitudes.
headers:
retry-after:
$ref: '#/components/headers/RetryAfterHeader'
x-auth0-error-kind:
$ref: '#/components/headers/XAuth0ErrorKindHeader'
x-ratelimit-limit:
$ref: '#/components/headers/XRateLimitLimitHeader'
x-ratelimit-remaining:
$ref: '#/components/headers/XRateLimitRemainingHeader'
x-ratelimit-reset:
$ref: '#/components/headers/XRateLimitResetHeader'
headers:
XRateLimitLimitHeader:
description: El número máximo de solicitudes permitido durante la ventana del límite
required: true
schema:
type: number
XRateLimitRemainingHeader:
description: >-
El número de solicitudes restantes en la ventana actual antes de que se
rechacen las solicitudes
required: true
schema:
type: number
XRateLimitResetHeader:
description: >-
La hora prevista (como marca de tiempo UNIX, en segundos) en que se
repondrá el bucket
required: true
schema:
type: number
RetryAfterHeader:
description: >-
La cantidad de segundos que el cliente debe esperar antes de realizar
una nueva solicitud
required: true
schema:
type: number
XAuth0ErrorKindHeader:
description: >-
Un indicador de que el límite de tasa superado es un límite global (por
inquilino).
schema:
const: global-rate-limit
type: string
securitySchemes:
Bearer-DPoP:
description: >-
Los tokens Bearer y DPoP son compatibles según la configuración de la
API
scheme: bearer
type: http
````