Konfigurera registrering och inloggning med ett X-konto med hjälp av Azure Active Directory B2C

• Skapa ett användarflöde så att användare kan registrera sig och logga in på ditt program.
• Registrera ett webbprogram.

• Slutför stegen i Kom igång med anpassade principer i Active Directory B2C. Handledningen visar hur du uppdaterar anpassade principfiler för att använda konfigurationen för din Azure AD B2C-klient.
• Registrera ett webbprogram.

1. Logga in på X Developer Portal med dina X-kontoautentiseringsuppgifter.
2. Välj knappen + Skapa projekt .
3. Under fliken Projektnamn anger du ett föredraget namn på projektet och väljer sedan knappen Nästa .
4. Under fliken Användningsfall väljer du önskat användningsfall och väljer sedan Nästa.
5. Under fliken Projektbeskrivning anger du projektbeskrivningen och väljer sedan knappen Nästa .
6. Under fliken Appnamn anger du ett namn för din app, till exempel azureadb2c, och väljer knappen Nästa .
7. Under fliken Nycklar och token kopierar du värdet för API-nyckel och API-nyckelhemlighet. Du kommer att använda dessa för konfiguration senare.
8. Välj Appinställningar för att öppna appinställningarna.
9. I den nedre delen av sidan går du till Inställningar för användarautentisering och väljer Konfigurera.
10. Under Typ av app väljer du lämplig apptyp, till exempel Webbapp.
11. Under Appinformation:
    1. För återanrops-URI/omdirigerings-URL anger du https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/your-policy-id/oauth1/authresp. Om du använder en anpassad domän anger du https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp. Använd alla gemener när du anger ditt klientnamn och användarflödes-ID även om de definieras med versaler i Azure AD B2C. Ersätta:
       • your-tenant-name med namnet på din hyresgäst.
       • your-domain-name med din anpassade domän.
       • your-policy-id med identifieraren för ditt användarflöde. Till exempel b2c_1a_signup_signin_x.
    2. För webbadressen till webbplatsen anger du https://your-tenant.b2clogin.com. Ersätt your-tenant med namnet på din hyresgäst. Till exempel https://contosob2c.b2clogin.com. Om du använder en anpassad domän anger du https://your-domain-name.
    3. (Valfritt) Ange en URL för tjänstvillkoren, till exempel http://www.contoso.com/tos. Policy-URL:en är en sida som du underhåller för att tillhandahålla villkor för din applikation.
    4. (Valfritt) Ange en URL för sekretesspolicyn, till exempel http://www.contoso.com/privacy. Policy-URL är en sida som du hanterar för att tillhandahålla sekretessinformation för din applikation.
12. Välj Spara.

1. Logga in på X Developer Portal med dina X-kontoautentiseringsuppgifter.
2. Välj knappen + Skapa projekt .
3. Under fliken Projektnamn anger du ett föredraget namn på projektet och väljer sedan knappen Nästa .
4. Under fliken Användningsfall väljer du önskat användningsfall och väljer sedan Nästa.
5. Under fliken Projektbeskrivning anger du projektbeskrivningen och väljer sedan knappen Nästa .
6. Under fliken Appnamn anger du ett namn för din app, till exempel azureadb2c, och väljer knappen Nästa .
7. Under fliken Nycklar och token kopierar du värdet för API Key och API Key Secret för senare. Du använder båda för att konfigurera X som identitetsprovider i din Azure AD B2C-klientorganisation.
8. Välj Appinställningar för att öppna appinställningarna.
9. I den nedre delen av sidan går du till Inställningar för användarautentisering och väljer Konfigurera.
10. Under Typ av app väljer du lämplig apptyp, till exempel Webbapp.
11. Under Appinformation:
    1. För återanrops-URI/omdirigerings-URL anger du https://your-tenant.b2clogin.com/your-tenant-name.onmicrosoft.com/your-user-flow-name/oauth1/authresp. Om du använder en anpassad domän anger du https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp. Använd alla gemener när du anger ditt klientnamn och användarflödes-ID även om de definieras med versaler i Azure AD B2C. Ersätta:
       • your-tenant-name med namnet på din hyresgäst.
       • your-domain-name med din anpassade domän.
       • your-user-flow-name med identifieraren för ditt användarflöde. Till exempel b2c_1_signup_signin_x.
    2. För webbadressen till webbplatsen anger du https://your-tenant.b2clogin.com. Ersätt your-tenant med namnet på din hyresgäst. Till exempel https://contosob2c.b2clogin.com. Om du använder en anpassad domän anger du https://your-domain-name.
    3. Ange en URL för tjänstvillkoren, till exempel http://www.contoso.com/tos. Policy-URL:en är en sida som du underhåller för att tillhandahålla villkor för din applikation.
    4. Ange en URL för sekretesspolicyn, till exempel http://www.contoso.com/privacy. Policy-URL är en sida som du hanterar för att tillhandahålla sekretessinformation för din applikation.
12. Välj Spara.

Konfigurera X som identitetsprovider

1. Logga in på Azure-portalen med ett konto som har minst administratörsbehörighet för extern identitetsprovider .
2. Om du har åtkomst till flera klientorganisationer väljer du ikonen Inställningar på den översta menyn för att växla till din Azure AD B2C-klientorganisation från menyn Kataloger + prenumerationer.
3. Välj Alla tjänster i det övre vänstra hörnet i Azure-portalen, sök efter och välj Azure AD B2C.
4. Välj Identitetsprovidrar och sedan Twitter.
5. Ange ett Namn. Till exempel X.
6. För klient-ID anger du API-nyckeln för X-programmet som du skapade tidigare.
7. För klienthemligheten anger du den API-nyckelhemlighet som du registrerade.
8. Välj Spara.

Lägga till X-identitetsprovider i ett användarflöde

I det här läget har X-identitetsprovidern konfigurerats, men den är ännu inte tillgänglig på någon av inloggningssidorna. Så här lägger du till X-identitetsprovidern i ett användarflöde:

1. I din Azure AD B2C-klient väljer du Användarflöden.
2. Välj det användarflöde som du vill lägga till X-identitetsprovidern.
3. Under De sociala identitetsprovidrar väljer du Twitter.
4. Välj Spara.

Testa användarflödet

1. Om du vill testa principen väljer du Kör användarflöde.
2. För Program väljer du webbprogrammet med namnet testapp1 som du registrerade tidigare. Svar-URL ska visa https://jwt.ms.
3. Välj knappen Kör användarflöde .
4. På registrerings- eller inloggningssidan väljer du Twitter för att logga in med X-kontot.

Skapa en principnyckel

Du måste lagra den hemliga nyckel som du tidigare noterade för X-appen i din Azure AD B2C-klient.

1. Logga in på Azure-portalen.
2. Om du har åtkomst till flera klientorganisationer väljer du ikonen Inställningar på den översta menyn för att växla till din Azure AD B2C-klientorganisation från menyn Kataloger + prenumerationer.
3. I Azure Portal söker du efter och väljer Azure AD B2C.
4. På den vänstra menyn går du till Principer och väljer Identity Experience Framework.
5. Välj Principnycklar och välj sedan Lägg till.
6. För Alternativ väljer du Manual.
7. Ange ett Namn för principnyckeln. Till exempel XSecret. Prefixet B2C_1A_ läggs automatiskt till i namnet på din nyckel.
8. För Hemlighet anger du det API-nyckelhemlighetsvärde som du registrerade tidigare.
9. För Nyckelanvändning väljer du Signature.
10. Klicka på Skapa.

Konfigurera X som identitetsprovider

För att göra det möjligt för användare att logga in med ett X-konto måste du definiera kontot som en anspråksprovider som Azure AD B2C kan kommunicera med via en slutpunkt. Slutpunkten innehåller en uppsättning anspråk som används av Azure AD B2C för att verifiera att en viss användare har autentiserats.

Du kan definiera ett X-konto som en anspråksprovider genom att lägga till det i elementet ClaimsProviders i tilläggsfilen för din policy. Se startpaketet för anpassad policy som du laddade ned i förutsättningarna i den här artikeln.

1. Öppna TrustFrameworkExtensions.xml.

2. Hitta elementet ClaimsProviders . Om den inte finns lägger du till den under rotelementet.

3. Lägg till en ny ClaimsProvider på följande sätt:

   <ClaimsProvider>
     <Domain>x.com</Domain>
     <DisplayName>X</DisplayName>
     <TechnicalProfiles>
       <TechnicalProfile Id="Twitter-OAuth1">
         <DisplayName>X</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 X 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>
   

4. Ersätt värdet för client_id med DEN API-nyckel som du registrerade tidigare.

5. Spara filen.

Lägg till en användarresa

I det här läget har identitetsprovidern konfigurerats, men den är ännu inte tillgänglig på någon av inloggningssidorna. Om du inte har en egen anpassad användarresa skapar du en dubblett av en befintlig mallanvändarresa, annars fortsätter du till nästa steg.

1. Öppna filenTrustFrameworkBase.xml från startpaketet.
2. Hitta och kopiera hela innehållet i elementet UserJourney som innehåller Id="SignUpOrSignIn".
3. Öppna TrustFrameworkExtensions.xml och leta upp elementet UserJourneys . Om elementet inte finns lägger du till ett.
4. Klistra in hela innehållet i elementet UserJourney som du kopierade som ett underordnat element till UserJourneys.
5. Byt namn på ID:t för användarens resa. Till exempel Id="CustomSignUpSignIn".

Lägg till identitetsleverantören i en användarupplevelse

Nu när du har en användarresa lägger du till den nya identitetsprovidern i användarresan. Du lägger först till en inloggningsknapp och länkar sedan knappen till en åtgärd. Åtgärden är den tekniska profil som du skapade tidigare.

1. Leta reda på orkestreringsstegelementet som innehåller Type="CombinedSignInAndSignUp", eller Type="ClaimsProviderSelection" i användarresan. Det är vanligtvis det första orkestreringssteget. Elementet ClaimsProviderSelections innehåller en lista över identitetsprovidrar som en användare kan logga in med. Ordningen på elementen styr ordningen på de inloggningsknappar som visas för användaren. Lägg till ett ClaimsProviderSelection XML-element. Ange värdet TargetClaimsExchangeId till ett lämpligt namn.

2. I nästa orkestreringssteg lägger du till ett ClaimsExchange-element . Ange ID:t till värdet för målanspråksutbytes-ID:t. Uppdatera TechnicalProfileReferenceId till ID:t för den tekniska profil som du skapade tidigare.

Följande XML visar de två första orkestreringsstegen för en användarresa med identitetsprovidern:

<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>

Konfigurera policyn för den förlitande parten

Principen för förlitande part, till exempel SignUpSignIn.xml, anger den användarresa som Azure AD B2C ska köra. Hitta elementet DefaultUserJourney under den förlitande parten. Uppdatera ReferenceId så att det matchar användarens rese-ID, där du lade till identitetsprovidern.

I följande exempel, för användarupplevelsen, är CustomSignUpSignIn inställt på :

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

Ladda upp den anpassade policyn

1. Logga in på Azure-portalen.
2. Välj ikonen Katalog + prenumeration i portalens verktygsfält och välj sedan den katalog som innehåller din Azure AD B2C-klientorganisation.
3. I Azure Portal söker du efter och väljer Azure AD B2C.
4. Under kategorin Principer väljer du Identity Experience Framework.
5. Välj Överför anpassad princip och ladda sedan upp de två principfilerna som du ändrade i följande ordning: tilläggsprincipen, till exempel TrustFrameworkExtensions.xml, och sedan den förlitande partprincipen, till exempel SignUpSignIn.xml.

Testa din anpassade policy

1. Välj din policy för förlitande part, till exempel B2C_1A_signup_signin.
2. För Program väljer du ett webbprogram som du registrerade tidigare. Svar-URL ska visa https://jwt.ms.
3. Välj knappen Kör nu .
4. På registrerings- eller inloggningssidan väljer du Twitter för att logga in med X-kontot.