Tartalomdefiníciók

Fontos

2025. május 1-jére az Azure AD B2C már nem lesz elérhető az új ügyfelek számára. További információ a GYIK-ben.

Megjegyzés:

Az Azure Active Directory B2C-ben az egyéni szabályzatok elsősorban összetett helyzetek kezelésére szolgálnak. A legtöbb forgatókönyv esetében javasoljuk, hogy beépített felhasználói folyamatokat használjon. Ha még nem tette meg, ismerkedjen meg az egyéni szabályzatok kezdőcsomagjával az Egyéni szabályzatok használatának első lépései az Active Directory B2C-ben.

Testre szabhatja az önérvényesített technikai profilok megjelenését és hangulatát. Az Azure Active Directory B2C (Azure AD B2C) kódokat futtat az ügyfél böngészőjében, és egy modern, több forrásból származó erőforrás-megosztás (CORS) nevű megközelítést használ.

A felhasználói felület testreszabásához meg kell adnia egy URL-címet a ContentDefinition elemben testreszabott HTML-tartalommal. Az önérvényesített műszaki profilban vagy az OrchestrationStep-ben erre a tartalomdefiníció-azonosítóra kell mutatnia. A tartalomdefiníció tartalmazhat egy LocalizedResourcesReferences elemet, amely meghatározza a betöltendő honosított erőforrások listáját. Az Azure AD B2C egyesíti a felhasználói felület elemeit az URL-címről betöltött HTML-tartalommal, majd megjeleníti a lapot a felhasználónak.

A ContentDefinitions elem URL-címeket tartalmaz a HTML5-sablonokhoz, amelyek felhasználhatók a felhasználói folyamat során. A HTML5-lap URI-ja egy megadott felhasználói felületi lépéshez használatos. Például a bejelentkezési vagy regisztrációs, jelszó-visszaállítási vagy hibaoldalak. A html5-fájl LoadUri-fájljának felülbírálásával módosíthatja a megjelenést és az érzést. Igény szerint létrehozhat új tartalomdefiníciókat. Ez az elem tartalmazhat honosított erőforrásokra mutató hivatkozást a Honosítás elemben megadott honosítási azonosítóra.

Az alábbi példa a tartalomdefiníció azonosítóját és a honosított erőforrások definícióját mutatja be:

<ContentDefinition Id="api.localaccountsignup">
  <LoadUri>~/tenant/default/selfAsserted.cshtml</LoadUri>
  <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
  <DataUri>urn:com:microsoft:aad:b2c:elements:selfasserted:1.1.0</DataUri>
  <Metadata>
    <Item Key="DisplayName">Local account sign up page</Item>
  </Metadata>
  <LocalizedResourcesReferences MergeBehavior="Prepend">
    <LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.localaccountsignup.en" />
    <LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.localaccountsignup.es" />
    ...

A LocalAccountSignUpWithLogonEmail önkiszolgáló műszaki profil metaadatai a ContentDefinitionReferenceId tartalomdefinícióazonosítót tartalmazzák a következőre állítva: api.localaccountsignup

<TechnicalProfile Id="LocalAccountSignUpWithLogonEmail">
  <DisplayName>Email signup</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.SelfAssertedAttributeProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="ContentDefinitionReferenceId">api.localaccountsignup</Item>
    ...
  </Metadata>
  ...

Tartalommeghatározás

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

Jellemző Kötelező Leírás
Azonosító Igen Egy tartalomdefiníció azonosítója. Az érték a lap későbbi, Tartalomdefiníciós azonosítók szakaszában van megadva.

A ContentDefinition elem a következő elemeket tartalmazza:

Elem Események Leírás
LoadUri 1:1 A tartalomdefiníció HTML5-lapjának URL-címét tartalmazó sztring.
RecoveryUri 1:1 A tartalomdefinícióval kapcsolatos hiba megjelenítésére szolgáló HTML-oldal URL-címét tartalmazó sztring. Jelenleg nincs használatban, az értéknek a következőnek kell lennie ~/common/default_page_error.html: .
DataUri 1:1 Egy html-fájl relatív URL-címét tartalmazó sztring, amely a lépéshez szükséges felhasználói élményt biztosítja.
Metadaták 0:1 Kulcs/érték párok gyűjteménye, amely a tartalomdefiníció által használt metaadatokat tartalmazza.
LocalizedResourcesReferences 0:1 Honosított erőforrások hivatkozásainak gyűjteménye. Ezzel az elemet használva testre szabhatja a felhasználói felület és a jogcímattribútum honosítását.

LoadUri

A LoadUri elem a tartalomdefiníció HTML5-lapjának URL-címét adja meg. Az Azure AD B2C egyéni szabályzat kezdőcsomagjai olyan tartalomdefiníciókkal szolgálnak, amelyek Azure AD B2C HTML-oldalakat használnak. A LoadUri a következővel ~kezdődik: az Azure AD B2C-bérlő relatív elérési útja.

<ContentDefinition Id="api.signuporsignin">
  <LoadUri>~/tenant/templates/AzureBlue/unified.cshtml</LoadUri>
  ...
</ContentDefinition>

A felhasználói felületet HTML-sablonokkal szabhatja testre. HTML-sablonok használatakor adjon meg egy abszolút URL-címet. Az alábbi példa egy HTML-sablonnal rendelkező tartalomdefiníciót szemléltet:

<ContentDefinition Id="api.signuporsignin">
  <LoadUri>https://your-storage-account.blob.core.windows.net/your-container/customize-ui.html</LoadUri>
  ...
</ContentDefinition>

DataUri

A DataUri elem az oldalazonosító megadására szolgál. Az Azure AD B2C az oldalazonosítóval tölti be és kezdeményezi a felhasználói felület elemeit és az ügyféloldali JavaScriptet. Az érték formátuma: urn:com:microsoft:aad:b2c:elements:page-name:version. Az alábbi táblázat a használható oldalazonosítókat sorolja fel.

Oldalazonosító Leírás
globalexception Hibalap megjelenítése kivétel vagy hiba esetén.
providerselection, idpselection Felsorolja azokat az identitásszolgáltatókat, amelyek közül a felhasználók választhatnak a bejelentkezés során.
unifiedssp Megjeleníti a helyi fiókkal való bejelentkezéshez szükséges űrlapot, amely egy e-mail-cím vagy egy felhasználónév alapján van megadva. Ez az érték a "Bejelentkezés funkció megőrzése" és az "Elfelejtette a jelszavát?" hivatkozást is tartalmazza.
unifiedssd Egy e-mail-címen vagy felhasználónéven alapuló helyi fiókkal való bejelentkezéshez használható űrlapot jelenít meg. Ez a lapazonosító elavult. Használja inkább az unifiedssp oldalazonosítót.
multifactor A telefonszámok ellenőrzése szöveges vagy hang használatával a regisztráció vagy a bejelentkezés során.
selfasserted Megjelenít egy űrlapot, amely adatokat gyűjt egy felhasználótól. Lehetővé teszi például, hogy a felhasználók létrehozhassák vagy frissíthessék a profiljukat.

Lapelrendezés kiválasztása

A JavaScript ügyféloldali kódját úgy engedélyezheti, hogy beszúrja contractelements az oldaltípust és az oldaltípust. Például: urn:com:microsoft:aad:b2c:elements:contract:page-name:version.

A verzió része a DataUri szabályzat felhasználói felületének elemeihez html- és CSS-t és JavaScriptet tartalmazó tartalomcsomagot határoz meg. Ha engedélyezni szeretné a JavaScript ügyféloldali kódját, a JavaScript alapjául szolgáló elemeknek nem módosíthatóknak kell lenniük. Ha nem módosíthatók, a módosítások váratlan viselkedést okozhatnak a felhasználói oldalakon. A problémák elkerülése érdekében kényszerítse ki a lapelrendezés használatát, és adja meg a lapelrendezési verziót. Ezzel biztosítja, hogy a JavaScripten alapuló tartalomdefiníciók nem módosíthatók. Még ha nem is szeretné engedélyezni a JavaScriptet, akkor is meg kell adnia a lapok lapelrendezési verzióját.

Az alábbi példa a verzió selfasserted1.2.0 mutatja be:

<!-- 
<BuildingBlocks> 
  <ContentDefinitions>-->
    <ContentDefinition Id="api.localaccountpasswordreset">
      <LoadUri>~/tenant/templates/AzureBlue/selfAsserted.cshtml</LoadUri>
      <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:1.2.0</DataUri>
      <Metadata>
        <Item Key="DisplayName">Local account change password page</Item>
      </Metadata>
    </ContentDefinition>
  <!-- 
  </ContentDefinitions> 
</BuildingBlocks> -->

Migrálás lapelrendezésre

Ha a régi DataUri-értékről (lapszerződés nélkül) az oldalelrendezési verzióra szeretne migrálni, adja hozzá a következő szót contract egy oldalverzióval. A következő táblázat segítségével migrálhatja a régi DataUri-értékről a lapelrendezés verziójára.

Régi DataUri-érték Új DataUri-érték
urn:com:microsoft:aad:b2c:elements:globalexception:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:globalexception:1.2.1
urn:com:microsoft:aad:b2c:elements:globalexception:1.1.0 urn:com:microsoft:aad:b2c:elements:contract:globalexception:1.2.1
urn:com:microsoft:aad:b2c:elements:idpselection:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:providerselection:1.2.1
urn:com:microsoft:aad:b2c:elements:selfasserted:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.7
urn:com:microsoft:aad:b2c:elements:selfasserted:1.1.0 urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.7
urn:com:microsoft:aad:b2c:elements:unifiedssd:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:unifiedssd:1.2.1
urn:com:microsoft:aad:b2c:elements:unifiedssp:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:unifiedssp:2.1.5
urn:com:microsoft:aad:b2c:elements:unifiedssp:1.1.0 urn:com:microsoft:aad:b2c:elements:contract:unifiedssp:2.1.5
urn:com:microsoft:aad:b2c:elements:multifactor:1.0.0 urn:com:microsoft:aad:b2c:elements:contract:multifactor:1.2.5
urn:com:microsoft:aad:b2c:elements:multifactor:1.1.0 urn:com:microsoft:aad:b2c:elements:contract:multifactor:1.2.5

Az alábbi példa a tartalomdefiníció azonosítóit és a megfelelő DataUri-t mutatja be a legújabb oldalverzióval:

<!-- 
<BuildingBlocks> -->
  <ContentDefinitions>
    <ContentDefinition Id="api.error">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:globalexception:1.2.1</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.idpselections">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:providerselection:1.2.1</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.idpselections.signup">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:providerselection:1.2.1</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.signuporsignin">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:unifiedssp:2.1.7</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.selfasserted">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.14</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.selfasserted.profileupdate">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.14</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.localaccountsignup">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.14</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.localaccountpasswordreset">
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.14</DataUri>
    </ContentDefinition>
    <ContentDefinition Id="api.phonefactor">
      <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
      <DataUri>urn:com:microsoft:aad:b2c:elements:contract:multifactor:1.2.5</DataUri>
    </ContentDefinition>
  </ContentDefinitions>
<!-- 
</BuildingBlocks> -->

Metadaták

A Metaadatok elem a következő elemeket tartalmazza:

Elem Események Leírás
Termék 0:n A tartalomdefinícióhoz kapcsolódó metaadatok.

A Metaadatelem Elem eleme a következő attribútumokat tartalmazza:

Jellemző Kötelező Leírás
Kulcs Igen A metaadatkulcs.

Metaadat-kulcsok

A tartalomdefiníció a következő metaadatelemeket támogatja:

Kulcs Kötelező Leírás
Megjelenítendő név Nem A tartalomdefiníció nevét tartalmazó sztring.

LocalizedResourcesReferences

A LocalizedResourcesReferences elem a következő elemeket tartalmazza:

Elem Események Leírás
LocalizedResourcesReference 1:n A tartalomdefiníció honosított erőforrás-hivatkozásainak listája.

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

Jellemző Kötelező Leírás
Nyelv Igen Az RFC 5646 -ra vonatkozó szabályzat támogatott nyelvét tartalmazó sztring – Címkék a nyelvek azonosításához.
LocalizedResourcesReferenceId Igen A LocalizedResources elem azonosítója.

Az alábbi példa egy regisztrációs vagy bejelentkezési tartalomdefiníciót mutat be, amely az angol, a francia és a spanyol nyelv honosítására hivatkozik:

<ContentDefinition Id="api.signuporsignin">
  <LoadUri>~/tenant/default/unified.cshtml</LoadUri>
  <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
  <DataUri>urn:com:microsoft:aad:b2c:elements:unifiedssp:1.0.0</DataUri>
  <Metadata>
    <Item Key="DisplayName">Signin and Signup</Item>
  </Metadata>
  <LocalizedResourcesReferences MergeBehavior="Prepend">
    <LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.signuporsignin.en" />
    <LocalizedResourcesReference Language="fr" LocalizedResourcesReferenceId="api.signuporsignin.rf" />
    <LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.signuporsignin.es" />
</LocalizedResourcesReferences>
</ContentDefinition>

Ha tudni szeretné, hogyan adhat hozzá honosítási támogatást a tartalomdefiníciókhoz, olvassa el a Honosítás című témakört.

Tartalomdefiníciós azonosítók

A ContentDefinition elem azonosító attribútuma határozza meg a tartalomdefinícióhoz kapcsolódó oldal típusát. Az elem meghatározza azt a környezetet, amelyet egy egyéni HTML5/CSS-sablon alkalmazni fog. Az alábbi táblázat az Identity Experience Framework által felismert tartalomdefiníciós azonosítókat és a hozzájuk kapcsolódó oldaltípusokat ismerteti. Saját tartalomdefiníciókat tetszőleges azonosítóval hozhat létre.

ID (Azonosító) Alapértelmezett sablon Leírás
api.error kivétel.cshtml Hibalap – Hibalap megjelenítése kivétel vagy hiba esetén.
api.idpselections idpSelector.cshtml Identitásszolgáltató kiválasztási lapja – Azokat az identitásszolgáltatókat sorolja fel, amelyek közül a felhasználók a bejelentkezés során választhatnak. A lehetőségek általában vállalati identitásszolgáltatók, közösségi identitásszolgáltatók, például Facebook és Google+ vagy helyi fiókok.
api.idpselections.signup idpSelector.cshtml Identitásszolgáltató kiválasztása a regisztrációhoz – Felsorolja azokat az identitásszolgáltatókat, amelyek közül a felhasználók választhatnak a regisztráció során. A lehetőségek általában vállalati identitásszolgáltatók, közösségi identitásszolgáltatók, például Facebook és Google+ vagy helyi fiókok.
api.localaccountpasswordreset selfasserted.cshtml Elfelejtett jelszólap – Megjeleníti az űrlapot, amelyet a felhasználóknak be kell fejezniük a jelszó-visszaállítás kezdeményezéséhez.
api.localaccountsignin selfasserted.cshtml Helyi fiók bejelentkezési lapja – Egy e-mail-címen vagy felhasználónéven alapuló helyi fiókkal való bejelentkezéshez használható űrlapot jelenít meg. Az űrlap tartalmazhat szövegbeviteli mezőt és jelszóbeviteli mezőt.
api.localaccountRegisztráció selfasserted.cshtml Helyi fiók regisztrációs oldala – Egy e-mail-cím vagy felhasználónév alapján létrehozott helyi fiókra való regisztráció űrlapját jeleníti meg. Az űrlap különböző beviteli vezérlőket tartalmazhat, például: szövegbeviteli mezőt, jelszóbeviteli mezőt, választógombot, egyszeresen kijelölhető legördülő mezőket és több jelölőnégyzetet.
api.phonefactor többtényezős-1.0.0.cshtml Többtényezős hitelesítési oldal – Telefonszámok ellenőrzése szöveges vagy hangalapú módon a regisztráció vagy a bejelentkezés során.
api.selfasserted selfasserted.cshtml Közösségi fiók regisztrációs oldala – Megjeleníti az űrlapot, amelyet a felhasználóknak ki kell tölteniük, amikor egy közösségi identitásszolgáltatótól származó meglévő fiókkal regisztrálnak. Ez a lap hasonló az előző közösségi fiók regisztrációs oldalához, kivéve a jelszóbeviteli mezőket.
api.selfasserted.profileupdate updateprofile.cshtml Profilfrissítési lap – Egy űrlapot jelenít meg, amelyhez a felhasználók hozzáférhetnek a profiljuk frissítéséhez. Ez a lap hasonló a közösségi fiók regisztrációs oldalához, kivéve a jelszóbeviteli mezőket.
api.signuporsignin unified.cshtml Egységes regisztrációs vagy bejelentkezési oldal – Kezeli a felhasználói regisztrációt és a bejelentkezési folyamatot. A felhasználók használhatják a vállalati identitásszolgáltatókat, a közösségi identitásszolgáltatókat, például a Facebookot vagy a Google+-t vagy a helyi fiókokat.

Következő lépések

A felhasználói felület tartalomdefiníciók használatával történő testreszabására példa:

Az alkalmazás felhasználói felületének testreszabása egyéni szabályzat használatával

  • Last updated on