ContentDefinitions

可以自定义任何 自断言技术配置文件的外观。 Azure Active Directory B2C（Azure AD B2C）在客户的浏览器中运行代码，并使用一种称为跨域资源共享（CORS）的新式方法。

若要自定义用户界面，请在 ContentDefinition 元素中指定包含自定义 HTML 内容的 URL。 在自断言技术配置文件或 OrchestrationStep 中，指向该内容定义标识符。 内容定义可能包含 LocalizedResourcesReferences 元素，该元素指定要加载的本地化资源列表。 Azure AD B2C 将用户界面元素与从 URL 加载的 HTML 内容合并，然后向用户显示页面。

ContentDefinitions 元素包含可用于用户旅程的 HTML5 模板的 URL。 HTML5 页面 URI 用于指定的用户界面步骤。 例如，登录或注册、密码重置或错误页。 可以通过重写 HTML5 文件的 LoadUri 来修改外观。 可以根据需要创建新的内容定义。 此元素可能包含本地化资源引用，以引用本地化元素中指定的 本地化 标识符。

以下示例显示了内容定义标识符和本地化资源的定义：

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

LocalAccountSignUpWithLogonEmail 自断言技术配置文件的元数据包含内容定义标识符 ContentDefinitionReferenceId 设置为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>
  ...

ContentDefinition 元素包含以下属性：

ContentDefinition 元素包含以下元素：

LoadUri 元素用于指定内容定义的 HTML5 页面的 URL。 Azure AD B2C 自定义策略初学者包 附带了使用 Azure AD B2C HTML 页面的内容定义。 LoadUri 以 Azure AD B2C 租户的相对路径开头~。

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

可以使用 HTML 模板自定义用户界面。 使用 HTML 模板时，请提供绝对 URL。 以下示例演示了 HTML 模板的内容定义：

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

DataUri 元素用于指定页面标识符。 Azure AD B2C 使用页面标识符来加载和启动 UI 元素和客户端 JavaScript。 值的格式为 urn:com:microsoft:aad:b2c:elements:page-name:version. 下表列出了可以使用的页面标识符。

可以通过在页面类型之间插入contract和页面类型来启用 elements。 例如，urn:com:microsoft:aad:b2c:elements:contract:page-name:version。

版本部分DataUri指定策略中用户界面元素包含 HTML、CSS 和 JavaScript 的内容包。 如果打算启用 JavaScript 客户端代码，则基于 JavaScript 的元素必须不可变。 如果它们不是不可变的，任何更改都可能导致用户页面上出现意外行为。 若要防止这些问题，请强制使用页面布局并指定页面布局版本。 这样做可确保基于 JavaScript 的所有内容定义都是不可变的。 即使不想启用 JavaScript，仍需要为页面指定页面布局版本。

以下示例显示了版本的 selfasserted1.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> -->

若要从旧的 DataUri 值（没有页面协定）迁移到页面布局版本，请添加后跟页面版本的单词 contract 。 使用下表从旧的 DataUri 值迁移到页面布局版本。

以下示例显示了内容定义标识符和具有最新页面版本的相应 DataUri：

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

Metadata 元素包含以下元素：

Metadata 元素的 Item 元素包含以下属性：

内容定义支持以下元数据项：

LocalizedResourcesReferences 元素包含以下元素：

LocalizedResourcesReference 元素包含以下属性：

以下示例演示了一个注册或登录内容定义，该定义引用了英语、法语和西班牙语的本地化：

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

若要了解如何向内容定义添加本地化支持，请参阅 本地化。

ContentDefinition 元素的 ID 属性指定与内容定义相关的页面类型。 该元素定义自定义 HTML5/CSS 模板将应用的上下文。 下表描述了标识体验框架识别的内容定义 ID 集，以及与其相关的页面类型。 可以使用任意 ID 创建自己的内容定义。

有关使用内容定义自定义用户界面的示例，请参阅：

使用自定义策略自定义应用程序的用户界面