OAuth 2.0으로 Workload Identity Federation 설정

애플리케이션을 등록합니다.

1. App registrations 로 이동합니다.

   1. Azure Portal 에서 계정을 검색 하고 를 Microsoft Entra ID 클릭합니다.

   2. 좌측 탐색의 Manage 섹션에서 App registrations을 클릭합니다.

2. New registration를 클릭합니다.

3. 다음 값을 적용합니다.

   필드	값
   Name	Atlas Database - Workload
   Supported Account Types	Accounts in this organizational directory only (single tenant)
   Redirect URI	Web

(선택 사항) 그룹 클레임을 추가합니다.

Atlas 에서 액세스 권한을 정의하는 동안 서비스 주체 식별자를 MongoDB 사용자 식별자로 사용하는 것이 가장 좋습니다. 이 일반적인 접근 방식을 사용할 계획이라면 이 단계를 건너뛰세요. 그러나 Azure AD 보안 그룹 식별자와 같은 그룹 식별자를 대신 사용하려는 경우 아래 단계에 따라 애플리케이션 등록에서 그룹 클레임을 설정하다 수 있습니다.

1. Token Configuration(으)로 이동합니다.

   좌측 탐색의 Manage 섹션에서 Token Configuration을 클릭합니다.

2. Add groups claim를 클릭합니다.

3. Edit groups claim 0} 모달에서 을 Security 선택합니다.

   선택하는 그룹은 Azure 환경에서 구성한 그룹 유형에 따라 다릅니다. 적절한 그룹 정보를 전송하려면 다른 그룹 유형을 선택해야 할 수도 있습니다.

4. 0} Customize token properties by type 섹션에서 만 선택했는지 확인합니다.Group ID

   Group Id를 선택하면 Azure에서 보안 그룹의 객체 ID를 보냅니다.

5. Add를 클릭합니다.

   그룹 클레임 추가에 대해자세히 알아보려면 Azure 설명서를 참조하세요.

애플리케이션 ID URI를 활성화합니다.

1. 왼쪽 사이드바에서 Expose an API (으)로 이동하여 애플리케이션 ID URI를 활성화 합니다.

2. 애플리케이션 ID URI를 활성화합니다.

   1. Azure 에서 할당한 기본값 애플리케이션 ID URI인 <application_client_id> 을 유지합니다. MongoDB Atlas 및 모든 MongoDB 드라이버는 Workload Identity Federation 구성에 이 값을 요구하므로 이 값을 복사하여 저장 합니다.

매니페스트를 업데이트합니다.

1. 좌측 탐색의 Manage 섹션에서 Manifest을 클릭합니다.

2. 0}을 accessTokenAcceptedVersion null 에서 2 로 업데이트합니다.

   숫자 2는 Microsoft의 액세스 토큰 버전 2를 나타냅니다. 다른 애플리케이션에서는 이를 Active Directory에서 관리하는 사용자 ID의 서명된 증명으로 사용합니다. 버전 2는 토큰이 MongoDB가 이해할 수 있는 JSON Web Token인지 확인합니다.

3. Save를 클릭합니다.

선택적 클레임을 추가하는 방법에 대해 자세히 알아보려면 Azure 설명서를 참조하세요.

메타데이터를 기억하세요.

1. 왼쪽 탐색에서 Overview을 클릭합니다.

   Application (client) ID 값을 복사합니다.

2. 상단 탐색에서 Endpoints을 클릭합니다.

   /.well-known/openid-configuration 부분을 제외한 OpenID Connect metadata document 값을 복사합니다.

   OpenID Connect metadata document URL 을 따라 이동하고 issuer 값을 복사하여 이 값을 조회 할 수도 있습니다.

다음 표는 Atlas 구성 속성에서 이러한 Microsoft Entra ID UI 값이 매핑하는 것을 보여 줍니다.

조직 설정으로 이동합니다.

1. Open Federation Management App 을(를) 클릭합니다.

Identity Providers 왼쪽 사이드바에서 을(를) 클릭합니다.

1. Set Up Identity Provider 또는 Configure Identity Provider을(를) 클릭합니다.

2. Workload Identity Provider Continue0}을 선택하고 을 클릭합니다.

다음 Workload Identity Federation 설정을 입력합니다.

Save and Finish를 클릭합니다.

조직 의 워크로드 아이덴티티를 활성화합니다.

1. Connect Organizations를 클릭합니다.

2. Workload Identity Federation에 연결하려는 조직 의 경우 Configure Access 을(를) 클릭합니다.

3. Connect Identity Provider를 클릭합니다.

   참고

   다른 IdP 를 이미 구성한 경우 Atlas 는 대신 Connect Identity Provider(s) 버튼을 표시합니다.

워크로드 아이덴티티 제공자를 선택합니다.

Connect Identity Provider(s) 모달에서 Purpose 이 Workload Identity Federation 인 워크로드 아이덴티티 제공자를 선택합니다.

Connect를 클릭합니다.

Workload Identity Provider를 조직 에 연결하면 Atlas 는 해당 조직 내의 모든 프로젝트에 대해 Workload Identity Federation을 활성화합니다.

조직 설정으로 이동합니다.

1. Open Federation Management App 을(를) 클릭합니다.

Identity Providers 왼쪽 사이드바에서 을(를) 클릭합니다.

1. Set Up Identity Provider 또는 Configure Identity Provider을(를) 클릭합니다.

2. Workload Identity Provider Continue0}을 선택하고 을 클릭합니다.

다음 Workload Identity Federation 설정을 입력합니다.

Save and Finish를 클릭합니다.

조직 에서 워크로드 아이덴티티를 활성화합니다.

1. Connect Organizations를 클릭합니다.

2. Workload Identity Federation에 연결하려는 조직에 대해 Configure Access 을(를) 클릭합니다.

3. Connect Identity Provider를 클릭합니다.

   참고

   다른 IdP 를 이미 구성한 경우 Atlas 는 대신 Connect Identity Provider(s) 버튼을 표시합니다.

워크로드 아이덴티티 제공자를 선택합니다.

Connect Identity Provider(s) 모달에서 Purpose 이 Workload Identity Federation 인 워크로드 아이덴티티 제공자를 선택합니다.

Connect를 클릭합니다.

Workload Identity Provider를 조직 에 연결하면 Atlas 는 해당 조직 내의 모든 프로젝트에 대해 Workload Identity Federation을 활성화합니다.