Quickstart: Gebruikers aanmelden en een web-API aanroepen in een voorbeeld van een mobiele app

Van toepassing op: Externe tenants (meer informatie)

Voordat u begint, gebruikt u de Kies een tenanttype selector bovenaan deze pagina om het tenanttype te selecteren. Microsoft Entra ID biedt twee tenantconfiguraties, werknemers en externe. Een tenantconfiguratie voor werknemers is bedoeld voor uw werknemers, interne apps en andere organisatieresources. Een externe tenant is bedoeld voor uw klantgerichte apps.

Deze handleiding laat zien hoe u een voorbeeld van een mobiele toepassing configureert om gebruikers aan te melden en een ASP.NET Core-web-API aan te roepen.

Android

In dit artikel voert u de volgende taken uit:

• Voeg een omleidings-URL voor een platform toe aan een webtoepassing.
• Schakel openbare clientstromen in.
• Werk het voorbeeldbestand van de Android-configuratiecode bij om uw eigen externe Microsoft Entra-id te gebruiken voor tenantgegevens van de klant.
• Voer de mobiele Android-voorbeeldtoepassing uit en test deze.
• Een beveiligde web-API aanroepen.

iOS/macOS

In dit artikel voert u de volgende taken uit:

• Voeg een omleidings-URL voor een platform toe aan een webtoepassing.
• Schakel openbare clientstromen in voor een toepassing.
• Werk het voorbeeldbestand voor de iOS-configuratiecode bij om uw eigen externe Microsoft Entra-id te gebruiken voor tenantgegevens van de klant.
• Voer de mobiele iOS-voorbeeldtoepassing uit en test deze.

Vereiste voorwaarden

Android

• Android Studio.

• Een externe tenant. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis proefversie.

• Registreer een nieuwe clientweb-app in het Microsoft Entra-beheercentrum, geconfigureerd voor accounts in elke organisatiedirectory en persoonlijke Microsoft-accounts. Raadpleeg Een applicatie registreren voor meer details. Noteer de volgende waarden op de pagina Overzicht van de toepassing voor later gebruik:

  • Applicatie (client) ID
  • ID van de directory (tenant)

• Een web-API-registratie die ten minste één bereik (gedelegeerde machtigingen) en één app-rol (toepassingsmachtiging) beschikbaar maakt, zoals ToDoList.Read. Als u dat nog niet hebt gedaan, volgt u de instructies voor een API aanroepen in een mobiele Android-voorbeeld-app om een functionele beveiligde ASP.NET Core-web-API te hebben. Zorg ervoor dat u de volgende stappen uitvoert:

  • API-bereiken configureren
  • App-rollen configureren
  • Optionele claims instellen
  • Voorbeeldweb-API klonen of downloaden
  • Voorbeeldweb-API configureren en uitvoeren

iOS/macOS

• Xcode.

• Een externe tenant. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis proefversie.

• Registreer een nieuwe clientweb-app in het Microsoft Entra-beheercentrum, geconfigureerd voor accounts in elke organisatiedirectory en persoonlijke Microsoft-accounts. Raadpleeg Een applicatie registreren voor meer details. Noteer de volgende waarden op de pagina Overzicht van de toepassing voor later gebruik:

  • Applicatie (client) ID
  • Directory-id (tenant)*

• Een API-registratie die ten minste één bereik (gedelegeerde machtigingen) en één app-rol (toepassingsmachtiging) beschikbaar maakt, zoals ToDoList.Read. Als u dat nog niet hebt gedaan, volgt u de instructies voor een API aanroepen in een mobiele iOS-voorbeeld-app om een functionele beveiligde ASP.NET Core-web-API te hebben. Zorg ervoor dat u de volgende stappen uitvoert:

  • API-bereiken configureren.
  • App-rollen configureren.
  • Configureer optionele claims.
  • Kloon ofwel download voorbeeld web-API.
  • Configureer en voer voorbeeldweb-API uit.

Een omleidings-URL voor het platform toevoegen

Android

Voer de volgende stappen uit om uw app-type op te geven voor uw app-registratie:

1. Onder Beheren, selecteer Verificatie.
2. Selecteer op de pagina Platformconfiguraties de optie Een platform toevoegen en selecteer vervolgens de optie Android.
3. Voer de pakketnaam van het project in. Als u de voorbeeldcode hebt gedownload, is com.azuresamples.msaldelegatedandroidkotlinsampleappdeze waarde.
4. Selecteer in de sectie Handtekening-hash van het deelvenster Uw Android-app configureren de optie Een hash voor de ontwikkelingshandtekening genereren. Dit verandert voor elke ontwikkelomgeving. Kopieer en voer de KeyTool-opdracht uit voor uw besturingssysteem in uw Terminal.
5. Voer de handtekening-hash in die is gegenereerd door KeyTool.
6. Selecteer Configureren.
7. Kopieer de MSAL-configuratie vanuit het deelvenster Android-configuratie en sla deze op voor latere app-configuratie.
8. Kies Gereed.

iOS/macOS

Voer de volgende stappen uit om uw app-type op te geven voor uw app-registratie:

1. Onder Beheren, selecteer Verificatie.
2. Selecteer op de pagina Platformconfiguratieseen platform toevoegen en selecteer vervolgens de optie iOS/macOS .
3. Voer de bundel-id van het project in. Als u de voorbeeldcode hebt gedownload, is com.microsoft.identitysample.ciam.MSALiOSdeze waarde.
4. Selecteer Configureren en sla de MSAL-configuratie op die wordt weergegeven in het configuratievenster iOS/macOS , zodat u deze kunt invoeren wanneer u de app later configureert.
5. Kies Gereed.

Openbare clientstroom inschakelen

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

1. Onder Beheren, selecteer Verificatie.

2. Selecteer Ja onder Geavanceerde instellingen voor openbare clientstromen toestaan.

3. Selecteer Opslaan om uw wijzigingen op te slaan.

Web-API-machtigingen verlenen aan de voorbeeld-app

Nadat u zowel uw client-app als web-API hebt geregistreerd en de API hebt blootgesteld door scopes te maken, kunt u de machtigingen van de client voor de API configureren door de volgende stappen uit te voeren:

1. Selecteer op de pagina App-registraties de toepassing die u hebt gemaakt (zoals ciam-client-app) om de overzichtspagina te openen.

2. Selecteer onder Beheren de optie API-machtigingen.

3. Selecteer onder Geconfigureerde machtigingen de optie Een machtiging toevoegen.

4. Selecteer de API's die door mijn organisatie worden gebruikt .

5. Selecteer in de lijst met API's de API, zoals ciam-ToDoList-api.

6. Selecteer de optie Gedelegeerde machtigingen .

7. Selecteer in de lijst met machtigingen ToDoList.Read, ToDoList.ReadWrite (gebruik indien nodig het zoekvak).

8. Selecteer de knop Toestemmingen toevoegen.

9. Op dit moment hebt u de machtigingen correct toegewezen. Omdat de tenant echter de tenant van een klant is, kunnen de consumentengebruikers zelf geen toestemming geven voor deze machtigingen. Om dit te verhelpen, moet u als beheerder toestemming geven voor deze machtigingen namens alle gebruikers in de tenant:

   1. Selecteer Verleen beheerderstoestemming voor <uw tenantnaam>, selecteer vervolgens Ja.

   2. Selecteer Vernieuwen en controleer vervolgens of Verleend voor <uw tenantnaam> wordt weergegeven onder Status voor beide machtigingen.

10. Selecteer in de lijst Geconfigureerde machtigingen de machtigingen ToDoList.Read en ToDoList.ReadWrite , één voor één en kopieer de volledige URI van de machtiging voor later gebruik. De volledige machtigings-URI ziet er ongeveer uit als api://{clientId}/{ToDoList.Read} of api://{clientId}/{ToDoList.ReadWrite}.

Mobiele voorbeeldapplicatie klonen

Android

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-browser-delegated-android-sample
  

iOS/macOS

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-browser-delegated-ios-sample.git
  

De mobiele Android-voorbeeldtoepassing configureren

Android

Als u verificatie en toegang tot web-API-resources wilt inschakelen, configureert u het voorbeeld door de volgende stappen uit te voeren:

1. Open in Android Studio het project dat u hebt gekloond.

2. Open het /app/src/main/res/raw/auth_config_ciam.json bestand.

3. Vind de invultekst:

   • Enter_the_Application_Id_Here en vervang deze door de Application-id (client)-id van de app die u eerder hebt geregistreerd.
   • Enter_the_Redirect_Uri_Here en vervang deze door de waarde van redirect_uri in het MSAL-configuratiebestand (Microsoft Authentication Library) dat u eerder hebt gedownload toen u de omleidings-URL van het platform toevoegde.
   • 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 tenant-subdomein niet weet, leer dan hoe u uw tenantgegevens kunt lezen.

4. Openen /app/src/main/AndroidManifest.xml bestand.

5. Vind de invultekst:

   • ENTER_YOUR_SIGNATURE_HASH_HERE en vervang deze door de handtekening-hash die u eerder hebt gegenereerd toen u de omleidings-URL van het platform toevoegde.

6. Openen /app/src/main/java/com/azuresamples/msaldelegatedandroidkotlinsampleapp/MainActivity.kt-bestand.

7. Zoek de eigenschap met de naam WEB_API_BASE_URL en stel de URL in op uw web-API.

8. Zoek de eigenschap met de naam scopes en stel de bereiken in die zijn vastgelegd in Machtigingen voor web-API verlenen aan de Android-voorbeeld-app.

   private const val scopes = "" // Developers should set the respective scopes of their web API here. For example, private const val scopes = "api://{clientId}/{ToDoList.Read} api://{clientId}/{ToDoList.ReadWrite}"
   

U hebt de app geconfigureerd en deze kan worden uitgevoerd.

iOS/macOS

Als u verificatie en toegang tot web-API-resources wilt inschakelen, configureert u het voorbeeld door de volgende stappen uit te voeren:

1. Open in Xcode het project dat u hebt gekloond.

2. Open het bestand /MSALiOS/Configuration.swift .

3. Vind de invultekst:

   • Enter_the_Application_Id_Here en vervang deze door de Application-id (client)-id van de app die u eerder hebt geregistreerd.
   • Enter_the_Redirect_URI_Here en vervang deze door de waarde van kRedirectUri in het MSAL-configuratiebestand (Microsoft Authentication Library) dat u eerder hebt gedownload toen u de omleidings-URL van het platform hebt toegevoegd.
   • Enter_the_Protected_API_Full_URL_Here en vervang deze door de URL naar uw web-API. De Enter_the_Protected_API_Full_URL_Here moet de basis-URL (de geïmplementeerde WEB-API-URL) en het eindpunt (/api/todolist) voor onze ASP.NET web-API bevatten.
   • Enter_the_Protected_API_Scopes_Here en vervang deze door de scopes die zijn vastgelegd in Web-API-machtigingen verlenen aan de iOS-voorbeeld-app.
   • 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 tenant-subdomein niet weet, leer dan hoe u uw tenantgegevens kunt lezen.

U hebt de app geconfigureerd en deze kan worden uitgevoerd.

Voorbeeld-app uitvoeren en web-API aanroepen

Android

Voer de volgende stappen uit om uw app te bouwen en uit te voeren:

1. Selecteer uw app in het menu Configuraties uitvoeren in de werkbalk.

2. Selecteer in het menu van het doelapparaat het apparaat waarop u de app wilt uitvoeren.

   Als u geen apparaten hebt geconfigureerd, moet u een virtueel Android-apparaat maken om de Android Emulator te gebruiken of een fysiek Android-apparaat te verbinden.

3. Druk op de knop Uitvoeren.

4. Selecteer Token interactief verkrijgen om een toegangstoken aan te vragen.

5. Selecteer API: VOER GET uit om de eerder ingestelde ASP.NET Core-web-API aan te roepen. Een geslaagde aanroep van de web-API retourneert HTTP 200, terwijl HTTP 403 onbevoegde toegang aantekent.

iOS/macOS

Voer de volgende stappen uit om uw app te bouwen en uit te voeren:

1. Als u uw code wilt bouwen en uitvoeren, selecteert u Uitvoeren in het menu Product in Xcode. Na een geslaagde build start Xcode de voorbeeld-app in de simulator.
2. Selecteer Token interactief verkrijgen om een toegangstoken aan te vragen.
3. Selecteer API: VOER GET uit om de eerder ingestelde ASP.NET Core-web-API aan te roepen. Een geslaagde aanroep van de web-API retourneert HTTP-200, terwijl HTTP-403 onbevoegde toegang aantekent.

Verwante inhoud

Android

• Gebruikers inloggen in een voorbeeld mobiele Android-app (Kotlin) door gebruik te maken van systeemeigen authenticatie.
• wachtwoord opnieuw instellen inschakelen.
• Het standaardmerk aanpassen.
• Aanmelding configureren met Google.

iOS/macOS

• Meld gebruikers aan in het voorbeeld van een iOS-app (Swift) door gebruik te maken van native authenticatie.
• wachtwoord opnieuw instellen inschakelen.
• Het standaardmerk aanpassen.
• Aanmelding configureren met Google.