Konfigurowanie rejestracji i logowania przy użyciu konta w usłudze Twitter - Azure AD B2C

Artykuł
11/08/2023

Przed rozpoczęciem użyj selektora Wybierz typ zasad, 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.

Uwaga

W usłudze Azure Active Directory B2C zasady niestandardowe są przeznaczone głównie do rozwiązywania złożonych scenariuszy. W przypadku większości scenariuszy zalecamy używanie wbudowanych przepływów użytkownika. Jeśli nie zostało to zrobione, dowiedz się więcej o niestandardowym pakiecie startowym zasad w temacie Wprowadzenie do zasad niestandardowych w usłudze Active Directory B2C.

Wymagania wstępne

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

Wykonaj kroki opisane w artykule Wprowadzenie do zasad niestandardowych w usłudze Active Directory B2C
Rejestrowanie aplikacji internetowej.

Tworzenie aplikacji

Aby włączyć logowanie dla użytkowników przy użyciu konta usługi Twitter w usłudze Azure AD B2C, musisz utworzyć aplikację usługi Twitter. Jeśli nie masz jeszcze konta w serwisie Twitter, możesz zarejestrować się pod adresem https://twitter.com/signup. Musisz również ubiegać się o konto dewelopera. Aby uzyskać więcej informacji, zobacz Apply for access (Stosowanie w celu uzyskania dostępu).

Zaloguj się do portalu deweloperów usługi Twitter przy użyciu poświadczeń konta w usłudze Twitter.
Wybierz przycisk + Utwórz projekt .
Na karcie Nazwa projektu wprowadź preferowaną nazwę projektu, a następnie wybierz przycisk Dalej .
Na karcie Przypadek użycia wybierz preferowany przypadek użycia, a następnie wybierz przycisk Dalej.
Na karcie Opis projektu wprowadź opis projektu, a następnie wybierz przycisk Dalej .
Na karcie Nazwa aplikacji wprowadź nazwę aplikacji, taką jak azureadb2c, a następnie wybierz przycisk Dalej .
Na karcie Tokeny kluczy & skopiuj wartość klucza interfejsu API i klucza interfejsu API Key. Będą one używane do późniejszej konfiguracji.
Wybierz pozycję Ustawienia aplikacji, aby otworzyć ustawienia aplikacji.
W dolnej części strony w obszarze Ustawienia uwierzytelniania użytkownika wybierz pozycję Skonfiguruj.
W obszarze Typ aplikacji wybierz odpowiedni typ aplikacji, taki jak Aplikacja internetowa.
W obszarze Informacje o aplikacji:
1. W polu Identyfikator URI/Adres URL przekierowania wywołania zwrotnego wprowadź wartość https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/your-policy-id/oauth1/authresp. Jeśli używasz domeny niestandardowej, wprowadź .https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp Użyj wszystkich małych liter podczas wprowadzania nazwy dzierżawy i identyfikatora przepływu użytkownika, nawet jeśli są one zdefiniowane z wielkimi literami w usłudze Azure AD B2C. Zastąpić:
  - your-tenant-name z nazwą swojej dzierżawy.
  - your-domain-name z domeną niestandardową.
  - your-policy-id z identyfikatorem przepływu użytkownika. Na przykład b2c_1a_signup_signin_twitter.
2. W polu Adres URL witryny internetowej wprowadź .https://your-tenant.b2clogin.com Zastąp your-tenant ciąg nazwą dzierżawy. Na przykład https://contosob2c.b2clogin.com. Jeśli używasz domeny niestandardowej, wprowadź .https://your-domain-name
3. (Opcjonalnie) Wprowadź adres URL warunków użytkowania usługi, na przykład http://www.contoso.com/tos. Adres URL zasad to strona, którą utrzymujesz, aby podać warunki i postanowienia aplikacji.
4. (Opcjonalnie) Wprowadź adres URL zasad ochrony prywatności, na przykład http://www.contoso.com/privacy. Adres URL zasad to strona, którą utrzymujesz, aby zapewnić informacje o ochronie prywatności aplikacji.
Wybierz pozycję Zapisz.

Zaloguj się do portalu deweloperów usługi Twitter przy użyciu poświadczeń konta w usłudze Twitter.
Wybierz przycisk + Utwórz projekt .
Na karcie Nazwa projektu wprowadź preferowaną nazwę projektu, a następnie wybierz przycisk Dalej .
Na karcie Przypadek użycia wybierz preferowany przypadek użycia, a następnie wybierz przycisk Dalej.
Na karcie Opis projektu wprowadź opis projektu, a następnie wybierz przycisk Dalej .
Na karcie Nazwa aplikacji wprowadź nazwę aplikacji, taką jak azureadb2c, a następnie wybierz przycisk Dalej .
Na karcie Tokeny kluczy & skopiuj wartość klucza interfejsu API i klucza interfejsu API Key w celu późniejszego użycia. Oba te elementy służą do konfigurowania usługi Twitter jako dostawcy tożsamości w dzierżawie usługi Azure AD B2C.
Wybierz pozycję Ustawienia aplikacji, aby otworzyć ustawienia aplikacji.
W dolnej części strony w obszarze Ustawienia uwierzytelniania użytkownika wybierz pozycję Skonfiguruj.
W obszarze Typ aplikacji wybierz odpowiedni typ aplikacji, taki jak Aplikacja internetowa.
W obszarze Informacje o aplikacji:
1. W polu Identyfikator URI/Adres URL przekierowania wywołania zwrotnego wprowadź wartość https://your-tenant.b2clogin.com/your-tenant-name.onmicrosoft.com/your-user-flow-name/oauth1/authresp. Jeśli używasz domeny niestandardowej, wprowadź .https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp Użyj wszystkich małych liter podczas wprowadzania nazwy dzierżawy i identyfikatora przepływu użytkownika, nawet jeśli są one zdefiniowane z wielkimi literami w usłudze Azure AD B2C. Zastąpić:
  - your-tenant-name z nazwą swojej dzierżawy.
  - your-domain-name z domeną niestandardową.
  - your-user-flow-name z identyfikatorem przepływu użytkownika. Na przykład b2c_1_signup_signin_twitter.
2. W polu Adres URL witryny internetowej wprowadź .https://your-tenant.b2clogin.com Zastąp your-tenant ciąg nazwą dzierżawy. Na przykład https://contosob2c.b2clogin.com. Jeśli używasz domeny niestandardowej, wprowadź .https://your-domain-name
3. Wprowadź adres URL warunków użytkowania usługi, na przykład http://www.contoso.com/tos. Adres URL zasad to strona, którą utrzymujesz, aby podać warunki i postanowienia aplikacji.
4. Wprowadź adres URL zasad ochrony prywatności, na przykład http://www.contoso.com/privacy. Adres URL zasad to strona, którą utrzymujesz, aby zapewnić informacje o ochronie prywatności aplikacji.
Wybierz pozycję Zapisz.

Konfigurowanie usługi Twitter jako dostawcy tożsamości

Zaloguj się w witrynie Azure Portal jako administrator globalny dzierżawy usługi Azure AD B2C.
Jeśli masz dostęp do wielu dzierżaw, wybierz ikonę Ustawienia w górnym menu, aby przełączyć się do dzierżawy usługi Azure AD B2C z menu Katalogi i subskrypcje.
Wybierz pozycję Wszystkie usługi w lewym górnym rogu witryny Azure Portal, a następnie wyszukaj i wybierz usługę Azure AD B2C.
Wybierz pozycję Dostawcy tożsamości, a następnie wybierz pozycję Twitter.
Wprowadź nazwę. Na przykład Twitter.
W polu Identyfikator klienta wprowadź klucz interfejsu API utworzonej wcześniej aplikacji Twitter.
W polu Klucz tajny klienta wprowadź wpis tajny klucza interfejsu API, który został zarejestrowany.
Wybierz pozycję Zapisz.

Dodawanie dostawcy tożsamości usługi Twitter do przepływu użytkownika

W tym momencie dostawca tożsamości twitter został skonfigurowany, ale nie jest jeszcze dostępny na żadnej ze stron logowania. Aby dodać dostawcę tożsamości usługi Twitter do przepływu użytkownika:

W dzierżawie usługi Azure AD B2C wybierz pozycję Przepływy użytkownika.
Wybierz przepływ użytkownika, który chcesz dodać dostawcę tożsamości usługi Twitter.
W obszarze Dostawcy tożsamości społecznościowych wybierz pozycję Twitter.
Wybierz pozycję Zapisz.

Testowanie przepływu użytkownika

Aby przetestować zasady, wybierz pozycję Uruchom przepływ użytkownika.
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.
Wybierz przycisk Uruchom przepływ użytkownika.
Na stronie rejestracji lub logowania wybierz pozycję Twitter , aby zalogować się przy użyciu konta w usłudze Twitter.

Tworzenie klucza zasad

Musisz przechowywać klucz tajny, który został wcześniej zarejestrowany dla aplikacji twitter w dzierżawie usługi Azure AD B2C.

Zaloguj się w witrynie Azure Portal.
Jeśli masz dostęp do wielu dzierżaw, wybierz ikonę Ustawienia w górnym menu, aby przełączyć się do dzierżawy usługi Azure AD B2C z menu Katalogi i subskrypcje.
W witrynie Azure Portal wyszukaj i wybierz pozycję Azure AD B2C.
W menu po lewej stronie w obszarze Zasady wybierz pozycję Identity Experience Framework.
Wybierz pozycję Klucze zasad, a następnie wybierz pozycję Dodaj.
W obszarze Opcje wybierz pozycję Manual.
Wprowadź nazwę klucza zasad. Na przykład TwitterSecret. Prefiks B2C_1A_ jest dodawany automatycznie do nazwy klucza.
W polu Wpis tajny wprowadź wcześniej zarejestrowaną wartość klucza klucza interfejsu API.
W obszarze Użycie klucza wybierz pozycję Signature.
Kliknij pozycję Utwórz.

Konfigurowanie usługi Twitter jako dostawcy tożsamości

Aby umożliwić użytkownikom logowanie się przy użyciu konta w usłudze Twitter, musisz zdefiniować konto 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.

Konto usługi Twitter można zdefiniować jako dostawcę oświadczeń, dodając je do elementu ClaimsProviders w pliku rozszerzenia zasad. Zapoznaj się z niestandardowym pakietem startowym zasad pobranym w sekcji Wymagania wstępne tego artykułu.

Otwórz plik TrustFrameworkExtensions.xml.
Znajdź element ClaimsProviders. Jeśli nie istnieje, dodaj go pod elementem głównym.

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

<ClaimsProvider>
  <Domain>twitter.com</Domain>
  <DisplayName>Twitter</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Twitter-OAuth1">
      <DisplayName>Twitter</DisplayName>
      <Protocol Name="OAuth1" />
      <Metadata>
        <Item Key="ProviderName">Twitter</Item>
        <Item Key="authorization_endpoint">https://api.twitter.com/oauth/authenticate</Item>
        <Item Key="access_token_endpoint">https://api.twitter.com/oauth/access_token</Item>
        <Item Key="request_token_endpoint">https://api.twitter.com/oauth/request_token</Item>
        <Item Key="ClaimsEndpoint">https://api.twitter.com/1.1/account/verify_credentials.json?include_email=true</Item>
        <Item Key="ClaimsResponseFormat">json</Item>
        <Item Key="client_id">Your Twitter application API key</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_TwitterSecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="user_id" />
        <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="screen_name" />
        <OutputClaim ClaimTypeReferenceId="email" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="twitter.com" />
        <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>

Zastąp wartość client_id kluczem interfejsu API, który został wcześniej zarejestrowany.
Zapisz plik.

Dodawanie podróży 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 podróży użytkownika niestandardowego, utwórz duplikat istniejącej podróży użytkownika szablonu, w przeciwnym razie przejdź do następnego kroku.

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

Dodawanie dostawcy tożsamości do podróży użytkownika

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

Znajdź element kroku aranżacji, który zawiera Type="CombinedSignInAndSignUp"element , lub Type="ClaimsProviderSelection" w podróży 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 ClaimsProviderSelection XML. Ustaw wartość TargetClaimsExchangeId na przyjazną nazwę.
W następnym kroku aranżacji dodaj element ClaimsExchange . Ustaw identyfikator na wartość identyfikatora wymiany oświadczeń docelowych. Zaktualizuj wartość TechnicalProfileReferenceId na identyfikator utworzonego wcześniej profilu technicznego.

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="TwitterExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="TwitterExchange" TechnicalProfileReferenceId="Twitter-OAuth1" />
  </ClaimsExchanges>
</OrchestrationStep>

Konfigurowanie zasad jednostki uzależnionej

Zasady jednostki uzależnionej, na przykład SignUpSignIn.xml, określają podróż użytkownika, który będzie wykonywany przez usługę Azure AD B2C. Znajdź element DefaultUserJourney w ramach jednostki uzależnionej. 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 CustomSignUpSignIn dla podróży użytkownika identyfikator ReferenceId jest ustawiony na :CustomSignUpSignIn

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

Przekazywanie zasad niestandardowych

Zaloguj się w witrynie Azure Portal.
Wybierz ikonę Katalog i subskrypcja na pasku narzędzi portalu, a następnie wybierz katalog zawierający dzierżawę usługi Azure AD B2C.
W witrynie Azure Portal wyszukaj i wybierz pozycję Azure AD B2C.
W obszarze Zasady wybierz pozycję Identity Experience Framework.
Wybierz pozycję Przekaż zasady niestandardowe, a następnie przekaż dwa zmienione pliki zasad w następującej kolejności: zasady rozszerzenia, na przykład TrustFrameworkExtensions.xml, a następnie zasady jednostki uzależnionej, takie jak SignUpSignIn.xml.

Testowanie zasad niestandardowych

Wybierz zasady jednostki uzależnionej, na przykład B2C_1A_signup_signin.
W polu Aplikacja wybierz wcześniej zarejestrowaną aplikację internetową. Adres URL odpowiedzi powinien zawierać wartość https://jwt.ms.
Wybierz przycisk Uruchom teraz.
Na stronie rejestracji lub logowania wybierz pozycję Twitter , aby zalogować się przy użyciu konta w usłudze Twitter.

Jeśli proces logowania zakończy się pomyślnie, przeglądarka zostanie przekierowana do https://jwt.msusługi , która wyświetla zawartość tokenu zwróconego przez usługę Azure AD B2C.

Napiwek

Jeśli występuje unauthorized błąd podczas testowania tego dostawcy tożsamości, upewnij się, że używasz poprawnego klucza interfejsu API usługi Twitter i klucza interfejsu API lub spróbuj zastosować dostęp z podwyższonym poziomem uprawnień. Ponadto zalecamy zapoznanie się ze strukturą projektów usługi Twitter, jeśli aplikacja została zarejestrowana przed udostępnieniem tej funkcji.

Konfigurowanie rejestracji i logowania przy użyciu konta usługi Twitter przy użyciu usługi Azure Active Directory B2C

Wymagania wstępne

Tworzenie aplikacji

Konfigurowanie usługi Twitter jako dostawcy tożsamości

Dodawanie dostawcy tożsamości usługi Twitter do przepływu użytkownika

Testowanie przepływu użytkownika

Tworzenie klucza zasad

Konfigurowanie usługi Twitter jako dostawcy tożsamości

Dodawanie podróży użytkownika

Dodawanie dostawcy tożsamości do podróży użytkownika

Konfigurowanie zasad jednostki uzależnionej

Przekazywanie zasad niestandardowych

Testowanie zasad niestandardowych

Dodatkowe zasoby