Compartilhar via


Política de Estrutura de Confiança

Importante

A partir de 1º de maio de 2025, o Azure AD B2C não estará mais disponível para compra para novos clientes. Saiba mais em nossas perguntas frequentes.

Observação

No Azure Active Directory B2C, as políticas personalizadas são projetadas principalmente para tratar de cenários complexos. Para a maioria dos cenários, recomendamos que você use fluxos de usuários predefinidos. Se você ainda não fez isso, saiba mais sobre o pacote de início de política personalizado em Introdução às políticas personalizadas no Active Directory B2C.

Uma política personalizada é representada como um ou mais arquivos formatados por XML, que se referem uns aos outros em uma cadeia hierárquica. Os elementos XML definem elementos da política, como o esquema de declarações, transformações de declarações, definições de conteúdo, provedores de declarações, perfis técnicos, percurso do usuário e etapas de orquestração. Cada arquivo de política é definido dentro do elemento TrustFrameworkPolicy de nível superior de um arquivo de política.

<TrustFrameworkPolicy
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="https://www.w3.org/2001/XMLSchema"
  xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
  PolicySchemaVersion="0.3.0.0"
  TenantId="yourtenant.onmicrosoft.com"
  PolicyId="B2C_1A_TrustFrameworkBase"
  PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">
  ...

O elemento TrustFrameworkPolicy contém os seguintes atributos:

Atributo Obrigatório Descrição
PolicySchemaVersion Sim A versão do esquema que deve ser usada para executar a política. O valor deve ser 0.3.0.0
TenantObjectId Não O identificador de objeto exclusivo do locatário do Azure AD B2C (Azure Active Directory B2C).
ID do Inquilino (TenantId) Sim O identificador exclusivo do locatário ao qual essa política pertence.
PolicyId Sim O identificador exclusivo da política. Esse identificador deve ser prefixado por B2C_1A_
PublicPolicyUri Sim O URI da política, que é a combinação da ID do locatário e da ID da política.
Modo de implantação Não Valores possíveis: Production ou Development. Production é o padrão. Use essa propriedade para depurar sua política. Para obter mais informações, consulte Coletando logs.
UserJourneyRecorderEndpoint Não O ponto de extremidade usado para registro em log. O valor deve ser definido para urn:journeyrecorder:applicationinsights se o atributo existir. Para obter mais informações, consulte Coletando logs.

O exemplo a seguir mostra como especificar o elemento TrustFrameworkPolicy :

<TrustFrameworkPolicy
   xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="https://www.w3.org/2001/XMLSchema"
   xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
   PolicySchemaVersion="0.3.0.0"
   TenantId="yourtenant.onmicrosoft.com"
   PolicyId="B2C_1A_TrustFrameworkBase"
   PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">

O elemento TrustFrameworkPolicy contém os seguintes elementos:

Elemento Ocorrências Descrição
Política de base 0:1 O identificador de uma política base.
Blocos de construção 0:1 Os blocos de construção da política.
Provedores de declarações 0:1 Uma coleção de provedores de declarações.
Jornadas do usuário 0:1 Uma coleção de percursos do usuário.
SubJornadas 0:1 Uma coleção de sub-percursos.
Contando com o Partido 0:1 Uma definição de uma política de terceira parte confiável.

Para herdar uma política de outra política, um elemento BasePolicy deve ser declarado sob o elemento TrustFrameworkPolicy do arquivo de política. O elemento BasePolicy é uma referência à política base da qual essa política é derivada.

As ocorrências referem-se ao número de elementos filho que um elemento pai pode ou deve ter:

  • 0:1 significa que o elemento pai tem zero ou um elemento filho.
  • 1:1 significa que o elemento pai deve ter um elemento filho.
  • 1:n significa que o elemento pai deve ter um ou muitos elementos filho.
  • 0:n significa que o elemento pai pode ter zero ou qualquer número de elementos.

O elemento BasePolicy contém os seguintes elementos:

Elemento Ocorrências Descrição
ID do Inquilino (TenantId) 1:1 O identificador do locatário do Azure AD B2C.
PolicyId 1:1 O identificador da política pai.

O exemplo a seguir mostra como especificar uma política base. Essa política de B2C_1A_TrustFrameworkExtensions é derivada da política de B2C_1A_TrustFrameworkBase .

<TrustFrameworkPolicy
   xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="https://www.w3.org/2001/XMLSchema"
   xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06"
   PolicySchemaVersion="0.3.0.0"
   TenantId="yourtenant.onmicrosoft.com"
   PolicyId="B2C_1A_TrustFrameworkExtensions"
   PublicPolicyUri="http://yourtenant.onmicrosoft.com/B2C_1A_TrustFrameworkExtensions">

  <BasePolicy>
    <TenantId>yourtenant.onmicrosoft.com</TenantId>
    <PolicyId>B2C_1A_TrustFrameworkBase</PolicyId>
  </BasePolicy>
  ...
</TrustFrameworkPolicy>