My Account API

Auth0 My Account API offre un ensemble dédié de terminaux permettant aux utilisateurs de gérer leurs propres informations de compte. Les clients peuvent utiliser ces API pour créer des expériences en libre-service dans leurs applications ou ajouter progressivement des détails à un compte utilisateur. My Account API fonctionne dans le contexte de l’utilisateur actuellement connecté et peut être utilisé directement dans les applications destinées aux utilisateurs.

​

Activer My Account API

Vous pouvez activer le My account API pour votre locataire dans le Dashboard de Auth0:

1. Accédez aux Applications > API.
2. Localisez la bannière My Account API.
3. Sélectionnez activer.

Par défaut, le My Account API est créé avec les éléments suivants : application API politiques d’accès :

• require_client_grant pour les flux d’utilisateurs
• deny_all for client (machine-to-machine) flows

Pour une autorisation application vers accès My Account API au nom de l’utilisateur, vous devez créer explicitement une autorisation client pour cette autorisation application, qui vous permet de définir la limite maximale permissions de l’autorisation application peut demander. Vous pouvez également modifier les flux politique pour l’utilisateur accès en allow_all, ce qui permet à tout application de votre locataire de demander n’importe quel permission depuis My Account API. Auth0 déconseille l’utilisation de allow_all pour les flux utilisateur accès car le My Account API expose des informations et des opérations sensibles. Il est recommandé d’appliquer le principe du moindre privilège avec My Account API afin de garantir que les applications n’accèdent accès qu’aux ressources strictement nécessaires, minimisant ainsi les risques de sécurité potentiels. Les autorisations finales accordées à application seront déterminées par l’intersection des autorisations de permissions autorisées par application, API, accès, politique et Role-based Access Control. (RBAC) permissions attribuées à utilisateur final, et à tout utilisateur consentement donné (le cas échéant). Pour en savoir plus sur la gestion des autorisations associées, consultez : Apprendre, application, API, politiques d’accès et client. class=‘notranslate’>accès aux API : client Grants.

​

Obtenez un jeton d’accès

Vous pouvez obtenir un jeton d’accès 1 pour le compte 2 de la même manière que vous obtiendriez un jeton jeton d’accès pour l’une de vos propres API. Si vous utilisez Universal Login, lecture les articles suivants:

• Appelez votre API en utilisant le flux de code d’autorisation
• Appelez votre API en utilisant le flux de code d’autorisation avec PKCE

Si vous utilisez la connexion intégrée, lecture les articles suivants:

• Appelez votre API en utilisant le mot de passe du propriétaire de la ressource flux
• Connexion flux avec clés d’identification API

​

Audience

L’ audience de My Account API est https://{yourDomain}/me/.

​

Permission

My Account API prend en charge les éléments suivants permissions:

Permission	Description
create:me:authentication-methods	Permet à l’utilisateur d’inscrire un nouveau authentification.
read:me:authentication-methods	Permet à l’utilisateur de consulter les méthodes existantes authentification.
update:me:authentication-methods	Permet à l’utilisateur de modifier les méthodes existantes authentification.
delete:me:authentication-methods	Permet à l’utilisateur de modifier les méthodes existantes.
read:me:factors	Permet à l’utilisateur de consulter les facteurs auxquels il peut s’inscrire.

Pour les comptes connectés avec jeton coffre-fort, My Account API prend en charge les permissions suivants:

Permission	Description
create:me:connected_accounts	Permet à l’utilisateur de connecter un nouveau compte à son profil utilisateur.
read:me:connected_accounts	Permet à l’utilisateur de consulter les comptes connectés existants liés à son compte profil utilisateur.
delete:me:connected_accounts	Permet à l’utilisateur de supprimer un compte connecté de son profil utilisateur.

​

Examples

​

Connexion universelle avec flux de code d’autorisation

Étape 1: Demander le code autorisation

Étape 2: Échangez le code pour jeton d’accès

​

Connexion intégrée avec clés d’identification natif

Étape 1: Demander un défi de connexion

Étape 2: Authentifier l’utilisateur existant

​

Endpoints

​

Méthodes authentification

Inscrivez-vous à la méthode authentification

Permet à l’utilisateur d’enregistrer une nouvelle méthode authentification (telle qu’une clé d’identification). ENDPOINT POST https://{yourDomain}/me/authentication-methods PERMISSIONS create:me:authentication-methods PARAMÈTRES CORPORELS

Paramètre	Type de données	Obligatoire?	Description
type	string	Requis	Type de la méthode authentification. Valeurs disponibles passkey.
connection	string	Optionnel	Le nom du connexion sur lequel créer la nouvelle méthode authentification.
identity_user_id	string	Optionnel	L’identifiant de l’utilisateur actuel. Utilisé avec les comptes liés.

​

Limites de débit

Pendant accès anticipé, My Account API est limité à un niveau locataire à 25 requêtes par seconde.

​

Cross-Origin Requêtes

Si vous avez l’intention d’appeler My Account API directement depuis un navigateur application (comme une page unique application) fonctionnant sur un domaine différent de votre Auth0 locataire, vous rencontrerez des politiques de sécurité du navigateur connues sous le nom de Cross-Origin Partage de ressources (CORS). Par défaut, les navigateurs bloquent ces requêtes cross-origin. Pour permettre à votre application d’envoyer avec succès des requêtes au API, vous devez ajouter le domaine (son « origine ») de votre client à la configuration de votre client :

1. Accédez à Dashboard > Applications. Sélectionnez application pour afficher.
2. Sous cross-origin authentification, activez l’option Autoriser Cross-Origin authentification.
3. Localisez les Origines autorisées (CORS) et saisissez l’origine de votre application URL.
4. Sélectionnez Enregistrer.

Pour en savoir plus, consultez la documentation: Configurer le partage de ressources.