Avant de commencer
-
Configurez une application machine-to-machine (M2M) et accordez-lui l’accès à l’Auth0 Management API avec les scopes suivants :
create:authentication_methodsread:authentication_methodsupdate:authentication_methodsdelete:authentication_methods
Obtenir toutes les méthodes d’authentification
Utilisez le point de terminaison Récupère la liste des méthodes d’authentification pour obtenir la liste de toutes les méthodes d’authentification qu’un utilisateur a complètement ou partiellement configurées. Ce point de terminaison nécessite le scope :read:authentication_methods.
Exemples
La requête suivante renvoie la liste de toutes les méthodes d’authentification d’un utilisateur donné.Réponses
Pour chaque requête valide, l’ renverra une réponse au format JSON.Obtenir une seule méthode d’authentification
Utilisez le point de terminaison Obtenir une méthode d’authentification par ID pour récupérer une méthode d’authentification d’un utilisateur en indiquant l’ID de la méthode d’authentification. Ce point de terminaison nécessite le scope suivant :read:authentication_methods.
Exemples
La requête suivante renvoie une seule méthode d’authentification pour un utilisateur à partir de l’ID de la méthode d’authentification indiquée.Réponses
Pour chaque requête valide, la Management API renverra une réponse au format JSON.Créer une méthode d’authentification
Utilisez le point de terminaison Crée une méthode d’authentification pour un utilisateur donné pour créer une méthode d’authentification pour un utilisateur, y compris par SMS, courriel, mot de passe à usage unique (OTP) ou WebAuthn avec clés de sécurité. Pour en savoir plus sur les facteurs d’authentification MFA disponibles, consultez Facteurs d’authentification multifacteur. Ce point de terminaison nécessite le scopecreate:authentication_methods.
SMS
Envoyez un OTP aux utilisateurs par SMS; ils seront ensuite invités à le saisir avant de pouvoir terminer l’authentification.Exemples
La requête suivante crée une méthode d’authentification par SMS pour un utilisateur.Réponses
Pour chaque requête valide, la Management API renvoie une réponse au format JSON.Exemples
La requête suivante crée une méthode d’authentification par courriel pour l’utilisateur.Réponses
Pour chaque requête valide, la Management API renverra une réponse au format JSON.Mots de passe à usage unique (OTP)
Permettez aux utilisateurs d’utiliser une application d’authentification, comme Google Authenticator, sur leur appareil personnel pour générer un OTP qui change périodiquement et qu’ils devront saisir avant de terminer l’authentification.Exemples
La requête suivante crée une méthode d’authentification OTP pour un utilisateur.Vous utilisez l’Auth0 CLI? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.
Réponses
Pour chaque requête valide, la Management API renvoie une réponse au format JSON.WebAuthn avec des clés de sécurité
Permettez aux utilisateurs d’utiliser des clés de sécurité conformes à FIDO (par exemple, Yubikey ou Google Titan) pour l’authentification multifacteur.Exemples
La requête suivante crée, pour un utilisateur, une méthode d’authentification WebAuthn avec des clés de sécurité.Réponses
Pour chaque requête valide, la Management API renvoie une réponse au format JSON.Remplacer toutes les méthodes d’authentification
Utilisez le point de terminaison Met à jour toutes les méthodes d’authentification en les remplaçant par celles fournies pour remplacer toutes les méthodes d’authentification existantes par celles fournies. Cet point de terminaison nécessite le scopeupdate:authentication_methods.
Exemples
La requête suivante remplace toutes les méthodes d’authentification existantes d’un utilisateur.Réponses
Pour chaque requête valide, la Management API renvoie une réponse au format JSON.Mettre à jour une seule méthode d’authentification
Utilisez le point de terminaison Updates an authentication method pour mettre à jour une seule méthode d’authentification d’un utilisateur. Ce point de terminaison nécessite le scope :update:authentication_methods.
Exemples
La requête suivante met à jour une seule méthode d’authentification pour un utilisateur en fonction de l’ID de la méthode d’authentification spécifiée.Réponses
Pour chaque requête valide, la Management API renverra une réponse au format JSON.Supprimer toutes les méthodes d’authentification
Utilisez le point de terminaison Supprimer toutes les méthodes d’authentification de l’utilisateur spécifié pour supprimer toutes les méthodes d’authentification d’un utilisateur. Ce point de terminaison nécessite le scope suivant :delete:authentication_methods.
Exemples
La requête suivante supprime toutes les méthodes d’authentification d’un utilisateur.Réponses
Pour chaque requête valide, la Management API renvoie une réponse avec un code d’état204 et un corps de la réponse vide.
Supprimer une seule méthode d’authentification
Utilisez le point de terminaison Deletes an authentication method by ID pour supprimer une méthode d’authentification d’un utilisateur.Exemples
La requête suivante supprime une méthode d’authentification précise d’un utilisateur à partir de l’ID de la méthode d’authentification indiquée.Réponses
Pour chaque requête valide, la Management API renvoie une réponse avec un code d’état204 et un corps de la réponse vide.