Démarrage rapide : Se connecter à l’aide de l’authentification native intégrée

S’applique à : cercle vert avec un symbole de coche blanc qui indique que le contenu suivant s’applique aux locataires externes. Locataires externes (en savoir plus)

Approche d’authentification : Authentification native incorporée.

Dans ce guide de démarrage rapide, vous allez configurer un exemple React Next.js pour l’authentification native incorporée avec Microsoft Authentication Library (MSAL) pour JavaScript 5.29.0. Le parcours par e-mail et mot de passe utilise un domaine personnalisé vérifié par le locataire avec le partage de ressources cross-origin (CORS) en périphérie.

Important

L’API d’authentification native V2 est en préversion. L’API d’authentification native V1 reste généralement disponible. Consultez les Conditions d’utilisation supplémentaires pour les préversions Microsoft Azure pour connaître les conditions légales qui s’appliquent aux fonctionnalités en préversion.

Prerequisites

  • Un locataire externe et une application cliente publique configurée pour l’authentification native incorporée. Terminez « Configurer une application ».
  • Un domaine personnalisé vérifié par le locataire, l’ID d’application et le GUID du locataire de l’annuaire.
  • CORS sur la périphérie de domaine personnalisé configurée pour l’origine du navigateur de l’exemple, http://localhost:3000. Appliquez le contrat proxy partagé pour les origines, les requêtes preflight, les en-têtes du Kit de développement logiciel (SDK) et les réponses de réussite et d’erreur.
  • Un compte client avec e-mail et mot de passe. Si la stratégie de locataire nécessite une authentification multifacteur (MFA), préparez un facteur sms ou de messagerie activé pour cet exemple de parcours.
  • Node.js 20.9.0 ou version ultérieure, npm, Git et un éditeur de code.
  • Le port 3000 est disponible pour l’application.

Obtenir l’exemple

L’exemple a un lanceur unifié pour V1 et V2. Utilisez la révision épinglée et la version du Kit de développement logiciel (SDK) ci-dessous pour suivre ce guide de démarrage rapide :

  1. Clonez le référentiel, consultez l’exemple de révision et ouvrez son application React Next.js :

    git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples
    cd ms-identity-ciam-native-javascript-samples
    git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808
    cd typescript/native-auth/react-nextjs-sample
    
  2. Installez la version exacte du Kit de développement logiciel (SDK) avec les exemples de dépendances :

    npm install --save-exact "@azure/msal-browser@5.29.0"
    

Configurer l’application

Utilisez https://<tenant-verified-custom-domain>/<tenant-GUID> à la fois pour l’autorité de service et la base de transport de l’API sdk dans cet itinéraire de périphérie. Conservez les liens HAL absolus opaques pour cette autorité inchangés. N’ajoutez pas de clé secrète client à la configuration du navigateur.

  1. Ouvrez src/config/auth-config.ts.
  2. Remplacez Enter_the_Application_Id_Here par l’ID d’application.
  3. Remplacez la valeur complète https://<tenant-verified-custom-domain>/<tenant-GUID> par auth.authority, en remplaçant votre nom d’hôte vérifié et votre GUID de locataire.
  4. Ajoutez auth.knownAuthorities en tant que tableau contenant le nom d’hôte vérifié, sans schéma ni chemin d’accès.
  5. Définissez la chaîne requise customAuth.authApiProxyUrl sur la même autorité complète https://<tenant-verified-custom-domain>/<tenant-GUID> . Incluez le GUID du locataire dans les deux paramètres d’URL du Kit de développement logiciel (SDK).
  6. Enregistrez le fichier de configuration. L’exemple V2 utilise les étendues par défaut du Kit de développement logiciel (SDK) sans claims personnalisées. Les exigences de l’authentification multifacteur proviennent de votre stratégie de locataire, et non de la sélection de V2.

Exécuter l’exemple

Exécutez l’application depuis le répertoire de l’exemple. Cette configuration de périphérie de domaine personnalisé n’utilise pas le proxy CORS local de l’exemple :

  1. Démarrez l’application :

    npm run dev
    
  2. Ouvrez http://localhost:3000 dans un navigateur et sélectionnez V2. Laissez l’application en cours d’exécution pendant le test.

Connectez-vous en tant que client de test

Utilisez le lanceur unifié de l’exemple pour tester uniquement les méthodes activées pour la transaction actuelle.

  1. Entrez l’adresse e-mail du client de test, puis sélectionnez Se connecter.
  2. Si le service propose plusieurs méthodes de premier facteur, sélectionnez la méthode de mot de passe. Entrez le mot de passe lorsque vous y êtes invité et sélectionnez Se connecter.
  3. Si le service demande l’authentification multifacteur, sélectionnez une méthode e-mail ou SMS retournée et entrez son code de vérification.
  4. Vérifiez que l’exemple indique que la connexion est terminée. N’exposez pas de jetons dans les captures d’écran, les journaux ou la sortie du support.

La connexion par code secret unique par e-mail utilise un compte client et un flux d’utilisateur configurés pour cette méthode. Ce guide de démarrage rapide suit le parcours par e-mail et mot de passe.

Nettoyer la session

Terminez le test local sans supprimer la configuration du locataire partagé.

La déconnexion de l’exemple ne met pas fin à d’autres sessions d’application ou de navigateur.

  1. Déconnectez-vous de l’application d’exemple et videz l’interface utilisateur de l’application liée au compte.
  2. Arrêtez le processus d’application dans son terminal.