Delen via

Inhoudsdefinities

Belangrijk

Vanaf 1 mei 2025 is Azure AD B2C niet meer beschikbaar voor nieuwe klanten. Meer informatie vindt u in onze veelgestelde vragen.

Opmerking

In Azure Active Directory B2C is aangepast beleid voornamelijk bedoeld om met complexe scenario's om te gaan. Voor de meeste scenario's wordt aangeraden ingebouwde gebruikersstromen te gebruiken. Als u dit nog niet hebt gedaan, vindt u meer informatie over aangepast beleid in het starterspakket in Aan de slag met aangepaste beleidsregels in Active Directory B2C.

U kunt het uiterlijk van elk zelfbeweert technisch profiel aanpassen. Azure Active Directory B2C (Azure AD B2C) voert code uit in de browser van uw klant en maakt gebruik van een moderne benadering met de naam Cross-Origin Resource Sharing (CORS).

Als u de gebruikersinterface wilt aanpassen, geeft u een URL op in het element ContentDefinition met aangepaste HTML-inhoud. In het zelf-asserted technische profiel of OrchestrationStep wijst u die inhoudsdefinitie-id aan. De inhoudsdefinitie kan een element LocalizedResourcesReferences bevatten dat een lijst met gelokaliseerde resources aangeeft die moeten worden geladen. Azure AD B2C voegt elementen van de gebruikersinterface samen met de HTML-inhoud die vanuit uw URL wordt geladen en geeft de pagina vervolgens weer aan de gebruiker.

Het element ContentDefinitions bevat URL's naar HTML5-sjablonen die kunnen worden gebruikt in een gebruikerstraject. De HTML5-pagina-URI wordt gebruikt voor een opgegeven gebruikersinterfacestap. Bijvoorbeeld de aanmeldings- of registratiepagina's, het opnieuw instellen van wachtwoorden of foutpagina's. U kunt het uiterlijk wijzigen door de LoadUri voor het HTML5-bestand te overschrijven. U kunt nieuwe inhoudsdefinities maken op basis van uw behoeften. Dit element kan een verwijzing naar gelokaliseerde resources bevatten naar de lokalisatie-id die is opgegeven in het element Lokalisatie .

In het volgende voorbeeld ziet u de inhoudsdefinitie-id en de definitie van gelokaliseerde resources:

<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" />
    ...

De metagegevens van het self-asserted technische profiel LocalAccountSignUpWithLogonEmail bevat de inhoudsdefinitie-id ContentDefinitionReferenceId ingesteld op 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>
  ...

Definitie van inhoud

Het element ContentDefinition bevat het volgende kenmerk:

Eigenschap Verplicht Beschrijving
Identiteitsbewijs Ja Een id voor een inhoudsdefinitie. De waarde is een waarde die is opgegeven in de sectie Inhoudsdefinitie-id's verderop op deze pagina.

Het element ContentDefinition bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Laad Uri 1:1 Een tekenreeks die de URL van de HTML5-pagina voor de inhoudsdefinitie bevat.
RecoveryUri 1:1 Een tekenreeks die de URL van de HTML-pagina bevat voor het weergeven van een fout met betrekking tot de inhoudsdefinitie. Momenteel niet gebruikt, moet de waarde zijn ~/common/default_page_error.html.
DataUri 1:1 Een tekenreeks die de relatieve URL van een HTML-bestand bevat waarmee de gebruikerservaring voor de stap kan worden aangeroepen.
Metagegevens 0:1 Een verzameling sleutel-waardeparen die de metagegevens bevat die worden gebruikt door de inhoudsdefinitie.
GelokaliseerdeBronnenReferenties 0:1 Een verzameling gelokaliseerde resourcesverwijzingen. Gebruik dit element om de lokalisatie van een gebruikersinterface en claimkenmerk aan te passen.

Laad Uri

Het element LoadUri wordt gebruikt om de URL van de HTML5-pagina voor de inhoudsdefinitie op te geven. De azure AD B2C-starterpakketten voor aangepast beleid worden geleverd met inhoudsdefinities die gebruikmaken van Azure AD B2C HTML-pagina's. De LoadUri begint met ~, een relatief pad naar uw Azure AD B2C-tenant.

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

U kunt de gebruikersinterface aanpassen met HTML-sjablonen. Wanneer u HTML-sjablonen gebruikt, geeft u een absolute URL op. In het volgende voorbeeld ziet u een inhoudsdefinitie met EEN HTML-sjabloon:

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

DataUri

Het DataUri-element wordt gebruikt om de pagina-id op te geven. Azure AD B2C gebruikt de pagina-id om UI-elementen en JavaScript aan de clientzijde te laden en te initiëren. De notatie van de waarde is urn:com:microsoft:aad:b2c:elements:page-name:version. De volgende tabel bevat de pagina-id's die u kunt gebruiken.

Pagina-id Beschrijving
globalexception Geeft een foutpagina weer wanneer er een uitzondering of een fout optreedt.
providerselection, idpselection Geeft een lijst weer van de id-providers waaruit gebruikers kunnen kiezen tijdens het aanmelden.
unifiedssp Geeft een formulier weer voor aanmelding met een lokaal account dat is gebaseerd op een e-mailadres of een gebruikersnaam. Deze waarde biedt ook de koppeling 'Aanmeldfunctionaliteit behouden' en 'Uw wachtwoord vergeten?'.
unifiedssd Geeft een formulier weer voor aanmelding met een lokaal account dat is gebaseerd op een e-mailadres of een gebruikersnaam. Deze pagina-id is afgeschaft. Gebruik in plaats daarvan de unifiedssp pagina-id.
multifactor Verifieert telefoonnummers met behulp van tekst of spraak tijdens het registreren of aanmelden.
selfasserted Geeft een formulier weer om gegevens van een gebruiker te verzamelen. Stelt gebruikers bijvoorbeeld in staat hun profiel te maken of bij te werken.

Een pagina-indeling selecteren

U kunt Code aan de clientzijde van JavaScript inschakelen door tussen en het paginatype in te contractelements voegen. Bijvoorbeeld: urn:com:microsoft:aad:b2c:elements:contract:page-name:version.

Het versiegedeelte van het DataUri bestand geeft het pakket met inhoud met HTML, CSS en JavaScript op voor de elementen van de gebruikersinterface in uw beleid. Als u code aan de clientzijde van JavaScript wilt inschakelen, moeten de elementen waarop u uw JavaScript baset onveranderbaar zijn. Als ze niet onveranderbaar zijn, kunnen wijzigingen onverwacht gedrag veroorzaken op uw gebruikerspagina's. Als u deze problemen wilt voorkomen, dwingt u het gebruik van een pagina-indeling af en geeft u een versie van de pagina-indeling op. Dit zorgt ervoor dat alle inhoudsdefinities waarop u uw JavaScript hebt gebaseerd onveranderbaar zijn. Zelfs als u JavaScript niet wilt inschakelen, moet u nog steeds de versie van de pagina-indeling voor uw pagina's opgeven.

In het volgende voorbeeld ziet u de DataUri van selfasserted de versie 1.2.0:

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

Migreren naar pagina-indeling

Als u wilt migreren van de oude DataUri-waarde (zonder paginacontract) naar de versie van de pagina-indeling, voegt u het woord contract gevolgd door een paginaversie toe. Gebruik de volgende tabel om te migreren van de oude DataUri-waarde naar de versie van de pagina-indeling.

Oude DataUri-waarde Nieuwe datauri-waarde
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

In het volgende voorbeeld ziet u de inhoudsdefinitie-id's en de bijbehorende DataUri met de nieuwste paginaversie:

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

Metagegevens

Een metagegevenselement bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Onderdeel 0:n De metagegevens die betrekking hebben op de inhoudsdefinitie.

Het itemelement van het element Metagegevens bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Sleutelcode Ja De metagegevenssleutel.

Metagegevenssleutels

Inhoudsdefinitie ondersteunt de volgende metagegevensitems:

Sleutelcode Verplicht Beschrijving
Schermnaam Nee. Een tekenreeks die de naam van de inhoudsdefinitie bevat.

GelokaliseerdeBronnenReferenties

Het element LocalizedResourcesReferences bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Gelokaliseerde bronnen Referentie 1:n Een lijst met gelokaliseerde bronverwijzingen voor de inhoudsdefinitie.

Het element LocalizedResourcesReference bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Taal Ja Een tekenreeks die een ondersteunde taal voor het beleid bevat per RFC 5646 - Tags voor het identificeren van talen.
Gelokaliseerde bronnen Referentie-id Ja De id van het element LocalizedResources .

In het volgende voorbeeld ziet u een definitie van registratie- of aanmeldingsinhoud met een verwijzing naar lokalisatie voor Engels, Frans en Spaans:

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

Zie Lokalisatie voor meer informatie over het toevoegen van lokalisatieondersteuning aan uw inhoudsdefinities.

Id's van inhoudsdefinities

Het id-kenmerk van het element ContentDefinition geeft het type pagina aan dat betrekking heeft op de inhoudsdefinitie. Het element definieert de context die een aangepaste HTML5-/CSS-sjabloon gaat toepassen. In de volgende tabel wordt de set inhoudsdefinitie-id's beschreven die worden herkend door het Identity Experience Framework en de paginatypen die aan deze id's zijn gerelateerd. U kunt uw eigen inhoudsdefinities maken met een willekeurige id.

ID-kaart (standaard)sjabloon Beschrijving
api.fout uitzondering.cshtml Foutpagina : geeft een foutpagina weer wanneer er een uitzondering of een fout is opgetreden.
api.idpsverkiezingen idpSelector.cshtml Pagina voor het selecteren van id-providers : geeft een lijst weer van id-providers waaruit gebruikers kunnen kiezen tijdens het aanmelden. De opties zijn meestal zakelijke id-providers, sociale id-providers zoals Facebook en Google+, of lokale accounts.
api.idpsverkiezingen.aanmelden idpSelector.cshtml Selectie van id-providers voor registratie : geeft een lijst weer van id-providers waaruit gebruikers kunnen kiezen tijdens de registratie. De opties zijn meestal zakelijke id-providers, sociale id-providers zoals Facebook en Google+, of lokale accounts.
api.localaccountpasswordreset zelfbevestiging.cshtml Wachtwoordpagina vergeten - Geeft een formulier weer dat gebruikers moeten voltooien om een wachtwoord opnieuw in te stellen.
api.localaccountsignin zelfbevestiging.cshtml Aanmeldingspagina voor lokaal account: geeft een formulier weer voor aanmelding met een lokaal account dat is gebaseerd op een e-mailadres of een gebruikersnaam. Het formulier kan een tekstvak en een invoervak voor wachtwoorden bevatten.
api.localaccountaanmelden zelfbevestiging.cshtml Registratiepagina voor lokaal account: geeft een formulier weer voor registratie voor een lokaal account dat is gebaseerd op een e-mailadres of gebruikersnaam. Het formulier kan verschillende invoerbesturingselementen bevatten, zoals: een tekstvak, een invoervak voor wachtwoorden, een keuzerondje, vervolgkeuzelijsten met één selectie en selectievakjes met meerdere selectievakjes.
api.phonefactor multifactor-1.0.0.cshtml Pagina Meervoudige verificatie : verifieert telefoonnummers, met behulp van tekst of spraak, tijdens het registreren of aanmelden.
api.zelfbevestiging zelfbevestiging.cshtml Aanmeldingspagina voor sociale accounts : geeft een formulier weer dat gebruikers moeten voltooien wanneer ze zich aanmelden met een bestaand account van een sociale id-provider. Deze pagina is vergelijkbaar met de voorgaande aanmeldingspagina voor sociale accounts, met uitzondering van de velden voor wachtwoordinvoer.
api.zelfbevestiging.profielupdate updateprofiel.cshtml Pagina profielupdate - Geeft een formulier weer waartoe gebruikers toegang hebben om hun profiel bij te werken. Deze pagina is vergelijkbaar met de aanmeldingspagina van het sociale account, met uitzondering van de velden voor wachtwoordinvoer.
api.signuporsignin verenigd.cshtml Geïntegreerde registratie- of aanmeldingspagina : verwerkt het registratie- en aanmeldingsproces van de gebruiker. Gebruikers kunnen zakelijke id-providers, sociale id-providers, zoals Facebook of Google+, of lokale accounts gebruiken.

Volgende stappen

Zie voor een voorbeeld van het aanpassen van de gebruikersinterface met behulp van inhoudsdefinities:

De gebruikersinterface van uw toepassing aanpassen met behulp van een aangepast beleid

  • Last updated on