Konfigurowanie rejestracji i logowania przy użyciu identyfikatora mobilnego przy użyciu usługi Azure Active Directory B2C

Ważne

Od 1 maja 2025 r. usługa Azure AD B2C nie będzie już dostępna do zakupu dla nowych klientów. Dowiedz się więcej w naszych często zadawanych pytaniach.

Przed rozpoczęciem użyj selektora Wybierz typ zasad w górnej części tej strony, aby wybrać typ konfigurowanych zasad. Usługa Azure Active Directory B2C oferuje dwie metody definiowania sposobu interakcji użytkowników z aplikacjami: za pomocą wstępnie zdefiniowanych przepływów użytkowników lub w pełni konfigurowalnych zasad niestandardowych. Kroki wymagane w tym artykule są różne dla każdej metody.

Z tego artykułu dowiesz się, jak zapewnić klientom rejestrację i logowanie się przy użyciu identyfikatora mobilnego w aplikacjach przy użyciu usługi Azure Active Directory B2C (Azure AD B2C). Rozwiązanie Mobile ID chroni dostęp do danych i aplikacji firmowych za pomocą kompleksowego rozwiązania do silnego uwierzytelniania wieloskładnikowego (MFA). Dodajesz Identyfikator mobilny do przepływów użytkownika lub zasad niestandardowych przy użyciu protokołu OpenID Connect.

Wymagania wstępne

• Utwórz przepływ użytkownika, aby użytkownicy mogli zarejestrować się i zalogować do aplikacji.
• Rejestrowanie aplikacji internetowej.

• Wykonaj kroki opisane w Jak rozpocząć z zasadami niestandardowymi w usłudze Active Directory B2C. W tym samouczku przedstawiono sposób aktualizowania niestandardowych plików zasad, aby korzystać z konfiguracji kont usługi Azure AD B2C.
• Rejestrowanie aplikacji internetowej.

Tworzenie aplikacji identyfikatora mobilnego

Aby włączyć logowanie dla użytkowników z identyfikatorem mobilnym w usłudze Azure AD B2C, należy utworzyć aplikację. Aby utworzyć aplikację identyfikatora mobilnego, wykonaj następujące kroki:

1. Skontaktuj się z pomocą techniczną dotyczącą identyfikatora mobilnego.

2. Podaj identyfikator mobilny oraz informacje dotyczące dzierżawy usługi Azure AD B2C.

   Klawisz	Uwaga / Notatka
   URI przekierowania	https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp Podaj identyfikator URI. Jeśli używasz domeny niestandardowej, wprowadź.https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp Zastąp your-tenant-name nazwą dzierżawcy i your-domain-name domeną niestandardową.
   Metoda uwierzytelniania punktu końcowego tokenu	client_secret_post

3. Po zarejestrowaniu aplikacji następujące informacje będą udostępniane przez identyfikator aplikacji mobilnej. Te informacje służą do konfigurowania przepływu użytkownika lub zasad niestandardowych.

   Klawisz	Uwaga / Notatka
   ID klienta	Identyfikator klienta usługi Mobile ID. Na przykład 00001111-aaaa-2222-bbbb-3333cccc44444.
   Tajemnica klienta	Tajny klucz klienta Mobile ID.

Konfigurowanie identyfikatora mobilnego jako dostawcy tożsamości

1. Jeśli masz dostęp do wielu dzierżaw, wybierz ikonę Ustawienia w górnym menu, aby przełączyć się na dzierżawę Azure AD B2C z menu Katalogi + subskrypcje.

2. Wybierz pozycję Wszystkie usługi w lewym górnym rogu witryny Azure Portal, a następnie wyszukaj i wybierz pozycję Azure AD B2C.

3. Wybierz pozycję Dostawcy tożsamości, a następnie wybierz pozycję Nowy dostawca OpenID Connect.

4. W polu Nazwa wprowadź nazwę. Na przykład wprowadź identyfikator telefonu komórkowego.

5. W polu Adres URL metadanych wprowadź adres URL identyfikatora aplikacji mobilnej OpenId dobrze znanego punktu końcowego konfiguracji. Przykład:

   https://openid.mobileid.ch/.well-known/openid-configuration
   

6. W polu Identyfikator klienta wprowadź identyfikator klienta usługi Mobile ID.

7. W polu Klucz tajny klienta wprowadź klucz tajny klienta identyfikatora mobilnego.

8. W polu Zakres wprowadź openid, profile, phone, mid_profile.

9. Pozostaw wartości domyślne Typ odpowiedzi (code) i Tryb odpowiedzi (form_post).

10. (Opcjonalnie) W polu Wskazówka dotycząca domeny wprowadź wartość mobileid.ch. Aby uzyskać więcej informacji, zobacz Konfigurowanie logowania bezpośredniego przy użyciu usługi Azure Active Directory B2C.

11. W obszarze Mapowanie oświadczeń dostawcy tożsamości wybierz następujące oświadczenia:

    • Identyfikator użytkownika: sub
    • Nazwa wyświetlana: nazwa

12. Wybierz Zapisz.

Dodaj dostawcę tożsamości Mobilnego ID do przepływu użytkownika

Na tym etapie skonfigurowano dostawcę tożsamości Mobile ID, ale nie jest jeszcze dostępny na żadnej z stron logowania. Aby dodać dostawcę tożsamości Mobile ID do procesu użytkownika:

1. W dzierżawie Azure AD B2C wybierz opcję Przepływy użytkownika.
2. Wybierz przepływ użytkownika, do którego chcesz dodać dostawcę tożsamości Mobilny ID.
3. W obszarze Dostawcy tożsamości społecznościowych wybierz pozycję Identyfikator mobilny.
4. Wybierz Zapisz.
5. Aby przetestować politykę, wybierz pozycję Uruchom przepływ użytkownika.
6. W polu Aplikacja wybierz aplikację internetową o nazwie testapp1 , która została wcześniej zarejestrowana. Adres URL odpowiedzi powinien zawierać wartość https://jwt.ms.
7. Wybierz przycisk Uruchom przepływ użytkownika.
8. Na stronie rejestracji lub logowania wybierz pozycję Identyfikator mobilny , aby zalogować się przy użyciu identyfikatora mobilnego.

Jeśli proces logowania zakończy się pomyślnie, przeglądarka zostanie przekierowana do https://jwt.ms, gdzie wyświetlana jest zawartość tokenu zwróconego przez Azure AD B2C.

Tworzenie klucza zasad

Musisz przechowywać tajemnicę klienta otrzymaną z Mobile ID w dzierżawie usługi Azure AD B2C.

1. Zaloguj się do witryny Azure Portal.
2. Upewnij się, że używasz katalogu zawierającego tenant usługi Azure AD B2C. Wybierz filtr Katalog i subskrypcja w górnym menu i wybierz katalog zawierający dzierżawę.
3. Wybierz pozycję Wszystkie usługi w lewym górnym rogu witryny Azure Portal, a następnie wyszukaj i wybierz pozycję Azure AD B2C.
4. Na stronie Przegląd ogólny wybierz pozycję Identity Experience Framework.
5. Wybierz Klucze zasad, a następnie wybierz Dodaj.
6. W obszarze Opcje wybierz pozycję Manual.
7. Wprowadź nazwę klucza zasad. Na przykład Mobile IDSecret. Prefiks B2C_1A_ jest dodawany automatycznie do nazwy klucza.
8. W polu Wpis tajny wprowadź klucz tajny klienta identyfikatora mobilnego.
9. W obszarze Użycie klucza wybierz pozycję Signature.
10. Wybierz Utwórz.

Konfigurowanie identyfikatora mobilnego jako dostawcy tożsamości

Aby umożliwić użytkownikom logowanie się przy użyciu identyfikatora mobilnego, należy zdefiniować identyfikator mobilny jako dostawcę oświadczeń, z którym usługa Azure AD B2C może komunikować się za pośrednictwem punktu końcowego. Punkt końcowy udostępnia zestaw oświadczeń używanych przez usługę Azure AD B2C do sprawdzania, czy określony użytkownik został uwierzytelniony.

Identyfikator urządzenia przenośnego można zdefiniować jako dostawcę oświadczeń, dodając go do elementu ClaimsProviders w pliku rozszerzenia zasad.

1. Otwórz TrustFrameworkExtensions.xml.

2. Znajdź element ClaimsProviders . Jeśli nie istnieje, dodaj go pod elementem głównym.

3. Dodaj nowy element ClaimsProvider w następujący sposób:

   <ClaimsProvider>
   <Domain>mobileid.ch</Domain>
   <DisplayName>Mobile-ID</DisplayName>
   <TechnicalProfiles>
     <TechnicalProfile Id="MobileID-OAuth2">
     <DisplayName>Mobile-ID</DisplayName>
     <Protocol Name="OAuth2" />
     <Metadata>
       <Item Key="ProviderName">Mobile-ID</Item>
        <Item Key="authorization_endpoint">https://m.mobileid.ch/oidc/authorize</Item>
         <Item Key="AccessTokenEndpoint">https://openid.mobileid.ch/token</Item>
         <Item Key="ClaimsEndpoint">https://openid.mobileid.ch/userinfo</Item>
         <Item Key="scope">openid, profile, phone, mid_profile</Item>
         <Item Key="HttpBinding">POST</Item>
         <Item Key="UsePolicyInRedirectUri">false</Item>
         <Item Key="token_endpoint_auth_method">client_secret_post</Item>
         <Item Key="BearerTokenTransmissionMethod">AuthorizationHeader</Item>
         <Item Key="client_id">Your application ID</Item>
       </Metadata>
       <CryptographicKeys>
         <Key Id="client_secret" StorageReferenceId="B2C_1A_MobileIdSecret" />
       </CryptographicKeys>
       <OutputClaims>
         <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="sub"/>
         <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name"/>
         <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="mobileid.ch" />
         <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
       </OutputClaims>
       <OutputClaimsTransformations>
         <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
         <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
         <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
         <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" />
       </OutputClaimsTransformations>
       <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
       </TechnicalProfile>
     </TechnicalProfiles>
   </ClaimsProvider>
   

4. Ustaw client_id na identyfikator klienta Mobile ID.

5. Zapisz plik.

Dodanie ścieżki użytkownika

W tym momencie dostawca tożsamości został skonfigurowany, ale nie jest jeszcze dostępny na żadnej ze stron logowania. Jeśli nie masz własnej niestandardowej podróży użytkownika, utwórz duplikat szablonu podróży użytkownika, inaczej przejdź do następnego kroku.

1. Otwórz plik TrustFrameworkBase.xml z pakietu startowego.
2. Znajdź i skopiuj całą zawartość elementu UserJourney , który zawiera Id="SignUpOrSignIn"element .
3. Otwórz TrustFrameworkExtensions.xml i znajdź element UserJourneys . Jeśli element nie istnieje, dodaj go.
4. Wklej całą zawartość elementu UserJourney skopiowaną jako element podrzędny elementu UserJourneys .
5. Zmień identyfikator podróży użytkownika. Na przykład Id="CustomSignUpSignIn".

Dodaj dostawcę tożsamości do podróży użytkownika

Teraz, gdy masz ścieżkę użytkownika, dodaj nowego dostawcę tożsamości do tej ścieżki. Najpierw dodaj przycisk logowania, a następnie połącz przycisk z akcją. Akcja to utworzony wcześniej profil techniczny.

1. Znajdź element kroku aranżacji, który zawiera Type="CombinedSignInAndSignUp" lub Type="ClaimsProviderSelection" w ścieżce użytkownika. Zazwyczaj jest to pierwszy krok aranżacji. Element ClaimsProviderSelections zawiera listę dostawców tożsamości, za pomocą których użytkownik może się zalogować. Kolejność elementów kontroluje kolejność przycisków logowania przedstawionych użytkownikowi. Dodaj element XML ClaimsProviderSelection. Ustaw wartość TargetClaimsExchangeId na przyjazną nazwę.

2. W następnym kroku aranżacji dodaj element ClaimsExchange . Ustaw Id na wartość identyfikatora wymiany oświadczeń dla celu. Zaktualizuj wartość TechnicalProfileReferenceId na Id profilu technicznego utworzonego wcześniej.

Poniższy kod XML przedstawia dwa pierwsze kroki orkiestracji podróży użytkownika z dostawcą tożsamości:

<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
  <ClaimsProviderSelections>
    ...
    <ClaimsProviderSelection TargetClaimsExchangeId="MobileIDExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="MobileIDExchange" TechnicalProfileReferenceId="MobileID-OAuth2" />
  </ClaimsExchanges>
</OrchestrationStep>

Konfigurowanie polityki podmiotu polegającego

Polityka zaufanej strony, na przykład SignUpSignIn.xml, określa podróż użytkownika, którą zrealizuje Azure AD B2C. Znajdź element DefaultUserJourney w stronie zaufanej. Zaktualizuj identyfikator ReferenceId , aby był zgodny z identyfikatorem podróży użytkownika, w którym dodano dostawcę tożsamości.

W poniższym przykładzie dla ścieżki użytkownika CustomSignUpSignIn identyfikator ReferenceId jest ustawiony na:CustomSignUpSignIn

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

Przekaż zasady niestandardowe

1. Zaloguj się do witryny Azure Portal.
2. Wybierz ikonę Katalog i subskrypcja na pasku narzędzi portalu, a następnie wybierz katalog zawierający dzierżawę usługi Azure AD B2C.
3. W witrynie Azure Portal wyszukaj i wybierz pozycję Azure AD B2C.
4. W obszarze Policieswybierz pozycję Identity Experience Framework.
5. Wybierz Załaduj zasady niestandardowe, a następnie załaduj dwa zmienione pliki zasad w następującej kolejności: zasady rozszerzenia, na przykład TrustFrameworkExtensions.xml, a następnie zasady strony zależnej, takie jak SignUpSignIn.xml.

Przetestuj swoje zasady niestandardowe

1. Wybierz zasady zaufanej strony, na przykład B2C_1A_signup_signin.
2. W polu Aplikacja wybierz wcześniej zarejestrowaną aplikację internetową. Adres URL odpowiedzi powinien zawierać wartość https://jwt.ms.
3. Wybierz przycisk Uruchom teraz .
4. Na stronie rejestracji lub logowania wybierz pozycję Identyfikator mobilny , aby zalogować się przy użyciu identyfikatora mobilnego.

Jeśli proces logowania zakończy się pomyślnie, przeglądarka zostanie przekierowana do https://jwt.ms, gdzie wyświetlana jest zawartość tokenu zwróconego przez Azure AD B2C.

Dalsze kroki

Dowiedz się, jak przekazać token identyfikatora mobilnego do aplikacji.