사용자 프로필 특성

적용 대상: 직원 테넌트 외부 테넌트 (자세한 정보)

가입 중에 수집되는 사용자 특성은 사용자의 프로필과 함께 디렉터리에 저장됩니다. 기본 제공 사용자 특성 중에서 선택하거나 사용자 지정 사용자 특성을 만들 수 있습니다.

• Microsoft Entra 외부 ID에서는 도시, 국가/지역, 이메일 주소 등과 같은 기본 제공 사용자 특성을 제공합니다. 가입 중에 수집하고자 하는 기본 제공 사용자 특성을 선택할 수 있습니다.

• 수집하려는 정보가 더 있다면 사용자 지정 사용자 특성을 만들 수 있습니다. 가입 페이지에 텍스트 상자, 라디오 단추, 확인란을 비롯한 여러 사용자 지정 입력 컨트롤을 추가하여 특성을 수집할 수 있습니다. 다음 예에서는 사용자 지정 입력 컨트롤을 사용하여 멤버십 번호, 사용 약관 동의, 개인정보처리방침 동의에 대한 특성을 수집하는 방법을 보여줍니다.

  

기본 제공 사용자 특성

Microsoft Entra 외부 ID에는 가입 중에 수집할 수 있는 기본 제공 사용자 특성이 있습니다. 사용자는 Microsoft Entra 관리 센터에서 사용자 흐름을 만들 때 이러한 특성을 구성합니다.

다음 표에는 가입 흐름 중에 수집할 수 있는 기본 제공 사용자 특성이 요약되어 있습니다.

• Microsoft Entra 관리 센터의 레이블은 Microsoft Entra 관리 센터에 표시되는 사용자 특성의 이름입니다.
• 프로그래밍 가능한 이름은 Microsoft Graph API의 사용자 리소스에 사용되는 사용자 특성의 이름입니다. 기본 인증과 같이 프로그래밍 방식으로 이 사용자 특성을 사용하려는 경우 이 이름을 사용합니다.
• 데이터 형식은 사용자 특성의 데이터 형식입니다.

Microsoft Entra 관리 센터의 레이블	프로그래밍 가능한 이름	데이터 형식	설명
City	city	문자열	최대 길이는 128자입니다.
국가/지역	country	문자열	최대 길이는 128자입니다.
표시 이름	displayName	문자열	최대 길이는 256자입니다.
이메일 주소	mail	문자열	이 속성은 강세 문자를 포함할 수 없습니다. 기본 인증 API에서 이 특성은 사용자 이름으로 참조됩니다.
이름	givenName	문자열	최대 길이는 64자입니다.
직함	jobTitle	문자열	최대 길이는 128자입니다.
우편 번호	postalCode	문자열	최대 길이는 40자입니다.
시/도	state	문자열	최대 길이는 128자입니다.
주소	streetAddress	문자열	최대 길이는 1024자입니다.
Surname	surname	문자열	최대 길이는 64자입니다.

사용자 지정 사용자 특성

앱에 기본 제공 사용자 특성이 제공하는 것보다 많은 정보가 필요한 경우 자체 특성을 추가할 수 있습니다. 이러한 특성을 사용자 지정 사용자 특성이라고합니다.

사용자 지정 사용자 특성을 정의하려면 먼저 테넌트의 모든 사용자 흐름에서 사용할 수 있도록 테넌트 수준에서 특성을 만듭니다. 그런 다음 가입 사용자 흐름에 특성을 할당하고 가입 페이지에 어떻게 표시할지 구성합니다.

사용자 지정 사용자 특성 만들기 문서에서 사용자 지정 사용자 특성을 만드는 방법을 알아보세요.

사용자 지정 사용자 특성 입력 형식

사용자 지정 사용자 특성을 사용하기 전에 수집하려는 각 사용자 지정 특성에 대해 사용자 입력을 수집하는 가장 좋은 방법을 결정합니다. 다음 입력 형식 컨트롤을 사용하여 가입 중에 사용자로부터 정보를 수집할 수 있습니다.

• 문자열 텍스트 상자
• 라디오 단추
• 다중 선택 확인란
• 숫자 텍스트 상자
• 단일 선택 확인란

다음 표를 참조하여 적절한 데이터 형식 및 사용자 입력 형식을 찾으세요.

데이터 형식	사용자 입력 형식	설명
문자열	TextBox	자유 형식 텍스트 입력 필드입니다.
문자열	RadioSingleSelect	선택 항목이 하나만 있는 일련의 라디오 단추입니다. 개별 라디오 단추의 텍스트에는 Markdown 언어로 서식이 지정된 하이퍼링크가 포함될 수 있습니다.
문자열	CheckboxMultiSelect	선택 항목을 여러 개 둘 수 있는 1개 이상의 확인란입니다. 개별 확인란의 텍스트에는 Markdown 언어로 서식이 지정된 하이퍼링크가 포함될 수 있습니다.
Boolean	CheckboxSingleSelect	레이블이 있는 단일 부울 확인란입니다. 확인란의 레이블에는 Markdown 언어로 서식이 지정된 하이퍼링크가 포함될 수 있습니다.
정수	NumericTextBox	자유 형식 정수 항목입니다.

확인란 및 라디오 단추에는 사용 약관 및 개인정보처리방침과 같은 다른 콘텐츠로 이어지는 하이퍼링크가 포함될 수 있습니다. 이 문서의 시작 부분에 있는 예는 기본 제공 특성과 사용자 지정 특성을 함께 사용하는 가입 페이지를 보여 줍니다. 예제:

• 표시 이름 필드는 기본 제공 특성입니다.
• 멤버십 번호는 숫자 정수를 허용하는 자유 형식 입력 필드가 있는 사용자 지정 특성입니다. Int 데이터 형식 및 NumericTextBox 사용자 입력 형식을 사용하여 이 형식을 구성할 수 있습니다.
• 사용 약관 및 개인정보처리방침 사용자 지정 특성은 하이퍼링크가 포함된 레이블이 있는 별도의 단일 선택 확인란입니다. 기본적으로 CheckboxSingleSelect 사용자 입력 형식으로 설정되는 부울 데이터 형식을 사용하여 단일 확인란을 구성할 수 있습니다. Markdown 언어를 사용하여 확인란 레이블에 하이퍼링크를 추가합니다.

사용자 입력 형식 구성 문서에서 사용자 특성 입력 형식을 구성하는 방법을 알아보세요.

사용자 지정 사용자 특성이 저장되는 위치

사용자 지정 사용자 특성은 디렉터리에 저장된 사용자 프로필 정보를 확장하므로 디렉터리 확장 특성이라고도 합니다. 외부 테넌트의 모든 확장 특성은 b2c-extensions-app이라는 앱에 저장됩니다. 사용자가 가입 중에 사용자 지정 특성 값을 입력하면 해당 값이 사용자 개체에 추가되며 명명 규칙 extension_{appId-without-hyphens}_{custom-attribute-name}을 사용하여 Microsoft Graph API를 통해 호출할 수 있습니다. 각 요소는 다음을 의미합니다.

• {appId-without-hyphens}는 b2c-extensions-app에 대한 클라이언트 ID의 일부 제거된 버전입니다.
• {custom-attribute-name}은 사용자 지정 특성에 할당한 이름입니다.

예를 들어 b2c-extensions-app의 클라이언트 ID가 2588a-bcdwh-tfeehj-jeeqw-ertc라면 특성 이름은 다음과 같습니다.

• loyaltyNumber이면 사용자 지정 특성의 이름이 extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber로 지정됩니다.
• Loyalty Number이면 사용자 지정 특성의 이름이 extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber로 지정됩니다. 공백을 제거하고 camelCase를 사용하여 단어를 구분합니다.

외부 테넌트에 등록된 b2c-extensions-app의 애플리케이션 ID를 찾는 방법을 알아보려면 확장 앱의 애플리케이션 ID 찾기 문서를 참고하세요.

Microsoft Graph API

Microsoft Graph에서는 사용자 특성을 사용자 흐름 특성이라고 합니다. identityUserFlowAttribute 리소스 종류 및 관련 메서드를 사용하여 기본 제공 및 사용자 지정 사용자 흐름 특성을 모두 관리합니다.

관련 콘텐츠

• 애플리케이션에 반환된 ID 토큰에 특성 추가

• 고객의 가입 및 로그인 사용자 흐름을 만드는 방법 자세히 알아보기

• 기본 인증 MSAL Android SDK 특성 작성기