Azure AD B2C의 전화 번호 클레임 변환 정의
이 문서에서는 Azure AD B2C(Azure Active Directory B2C) 사용자 지정 정책의 전화 번호 클레임 변환을 사용하기 위한 참조 및 예제를 제공합니다. 일반적인 클레임 변환에 대한 자세한 내용은 ClaimsTransformations를 참조하세요.
참고
이 기능은 공개 미리 보기 상태입니다.
ConvertPhoneNumberClaimToString
phoneNumber 데이터 형식을 string 데이터 형식으로 변환합니다. 이 클레임 변환의 라이브 데모를 확인하세요.
| 요소 | TransformationClaimType | 데이터 형식 | 메모 |
|---|---|---|---|
| InputClaim | phoneNumber | phoneNumber | 문자열로 변환할 클레임입니다. |
| OutputClaim | phoneNumberString | 문자열 | 이 클레임 변환이 호출된 후에 생성되는 클레임입니다. |
ConvertPhoneNumberClaimToString의 예
이 예제에서는 값 형식이 phoneNumber인 cellPhoneNumber 클레임은 값 형식이 string인 cellPhone 클레임으로 변환됩니다.
<ClaimsTransformation Id="PhoneNumberToString" TransformationMethod="ConvertPhoneNumberClaimToString">
<InputClaims>
<InputClaim ClaimTypeReferenceId="cellPhoneNumber" TransformationClaimType="phoneNumber" />
</InputClaims>
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="cellPhone" TransformationClaimType="phoneNumberString" />
</OutputClaims>
</ClaimsTransformation>
- 입력 클레임:
- phoneNumber: +11234567890(phoneNumber)
- 출력 클레임:
- phoneNumberString: +11234567890(문자열)
ConvertStringToPhoneNumberClaim
전화 번호 형식의 유효성을 검사합니다. 유효한 경우 Azure AD B2C에서 사용하는 표준 형식으로 변경합니다. 제공된 전화 번호의 형식이 잘못된 경우 오류 메시지가 반환됩니다. 이 클레임 변환의 라이브 데모를 확인하세요.
| 요소 | TransformationClaimType | 데이터 형식 | 메모 |
|---|---|---|---|
| InputClaim | phoneNumberString | 문자열 | 전화 번호에 대한 문자열 클레임입니다. 전화 번호는 국제 형식이어야 하며 앞에 "+"와 국가/지역 코드로 완료해야 합니다. 입력 클레임 country가 제공되는 경우 전화 번호는 지역 형식(국가/지역 코드 제외)입니다. |
| InputClaim | country | 문자열 | [선택 사항] ISO3166 형식의 전화 번호 국가/지역 코드에 대한 문자열 클레임(2자 ISO-3166 국가/지역 코드). |
| OutputClaim | outputClaim | phoneNumber | 이 클레임 변환의 결과입니다. |
ConvertStringToPhoneNumberClaim 클레임 변환은 항상 자체 어설션된 기술 프로필 또는 표시 컨트롤을 통해 호출되는 유효성 검사 기술 프로필에서 실행됩니다. UserMessageIfClaimsTransformationInvalidPhoneNumber 자체 어설션된 기술 프로필 메타데이터는 사용자에게 표시되는 오류 메시지를 제어합니다.
ConvertStringToPhoneNumberClaim의 예
다음 예제에서는 phoneString 클레임이 실제로 유효한 전화 번호인지 확인한 다음, 표준 Azure AD B2C 형식으로 전화 번호를 반환합니다. 그렇지 않으면 오류 메시지가 throw됩니다.
<ClaimsTransformation Id="ConvertStringToPhoneNumber" TransformationMethod="ConvertStringToPhoneNumberClaim">
<InputClaims>
<InputClaim ClaimTypeReferenceId="phoneString" TransformationClaimType="phoneNumberString" />
<InputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="country" />
</InputClaims>
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="outputClaim" />
</OutputClaims>
</ClaimsTransformation>
- 입력 클레임:
- phoneNumberString: 033 456-7890
- 국가: DK
- 출력 클레임:
- outputClaim: +450334567890
국가 코드 클레임이 없는 ConvertStringToPhoneNumberClaim의 예
이 클레임 변환 모드의 라이브 데모를 확인하세요.
- 입력 클레임:
- phoneNumberString: +1(123) 456-7890
- 출력 클레임:
- outputClaim: +11234567890
ConvertStringToPhoneNumberClaim 클레임 변환 호출
이 클레임 변환이 포함된 유효성 검사 기술 프로필을 호출하는 자체 어설션된 기술 프로필은 오류 메시지를 정의할 수 있습니다.
<TechnicalProfile Id="SelfAsserted-LocalAccountSignUp-Phone">
<Metadata>
<Item Key="UserMessageIfClaimsTransformationInvalidPhoneNumber">Custom error message if the phone number is not valid.</Item>
</Metadata>
...
</TechnicalProfile>
GetNationalNumberAndCountryCodeFromPhoneNumberString
입력 클레임에서 국가/지역 코드와 국가 번호를 추출하고, 제공된 전화 번호가 올바르지 않은 경우 필요에 따라 예외를 throw합니다. 이 클레임 변환의 라이브 데모를 확인하세요.
| 요소 | TransformationClaimType | 데이터 형식 | 메모 |
|---|---|---|---|
| InputClaim | phoneNumber | 문자열 | 전화 번호의 문자열 클레임입니다. 전화 번호는 국제 형식이어야 하며 앞에 "+"와 국가/지역 코드로 완료해야 합니다. |
| InputParameter | throwExceptionOnFailure | boolean | [선택 사항] 전화 번호가 잘못된 경우 예외가 throw되는지 여부를 나타내는 매개 변수입니다. 기본값은 False입니다. |
| InputParameter | countryCodeType | 문자열 | [선택 사항] 출력 클레임에서 국가/지역 코드의 형식을 나타내는 매개 변수입니다. 사용 가능한 값은 CallingCode(국가/지역에 대한 국제 호출 코드(예: +1)) 또는 ISO3166(2자 ISO-3166 국가/지역 코드)입니다. |
| OutputClaim | nationalNumber | 문자열 | 전화 번호의 국가별 번호에 대한 문자열 클레임입니다. |
| OutputClaim | countryCode | 문자열 | 전화 번호의 국가/지역 코드에 대한 문자열 클레임입니다. |
GetNationalNumberAndCountryCodeFromPhoneNumberString 클레임 변환이 자체 어설션된 기술 프로필 또는 표시 제어 작업을 통해 호출된 효율성 검사 기술 프로필에서 실행된 경우 UserMessageIfPhoneNumberParseFailure 자체 어설션된 기술 프로필 메타데이터가 사용자에게 표시되는 오류 메시지를 제어합니다.
이 클레임 변환을 사용하여 전체 전화 번호를 국가/지역 코드와 국가별 번호로 분할할 수 있습니다. 제공된 전화 번호가 잘못된 경우 오류 메시지를 throw하도록 선택할 수 있습니다.
GetNationalNumberAndCountryCodeFromPhoneNumberString의 예
다음 예제에서는 전화 번호를 국가별 번호와 국가/지역 코드로 분할하려고 합니다. 전화 번호가 유효한 경우 전화 번호는 국가별 번호로 재정의됩니다. 전화 번호가 잘못된 경우 예외가 throw되지 않으며 전화 번호에 원래 값이 남아 있습니다.
<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
<InputClaims>
<InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
</InputClaims>
<InputParameters>
<InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
<InputParameter Id="countryCodeType" DataType="string" Value="ISO3166" />
</InputParameters>
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
<OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
</OutputClaims>
</ClaimsTransformation>
- 입력 클레임:
- phoneNumber: +49(123) 456-7890
- 입력 매개 변수:
- throwExceptionOnFailure: false
- countryCodeType: ISO3166
- 출력 클레임:
- nationalNumber: 1234567890
- countryCode: DE
CallingCode 매개 변수가 있는 GetNationalNumberAndCountryCodeFromPhoneNumberString의 예
다음 예제에서는 전화 번호를 국가별 번호와 국가 통화 코드로 분할하려고 합니다.
<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
<InputClaims>
<InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
</InputClaims>
<InputParameters>
<InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
<InputParameter Id="countryCodeType" DataType="string" Value="CallingCode" />
</InputParameters>
<OutputClaims>
<OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
<OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
</OutputClaims>
</ClaimsTransformation>
- 입력 클레임:
- phoneNumber: +49(123) 456-7890
- 입력 매개 변수
- throwExceptionOnFailure: false
- countryCodeType: CallingCode
- 출력 클레임:
- nationalNumber: 1234567890
- countryCode: +49
GetNationalNumberAndCountryCodeFromPhoneNumberString 클레임 변환 호출
이 클레임 변환이 포함된 유효성 검사 기술 프로필을 호출하는 자체 어설션된 기술 프로필은 오류 메시지를 정의할 수 있습니다.
<TechnicalProfile Id="SelfAsserted-LocalAccountSignup-Phone">
<Metadata>
<Item Key="UserMessageIfPhoneNumberParseFailure">Custom error message if the phone number is not valid.</Item>
</Metadata>
...
</TechnicalProfile>
다음 단계
- Azure AD B2C 커뮤니티 GitHub 리포지토리에서 더 많은 클레임 변환 샘플 찾기