> ## 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.
# Requête de création d’un compte connecté
> Démarrer un flux d’autorisation pour lier le compte de l’utilisateur authentifié à un fournisseur d’identité externe.
export const Scopes = ({scopes = []}) => {
return
Portées
{"Les portées définissent les autorisations et les niveaux d’accès des requêtes API et des jetons d’authentification."}
;
};
## OpenAPI
````yaml docs/fr-ca/oas/myaccount/myaccount-api-oas.json POST /connected-accounts/connect
openapi: 3.1.0
info:
description: "L’API My Account d’Auth0 fournit un ensemble dédié de points de terminaison permettant aux utilisateurs de gérer les renseignements de leur propre compte. Les clients peuvent utiliser ces API pour créer des expériences libre-service dans leurs applications ou enrichir progressivement le compte d’un utilisateur.\n\nL’API My Account fonctionne dans le contexte de l’utilisateur actuellement connecté et peut être utilisée directement dans des applications destinées aux utilisateurs.\n\n:::tip Utiliser le domaine Auth0 ou un domaine personnalisé\n\nL’API My Account prend en charge l’utilisation de votre domaine Auth0 canonique ou de votre domaine personnalisé, mais vous devez utiliser le même domaine tout au long du processus, notamment pour\_:\n\n- Obtenir un jeton d’accès\n- Définir la valeur d’audience\n- Appeler le point de terminaison de l’API My Account\n\nPour en savoir plus, consultez [Custom Domains](https://auth0.com/docs/customize/custom-domains).\n\n:::\n\n## Activer l’API My Account\n\nVous pouvez activer l’API My Account pour votre tenant dans le tableau de bord Auth0\_:\n\n1. Accédez à Authentication > APIs.\n2. Repérez la bannière MyAccount API.\n3. Sélectionnez Activate.\n\n\n\nPar défaut, l’API My Account est créée avec les application API access policies suivantes\_:\n\n`require_client_grant` pour les flux utilisateur\n\n`deny_all` pour les flux client (machine à machine)\n\nPour qu’une application puisse accéder à l’API My Account au nom de l’utilisateur, vous devez créer explicitement un client grant pour cette application, ce qui vous permet de définir les scopes maximaux que l’application peut demander. Vous pouvez aussi remplacer la policy des flux d’accès utilisateur par allow_all, ce qui permet à toute application de votre tenant de demander n’importe quel scope de l’API My Account.\n\nComme l’API My Account expose des renseignements et des opérations sensibles, Auth0 ne recommande pas d’utiliser allow_all pour les flux d’accès utilisateur. Vous devriez appliquer le principe du moindre privilège avec l’API My Account afin de veiller à ce que les applications n’obtiennent que l’accès dont elles ont réellement besoin, ce qui réduit les risques de sécurité potentiels.\n\nLes permissions finales accordées à l’application seront déterminées par l’intersection des scopes autorisés par l’application API access policy, des permissions Role-Based Access Control (RBAC) attribuées à l’utilisateur final et du consentement donné par l’utilisateur, s’il y a lieu.\n\n:::info Flux pris en charge\n\nVous ne pouvez pas mettre à jour l’application API access policy pour l’accès client à l’API My Account, ce qui signifie que vous ne pouvez pas accéder à l’API My Account à l’aide du Client Credentials Flow.\n\n:::\n\nPour en savoir plus sur la gestion des application API access policies et des client grants qui y sont associés, consultez [Application Access to APIs: Client Grants](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants).\n\n## Obtenir un jeton d’accès\n\nVous pouvez obtenir un jeton d’accès pour l’API My Account de la même façon que pour l’une de vos propres API.\n\n:::info \nSi vous comptez permettre à l’API My Account d’effectuer des opérations sensibles (comme l’inscription d’une méthode d’authentification), nous vous recommandons fortement d’utiliser l’[authentification renforcée (step-up authentication)](https://auth0.com/docs/secure/multi-factor-authentication/step-up-authentication) pour appliquer des politiques de sécurité supplémentaires au moyen de l’[authentification multifacteur (MFA)](https://auth0.com/docs/secure/multi-factor-authentication).\n:::\n\nSi vous utilisez Universal Login, consultez les articles suivants\_:\n\n- [Call Your API Using the Authorization Code Flow](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow/call-your-api-using-the-authorization-code-flow)\n- [Call Your API Using the Authorization Code Flow with 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)\n\nSi vous utilisez l’embedded login, consultez les articles suivants\_:\n\n- [Call Your API Using Resource Owner Password Flow](https://auth0.com/docs/get-started/authentication-and-authorization-flow/resource-owner-password-flow/call-your-api-using-resource-owner-password-flow)\n- [Login Flow with Native Passkeys API](https://auth0.com/docs/native-passkeys-api#login-flow)\n\n## Exemples\n\n### Universal Login avec le flux de code d’autorisation\n\n**Étape 1\_: Demander un code d’autorisation**\n\n```\ncurl --request GET \\\n --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'\n```\n\n**Étape 2\_: Échanger le code contre un jeton d’accès**\n\n```\ncurl --request POST \\\n --url 'https://{yourDomain}/oauth/token' \\\n --header 'content-type: application/json' \\\n --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\": \"\"}'\n```\n\n### Embedded login avec des passkeys natives\n\n**Étape 1\_: Demander un challenge de connexion**\n\n```\ncurl --request POST \\\n --url 'https://{yourDomain}/passkey/challenge' \\\n --header 'content-type: application/json' \\\n --data '{\"client_id\": \"{yourClientId}\"}'\n```\n\n**Étape 2\_: Authentifier un utilisateur existant**\n\n```\ncurl --request POST \\\n --url 'https://{yourDomain}/oauth/token' \\\n --header 'content-type: application/json' \\\n --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}\"}'\n```"
title: My Account
version: '1.0'
servers:
- url: https://{host}/me/v1
variables:
host:
default: auth0.auth0.com
description: Nom d’hôte personnalisé ou canonique
security: []
tags:
- description: Facteurs
name: factors
x-displayName: Factors
- description: Comptes connectés
name: connected-accounts
x-displayName: Connected Accounts
- description: Méthodes d’authentification
name: authentication-methods
x-displayName: Authentication Methods
- description: Consentements
name: consents
x-displayName: Consents
- description: Organisations
name: organizations
x-displayName: Organizations
paths:
/connected-accounts/connect:
post:
tags:
- connected-accounts
summary: Créer une requête de compte connecté
description: >-
Démarrer un flux d’autorisation pour lier le compte de l’utilisateur
authentifié à un fournisseur d’identité externe.
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: Corps de la requête pour créer une requête de liaison de compte.
properties:
authorization_params:
$ref: '#/components/schemas/AuthorizationParams'
code_challenge:
description: Le code challenge PKCE dérivé du code verifier.
maxLength: 128
minLength: 43
type: string
code_challenge_method:
const: S256
description: >-
La méthode utilisée pour dériver le code challenge. Obligatoire
lorsque code_challenge est fourni.
type: string
connection:
description: >-
Le nom de la connexion à lier au compte (p. ex., 'google-oauth2',
'facebook').
maxLength: 128
minLength: 1
type: string
redirect_uri:
description: >-
L’URI de redirection à utiliser une fois le processus de connexion
terminé.
format: uri
maxLength: 2048
type: string
scopes:
description: >-
Définit les permissions que le client demande au fournisseur
d’identité. Doit inclure les scopes standard utilisés pour
identifier l’utilisateur (p. ex. 'openid', 'email', 'profile'), le
scope requis pour obtenir des refresh tokens au besoin (p. ex.
'offline_access'), ainsi que tout scope personnalisé dont le client
a besoin pour accéder à des ressources protégées.
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: >-
Une valeur opaque utilisée pour maintenir l’état entre la requête et
le callback.
maxLength: 4096
minLength: 1
type: string
required:
- connection
- redirect_uri
type: object
AuthorizationParams:
additionalProperties: false
description: >-
Paramètres d’autorisation à envoyer au fournisseur d’identité (IdP)
sous-jacent durant la requête d’autorisation. Ces paramètres influencent
la façon dont l’IdP traite le flux d’autorisation et les permissions
demandées.
properties:
acr_values:
description: >-
Précise les valeurs de référence de classe du contexte
d’authentification souhaitées, qui indiquent le niveau
d’authentification requis (p. ex., multifacteur, sans mot de passe).
Le fournisseur d’identité (IdP) peut appliquer un niveau d’assurance
précis en fonction de ces valeurs.
maxLength: 1024
minLength: 1
type: string
audience:
description: >-
Définit le destinataire visé du jeton d’accès, en indiquant
généralement à qui le jeton est destiné (p. ex., un identifiant
d’API).
maxLength: 512
minLength: 1
type: string
display:
$ref: '#/components/schemas/DisplayEnum'
id_token_hint:
description: >-
Fournit un id_token déjà émis à l’IdP. Il peut être utilisé pour
indiquer quel utilisateur est en cours d’authentification ou pour
faciliter les requêtes de déconnexion.
maxLength: 4096
minLength: 1
type: string
login_hint:
description: >-
Fournit une indication sur l’identifiant de l’utilisateur (comme une
adresse courriel ou un nom d’utilisateur) afin de préremplir le
formulaire de connexion.
maxLength: 255
minLength: 1
type: string
max_age:
description: >-
Indique le temps maximal (en secondes) écoulé depuis la dernière
authentification de l’utilisateur. Si ce délai est dépassé, l’IdP
oblige l’utilisateur à s’authentifier de nouveau.
maximum: 2147483647
minimum: 0
type: integer
prompt:
$ref: '#/components/schemas/PromptEnum'
resource:
description: >-
Précise à quel serveur de ressources le client demande l’accès
(utilisé dans les indicateurs de ressource OAuth 2.0).
maxLength: 512
minLength: 1
type: string
ui_locales:
description: >-
Indique les langues préférées pour l’interface utilisateur,
transmises sous forme de liste de balises de langue BCP47 séparées
par des espaces (p. ex., '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: L’identifiant de session d’authentification.
maxLength: 64
type: string
connect_params:
$ref: '#/components/schemas/ConnectParams'
connect_uri:
description: L’URI de base pour lancer le flux de liaison de compte.
format: uri
type: string
expires_in:
description: Le nombre de secondes avant l’expiration du 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: >-
Indique comment l’IdP doit présenter l’interface d’authentification à
l’utilisateur.
enum:
- page
- popup
- touch
- wap
PromptEnum:
description: >-
Détermine si l’IdP doit demander à l’utilisateur de s’authentifier ou de
donner son consentement.
enum:
- none
- login
- consent
- select_account
ConnectParams:
additionalProperties: false
description: Paramètres à utiliser avec l’URI de connexion.
properties:
ticket:
description: L’identifiant du ticket à utiliser avec l’URI de connexion.
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: Requête de liaison de compte créée avec succès
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: Entrée invalide selon le schéma.
Unauthorized:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Non autorisé.
Forbidden:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Interdit.
UnsupportedMediaType:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Type de média non pris en charge.
TooManyRequests:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Trop de requêtes.
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: Le nombre maximal de requêtes autorisées pendant la fenêtre de la limite
required: true
schema:
type: number
XRateLimitRemainingHeader:
description: >-
Le nombre de requêtes restantes dans la fenêtre en cours avant le rejet
des requêtes
required: true
schema:
type: number
XRateLimitResetHeader:
description: >-
Le moment prévu (sous forme d’horodatage UNIX, en secondes) auquel le
bucket sera réapprovisionné
required: true
schema:
type: number
RetryAfterHeader:
description: >-
Le nombre de secondes que le client doit attendre avant d’effectuer une
nouvelle requête
required: true
schema:
type: number
XAuth0ErrorKindHeader:
description: >-
Indique si la limite de débit dépassée est une limite globale (par
tenant).
schema:
const: global-rate-limit
type: string
securitySchemes:
Bearer-DPoP:
description: >-
Les jetons Bearer et DPoP sont pris en charge selon la configuration de
l’API
scheme: bearer
type: http
````