부울 클레임 변환

이 문서에서는 Azure AD B2C(Active Directory B2C) 내 ID 경험 프레임워크 스키마의 부울 클레임 변환 사용을 위한 예제를 제공합니다. 자세한 내용은 클레임 변환을 참조하세요.

AndClaims

두 부울 입력 클레임의 And 연산을 계산하고 연산 결과를 사용하여 출력 클레임을 설정합니다. 이 클레임 변환의 라이브 데모를 확인하세요.

요소	TransformationClaimType	데이터 형식	메모
InputClaim	inputClaim1	boolean	평가할 첫 번째 클레임입니다.
InputClaim	inputClaim2	boolean	평가할 두 번째 클레임입니다.
OutputClaim	outputClaim	boolean	이 클레임 변환을 호출하고 나면 생성되는 클레임(true 또는 false)입니다.

AndClaims의 예

다음 클레임 변환은 두 부울 클레임(isEmailNotExist 및 isSocialAccount)의 And 연산을 수행하는 방법을 보여 줍니다. 두 입력 클레임의 값이 모두 true이면 출력 클레임 presentEmailSelfAsserted는 true로 설정됩니다.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="AndClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="isEmailNotExist" TransformationClaimType="inputClaim1" />
    <InputClaim ClaimTypeReferenceId="isSocialAccount" TransformationClaimType="inputClaim2" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="presentEmailSelfAsserted" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• 입력 클레임:
  • inputClaim1: true
  • inputClaim2: false
• 출력 클레임:
  • outputClaim: false

AssertBooleanClaimIsEqualToValue

두 클레임의 부울 값이 같은지 확인하고 같지 않으면 예외를 throw합니다. 이 클레임 변환의 라이브 데모를 확인하세요.

요소	TransformationClaimType	데이터 형식	메모
inputClaim	inputClaim	boolean	확인할 클레임입니다.
InputParameter	valueToCompareTo	boolean	비교할 값(true 또는 false)입니다.

AssertBooleanClaimIsEqualToValue 클레임 변환은 항상 자체 어설션된 기술 프로필을 통해 호출되는 유효성 검사 기술 프로필에서 실행됩니다. UserMessageIfClaimsTransformationBooleanValueIsNotEqual 자체 어설션된 기술 프로필 메타데이터는 기술 프로필이 사용자에게 표시하는 오류 메시지를 제어합니다. 오류 메시지는 지역화될 수 있습니다.

AssertBooleanClaimIsEqualToValue의 예

다음 클레임 변환은 true 값을 사용하여 부울 클레임의 값을 확인하는 방법을 보여 줍니다. accountEnabled 클레임의 값이 false이면 오류 메시지가 throw됩니다.

<ClaimsTransformation Id="AssertAccountEnabledIsTrue" TransformationMethod="AssertBooleanClaimIsEqualToValue">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="accountEnabled" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="valueToCompareTo" DataType="boolean" Value="true" />
  </InputParameters>
</ClaimsTransformation>

• 입력 클레임:
  • inputClaim: false
  • valueToCompareTo: true
• 결과: 오류가 throw됨

AssertBooleanClaimIsEqualToValue 클레임 변환 호출

다음 Example-AssertBoolean 유효성 검사 기술 프로필은 AssertAccountEnabledIsTrue 클레임 변환을 호출합니다.

<TechnicalProfile Id="Example-AssertBoolean">
  <DisplayName>Unit test</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.ClaimsTransformationProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="ComparisonResult" DefaultValue="false" />
  </OutputClaims>
  <OutputClaimsTransformations>
    <OutputClaimsTransformation ReferenceId="AssertAccountEnabledIsTrue" />
  </OutputClaimsTransformations>
  <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
</TechnicalProfile>

자체 어설션된 기술 프로필은 Example-AssertBoolean 유효성 검사 기술 프로필을 호출합니다.

<TechnicalProfile Id="SelfAsserted-AssertDateTimeIsGreaterThan">
  <DisplayName>Example</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.selfasserted</Item>
    <Item Key="UserMessageIfClaimsTransformationBooleanValueIsNotEqual">Custom error message if account is disabled.</Item>
  </Metadata>
  ...
  <ValidationTechnicalProfiles>
    <ValidationTechnicalProfile ReferenceId="Example-AssertBoolean" />
  </ValidationTechnicalProfiles>
</TechnicalProfile>

CompareBooleanClaimToValue

클레임의 부울 값이 true 또는 false와 같은지 확인하고 압축 결과를 반환합니다. 이 클레임 변환의 라이브 데모를 확인하세요.

요소	TransformationClaimType	데이터 형식	메모
InputClaim	inputClaim	boolean	비교할 클레임입니다.
InputParameter	valueToCompareTo	boolean	비교할 값(true 또는 false)입니다.
OutputClaim	compareResult	boolean	이 클레임 변환이 호출된 후에 생성되는 클레임입니다.

CompareBooleanClaimToValue의 예

다음 클레임 변환은 true 값을 사용하여 부울 클레임의 값을 확인하는 방법을 보여 줍니다. IsAgeOver21Years 클레임의 값이 true와 같으면 클레임 변환에서 true를 반환하고 다르면 false로 반환합니다.

<ClaimsTransformation Id="AssertAccountEnabled" TransformationMethod="CompareBooleanClaimToValue">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="IsAgeOver21Years" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="valueToCompareTo" DataType="boolean" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim  ClaimTypeReferenceId="accountEnabled" TransformationClaimType="compareResult"/>
  </OutputClaims>
</ClaimsTransformation>

• 입력 클레임:
  • inputClaim: false
• 입력 매개 변수:
  • valueToCompareTo: true
• 출력 클레임:
  • compareResult: false

NotClaims

부울 입력 클레임의 Not 연산을 계산하고 연산 결과를 사용하여 출력 클레임을 설정합니다. 이 클레임 변환의 라이브 데모를 확인하세요.

요소	TransformationClaimType	데이터 형식	메모
InputClaim	inputClaim	boolean	연산을 수행할 클레임입니다.
OutputClaim	outputClaim	boolean	이 클레임 변환을 호출하고 나면 생성되는 클레임(true 또는 false)입니다.

NotClaims의 예

다음 클레임 변환은 클레임에 대해 논리적 부정을 수행하는 방법을 보여줍니다.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="NotClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="userExists" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="userExists" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• 입력 클레임:
  • inputClaim: false
• 출력 클레임:
  • outputClaim: true

OrClaims

두 부울 입력 클레임의 Or을 계산하고 연산 결과를 사용하여 출력 클레임을 설정합니다. 이 클레임 변환의 라이브 데모를 확인하세요.

요소	TransformationClaimType	데이터 형식	메모
InputClaim	inputClaim1	boolean	평가할 첫 번째 클레임입니다.
InputClaim	inputClaim2	boolean	평가할 두 번째 클레임입니다.
OutputClaim	outputClaim	boolean	이 클레임 변환을 호출하고 나면 생성되는 클레임(true 또는 false)입니다.

OrClaims의 예

다음 클레임 변환은 두 부울 클레임의 Or 연산을 수행하는 방법을 보여 줍니다.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="OrClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="isLastTOSAcceptedNotExists" TransformationClaimType="inputClaim1" />
    <InputClaim ClaimTypeReferenceId="isLastTOSAcceptedGreaterThanNow" TransformationClaimType="inputClaim2" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="presentTOSSelfAsserted" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• 입력 클레임:
  • inputClaim1: true
  • inputClaim2: false
• 출력 클레임:
  • outputClaim: true

다음 단계

• Azure AD B2C 커뮤니티 GitHub 리포지토리에서 더 많은 클레임 변환 샘플 찾기