Műszaki profilok

A technikai profilok egy beépített mechanizmust biztosítanak a különböző típusú felek közötti kommunikációhoz. A technikai profilok segítségével kommunikálhat az Azure Active Directory B2C (Azure AD B2C) bérlővel egy felhasználó létrehozásához vagy egy felhasználói profil olvasásához. A technikai profilok önaláírással is engedélyezhetők a felhasználóval való interakcióhoz. Egy technikai profil például összegyűjtheti a felhasználó hitelesítő adatait a bejelentkezéshez, majd megjelenítheti a regisztrációs oldalt vagy a jelszó-visszaállítási oldalt.

Műszaki profilok típusai

A műszaki profil az alábbi forgatókönyveket teszi lehetővé:

• Application Insights: Eseményadatokat küld az Application Insightsnak.
• Microsoft Entra ID: Támogatást nyújt az Azure AD B2C felhasználói felügyeletéhez.
• Microsoft Entra többtényezős hitelesítés: Támogatja a telefonszámok Microsoft Entra többtényezős hitelesítéssel történő ellenőrzését.
• Jogcímátalakítás: Meghívja a kimeneti jogcímátalakításokat a jogcímértékek módosításához, a jogcímek érvényesítéséhez vagy a kimeneti jogcímek alapértelmezett értékeinek beállításához.
• Azonosító jogkivonat-tipp: Ellenőrzi a id_token_hint JWT-jogkivonat aláírását, a kiállító nevét és a jogkivonat célközönségét, és kinyeri a jogcímet a bejövő jogkivonatból.
• JWT-tokenkibocsátó: Kibocsát egy JWT-jogkivonatot, amely visszakerül a függő entitás alkalmazásába.
• OAuth1: Összevonás bármely OAuth 1.0 protokoll-identitásszolgáltatóval.
• OAuth2: Összevonás bármely OAuth 2.0 protokoll-identitásszolgáltatóval.
• Egyszeri jelszó: Támogatja az egyszeri jelszó létrehozásának és ellenőrzésének kezelését.
• OpenID Connect: Összevonás bármely OpenID Connect protokoll identitásszolgáltatóval.
• Telefonos tényező: Támogatja a telefonszámok regisztrálását és ellenőrzését.
• RESTful szolgáltató: MEGHÍVJA a REST API-szolgáltatásokat, például a felhasználói bemenetek érvényesítését, a felhasználói adatok bővítését vagy az üzletági alkalmazásokkal való integrációt.
• SAML-identitásszolgáltató: Összevonás bármely SAML protokoll-identitásszolgáltatóval.
• SAML-tokenkibocsátó: Kibocsát egy SAML-jogkivonatot, amely visszakerül a függő entitás alkalmazásába.
• Önérvényesített: Interakcióba lép a felhasználóval. Összegyűjti például a felhasználó hitelesítő adatait a bejelentkezéshez, a regisztrációs oldal megjelenítéséhez vagy a jelszó alaphelyzetbe állításához.
• Munkamenet-kezelés: Különböző típusú munkameneteket kezel.

Műszaki profilfolyamat

A technikai profilok minden típusa ugyanazzal a fogalomtal rendelkezik. A bemeneti jogcímek olvasásával és jogcímátalakítások futtatásával kezdődnek. Ezután kommunikálnak a konfigurált féllel, például identitásszolgáltatóval, REST API-val vagy Microsoft Entra címtárszolgáltatással. A folyamat befejezése után a műszaki profil visszaadja a kimeneti jogcímeket, és futtathat kimeneti jogcím-átalakításokat. Az alábbi ábra a műszaki profilban hivatkozott átalakítások és leképezések feldolgozását mutatja be. A jogcímátalakítás végrehajtása után a kimeneti jogcímek azonnal a jogcímcsomagban lesznek tárolva, függetlenül attól, hogy a műszaki profil milyen féllel kommunikál.

1. Egyszeri bejelentkezés (SSO) munkamenet-kezelés: Visszaállítja a technikai profil munkamenet-állapotát az egyszeri bejelentkezés munkamenet-kezelésével.
2. Bemeneti jogcímek átalakítása: A műszaki profil elindítása előtt az Azure AD B2C bemeneti jogcímek átalakítását futtatja.
3. Bemeneti jogcímek: A jogcímek a műszaki profilhoz használt jogcímcsomagból lesznek átvéve.
4. Technikai profil végrehajtása: A műszaki profil kicseréli a jogcímeket a konfigurált féllel. Például:
   • Átirányítja a felhasználót az identitásszolgáltatóhoz a bejelentkezés befejezéséhez. A sikeres bejelentkezés után a felhasználó visszatér, és a technikai profil végrehajtása folytatódik.
   • Meghív egy REST API-t, miközben a paramétereket InputClaims-ként küldi el, és outputClaims-ként kéri vissza az információkat.
   • Létrehozza vagy frissíti a felhasználói fiókot.
   • Elküldi és ellenőrzi a többtényezős hitelesítés szöveges üzenetét.
5. Érvényesítési műszaki profilok: Az önaláírással rendelkező műszaki profilok érvényesítési technikai profilokat hívhatnak meg a felhasználó által profilozott adatok ellenőrzéséhez. Érvényesítési műszaki profilokat csak önérvényesítő műszaki profilok használhatnak.
6. Kimeneti jogcímek: A jogcímek visszakerülnek a jogcímcsomagba. Ezeket a jogcímeket a következő vezénylési lépésben vagy a kimeneti jogcímátalakításokban használhatja.
7. Kimeneti jogcímátalakítások: A műszaki profil befejezése után az Azure AD B2C kimeneti jogcímátalakításokat futtat.
8. Egyszeri bejelentkezéses munkamenet-kezelés: A technikai profil adatait megőrzi a munkamenetben az egyszeri bejelentkezés munkamenet-kezelésével.

A TechnicalProfiles elem a jogcímszolgáltató által támogatott technikai profilokat tartalmaz. Minden jogcímszolgáltatónak rendelkeznie kell legalább egy műszaki profillal. A műszaki profil határozza meg a jogcímszolgáltatóval való kommunikációhoz szükséges végpontokat és protokollokat. A jogcímszolgáltató több műszaki profillal is rendelkezhet.

<ClaimsProvider>
  <DisplayName>Display name</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Technical profile identifier">
      <DisplayName>Display name of technical profile</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        ...
      </Metadata>
      ...
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

A TechnicalProfile elem a következő attribútumot tartalmazza:

A TechnicalProfile elem a következő elemeket tartalmazza:

Protokoll

A Protokoll elem meghatározza a másik féllel való kommunikációhoz használandó protokollt. A Protokoll elem a következő attribútumokat tartalmazza:

Metaadatok

A Metaadatok elem egy adott protokoll megfelelő konfigurációs beállításait tartalmazza. A támogatott metaadatok listája a megfelelő műszaki profil specifikációjában van dokumentálva. A Metaadatok elem a következő elemet tartalmazza:

Elem

A Metaadat elem Elem eleme a következő attribútumot tartalmazza:

Az alábbi példa az OAuth2 műszaki profilhoz kapcsolódó metaadatok használatát mutatja be.

<TechnicalProfile Id="Facebook-OAUTH">
  ...
  <Metadata>
    <Item Key="ProviderName">facebook</Item>
    <Item Key="authorization_endpoint">https://www.facebook.com/dialog/oauth</Item>
    <Item Key="AccessTokenEndpoint">https://graph.facebook.com/oauth/access_token</Item>
    <Item Key="HttpBinding">GET</Item>
    <Item Key="UsePolicyInRedirectUri">0</Item>
    ...
  </Metadata>
  ...
</TechnicalProfile>

Az alábbi példa a REST API technikai profiljához kapcsolódó metaadatok használatát mutatja be.

<TechnicalProfile Id="REST-Validate-Email">
  ...
  <Metadata>
    <Item Key="ServiceUrl">https://api.sendgrid.com/v3/mail/send</Item>
    <Item Key="AuthenticationType">Bearer</Item>
    <Item Key="SendClaimsIn">Body</Item>
    ...
  </Metadata>
  ...
</TechnicalProfile>

Titkosítási kulcsok

Az Azure AD B2C szabályzatkulcsok formájában tárolja a titkos kulcsokat és a tanúsítványokat, hogy megbízhatóságot alakítson ki azokkal a szolgáltatásokkal, amellyel integrálva van. A technikai profil végrehajtása során az Azure AD B2C lekéri a titkosítási kulcsokat az Azure AD B2C szabályzatkulcsaiból. Ezután az Azure AD B2C a kulcsokkal hozza létre a megbízhatóságot, titkosít vagy aláír egy jogkivonatot. Ezek a megbízhatósági kapcsolatok a következőkből állnak:

• Összevonás OAuth1, OAuth2 és SAML identitásszolgáltatókkal.
• A REST API-szolgáltatásokkal való kapcsolat biztonságossá tétele.
• A JWT- és SAML-jogkivonatok aláírása és titkosítása.

A CryptographicKeys elem a következő elemet tartalmazza:

Kulcs

A kulcselem a következő attribútumot tartalmazza:

Bemeneti jogcímek átalakítása

Az InputClaimsTransformations elem olyan bemeneti jogcím-átalakítási elemek gyűjteményét tartalmazhatja, amelyek a bemeneti jogcímek módosítására vagy újak létrehozására szolgálnak.

A jogcímátalakítás gyűjteményében egy korábbi jogcímátalakítás kimeneti jogcímei lehetnek egy későbbi bemeneti jogcím-átalakítás bemeneti jogcímei. Ily módon jogcímátalakítások sorozata is lehet, amelyek egymástól függenek.

Az InputClaimsTransformations elem a következő elemet tartalmazza:

InputClaimsTransformation

Az InputClaimsTransformation elem a következő attribútumot tartalmazza:

Az alábbi technikai profilok a CreateOtherMailsFromEmail jogcímátalakításra hivatkoznak. A jogcímátalakítás hozzáadja email a jogcím értékét a gyűjteményhez, otherMails mielőtt megőrzi az adatokat a címtárban.

<TechnicalProfile Id="AAD-UserWriteUsingAlternativeSecurityId">
  ...
  <InputClaimsTransformations>
    <InputClaimsTransformation ReferenceId="CreateOtherMailsFromEmail" />
  </InputClaimsTransformations>
  <PersistedClaims>
    <PersistedClaim ClaimTypeReferenceId="alternativeSecurityId" />
    <PersistedClaim ClaimTypeReferenceId="userPrincipalName" />
    <PersistedClaim ClaimTypeReferenceId="mailNickName" DefaultValue="unknown" />
    <PersistedClaim ClaimTypeReferenceId="displayName" DefaultValue="unknown" />
    <PersistedClaim ClaimTypeReferenceId="otherMails" />
    <PersistedClaim ClaimTypeReferenceId="givenName" />
    <PersistedClaim ClaimTypeReferenceId="surname" />
  </PersistedClaims>
  ...
</TechnicalProfile>

Bemeneti jogcímek

Az InputClaims elem a műszaki profilhoz használt jogcímcsomagból veszi fel a jogcímeket. Egy önaláírt műszaki profil például a bemeneti jogcímekkel előre feltölti a felhasználó által biztosított kimeneti jogcímeket. A REST API technikai profilja a bemeneti jogcímekkel küld bemeneti paramétereket a REST API-végpontnak. Az Azure AD B2C egy bemeneti jogcímet használ egyedi azonosítóként egy fiók olvasásához, frissítéséhez vagy törléséhez.

Az InputClaims elem a következő elemet tartalmazza:

InputClaim

Az InputClaim elem a következő attribútumokat tartalmazza:

Jogcímek megjelenítése

A DisplayClaims elem a képernyőn megjelenítendő jogcímek listáját tartalmazza, amelyek adatokat gyűjtenek a felhasználótól. A megjelenítési jogcímek gyűjteményében hivatkozhat egy jogcímtípusra vagy egy létrehozott megjelenítési vezérlőre .

• A jogcímtípus a képernyőn megjelenítendő jogcímre mutató hivatkozás.
  • Ha arra szeretné kényszeríteni a felhasználót, hogy adjon meg egy értéket egy adott jogcímhez, állítsa a DisplayClaim elem Kötelező attribútumát a következőretrue: .
  • A megjelenítési jogcímek értékeinek előzetes feltöltéséhez használja a korábban ismertetett bemeneti jogcímeket. Az elem egy alapértelmezett értéket is tartalmazhat.
  • A DisplayClaims gyűjtemény ClaimType elemének a UserInputType elemet az Azure AD B2C által támogatott felhasználói beviteli típusra kell beállítania. Ilyenek például a TextBox következők: vagy DropdownSingleSelect.
• A megjelenítési vezérlő egy speciális funkciókkal rendelkező felhasználói felületi elem, amely az Azure AD B2C háttérszolgáltatással működik együtt. Lehetővé teszi, hogy a felhasználó műveleteket hajt végre azon a lapon, amely egy érvényesítési műszaki profilt hív meg a háttérrendszerben. Ilyen például egy e-mail-cím, telefonszám vagy ügyfélhűség-szám ellenőrzése.

A DisplayClaims elemeinek sorrendje határozza meg, hogy az Azure AD B2C milyen sorrendben jeleníti meg a jogcímeket a képernyőn.

A DisplayClaims elem a következő elemet tartalmazza:

DisplayClaim

A DisplayClaim elem a következő attribútumokat tartalmazza:

Az alábbi példa a megjelenítési jogcímek és megjelenítési vezérlők használatát mutatja be egy önérvényesített műszaki profilban.

A következő műszaki profilban:

• Az első megjelenítési jogcím hivatkozik a megjelenítési emailVerificationControl vezérlőre, amely összegyűjti és ellenőrzi az e-mail-címet.
• Az ötödik megjelenítési jogcím hivatkozik a megjelenítési phoneVerificationControl vezérlőre, amely összegyűjti és ellenőrzi a telefonszámot.
• A többi megjelenítési jogcím a felhasználótól begyűjtendő ClaimType-elemek.

<TechnicalProfile Id="Id">
  <DisplayClaims>
    <DisplayClaim DisplayControlReferenceId="emailVerificationControl" />
    <DisplayClaim ClaimTypeReferenceId="displayName" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="givenName" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="surName" Required="true" />
    <DisplayClaim DisplayControlReferenceId="phoneVerificationControl" />
    <DisplayClaim ClaimTypeReferenceId="newPassword" Required="true" />
    <DisplayClaim ClaimTypeReferenceId="reenterPassword" Required="true" />
  </DisplayClaims>
</TechnicalProfile>

Megőrzött jogcímek

A PersistedClaims elem tartalmazza azokat az értékeket, amelyeket egy Microsoft Entra ID technikai profilnak meg kell őriznie a szabályzat Jogcímekkéma szakaszában már definiált jogcímtípus és a Microsoft Entra attribútumnév közötti lehetséges leképezési információkkal.

A jogcím neve a Microsoft Entra attribútum neve, kivéve, ha meg van adva a PartnerClaimType attribútum, amely tartalmazza a Microsoft Entra attribútum nevét.

A PersistedClaims elem a következő elemet tartalmazza:

PersistedClaim

A PersistedClaim elem a következő attribútumokat tartalmazza:

Az alábbi példában az AAD-UserWriteUsingLogonEmail technikai profil vagy az új helyi fiókot létrehozó kezdőcsomag megőrzi a következő jogcímeket:

<PersistedClaims>
  <PersistedClaim ClaimTypeReferenceId="email" PartnerClaimType="signInNames.emailAddress" />
  <PersistedClaim ClaimTypeReferenceId="newPassword" PartnerClaimType="password"/>
  <PersistedClaim ClaimTypeReferenceId="displayName" DefaultValue="unknown" />
  <PersistedClaim ClaimTypeReferenceId="passwordPolicies" DefaultValue="DisablePasswordExpiration" />
  <PersistedClaim ClaimTypeReferenceId="givenName" />
  <PersistedClaim ClaimTypeReferenceId="surname" />
</PersistedClaims>

Kimeneti jogcímek

Az OutputClaims elem olyan jogcímek gyűjteménye, amelyek a műszaki profil befejezése után visszakerülnek a jogcímcsomagba. Ezeket a jogcímeket a következő vezénylési lépésben vagy a kimeneti jogcímátalakításokban használhatja. Az OutputClaims elem a következő elemet tartalmazza:

OutputClaim

Az OutputClaim elem a következő attribútumokat tartalmazza:

Kimeneti jogcímek átalakítása

Az OutputClaimsTransformations elem az OutputClaimsTransformation elemek gyűjteményét is tartalmazhatja. A kimeneti jogcímek átalakításával módosíthatja a kimeneti jogcímeket, vagy újakat hozhat létre. A végrehajtás után a kimeneti jogcímek vissza lesznek helyezve a jogcímcsomagba. Ezeket a jogcímeket a következő vezénylési lépésben használhatja.

A jogcímátalakítás gyűjteményében egy korábbi jogcímátalakítás kimeneti jogcímei lehetnek egy későbbi bemeneti jogcím-átalakítás bemeneti jogcímei. Ily módon jogcímátalakítások sorozata is lehet, amelyek egymástól függenek.

Az OutputClaimsTransformations elem a következő elemet tartalmazza:

OutputClaimsTransformation

Az OutputClaimsTransformation elem a következő attribútumot tartalmazza:

Az alábbi technikai profil az AssertAccountEnabledIsTrue jogcímátalakításra hivatkozik annak kiértékeléséhez, hogy a fiók engedélyezve van-e, vagy sem, miután elolvasta a accountEnabled jogcímet a címtárból.

<TechnicalProfile Id="AAD-UserReadUsingEmailAddress">
  ...
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="objectId" />
    <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="localAccountAuthentication" />
    <OutputClaim ClaimTypeReferenceId="userPrincipalName" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="accountEnabled" />
    <OutputClaim ClaimTypeReferenceId="otherMails" />
    <OutputClaim ClaimTypeReferenceId="signInNames.emailAddress" />
  </OutputClaims>
  <OutputClaimsTransformations>
    <OutputClaimsTransformation ReferenceId="AssertAccountEnabledIsTrue" />
  </OutputClaimsTransformations>
  ...
</TechnicalProfile>

Érvényesítési műszaki profilok

A rendszer érvényesítési műszaki profilt használ a kimeneti jogcímek önérvényesítő műszaki profilban való érvényesítéséhez. Az érvényesítési műszaki profil bármely protokoll szokásos technikai profilja, például a Microsoft Entra ID vagy a REST API. Az érvényesítési műszaki profil kimeneti jogcímeket ad vissza, vagy hibakódot ad vissza. A hibaüzenet a képernyőn jelenik meg a felhasználó számára, így a felhasználó újra próbálkozhat.

Az alábbi ábra bemutatja, hogy az Azure AD B2C hogyan használ érvényesítési műszaki profilt a felhasználói hitelesítő adatok ellenőrzéséhez.

Az ValidationTechnicalProfiles elem a következő elemet tartalmazza:

ValidationTechnicalProfile

Az ValidationTechnicalProfile elem a következő attribútumot tartalmazza:

SubjectNamingInfo

A SubjectNamingInfo elem határozza meg a függő entitás házirendjének jogkivonataiban használt tulajdonosnevet. A SubjectNamingInfo elem a következő attribútumot tartalmazza:

Műszaki profil belefoglalása

A műszaki profil tartalmazhat egy másik technikai profilt a beállítások módosításához vagy új funkciók hozzáadásához. Az IncludeTechnicalProfile elem arra a közös műszaki profilra mutató hivatkozás, amelyből a műszaki profil származik. A redundancia és a szabályzatelemek összetettségének csökkentése érdekében használja a belefoglalást, ha több olyan technikai profillal rendelkezik, amelyek megosztják az alapvető elemeket. Használjon közös műszaki profilt a közös konfigurációs készlettel, valamint a közös műszaki profilt tartalmazó konkrét feladat-technikai profilokkal együtt.

Tegyük fel, hogy rendelkezik egy REST API technikai profillal egyetlen végponttal, ahol különböző jogcímkészleteket kell küldenie különböző forgatókönyvekhez. Hozzon létre egy közös technikai profilt a megosztott funkciókkal, például a REST API-végpont URI-jával, metaadataival, hitelesítési típusával és titkosítási kulcsaival. Hozzon létre konkrét feladat-technikai profilokat, amelyek tartalmazzák a közös műszaki profilt. Ezután adja hozzá a bemeneti és kimeneti jogcímeket, vagy írja felül az adott műszaki profilhoz kapcsolódó REST API-végpont URI-t.

Az IncludeTechnicalProfile elem a következő attribútumot tartalmazza:

Az alábbi példa a felvétel használatát szemlélteti:

• REST-API-Common: Gyakori műszaki profil az alapkonfigurációval.
• REST-ValidateProfile: Tartalmazza a REST-API-Common műszaki profilt, és meghatározza a bemeneti és kimeneti jogcímeket.
• REST-UpdateProfile: Tartalmazza a REST-API-Common műszaki profilt, megadja a bemeneti jogcímeket, és felülírja a ServiceUrl metaadatokat.

<ClaimsProvider>
  <DisplayName>REST APIs</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="REST-API-Common">
      <DisplayName>Base REST API configuration</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.RestfulProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        <Item Key="ServiceUrl">https://your-app-name.azurewebsites.NET/api/identity</Item>
        <Item Key="AuthenticationType">Basic</Item>
        <Item Key="SendClaimsIn">Body</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="BasicAuthenticationUsername" StorageReferenceId="B2C_1A_B2cRestClientId" />
        <Key Id="BasicAuthenticationPassword" StorageReferenceId="B2C_1A_B2cRestClientSecret" />
      </CryptographicKeys>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
    </TechnicalProfile>

    <TechnicalProfile Id="REST-ValidateProfile">
      <DisplayName>Validate the account and return promo code</DisplayName>
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="objectId" />
        <InputClaim ClaimTypeReferenceId="email" />
        <InputClaim ClaimTypeReferenceId="userLanguage" PartnerClaimType="lang" DefaultValue="{Culture:LCID}" AlwaysUseDefaultValue="true" />
      </InputClaims>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="promoCode" />
      </OutputClaims>
      <IncludeTechnicalProfile ReferenceId="REST-API-Common" />
    </TechnicalProfile>

    <TechnicalProfile Id="REST-UpdateProfile">
      <DisplayName>Update the user profile</DisplayName>  
      <Metadata>
        <Item Key="ServiceUrl">https://your-app-name.azurewebsites.NET/api/identity/update</Item>
      </Metadata>
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="objectId" />
        <InputClaim ClaimTypeReferenceId="email" />
      </InputClaims>
      <IncludeTechnicalProfile ReferenceId="REST-API-Common" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

Többszintű integráció

A műszaki profilok egyetlen műszaki profilt is tartalmazhatnak. A befogadási szintek száma nincs korlátozva. Az AAD-UserReadUsingAlternativeSecurityId-NoError technikai profil például tartalmazza az AAD-UserReadUsingAlternativeSecurityId azonosítót. Ez a technikai profil beállítja a RaiseErrorIfClaimsPrincipalDoesNotExist metaadat-elemet true , és hibát jelez, ha egy közösségi fiók nem létezik a címtárban. Az AAD-UserReadUsingAlternativeSecurityId-NoError felülírja ezt a viselkedést, és letiltja a hibaüzenetet.

<TechnicalProfile Id="AAD-UserReadUsingAlternativeSecurityId-NoError">
  <Metadata>
    <Item Key="RaiseErrorIfClaimsPrincipalDoesNotExist">false</Item>
  </Metadata>
  <IncludeTechnicalProfile ReferenceId="AAD-UserReadUsingAlternativeSecurityId" />
</TechnicalProfile>

Az AAD-UserReadUsingAlternativeSecurityId tartalmazza a technikai profilt AAD-Common .

<TechnicalProfile Id="AAD-UserReadUsingAlternativeSecurityId">
  <Metadata>
    <Item Key="Operation">Read</Item>
    <Item Key="RaiseErrorIfClaimsPrincipalDoesNotExist">true</Item>
    <Item Key="UserMessageIfClaimsPrincipalDoesNotExist">User does not exist. Please sign up before you can sign in.</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="AlternativeSecurityId" PartnerClaimType="alternativeSecurityId" Required="true" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="objectId" />
    <OutputClaim ClaimTypeReferenceId="userPrincipalName" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="otherMails" />
    <OutputClaim ClaimTypeReferenceId="givenName" />
    <OutputClaim ClaimTypeReferenceId="surname" />
  </OutputClaims>
  <IncludeTechnicalProfile ReferenceId="AAD-Common" />
</TechnicalProfile>

Az AAD-UserReadUsingAlternativeSecurityId-NoError és az AAD-UserReadUsingAlternativeSecurityId sem adja meg a szükséges protokollelemet , mert az az AAD-Common műszaki profilban van megadva.

<TechnicalProfile Id="AAD-Common">
  <DisplayName>Azure Active Directory</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AzureActiveDirectoryProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  ...
</TechnicalProfile>

Technikai profil használata munkamenet-kezeléshez

A UseTechnicalProfileForSessionManagement elem az SSO-munkamenet technikai profiljára hivatkozik. A UseTechnicalProfileForSessionManagement elem a következő attribútumot tartalmazza:

Engedélyezve a felhasználói folyamatokhoz

A felhasználói folyamat JogcímekProviderSelections szolgáltatása határozza meg a jogcímszolgáltató kiválasztási lehetőségeit és sorrendjét. Az EnabledForUserJourneys elem segítségével szűrheti, hogy melyik jogcímszolgáltató érhető el a felhasználó számára. Az EnabledForUserJourneys elem a következő értékek egyikét tartalmazza:

• Mindig: Végrehajtja a műszaki profilt.
• Soha: Kihagyja a technikai profilt.
• OnClaimsExistence: Csak akkor hajtja végre, ha a műszaki profilban megadott bizonyos jogcím létezik.
• OnItemExistenceInStringCollectionClaim: Csak akkor hajtja végre, ha egy elem létezik egy sztringgyűjteményi jogcímben.
• OnItemAbsenceInStringCollectionClaim: Csak akkor hajtja végre, ha egy elem nem létezik sztringgyűjteményi jogcímben.

Az OnClaimsExistence, az OnItemExistenceInStringCollectionClaim vagy az OnItemAbsenceInStringCollectionClaim használatához a következő metaadatokat kell megadnia:

• ClaimTypeOnWhichToEnable: Megadja a kiértékelendő jogcím típusát.
• ClaimValueOnWhichToEnable: Az összehasonlítandó értéket adja meg.

A következő technikai profil csak akkor lesz végrehajtva, ha az identityProviders sztringgyűjtemény a következő facebook.comértéket tartalmazza:

<TechnicalProfile Id="UnLink-Facebook-OAUTH">
  <DisplayName>Unlink Facebook</DisplayName>
...
    <Metadata>
      <Item Key="ClaimTypeOnWhichToEnable">identityProviders</Item>
      <Item Key="ClaimValueOnWhichToEnable">facebook.com</Item>
    </Metadata>
...
  <EnabledForUserJourneys>OnItemExistenceInStringCollectionClaim</EnabledForUserJourneys>
</TechnicalProfile>