Quickstart: Gebruikers aanmelden in een voorbeeld-Node.js CLI-toepassing

Van toepassing op: Werknemershuurders Externe huurders (meer informatie)

In deze quickstart gebruikt u een voorbeeldtoepassing van de Node Command Line Interface (CLI) om gebruikers in te loggen op uw externe tenant. De voorbeeldtoepassing maakt gebruik van de Microsoft Authentication Library voor Node (MSAL Node) om verificatie af te handelen.

Voorwaarden

• Visual Studio Code of een andere code-editor.
• Node.js.
• Een externe tenant. Kies een van de volgende methoden om er een te maken:
  • (Aanbevolen) Gebruik de externe id-extensie van Microsoft Entra om rechtstreeks in Visual Studio Code een externe tenant in te stellen.
  • maak een nieuwe externe tenant in het Microsoft Entra-beheercentrum.
• Registreer een nieuwe app in het Microsoft Entra-beheercentrum, geconfigureerd voor alleen accounts in deze organisatorische directory. Raadpleeg Een applicatie registreren voor meer details. Noteer de volgende waarden van de Overview pagina van de applicatie voor later gebruik.
  • Applicatie (client) ID
  • Directory-id (huurder)
• Voeg de volgende redirect URI's toe met behulp van de configuratie voor het platform Mobiele en desktop applicaties. Raadpleeg Hoe u een omleidings-URI in uw applicatie kunt toevoegen voor meer details.
  • Aangepaste omleidings-URI's: http://localhost
• Koppel uw app aan een gebruikersstroom in het Microsoft Entra-beheercentrum. Deze gebruikersstroom kan worden gebruikt in meerdere toepassingen. Voor meer informatie, zie Zelfservice-aanmeldingsstromen voor apps in externe tenants maken en Uw toepassing toevoegen aan de gebruikersstroom.

Openbare clientstromen inschakelen

Volg deze stappen om uw app te identificeren als een openbare client:

1. Onder beheren, selecteer verificatie.

2. Selecteer onder Geavanceerde instellingenvoor openbare clientstromen toestaanJa.

3. Selecteer Opslaan om uw wijzigingen op te slaan.

Voorbeeld-Node.js CLI-toepassing klonen of downloaden

Als u de voorbeeldtoepassing wilt verkrijgen, kunt u deze klonen vanuit GitHub of downloaden als een .zip-bestand.

• Als u het voorbeeld wilt klonen, opent u een opdrachtprompt en navigeert u naar de locatie waar u het project wilt maken en voert u de volgende opdracht in:

  git clone https://github.com/Azure-Samples/ms-identity-ciam-javascript-tutorial.git
  

• download het .zip bestand. Pak het uit naar een bestandspad waarbij de lengte van de naam minder dan 260 tekens is.

De CLI-voorbeeldtoepassing Node.js configureren

Als u de clienttoepassing (Node.js CLI-app) wilt configureren om de registratiegegevens van uw Microsoft Entra-app te gebruiken, opent u het project in uw IDE en voert u de volgende stappen uit:

1. Open het bestand App\authConfig.js.

2. Vind de invultekst:

   • Enter_the_Application_Id_Here en vervang de bestaande waarde door de toepassings-id (clientId) van node-cli-app toepassing die is gekopieerd uit het Microsoft Entra-beheercentrum.
   • Enter_the_Tenant_Subdomain_Here en vervang dit door het subdomein Directory (tenant). Als uw primaire tenantdomein bijvoorbeeld is contoso.onmicrosoft.com, gebruikt u contoso. Als u uw tenantnaam niet hebt, ontdek je hoe je informatie over uw huurder kunt lezen

De voorbeeldtoepassing Node.js CLI uitvoeren en testen

U kunt nu de voorbeeld-Node.js CLI-toepassing testen.

1. Voer in de terminal de volgende opdracht uit:

   cd 1-Authentication\6-sign-in-node-cli-app\App
   npm start
   

2. De browser wordt automatisch geopend en u ziet een pagina die er ongeveer als volgt uitziet:

   

3. Typ op de aanmeldingspagina uw e-mailadres. Als u geen account hebt, selecteert u Geen account? Maak één, waarmee de registratiestroom wordt gestart.

4. Als u de registratieoptie kiest, voltooit u de volledige aanmeldingsstroom nadat u uw e-mail hebt ingevuld, eenmalige wachtwoordcode, nieuw wachtwoord en meer accountgegevens. Nadat u de registratiestroom hebt voltooid en u zich hebt aangemeld, ziet u een pagina die lijkt op de volgende schermopname:

   

5. Ga terug naar de terminal en bekijk uw verificatiegegevens, inclusief de id-tokenclaims.

Verwante inhoud

• gebruikers aanmelden in uw eigen Node.js CLI-toepassing.
• Wachtwoord opnieuw instellen inschakelen.
• Het standaardmerk aanpassen.