중요합니다
2025년 5월 1일부터 새 고객을 위해 Azure AD B2C를 더 이상 구매할 수 없습니다. FAQ에서 자세히 알아보세요.
시작하기 전에 이 페이지의 맨 위에 있는 정책 유형 선택기를 사용하여 설정하려는 정책 유형을 선택합니다. Azure Active Directory B2C는 미리 정의된 사용자 흐름 또는 완전히 구성 가능한 사용자 지정 정책을 통해 사용자가 애플리케이션과 상호 작용하는 방법을 정의하는 두 가지 방법을 제공합니다. 이 문서에서 필요한 단계는 각 방법마다 다릅니다.
비고
Azure Active Directory B2C에서 사용자 지정 정책은 주로 복잡한 시나리오를 해결하기 위해 설계되었습니다. 대부분의 시나리오에서 기본 제공 사용자 흐름을 사용하는 것이 좋습니다. 아직 수행하지 않았다면 Active Directory B2C에서 사용자 지정 정책 시작하기에서 사용자 지정 정책 스타터 팩에 대해 알아봅니다.
필수 조건
- 사용자가 애플리케이션에 가입하고 로그인할 수 있도록 사용자 흐름을 만듭니다.
- 웹 애플리케이션 등록.
- Active Directory B2C에서 사용자 지정 정책을 사용하여 시작하기에 있는 단계를 완료합니다. 이 자습서에서는 Azure AD B2C 테넌트 구성을 사용하도록 사용자 지정 정책 파일을 업데이트하는 방법을 안내합니다.
- 웹 애플리케이션 등록.
애플리케이션 만들기
Azure AD B2C에서 X 계정으로 사용자에 대한 로그인을 사용하도록 설정하려면 X 애플리케이션을 만들어야 합니다. X 계정이 아직 없으시면, https://x.com/signup
에서 가입할 수 있습니다.
개발자 계정에도 신청해야 합니다. 자세한 내용은 접근 권한 신청을 참조하세요.
- X 계정 자격 증명을 사용하여 X 개발자 포털 에 로그인합니다.
- +프로젝트 만들기 단추를 선택합니다.
- 프로젝트 이름 탭에서 프로젝트의 기본 이름을 입력한 다음, 다음 단추를 선택합니다.
- 사용 사례 탭에서 원하는 사용 사례를 선택한 다음 다음을 선택합니다.
- 프로젝트 설명 탭에서 프로젝트 설명을 입력하고 다음 단추를 선택합니다.
- 앱 이름 탭에서 azureadb2c와 같은 앱의 이름을 입력하고 다음 단추를 선택합니다.
- 키 및 토큰 탭에서 API 키 및 API 키 비밀의 값을 복사합니다. 나중에 구성에 사용합니다.
- 앱 설정을 선택하여 앱 설정을 엽니다.
- 페이지 아래쪽의 사용자 인증 설정에서 설정하기를 선택합니다.
- 앱 유형에서 웹앱과 같은 적절한 앱 유형을 선택합니다.
-
앱 정보에서:
-
콜백 URI/리디렉션 URL에 대해 .를 입력합니다
https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/your-policy-id/oauth1/authresp
. 사용자 지정 도메인을 사용하는 경우https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp
을 입력하십시오. Azure AD B2C에서 대문자로 정의된 경우에도 테넌트 이름 및 사용자 흐름 ID를 입력할 때 모든 소문자를 사용합니다. 대체하다-
your-tenant-name
에 테넌트 이름을 입력하세요. -
your-domain-name
사용자 지정 도메인과 함께. -
your-policy-id
사용자 흐름의 식별자를 사용합니다. 예:b2c_1a_signup_signin_x
.
-
-
웹 사이트 URL에
https://your-tenant.b2clogin.com
를 입력하세요. 를 테넌트 이름으로 바꿉 있습니다your-tenant
. 예:https://contosob2c.b2clogin.com
. 사용자 지정 도메인을 사용하는 경우https://your-domain-name
을 입력하십시오. - (선택 사항) 서비스 약관에 대한 URL을 입력합니다. 예를 들면 다음과 같습니다
http://www.contoso.com/tos
. 정책 URL은 애플리케이션에 대한 사용 약관을 제공하기 위해 유지 관리하는 페이지입니다. - (선택 사항) 예를 들어
http://www.contoso.com/privacy
에 대한 URL을 입력합니다. 정책 URL은 애플리케이션에 대한 개인 정보를 제공하기 위해 유지 관리하는 페이지입니다.
-
콜백 URI/리디렉션 URL에 대해 .를 입력합니다
- 저장을 선택합니다.
- X 계정 자격 증명을 사용하여 X 개발자 포털 에 로그인합니다.
- +프로젝트 만들기 단추를 선택합니다.
- 프로젝트 이름 탭에서 프로젝트의 기본 이름을 입력한 다음, 다음 단추를 선택합니다.
- 사용 사례 탭에서 원하는 사용 사례를 선택한 다음 다음을 선택합니다.
- 프로젝트 설명 탭에서 프로젝트 설명을 입력하고 다음 단추를 선택합니다.
- 앱 이름 탭에서 azureadb2c와 같은 앱의 이름을 입력하고 다음 단추를 선택합니다.
- 키 및 토큰 탭에서 나중에 API 키 및 API 키 비밀의 값을 복사합니다. 둘 다 사용하여 Azure AD B2C 테넌트에서 X를 ID 공급자로 구성합니다.
- 앱 설정을 선택하여 앱 설정을 엽니다.
- 페이지 아래쪽의 사용자 인증 설정에서 설정하기를 선택합니다.
- 앱 유형에서 웹앱과 같은 적절한 앱 유형을 선택합니다.
-
앱 정보에서:
-
콜백 URI/리디렉션 URL에 대해 .를 입력합니다
https://your-tenant.b2clogin.com/your-tenant-name.onmicrosoft.com/your-user-flow-name/oauth1/authresp
. 사용자 지정 도메인을 사용하는 경우https://your-domain-name/your-tenant-name.onmicrosoft.com/your-user-flow-Id/oauth1/authresp
을 입력하십시오. Azure AD B2C에서 대문자로 정의된 경우에도 테넌트 이름 및 사용자 흐름 ID를 입력할 때 모든 소문자를 사용합니다. 대체하다-
your-tenant-name
에 테넌트 이름을 입력하세요. -
your-domain-name
사용자 지정 도메인과 함께. -
your-user-flow-name
사용자 흐름의 식별자를 사용합니다. 예:b2c_1_signup_signin_x
.
-
-
웹 사이트 URL에
https://your-tenant.b2clogin.com
를 입력하세요. 를 테넌트 이름으로 바꿉 있습니다your-tenant
. 예:https://contosob2c.b2clogin.com
. 사용자 지정 도메인을 사용하는 경우https://your-domain-name
을 입력하십시오. -
서비스 약관에 대한 URL을 입력합니다. 예를 들면 다음과 같습니다
http://www.contoso.com/tos
. 정책 URL은 애플리케이션에 대한 사용 약관을 제공하기 위해 유지 관리하는 페이지입니다. - 예를 들어
http://www.contoso.com/privacy
에 대한 URL을 입력합니다. 정책 URL은 애플리케이션에 대한 개인 정보를 제공하기 위해 유지 관리하는 페이지입니다.
-
콜백 URI/리디렉션 URL에 대해 .를 입력합니다
- 저장을 선택합니다.
X를 ID 공급자로 구성
- 외부 ID 공급자 관리자 권한이 있는 계정으로 Azure Portal에 로그인합니다.
- 여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘을 선택하여 디렉터리 + 구독 메뉴에서 Azure AD B2C 테넌트로 전환합니다.
- Azure Portal의 왼쪽 위 모서리에 있는 모든 서비스를 선택하고 Azure AD B2C를 검색하여 선택합니다.
- ID 공급자를선택한 다음 Twitter를 선택합니다.
- 이름을 입력합니다. 예를 들어 X입니다.
- 클라이언트 ID에 대해 이전에 만든 X 애플리케이션의 API 키를 입력합니다.
- 클라이언트 암호에 대해 기록한 API 키 비밀을 입력합니다.
- 저장을 선택합니다.
사용자 흐름에 X ID 공급자 추가
이 시점에서 X ID 공급자가 설정되었지만 아직 로그인 페이지에서 사용할 수 없습니다. 사용자 흐름에 X ID 공급자를 추가하려면 다음을 수행합니다.
- Azure AD B2C 테넌트에서 사용자 흐름을 선택합니다.
- X ID 공급자를 추가하려는 사용자 흐름을 선택합니다.
- 소셜 ID 공급자 아래에서 Twitter를 선택합니다.
- 저장을 선택합니다.
사용자 흐름 테스트
- 정책을 테스트하려면 사용자 흐름 실행을 선택합니다.
-
애플리케이션의 경우 이전에 등록한 testapp1이라는 웹 애플리케이션을 선택합니다.
회신 URL에는
https://jwt.ms
가 표시되어야 합니다. - 사용자 흐름 실행 단추를 선택합니다.
- 등록 또는 로그인 페이지에서 Twitter 를 선택하여 X 계정으로 로그인합니다.
정책 키 만들기
이전에 X 앱에 대해 기록한 비밀 키를 Azure AD B2C 테넌트에 저장해야 합니다.
- Azure Portal에 로그인합니다.
- 여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘을 선택하여 디렉터리 + 구독 메뉴에서 Azure AD B2C 테넌트로 전환합니다.
- Azure Portal에서 Azure AD B2C를 검색하고 선택합니다.
- 왼쪽 메뉴의 정책에서 ID 경험 프레임워크를 선택합니다.
- 정책 키를 선택한 다음 추가를 선택합니다.
-
옵션의 경우 .를 선택합니다
Manual
. - 정책 키의 이름을 입력합니다. 예:
XSecret
. 접두사는B2C_1A_
키 이름에 자동으로 추가됩니다. - 비밀의 경우 이전에 기록한 API 키 비밀 값을 입력합니다.
-
키 사용에 대해
Signature
을(를) 선택합니다. - 만들기를 클릭합니다.
X를 ID 공급자로 구성
사용자가 X 계정을 사용하여 로그인할 수 있도록 하려면 Azure AD B2C가 엔드포인트를 통해 통신할 수 있는 클레임 공급자로 계정을 정의해야 합니다. 엔드포인트는 특정 사용자가 인증했는지 확인하기 위해 Azure AD B2C에서 사용하는 클레임 집합을 제공합니다.
X 계정을 정책의 확장 파일의 ClaimsProviders 요소에 추가하여 클레임 공급자로 정의할 수 있습니다. 이 문서의 필수 구성 요소에서 다운로드한 사용자 지정 정책 시작 팩을 참조하세요.
TrustFrameworkExtensions.xml엽니다.
ClaimsProviders 요소를 찾습니다. 존재하지 않는 경우 루트 요소 아래에 추가합니다.
다음과 같이 새 ClaimsProvider 를 추가합니다.
<ClaimsProvider> <Domain>x.com</Domain> <DisplayName>X</DisplayName> <TechnicalProfiles> <TechnicalProfile Id="Twitter-OAuth1"> <DisplayName>X</DisplayName> <Protocol Name="OAuth1" /> <Metadata> <Item Key="ProviderName">Twitter</Item> <Item Key="authorization_endpoint">https://api.twitter.com/oauth/authenticate</Item> <Item Key="access_token_endpoint">https://api.twitter.com/oauth/access_token</Item> <Item Key="request_token_endpoint">https://api.twitter.com/oauth/request_token</Item> <Item Key="ClaimsEndpoint">https://api.twitter.com/1.1/account/verify_credentials.json?include_email=true</Item> <Item Key="ClaimsResponseFormat">json</Item> <Item Key="client_id">Your X application API key</Item> </Metadata> <CryptographicKeys> <Key Id="client_secret" StorageReferenceId="B2C_1A_TwitterSecret" /> </CryptographicKeys> <OutputClaims> <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="user_id" /> <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="screen_name" /> <OutputClaim ClaimTypeReferenceId="email" /> <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="twitter.com" /> <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" /> </OutputClaims> <OutputClaimsTransformations> <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" /> <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" /> <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" /> <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" /> </OutputClaimsTransformations> <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" /> </TechnicalProfile> </TechnicalProfiles> </ClaimsProvider>
client_id 값을 이전에 기록한 API 키로 바꿉다.
파일을 저장합니다.
사용자 경험 추가
이 시점에서 ID 공급자가 설정되었지만 로그인 페이지에서는 아직 사용할 수 없습니다. 사용자 고유의 사용자 지정 사용자 여정이 없는 경우 기존 템플릿 사용자 경험의 중복을 만들고, 그렇지 않으면 다음 단계로 계속 진행합니다.
- 시작 팩에서 TrustFrameworkBase.xml 파일을 엽니다.
- 를 포함하는
Id="SignUpOrSignIn"
요소의 전체 콘텐츠를 찾아 복사합니다. - TrustFrameworkExtensions.xml 열고 UserJourneys 요소를 찾습니다. 요소가 없으면 추가합니다.
- UserJourneys 요소의 자식으로 복사한 UserJourney 요소의 전체 콘텐츠를 붙여넣습니다.
- 사용자 여정의 ID를 이름을 변경하세요. 예:
Id="CustomSignUpSignIn"
.
사용자 경험에 ID 공급자 추가
이제 사용자 경험을 했으므로 사용자 경험에 새 ID 공급자를 추가합니다. 먼저 로그인 단추를 추가한 다음, 단추를 작업에 연결합니다. 작업은 여러분이 이전에 생성한 기술 프로필에서 수행하는 것입니다.
사용자 여정에서
Type="CombinedSignInAndSignUp"
또는Type="ClaimsProviderSelection"
를 포함하는 오케스트레이션 단계 요소를 찾습니다. 일반적으로 첫 번째 오케스트레이션 단계입니다. ClaimsProviderSelections 요소에는 사용자가 로그인할 수 있는 ID 공급자 목록이 포함되어 있습니다. 요소의 순서는 사용자에게 표시되는 로그인 단추의 순서를 제어합니다. ClaimsProviderSelection XML 요소를 추가합니다. TargetClaimsExchangeId 값을 친숙한 이름으로 설정합니다.다음 오케스트레이션 단계에서 ClaimsExchange 요소를 추가합니다. ID를 대상 클레임 교환 ID의 값으로 설정합니다. TechnicalProfileReferenceId 값을 이전에 만든 기술 프로필의 ID로 업데이트합니다.
다음 XML은 ID 공급자를 사용하는 사용자 경험의 처음 두 오케스트레이션 단계를 보여 줍니다.
<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
<ClaimsProviderSelections>
...
<ClaimsProviderSelection TargetClaimsExchangeId="TwitterExchange" />
</ClaimsProviderSelections>
...
</OrchestrationStep>
<OrchestrationStep Order="2" Type="ClaimsExchange">
...
<ClaimsExchanges>
<ClaimsExchange Id="TwitterExchange" TechnicalProfileReferenceId="Twitter-OAuth1" />
</ClaimsExchanges>
</OrchestrationStep>
신뢰 당사자 정책 구성하다
신뢰 당사자 정책(예: SignUpSignIn.xml)은 Azure AD B2C가 실행할 사용자 경험을 지정합니다. 신뢰 당사자 내에서 DefaultUserJourney 요소를 찾습니다. 사용자 여행 ID와 일치하도록 ReferenceId를 업데이트합니다. 여기에는 ID 공급자를 추가했습니다.
다음 예제에서는 CustomSignUpSignIn
사용자 여정의 ReferenceId가 CustomSignUpSignIn
로 설정됩니다.
<RelyingParty>
<DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
...
</RelyingParty>
사용자 지정 정책 업로드
- Azure Portal에 로그인합니다.
- 포털 도구 모음에서 디렉터리 + 구독 아이콘을 선택한 다음, Azure AD B2C 테넌트가 포함된 디렉터리를 선택합니다.
- Azure Portal에서 Azure AD B2C를 검색하고 선택합니다.
- 정책에서 ID 환경 프레임워크를 선택합니다.
-
사용자 지정 정책 업로드를 선택한 다음, 변경한 두 개의 정책 파일을 다음 순서대로 업로드합니다. 확장 정책(예
TrustFrameworkExtensions.xml
: 신뢰 당사자 정책 등SignUpSignIn.xml
).
사용자 지정 정책 테스트
- 신뢰 당사자 정책을 선택하세요, 예를 들어
B2C_1A_signup_signin
. -
애플리케이션의 경우 이전에 등록한 웹 애플리케이션을 선택합니다.
회신 URL에는
https://jwt.ms
가 표시되어야 합니다. - 지금 실행 단추를 선택합니다.
- 등록 또는 로그인 페이지에서 Twitter 를 선택하여 X 계정으로 로그인합니다.
로그인 프로세스가 성공하면 브라우저가 리디렉션되어 https://jwt.ms
Azure AD B2C에서 반환된 토큰의 내용이 표시됩니다.
팁 (조언)
이 ID 공급자를 테스트하는 동안 unauthorized
오류가 발생할 경우 정확한 X API 키 및 API 키 비밀을 사용하거나 상승된 액세스를 신청해 보십시오. 또한 기능을 사용할 수 있기 전에 앱을 등록한 경우 X의 프로젝트 구조를 살펴보는 것이 좋습니다.