Azure Active Directory B2C에서 사용자 지정 정책을 사용하여 OpenID Connect ID 공급자로 AD FS 추가

아티클
01/24/2024

시작하기 전에 이 페이지 위쪽의 정책 유형 선택 선택기를 사용하여 설정하려는 정책 유형을 선택합니다. Azure Active Directory B2C는 사용자가 애플리케이션과 상호 작용하는 방법을 정의하는 두 가지 방법, 즉 미리 정의된 사용자 흐름 또는 완전히 구성 가능한 사용자 지정 정책을 통해 제공합니다. 이 문서에서 필요한 단계는 각 방법마다 다릅니다.

필수 조건

사용자가 애플리케이션에 가입하고 로그인할 수 있도록 사용자 흐름을 만듭니다.
웹 애플리케이션 등록.

Active Directory B2C에서 사용자 지정 정책을 사용하여 시작하기에 있는 단계를 완료합니다.
웹 애플리케이션 등록.

AD FS 애플리케이션 만들기

Azure AD B2C(Azure Active Directory B2C)에서 사용자가 AD FS 계정으로 로그인할 수 있도록 설정하려면 AD FS에서 애플리케이션 그룹을 만듭니다. 자세한 내용은 AD FS 2016 이상에서 OpenID Connect를 사용한 웹 애플리케이션 빌드를 참조하세요.

애플리케이션 그룹을 만들려면 다음 단계를 수행합니다.

서버 관리자에서 도구를 선택한 다음, AD FS 관리를 선택합니다.
AD FS 관리에서 애플리케이션 그룹을 마우스 오른쪽 단추로 클릭하고 애플리케이션 그룹 추가를 선택합니다.
애플리케이션 그룹 마법사 시작 화면에서 다음을 수행합니다.
1. 애플리케이션의 이름을 입력합니다. 예: Azure AD B2C 애플리케이션.
2. Client-Server 애플리케이션에서 웹 애플리케이션에 액세스하는 웹 브라우저 템플릿을 선택합니다.
3. 다음을 선택합니다.
애플리케이션 그룹 마법사 네이티브 애플리케이션 화면에서 다음을 수행합니다.
1. 복사는 클라이언트 식별자 값입니다. 클라이언트 ID는 사용자의 AD FS 애플리케이션 ID입니다. 이 문서의 후반부에 애플리케이션 ID가 필요합니다.
2. 리디렉션 URI에서 https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp 및 추가를 차례로 입력합니다. 사용자 지정 도메인을 사용하는 경우 https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp를 입력합니다. your-tenant-name을 테넌트 이름으로, your-domain-name을 사용자 지정 도메인으로 바꿉니다.
3. 다음, 다음, 다음을 차례로 선택하여 앱 등록 마법사를 완료합니다.
4. 닫기를 선택합니다.

앱 클레임 구성

이 단계에서는 애플리케이션이 Azure AD B2C에 반환할 클레임 AD FS를 구성합니다.

애플리케이션 그룹에서 생성한 애플리케이션을 선택합니다.
애플리케이션 속성 창에서 애플리케이션 아래에 있는 웹 애플리케이션을 선택합니다. 그런 다음, 편집을 선택합니다.
발급 변환 규칙 탭을 선택합니다. 그런 다음, 규칙 추가를 선택합니다.
클레임 규칙 템플릿에서 LDAP 특성을 클레임으로 전송을 선택하고 다음을 선택합니다.
클레임 규칙 이름을 제공합니다. 특성 저장소에서 Active Directory를 선택하고 다음과 같은 클레임을 추가합니다.

LDAP 특성 나가는 클레임 형식

사용자 보안 주체 이름 upn

Surname family_name

Given-Name given_name

Display-Name name

나가는 클레임 형식 드롭다운에 일부 이름이 표시되지 않습니다. 수동으로 입력해야 합니다(드롭다운은 편집 가능).
마침을 선택합니다.
적용을 선택한 다음, 확인을 선택합니다.
확인을 다시 선택하여 완료합니다.

LDAP 특성	나가는 클레임 형식
사용자 보안 주체 이름	upn
Surname	family_name
Given-Name	given_name
Display-Name	name

AD FS를 ID 공급자로 구성

Azure AD B2C 테넌트의 전역 관리자로 Azure Portal에 로그인합니다.
여러 테넌트에 액세스할 수 있는 경우 상단 메뉴의 설정 아이콘을 선택하여 디렉터리 + 구독 메뉴에서 Azure AD B2C 테넌트로 전환합니다.
Azure Portal의 왼쪽 상단 모서리에서 모든 서비스를 선택하고 Azure AD B2C를 검색하여 선택합니다.
ID 공급자를 선택한 다음, 새 OpenID Connect 공급자를 선택합니다.
이름을 입력합니다. 예를 들면 Contoso입니다.
메타데이터 URL의 경우 AD FS OpenID Connect 구성 문서의 URL을 입력합니다. 예시:
```
https://adfs.contoso.com/adfs/.well-known/openid-configuration 
```
Client ID에 대해 이전에 기록한 애플리케이션 ID를 입력합니다.
범위에 openid을 입력합니다.
응답 형식의 경우 id_token을 선택합니다. 따라서 클라이언트 암호 값은 필요하지 않습니다. 일반 OpenID Connect 공급자를 추가할 때 클라이언트 ID 및 암호 사용에 대해 자세히 알아봅니다.
(선택 사항) 도메인 힌트에 contoso.com을 입력합니다. 자세한 내용은 Azure Active Directory B2C를 사용하여 직접 로그인 설정을 참조하세요.
ID 공급자 클레임 매핑에서 다음 클레임을 선택합니다.
- 사용자 ID: upn
- 표시 이름: unique_name
- 이름: given_name
- 성: family_name
저장을 선택합니다.

사용자 흐름에 AD FS ID 공급자 추가

이 시점에서 AD FS(Contoso) ID 공급자가 설정되었지만 로그인 페이지에서 아직 사용할 수는 없습니다. AD FS ID 공급자를 사용자 흐름에 추가하려면 다음을 수행합니다.

Azure AD B2C 테넌트에서 사용자 흐름을 선택합니다.
AD FS ID 공급자(Contoso)를 추가하려는 사용자 흐름을 선택합니다.
소셜 ID 공급자 아래에서 Contoso를 선택합니다.
저장을 선택합니다.
정책을 테스트하려면 사용자 흐름 실행을 선택합니다.
애플리케이션에서 이전에 등록한 testapp1이라는 웹 애플리케이션을 선택합니다. 회신 URL에는 https://jwt.ms가 표시되어야 합니다.
사용자 흐름 실행 단추를 선택합니다.
가입 또는 로그인 페이지에서 Contoso를 선택하여 Contoso 계정으로 로그인합니다.

로그인 프로세스가 성공하면 브라우저가 Azure AD B2C에서 반환된 토큰의 내용을 표시하는 https://jwt.ms로 리디렉션됩니다.

AD FS를 ID 공급자로 구성

사용자가 AD FS 계정을 사용하여 로그인하도록 설정하려면 Azure AD B2C가 엔드포인트를 통해 통신할 수 있는 클레임 공급자로 AD FS를 정의해야 합니다.

TrustFrameworkExtensions.xml을 엽니다.
ClaimsProviders 요소를 찾습니다. 해당 요소가 없으면 루트 요소 아래에 추가합니다.

다음과 같이 새 ClaimsProvider를 추가합니다.

<ClaimsProvider>
  <Domain>contoso.com</Domain>
  <DisplayName>Contoso</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Contoso-OpenIdConnect">
      <DisplayName>Contoso</DisplayName>
      <Protocol Name="OpenIdConnect" />
      <Metadata>
        <Item Key="METADATA">https://your-adfs-domain/adfs/.well-known/openid-configuration</Item>
        <Item Key="response_types">id_token</Item>
        <Item Key="response_mode">form_post</Item>
        <Item Key="scope">openid</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="UsePolicyInRedirectUri">0</Item>
        <!-- Update the Client ID below to the Application ID -->
        <Item Key="client_id">Your AD FS application ID</Item>
      </Metadata>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="upn" />
        <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
        <OutputClaim ClaimTypeReferenceId="surname" PartnerClaimType="family_name" />
        <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="unique_name" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" PartnerClaimType="iss"  />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" AlwaysUseDefaultValue="true" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

메타데이터 URL의 경우 AD FS OpenID Connect 구성 문서의 URL을 입력합니다. 예시:
```
https://adfs.contoso.com/adfs/.well-known/openid-configuration 
```
client_id를 애플리케이션 등록의 애플리케이션 ID로 설정합니다.
파일을 저장합니다.

사용자 경험 추가

이 시점에서 ID 공급자가 설정되었지만 로그인 페이지에서 아직 사용할 수는 없습니다. 자체 사용자 지정 사용자 경험이 없는 경우 기존 템플릿 사용자 경험의 복제본을 만듭니다. 그렇지 않으면 다음 단계를 계속 진행합니다.

시작 팩에서 TrustFrameworkBase.xml 파일을 엽니다.
Id="SignUpOrSignIn"이 포함된 UserJourney 요소를 찾아서 전체 콘텐츠를 복사합니다.
TrustFrameworkExtensions.xml을 열어 UserJourneys 요소를 찾습니다. 요소가 존재하지 않는 경우 추가합니다.
이전 단계에서 복사한 UserJourney 요소의 전체 콘텐츠를 UserJourneys 요소의 자식으로 붙여넣습니다.
사용자 경험 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="ContosoExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="ContosoExchange" TechnicalProfileReferenceId="Contoso-OpenIdConnect" />
  </ClaimsExchanges>
</OrchestrationStep>

신뢰 당사자 정책 구성

신뢰 당사자 정책(예: SignUpSignIn.xml)은 Azure AD B2C에서 실행할 사용자 경험을 지정합니다. 신뢰 당사자 내에서 DefaultUserJourney 요소를 찾습니다. ID 공급자를 추가한 사용자 경험 ID와 일치하도록 ReferenceId를 업데이트합니다.

다음 예제에서는 CustomSignUpSignIn 사용자 경험에 대해 ReferenceId가 CustomSignUpSignIn으로 설정됩니다.

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

사용자 지정 정책 업로드

Azure Portal에 로그인합니다.
포털 도구 모음에서 디렉터리 + 구독 아이콘을 선택한 다음, Azure AD B2C 테넌트가 포함된 디렉터리를 선택합니다.
Azure Portal에서 Azure AD B2C를 검색하고 선택합니다.
정책에서 Identity Experience Framework를 선택합니다.
사용자 지정 정책 업로드를 선택한 다음, 변경한 두 정책 파일을 확장 정책(예: TrustFrameworkExtensions.xml), 신뢰 당사자 정책(예: SignUpSignIn.xml) 순으로 업로드합니다.

사용자 지정 정책 테스트

신뢰 당사자 정책(예: B2C_1A_signup_signin)을 선택합니다.
애플리케이션에서 이전에 등록된 웹 애플리케이션을 선택합니다. 회신 URL에는 https://jwt.ms가 표시되어야 합니다.
지금 실행 단추를 선택합니다.
가입 또는 로그인 페이지에서 Contoso를 선택하여 Contoso 계정으로 로그인합니다.

로그인 프로세스가 성공하면 브라우저가 Azure AD B2C에서 반환된 토큰의 내용을 표시하는 https://jwt.ms로 리디렉션됩니다.

다음 단계

애플리케이션에 AD-FS 토큰을 전달하는 방법에 대해 알아봅니다.

Azure Active Directory B2C에서 사용자 지정 정책을 사용하여 OpenID Connect ID 공급자로 AD FS 추가

필수 조건

AD FS 애플리케이션 만들기

앱 클레임 구성

AD FS를 ID 공급자로 구성

사용자 흐름에 AD FS ID 공급자 추가

AD FS를 ID 공급자로 구성

사용자 경험 추가

사용자 경험에 ID 공급자 추가

신뢰 당사자 정책 구성

사용자 지정 정책 업로드

사용자 지정 정책 테스트

다음 단계

추가 리소스