Share via


Gebruikers aanmelden in een voorbeeld van een mobiele iOS-app (Swift) met behulp van systeemeigen verificatie

In deze handleiding ziet u hoe u een iOS-voorbeeldtoepassing uitvoert die registratie-, aanmeldings-, afmeldings- en wachtwoordscenario's laat zien met behulp van Microsoft Entra Externe ID.

In dit artikel leert u het volgende:

  • Registreer de toepassing in de externe tenant.
  • Schakel openbare client- en systeemeigen verificatiestromen in.
  • Maak een gebruikersstroom in de externe tenant.
  • Koppel uw toepassing aan de gebruikersstroom.
  • Werk een voorbeeld van een systeemeigen mobiele iOS-toepassing bij om uw eigen externe tenantgegevens te gebruiken.
  • Voer de voorbeeldeigen mobiele iOS-toepassing uit en test deze.

Vereisten

Een toepassing registreren

Als u wilt dat uw toepassing gebruikers kan aanmelden met Microsoft Entra, moet Microsoft Entra Externe ID op de hoogte worden gesteld van de toepassing die u maakt. De app-registratie brengt een vertrouwensrelatie tot stand tussen de app en Microsoft Entra. Wanneer u een toepassing registreert, genereert externe id een unieke id die bekend staat als een toepassings-id (client), een waarde die wordt gebruikt om uw app te identificeren bij het maken van verificatieaanvragen.

De volgende stappen laten zien hoe u uw app registreert in het Microsoft Entra-beheercentrum:

  1. Meld u als toepassingsontwikkelaar aan bij het Microsoft Entra-beheercentrum.

  2. Als u toegang hebt tot meerdere tenants, gebruikt u het pictogram Instellingen in het bovenste menu om vanuit het menu Mappen en abonnementen over te schakelen naar uw externe tenant.

  3. Blader naar identiteitstoepassingen>> App-registraties.

  4. Selecteer + Nieuwe registratie.

  5. Op de pagina Een toepassing registreren die wordt weergegeven;

    1. Voer een betekenisvolle toepassingsnaam in die wordt weergegeven aan gebruikers van de app, bijvoorbeeld ciam-client-app.
    2. Onder Ondersteunde accounttypen selecteert u Enkel accounts in deze organisatieadreslijst.
  6. Selecteer Registreren.

  7. Het deelvenster Overzicht van de toepassing wordt weergegeven bij een geslaagde registratie. Noteer de toepassings-id (client) die moet worden gebruikt in de broncode van uw toepassing.

Openbare client- en systeemeigen verificatiestromen inschakelen

Als u wilt opgeven dat deze app een openbare client is en systeemeigen verificatie kan gebruiken, schakelt u openbare client- en systeemeigen verificatiestromen in:

  1. Selecteer op de pagina app-registraties de app-registratie waarvoor u openbare client- en systeemeigen verificatiestromen wilt inschakelen.
  2. Selecteer Verificatie onder Beheren.
  3. Sta onder Geavanceerde instellingen openbare clientstromen toe:
    1. Selecteer Ja als u de volgende mobiele en bureaubladstromen wilt inschakelen.
    2. Selecteer Ja voor Systeemeigen verificatie inschakelen.
  4. Selecteer de knop Opslaan .
  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. In de lijst met geconfigureerde machtigingen is aan uw toepassing de machtiging User.Read toegewezen. Omdat de tenant echter een externe tenant is, kunnen de consumentengebruikers zelf geen toestemming geven voor deze machtiging. U als beheerder moet toestemming geven voor deze machtiging namens alle gebruikers in de tenant:

    1. Selecteer Beheerderstoestemming verlenen voor <uw tenantnaam> en selecteer Vervolgens Ja.
    2. Selecteer Vernieuwen en controleer vervolgens of Verleend voor <uw tenantnaam> wordt weergegeven onder Status voor beide bereiken.

Een gebruikersstroom maken

Volg deze stappen om een gebruikersstroom te maken.

  1. Meld u als toepassingsontwikkelaar aan bij het Microsoft Entra-beheercentrum.

  2. Als u toegang hebt tot meerdere tenants, moet u ervoor zorgen dat u de map gebruikt die uw externe tenant bevat:

    1. Selecteer het pictogram Mappen en abonnementen op de werkbalk.
    2. In de portalinstellingen | Pagina Mappen en abonnementen , zoek uw externe tenantmap in de lijst met directorynamen en selecteer vervolgens Schakelen.
  3. Selecteer Identiteit in het zijbalkmenu.

  4. Selecteer Gebruikersstromen voor externe identiteiten>.

  5. Selecteer + Nieuwe gebruikersstroom.

  6. Op de pagina Maken :

    1. Voer een naam in voor de gebruikersstroom, zoals SignInSignUpSample.

    2. Selecteer E-mailaccounts in de lijst met id-providers. Met deze id-provider kunnen gebruikers zich aanmelden of registreren met hun e-mailadres.

    3. Onder E-mailaccounts kunt u een van de twee opties selecteren. Voor deze zelfstudie selecteert u Eenmalige wachtwoordcode voor e-mail.

      • E-mail met wachtwoord: hiermee kunnen nieuwe gebruikers zich registreren en aanmelden met een e-mailadres als de aanmeldingsnaam en een wachtwoord als hun eerste factorreferentie.
      • Eenmalige wachtwoordcode per e-mail verzenden: hiermee kunnen nieuwe gebruikers zich registreren en aanmelden met een e-mailadres als de aanmeldingsnaam en eenmalige wachtwoordcode e-mailen als hun eerste factorreferentie. Als u deze optie beschikbaar wilt maken op gebruikersstroomniveau, moet u eenmalige wachtwoordcode (OTP) voor e-mail inschakelen op tenantniveau (selecteer Alle id-providers en selecteer vervolgens voor Eenmalige wachtwoordcode voor e-mail geconfigureerd, selecteer De optie Ja en vervolgens Opslaan).
    4. Onder Gebruikerskenmerken kunt u de kenmerken kiezen die u wilt verzamelen van de gebruiker bij het aanmelden. Voor deze handleiding selecteert u Land/Regio en Plaats.

  7. Selecteer Maken. De nieuwe gebruikersstroom wordt weergegeven in de lijst gebruikersstromen . Vernieuw de pagina indien nodig.

De toepassing koppelen aan de gebruikersstroom

Hoewel veel toepassingen aan uw gebruikersstroom kunnen worden gekoppeld, kan één toepassing slechts worden gekoppeld aan één gebruikersstroom. Met een gebruikersstroom kan de gebruikerservaring voor specifieke toepassingen worden geconfigureerd. U kunt bijvoorbeeld een gebruikersstroom configureren waarvoor gebruikers zich moeten aanmelden of zich moeten aanmelden met een e-mailadres.

  1. Selecteer Identiteit in het zijbalkmenu.

  2. Selecteer Externe identiteiten en vervolgens Gebruikersstromen.

  3. Selecteer op de pagina Gebruikersstromen de naam van de gebruikersstroom die u eerder hebt gemaakt, bijvoorbeeld SignInSignUpSample.

  4. Selecteer Toepassingen onder Gebruiken.

  5. Selecteer Toepassing toevoegen.

  6. Selecteer de toepassing in de lijst, zoals ciam-client-app of gebruik het zoekvak om de toepassing te zoeken en selecteer deze.

  7. Kies Selecteren.

Voorbeeld van mobiele iOS-toepassing klonen

  1. Open Terminal en navigeer naar een map waarin u de code wilt behouden.

  2. Kloon de mobiele iOS-toepassing vanuit GitHub door de volgende opdracht uit te voeren:

    git clone https://github.com/Azure-Samples/ms-identity-ciam-native-auth-ios-sample.git
    
  3. Navigeer naar de map waarin de opslagplaats is gekloond:

    cd ms-identity-ciam-native-auth-ios-sample
    

De mobiele voorbeeldtoepassing voor iOS configureren

  1. Open in Xcode het project NativeAuthSampleApp.xcodeproj .

  2. Open het bestand NativeAuthSampleApp/Configuration.swift .

  3. Zoek de tijdelijke aanduiding:

    • Enter_the_Application_Id_Here en vervang deze door de toepassings-id (client) van de app die u eerder hebt geregistreerd.
    • Enter_the_Tenant_Subdomain_Here en vervang het door het subdomein Directory (tenant). Als uw primaire tenantdomein bijvoorbeeld is contoso.onmicrosoft.com, gebruikt u contoso. Als u uw tenantsubdomein niet hebt, leest u de details van uw tenant.

Notitie

Vergeet niet om een schema te selecteren voor het bouwen en doel waar u de gebouwde producten uitvoert. Elk schema bevat een lijst met echte of gesimuleerde apparaten die de beschikbare bestemmingen vertegenwoordigen.

Mobiele iOS-voorbeeldtoepassing uitvoeren en testen

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.

Schermopname van de gebruikersprompt om e-mail in te voeren in de iOS-app.

In deze handleiding wordt het gebruik van eenmalige wachtwoordcodes getest. Voer een geldig e-mailadres in, selecteer Registreren en start het scherm voor verzenden van code:

Schermopname van de gebruikersprompt om eenmalige wachtwoordcode (OTP) in de iOS-app in te voeren.

Nadat u uw e-mailadres op het vorige scherm hebt ingevoerd, stuurt de toepassing er een verificatiecode naartoe. Zodra u de ontvangen code hebt ingediend, gaat de toepassing terug naar het vorige scherm en meldt u zich automatisch aan.

Andere scenario's die in dit voorbeeld worden ondersteund

De voorbeeld-app ondersteunt de volgende stromen:

  • E-mail en wachtwoord hebben betrekking op aanmeldings- of registratiestromen met een e-mailbericht met een wachtwoord.
  • E-mail en wachtwoordaanmelding met gebruikerskenmerken hebben betrekking op registratie met e-mail en wachtwoord en het verzenden van gebruikerskenmerken.
  • Wachtwoordherstel omvat selfservice voor wachtwoordherstel (SSPR).
  • Met de beveiligde API van Access wordt een beveiligde API aangeroepen nadat de gebruiker zich heeft geregistreerd of zich heeft aangemeld en een toegangstoken heeft verkregen.
  • Terugval naar webbrowser omvat het gebruik van verificatie op basis van een browser als een terugvalmechanisme wanneer de gebruiker om welke reden dan ook geen verificatie kan voltooien via systeemeigen verificatie.

E-mail testen met wachtwoordstroom

In deze sectie test u e-mail met wachtwoordstroom, met de varianten zoals e-mail met wachtwoordaanmelding met gebruikerskenmerken en SSPR:

  1. Gebruik de stappen in het maken van een gebruikersstroom om een nieuwe gebruikersstroom te maken, maar selecteer deze keer e-mail met wachtwoord als verificatiemethode. U moet Land/regio en Plaats configureren als de gebruikerskenmerken. U kunt ook de bestaande gebruikersstroom wijzigen om e-mail met een wachtwoord te gebruiken (selecteer e-mail van gebruikersstromen>voor externe identiteiten>signInSignUpSample>>met wachtwoord>opslaan).

  2. Gebruik de stappen om de toepassing te koppelen aan de nieuwe gebruikersstroom om een app toe te voegen aan uw nieuwe gebruikersstroom.

  3. Voer de voorbeeld-app uit en selecteer vervolgens het beletseltekenmenu (...) om meer opties te openen.

  4. Selecteer het scenario dat u wilt testen, zoals e-mail en wachtwoord of e-mail en wachtwoordaanmelding met gebruikerskenmerken of wachtwoordherstel. Volg vervolgens de aanwijzingen. Als u wachtwoordherstel wilt testen, moet u zich eerst registreren voor een gebruiker en eenmalige wachtwoordcode voor alle gebruikers in uw tenant inschakelen.

Een beveiligde API-stroom aanroepen

Gebruik de stappen in Het aanroepen van een beveiligde web-API in een voorbeeld van een mobiele iOS-app met behulp van systeemeigen verificatie om een beveiligde web-API aan te roepen vanuit een mobiele Android-voorbeeld-app.

Volgende stappen