> ## 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.
# Obtenir les comptes connectés
> Récupérer les comptes connectés de l’utilisateur authentifié.
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 GET /connected-accounts/accounts
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/accounts:
get:
tags:
- connected-accounts
summary: Obtenir la liste des comptes connectés
description: Récupérer les comptes connectés de l’utilisateur authentifié.
operationId: getConnectedAccounts
parameters:
- $ref: '#/components/parameters/ConnectionQueryParameter'
- $ref: '#/components/parameters/FromQueryParameter'
- $ref: '#/components/parameters/TakeQueryParameter'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ListConnectedAccountsResponseContent'
description: Comptes connectés récupérés 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'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
security:
- Bearer-DPoP:
- read:me:connected_accounts
x-codeSamples: []
components:
parameters:
ConnectionQueryParameter:
description: Filtrer les comptes connectés selon le nom de la connexion
explode: true
in: query
name: connection
required: false
schema:
$ref: '#/components/schemas/ConnectionNamesFilter'
style: form
FromQueryParameter:
description: >-
Curseur de pagination - commencer à récupérer les résultats à partir de
ce point
in: query
name: from
required: false
schema:
type: string
TakeQueryParameter:
description: Nombre de résultats à renvoyer (1-20)
in: query
name: take
required: false
schema:
default: 10
minimum: 1
type: integer
schemas:
ListConnectedAccountsResponseContent:
additionalProperties: false
properties:
accounts:
items:
$ref: '#/components/schemas/ConnectedAccount'
maxItems: 20
type: array
next:
description: >-
Le token permettant de récupérer la page suivante de comptes
connectés (s’il y en a une)
type: string
required:
- accounts
type: object
ConnectionNamesFilter:
oneOf:
- maxLength: 128
type: string
- items:
maxLength: 128
type: string
maxItems: 20
minItems: 1
type: array
ConnectedAccount:
properties:
access_type:
$ref: '#/components/schemas/ConnectedAccountAccessTypeEnum'
connection:
description: Le nom de la connexion associée au compte.
type: string
created_at:
description: >-
Horodatage ISO 8601 indiquant la date de création du compte
connecté.
format: date-time
type: string
expires_at:
description: >-
Horodatage ISO 8601 indiquant la date d’expiration du compte
connecté.
format: date-time
type: string
id:
description: L’identifiant unique du compte connecté.
type: string
org_id:
description: >-
L’Organization ID auquel ce compte connecté est limité. Présent
uniquement pour les comptes liés à une organization.
type: string
scopes:
description: Les scopes accordés pour ce compte connecté.
items:
type: string
type: array
required:
- id
- connection
- access_type
- scopes
- created_at
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
ConnectedAccountAccessTypeEnum:
description: Le type d’accès du compte connecté.
enum:
- offline
type: string
ValidationError:
additionalProperties: false
properties:
detail:
type: string
field:
type: string
pointer:
type: string
source:
type: string
required:
- detail
type: object
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
responses:
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.
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'
securitySchemes:
Bearer-DPoP:
description: >-
Les jetons Bearer et DPoP sont pris en charge selon la configuration de
l’API
scheme: bearer
type: http
````