Logga in användare i exempelappen för Android (Kotlin) med inbyggd autentisering

Gäller för: Externa klienter (läs mer)

I den här snabbstarten får du lära dig hur du kör ett Android-exempelprogram som visar scenarier för registrering, inloggning, utloggning och lösenordsåterställning med hjälp av Microsoft Entras interna autentisering.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte redan har ett Skapa ett konto kostnadsfritt.

• Det här Azure-kontot måste ha behörighet att hantera program. Någon av följande Microsoft Entra-roller innehåller de behörigheter som krävs:

  • Appadministratör
  • Programutvecklare

• En extern hyresgäst. Om du inte har en, skapa en ny extern klientorganisation i administrationscentret för Microsoft Entra.

• Om du inte redan har gjort det registrerar du ett program i administrationscentret för Microsoft Entra. Se till att:

  • Registrera applikations-id (klient) och katalog-id (hyresgäst) att använda senare.
  • Bevilja administratörsmedgivande till programmet.

• Om du inte redan har gjort det skapar du ett användarflöde i administrationscentret för Microsoft Entra

• Associera din appregistrering med användarflödet

• Android Studio.

Aktivera offentliga klient- och interna autentiseringsflöden

Om du vill ange att den här appen är en offentlig klient och kan använda intern autentisering aktiverar du offentliga klient- och inbyggda autentiseringsflöden:

1. På sidan appregistreringar väljer du den appregistrering som du vill aktivera offentliga klient- och inbyggda autentiseringsflöden för.
2. Under Hantera, välj Autentisering.
3. Under Avancerade inställningartillåter du offentliga klientflöden:
   1. För Aktivera följande mobil- och skrivbordsflöden väljer du Ja.
   2. För Aktivera intern autentiseringväljer du Ja.
4. Välj knappen Spara.

Klona exempel Android-mobilapplikation

1. Öppna Terminal och navigera till en katalog där du vill behålla koden.

2. Klona programmet från GitHub genom att köra följande kommando:

   git clone https://github.com/Azure-Samples/ms-identity-ciam-native-auth-android-sample 
   

Konfigurera android-exempelprogrammet

1. Öppna det projekt som du klonade i Android Studio.

2. Öppna filen i mappen app/src/main/res/raw/native_auth_sample_app_config.json.

3. Hitta platshållaren:

   • Enter_the_Application_Id_Here och ersätt det med program-ID (klient)-ID:t för appen som du registrerade tidigare.
   • Enter_the_Tenant_Subdomain_Here och ersätt den med underdomänen för Directory (klientorganisation). Om din primära klientdomän till exempel är contoso.onmicrosoft.comanvänder du contoso. Om du inte känner till din underklientdomän, ta reda på hur du läser dina klientdetaljer.

Nu har du konfigurerat appen och den är redo att köras.

Kör och testa android-exempelmobilprogrammet

Följ dessa steg för att skapa och köra din app:

1. I verktygsfältet väljer du din app på menyn Kör konfigurationer.

2. I målenhetsmenyn väljer du den enhet som du vill köra appen på.

   Om du inte har konfigurerat några enheter måste du antingen skapa en virtuell Android-enhet för att använda Android-emulatorn eller ansluta en fysisk Android-enhet.

3. Välj knappen Kör. Appen öppnar skärmen E-post & OTP.

   

4. Ange en giltig e-postadress och välj sedan knappen Registrera dig. Appen öppnar skärmen skicka kod och du får en OTP-kod i e-postadressen.

   

5. Ange den OTP-kod som du får i inkorgen för e-post och välj Nästa. Om registreringen lyckas loggar appen in dig automatiskt. Om du inte får OTP-koden i inkorgen för e-post kan du skicka den igen efter en stund genom att välja Skicka lösenordigen.

6. Om du vill logga ut väljer du knappen Logga ut.

Andra scenarier som det här exemplet stöder

Den här exempelappen stöder också följande autentiseringsflöden:

• e-post + lösenord omfattar inloggnings- eller registreringsflöden med ett e-postmeddelande med lösenord.
• e-post + lösenordsregistrering med användarattribut omfattar registrering med e-post och lösenord och skicka användarattribut.
• Lösenordsåterställning omfattar självbetjänad lösenordsåterställning (SSPR).
• Åtkomstskyddat API omfattar anrop till ett skyddat API när användaren har registrerat sig eller loggat in och skaffat en åtkomsttoken.
• Återställning till webbläsare omfattar användningen av webbläsarbaserad autentisering som reservmekanism när användaren inte kan slutföra autentiseringen via intern autentisering av någon anledning.

Testa e-post med lösenordsflöde

I det här avsnittet testar du e-post med lösenordsflöde, med dess varianter som e-post med lösenordsregistrering med användarattribut och SSPR:

1. Använd stegen i skapa ett användarflöde för att skapa ett nytt användarflöde, men den här gången väljer du e-post med lösenord som autentiseringsmetod. Du måste konfigurera Country/Region och City som användarattribut. Du kan också ändra det befintliga användarflödet så att det använder e-post med lösenord (Välj externa identiteter>Användarflöden>SignInSignUpSample>Identitetsprovidrar>e-post med lösenord>Spara).

2. Följ stegen i associera programmet med det nya användarflödet för att lägga till en app i ditt nya användarflöde.

3. Kör exempelappen och välj sedan ellipsmenyn (...) för att öppna fler alternativ.

4. Välj det scenario som du vill testa, till exempel e-post + lösenord eller e-post + lösenordsregistrering med användarattribut eller Lösenordsåterställningoch följ sedan anvisningarna. Om du vill testa lösenordsåterställningmåste du först registrera en användare och aktivera e-post engångslösenkod för alla användare i klienten.

Testa anrop till ett skyddat API-flöde

Följ stegen i Anropa ett skyddat webb-API i en Android-exempelmobilapp med inbyggd autentisering för att anropa ett skyddat webb-API från en Android-exempelmobilapp.

Nästa steg