BuildingBlocks

Uwaga

W usłudze Azure Active Directory B2C zasady niestandardowe są przeznaczone głównie do rozwiązywania złożonych scenariuszy. W przypadku większości scenariuszy zalecamy używanie wbudowanych przepływów użytkowników. Jeśli nie zostało to zrobione, dowiedz się więcej o niestandardowym pakiecie startowym zasad w temacie Wprowadzenie do zasad niestandardowych w usłudze Active Directory B2C.

Element BuildingBlocks jest dodawany wewnątrz elementu 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="mytenant.onmicrosoft.com"
  PolicyId="B2C_1A_TrustFrameworkBase"
  PublicPolicyUri="http://mytenant.onmicrosoft.com/B2C_1A_TrustFrameworkBase">

  <BuildingBlocks>
    <ClaimsSchema>
      ...
    </ClaimsSchema>
    <Predicates>
    ...
    </Predicates>
    <PredicateValidations>
    ...
    </PredicateValidations>
    <ClaimsTransformations>
      ...
    </ClaimsTransformations>
    <ContentDefinitions>
      ...
    </ContentDefinitions>
    <Localization>
      ...
    </Localization>
    <DisplayControls>
      ...
    </DisplayControls>
 </BuildingBlocks>

Element BuildingBlocks zawiera następujące elementy, które należy określić w zdefiniowanej kolejności:

• ClaimsSchema — definiuje typy oświadczeń, do których można się odwoływać w ramach zasad. Schemat oświadczeń to miejsce, w którym deklarujesz typy oświadczeń. Typ oświadczenia jest podobny do zmiennej w wielu językach programowych. Możesz użyć typu oświadczenia do zbierania danych od użytkownika aplikacji, odbierania oświadczeń od dostawców tożsamości społecznościowych, wysyłania i odbierania danych z niestandardowego interfejsu API REST lub przechowywania dowolnych danych wewnętrznych używanych przez zasady niestandardowe.

• Predykaty i PredicateValidationsInput — umożliwia przeprowadzenie procesu weryfikacji, aby upewnić się, że tylko prawidłowo sformułowane dane są wprowadzane do oświadczenia.

• ClaimsTransformations — zawiera listę przekształceń oświadczeń, które mogą być używane w zasadach. Przekształcenie oświadczeń konwertuje jedno oświadczenie na inne. W transformacji oświadczeń należy określić metodę przekształcania, taką jak:

  • Zmiana wielkości liter oświadczenia ciągu na określony. Na przykład zmiana ciągu z małych liter na wielkie litery.
  • Porównywanie dwóch oświadczeń i zwracanie oświadczenia z wartością true wskazującą, że oświadczenia są zgodne, w przeciwnym razie false.
  • Tworzenie oświadczenia ciągu na podstawie podanego parametru w zasadach.
  • Tworzenie losowego ciągu przy użyciu generatora liczb losowych.
  • Formatowanie oświadczenia zgodnie z podanym ciągiem formatu. Ta transformacja używa metody języka C# String.Format .

• InputValidation — ten element umożliwia wykonywanie agregacji logicznych, które są podobne do i ilub.

• ContentDefinitions — zawiera adresy URL szablonów HTML5 do użycia w podróży użytkownika. W zasadach niestandardowych definicja zawartości definiuje identyfikator URI strony HTML5, który jest używany do określonego kroku podróży użytkownika. Na przykład strony logowania lub rejestracji, resetowania hasła lub błędów. Wygląd i działanie można zmodyfikować, przesłaniając identyfikator LoadUri dla pliku HTML5. Możesz też utworzyć nowe definicje zawartości zgodnie z potrzebami. Ten element może zawierać odwołanie do zlokalizowanych zasobów przy użyciu identyfikatora lokalizacji.

• Lokalizacja — umożliwia obsługę wielu języków. Obsługa lokalizacji w zasadach umożliwia skonfigurowanie listy obsługiwanych języków w zasadach i wybranie języka domyślnego. Obsługiwane są również ciągi i kolekcje specyficzne dla języka.

• DisplayControls — definiuje kontrolki , które mają być wyświetlane na stronie. Kontrolki wyświetlania mają specjalne funkcje i wchodzą w interakcje z profilami technicznymi weryfikacji zaplecza.