가입 시 사용자 지정 사용자 특성 수집
적용: 
Workforce 테넌트 
외부 테넌트(자세히 알아보기)
팁
이 문서는 외부 테넌트의 사용자 흐름에 적용됩니다. 인력 테넌트에 대한 자세한 내용은 사용자 흐름의 사용자 지정 특성 정의를 참조하세요.
기본 제공 사용자 특성이 제공하는 것보다 더 많은 정보가 앱에 필요한 경우 고유한 특성을 추가할 수 있습니다. 이러한 특성을 사용자 지정 사용자 특성이라고합니다.
사용자 지정 사용자 특성을 정의하려면 먼저 테넌트의 모든 사용자 흐름에서 사용할 수 있도록 테넌트 수준에서 특성을 만듭니다. 그런 다음 특성을 가입 사용자 흐름에 할당하고 가입 페이지에 표시할 방법을 구성합니다.
사용자 프로필 특성 문서에서 사용자 지의 사용자 특성에 자세히 알아봅니다.
사용자 지정 사용자 특성 만들기
Microsoft Entra 관리 센터에 로그인합니다.
여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘
을 사용하여 디렉터리 + 구독 메뉴에서 외부 테넌트로 전환합니다.ID>외부 ID>개요로 이동합니다.
사용자 지정 사용자 특성을 선택합니다. 목록에는 만든 사용자 지정 사용자 특성을 비롯해 테넌트에서 사용할 수 있는 모든 사용자 특성이 포함됩니다. 특성 유형 열은 특성이 기본 제공 특성인지 사용자 지정 특성인지를 나타냅니다.
추가를 선택합니다. 특성 추가 창에서 사용자 지정 특성의 이름(예: “사용 약관”)을 입력합니다.
데이터 형식에서 만들려는 데이터 및 사용자 입력 컨트롤의 형식에 따라 문자열, 부울 또는 Int를 선택합니다. 문자열 특성의 기본 사용자 입력 형식 값은 TextBox이지만 이후 단계에 이 값을 변경할 수 있습니다(예를 들어 라디오 단추나 다중 선택 확인란을 구성하려는 경우).
(선택 사항) 설명에 내부에서 사용할 사용자 지정 특성에 대한 설명을 입력합니다. 이 설명은 사용자에게 표시되지 않습니다.
만들기를 실행합니다. 이제 사용자 특성 목록에서 사용자 지정 특성을 사용할 수 있으며 사용자 흐름에 추가할 수 있습니다.
가입 흐름에 사용자 지정 사용자 특성 포함
이미 만든 사용자 흐름에 사용자 지정 사용자 특성을 추가하려면 다음 단계를 따릅니다. (새 사용자 흐름을 만들어야 하면 고객을 위한 가입 및 로그인 사용자 흐름 만들기를 참조하세요.)
Microsoft Entra 관리 센터에 로그인합니다.
여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘
을 사용하여 디렉터리 + 구독 메뉴에서 외부 테넌트로 전환합니다.ID>External Identities>사용자 흐름으로 이동합니다.
목록에서 사용자 흐름을 선택합니다.
사용자 특성을 선택합니다. 이 목록에는 이전 섹션에서 설명한 대로 정의한 모든 사용자 지정 사용자 특성이 포함됩니다. 예를 들어 이제 새 사용 약관 특성이 목록에 표시됩니다. 가입하는 동안 사용자로부터 수집하려는 특성을 선택합니다.
저장을 선택합니다.
사용자 입력 형식 및 페이지 레이아웃 구성
페이지 레이아웃 페이지에서 필요한 특성을 지정하고 표시 순서를 정렬할 수 있습니다. 또한 특성 레이블을 편집하고, 라디오 단추 또는 확인란을 만들고, 더 많은 콘텐츠(예: 사용 약관 또는 개인정보취급방침)에 대한 하이퍼링크를 추가할 수도 있습니다.
Microsoft Entra 관리 센터에 로그인합니다.
ID>외부 ID>사용자 흐름으로 이동합니다.
목록에서 사용자 흐름을 선택합니다.
사용자 지정에서 페이지 레이아웃을 선택합니다. 수집하기로 선택한 특성이 나타납니다.
레이블 열에서 값을 선택하고 텍스트를 수정하여 특성에 대한 레이블을 편집합니다.
다음과 같은 확인란 또는 라디오 단추를 구성합니다.
- 단일 선택 확인란: 부울 특성 형식이 가입 페이지에서 단일 선택 확인란으로 렌더링됩니다. 확인란 옆에 표시되는 텍스트를 구성하려면 레이블 열에서 값을 선택하고 편집합니다. Markdown 언어를 사용하여 하이퍼링크를 추가합니다. 자세한 내용은 단일 선택 확인란(CheckboxSingleSelect)을 구성하려면을 참조하세요.
- 다중 선택 확인란: 구성하려는 문자열 데이터 형식 특성을 찾고 사용자 입력 형식 열에서 값을 선택하여 편집기 창을 엽니다. CheckboxMultiSelect 사용자 입력 형식을 선택하고 값을 입력합니다. 자세한 내용은 다중 선택 확인란(CheckboxMultiSelect)을 구성하려면을 참조하세요.
- 라디오 단추: 구성하려는 문자열 데이터 형식 특성을 찾고 사용자 입력 형식 열에서 값을 선택하여 편집기 창을 엽니다. RadioSingleSelect 사용자 입력 형식을 선택하고 값을 입력합니다. 자세한 내용은 라디오 단추(RadioSingleSelect)를 구성하려면을 참조하세요.
특성을 선택하고 위로 이동, 아래로 이동, 맨 위로 이동 또는 맨 아래로 이동을 선택하여 표시 순서를 변경합니다.
필수 열의 확인란을 선택하여 필수 특성으로 만듭니다. 모든 특성을 필수로 표시할 수 있습니다. 다중 선택 확인란의 경우 “필수”이면 사용자가 하나 이상의 확인란을 선택해야 합니다.
모든 변경이 완료되면 저장을 선택합니다.
단일 선택 확인란(CheckboxSingleSelect) 구성
부울 데이터 형식의 특성은 사용자 입력 형식이 CheckboxSingleSelect입니다. 확인란 옆에 표시되는 텍스트를 수정하고 하이퍼링크를 포함할 수 있습니다.
팁
이 기능을 사용해 보려면 Woodgrove Groceries 데모로 이동하여 “사용 약관 및 개인정보처리방침에 대한 링크 추가” 사용 사례를 시작합니다.
단일 선택 확인란을 구성하려면 다음 단계를 수행합니다.
페이지 레이아웃 페이지에서 구성하려는 부울 데이터 형식의 특성을 찾습니다.
레이블 열에서 값을 선택하고 확인란 옆에 표시할 텍스트를 입력합니다. Markdown 언어를 사용하여 하이퍼링크를 추가합니다. 예시:
사용 약관 특성에 대한 레이블을 구성하려면 다음을 입력할 수 있습니다.
I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use);또는 사용 약관 및 개인정보처리방침을 단일 필수 확인란으로 결합할 수 있습니다.
I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy);
확인을 선택합니다.
페이지 레이아웃 페이지에서 저장을 선택합니다.
다중 선택 확인란(CheckboxMultiSelect) 구성
문자열 데이터 형식의 특성을 특성 레이블 아래에 나타나는 하나 이상의 확인란인 CheckboxMultiSelect 사용자 입력 형식으로 구성할 수 있습니다. 사용자는 하나 이상의 확인란을 선택할 수 있습니다. 개별 확인란의 텍스트를 정의하고 다른 콘텐츠에 대한 하이퍼링크를 포함할 수 있습니다. 이 특성을 “필수”로 지정하면 사용자가 확인란 중 하나 이상을 선택해야 합니다.
페이지 레이아웃 페이지에서 일련의 확인란으로 구성하려는 데이터 형식이 문자열인 특성을 찾습니다.
레이블 열에서 값을 선택하고 일련의 확인란 위에 표시할 제목(예:
How did you hear about us?)을 입력합니다.사용자 입력 형식 열에서 값을 선택하여 편집기 창을 엽니다.
편집기 창의 사용자 입력 형식에서 CheckboxMultiSelect를 선택합니다.
추가하려는 확인란마다 새 줄을 시작하고 다음 정보를 입력합니다.
텍스트 아래에 확인란 옆에 표시할 텍스트를 입력합니다. Markdown 언어를 사용하여 하이퍼링크를 추가합니다.
값 아래에 사용자 개체에 기록되고 사용자가 확인란을 선택하면 클레임으로 반환되는 값을 입력합니다.
확인을 선택합니다.
페이지 레이아웃 페이지에서 저장을 선택합니다.
라디오 단추(RadioSingleSelect) 구성
문자열 데이터 형식의 특성을 특성 레이블 아래에 표시되는 일련의 라디오 단추인 RadioSingleSelect 사용자 입력 형식으로 구성할 수 있습니다. 사용자는 하나의 라디오 단추만 선택할 수 있습니다. 개별 라디오 단추의 텍스트를 정의하고 다른 콘텐츠에 대한 하이퍼링크를 포함할 수 있습니다.
페이지 레이아웃 페이지에서 하나의 라디오 단추 또는 일련의 라디오 단추로 구성하려는 데이터 형식이 문자열인 특성을 찾습니다.
레이블 열에서 값을 선택하고 일련의 라디오 단추 위에 표시할 제목(예:
Sweatshirt size)을 입력합니다.사용자 입력 형식 열에서 값을 선택하여 편집기 창을 엽니다.
편집기 창의 사용자 입력 형식에서 RadioSingleSelect를 선택합니다.
추가하려는 라디오 단추마다 새 줄을 시작하고 다음 정보를 입력합니다.
텍스트 아래에 라디오 단추 옆에 표시할 텍스트를 입력합니다. Markdown 언어를 사용하여 하이퍼링크를 추가합니다.
값 아래에 사용자 개체에 기록되고 사용자가 라디오 단추를 선택하면 클레임으로 반환되는 값을 입력합니다.
확인을 선택합니다.
페이지 레이아웃 페이지에서 저장을 선택합니다.
확장 앱에 대한 애플리케이션 ID 찾기
사용자 지정 사용자 특성은 b2c-extensions-app이라는 앱에 저장됩니다. 사용자가 가입 중에 사용자 지정 특성 값을 입력하면 해당 값은 사용자 개체에 추가되며 명명 규칙 extension_{appId-without-hyphens}_{custom-attribute-name}을 사용하여 Microsoft Graph API를 통해 호출할 수 있습니다. 각 요소는 다음을 의미합니다.
{appId-without-hyphens}는 b2c-extensions-app에 대한 클라이언트 ID의 일부 제거된 버전입니다.{custom-attribute-name}은 사용자 지정 특성에 할당한 이름입니다.
다음 단계에 따라 확장 앱의 애플리케이션 ID를 찾습니다.
- Microsoft Entra 관리 센터에 로그인합니다.
- ID>앱 등록>모든 애플리케이션으로 이동합니다.
- 애플리케이션 b2c-extensions-app을 선택합니다. 수정하지 마세요. 사용자 데이터를 저장하기 위해 AADB2C에서 사용됩니다.
- 개요 페이지에서 애플리케이션(클라이언트) ID 값(예:
12345678-abcd-1234-1234-ab123456789)을 사용하되 하이픈을 제거합니다.
예를 들어 loyaltyNumber라는 사용자 지정 특성을 만드는 경우 extension_12345678abcd12341234ab123456789_loyaltyNumber로 참조합니다.
ID 토큰에 사용자 지정 사용자 특성 추가
사용자가 앱에 로그인하면 앱은 사용자 세부 정보가 포함된 ID 토큰을 받습니다. 이러한 세부 정보를 토큰 클레임이라고 합니다. 필요한 경우 클레임으로 사용할 수 있는 사용자 지정 사용자 특성을 앱에 반환되는 ID 토큰에 포함할 수 있습니다. 이렇게 하려면 애플리케이션에 반환되는 ID 토큰에 특성 추가 문서의 단계를 수행합니다.