OIDC를 사용하여 Workforce Identity Federation을 구성하려면 Okta 또는 Microsoft Entra ID 와 같은 외부 ID 제공자 에 OIDC 애플리케이션 등록합니다. 이렇게 하면 보안 인증 보장되고 사용자 관리 쉬워집니다.
이 작업에 대하여
Workforce Identity Federation은 OIDC를 사용합니다. OIDC 표준을 지원하는 모든 외부 ID 제공자 사용할 수 있습니다.
다음 권한 부여 유형에 대해 OIDC 애플리케이션 구성할 수 있습니다.
PKCE를 사용한 권한 부여 코드 흐름
기기 권한 부여 흐름
MongoDB 보안 강화를 위해 PKCE와 함께 Authorization Code Flow(권한 부여 코드 흐름)를 사용할 것을 권장합니다. 사용자가 브라우저 없이 컴퓨터에서 데이터베이스 액세스 해야 하는 경우에만 Device Authorization Flow(장치 권한 부여 흐름)를 사용하세요.
참고
Workforce Identity Federation은 인증 위해 JSON web token 만 지원합니다. 불투명 액세스 토큰은 지원 하지 않습니다.
다음 절차에서는 Microsoft Entra ID 및 Okta에 대한 자세한 구성 지침과 기타 외부 ID 제공자를 위한 일반 구성 지침을 제공합니다.
시작하기 전에
Okta를 ID 제공자로 사용하려면 Okta 계정이 있어야 합니다.
Microsoft Entra ID ID 제공자 로 사용하려면 Microsoft Azure 계정이있어야 합니다.
Microsoft AD FS를 서버로 사용하려면 Active Directory 도메인에 가입되어 있고 공개적으로 신뢰할 수 있는 SSL 인증서가 있는 AD FS 서버가 있어야 합니다.
단계
애플리케이션 등록
App registrations(으)로 이동합니다.
Azure Portal 계정에서 Microsoft Entra ID를 검색 하고 클릭합니다.
좌측 탐색의 Manage 섹션에서 App registrations을 클릭합니다.
New registration를 클릭합니다.
다음 값을 적용합니다.
필드값Name
MongoDB - Workforce
Supported Account Types
Accounts in this organizational directory only (single tenant)
Redirect URI
- Public client/native (mobile & desktop)
- MongoDB Compass와 MongoDB Shell을 사용하여 클러스터에 액세스하려면 Redirect URI을http://localhost:27097/redirect(으)로 설정합니다.Register를 클릭합니다.
애플리케이션 등록에 대해 자세히 학습하려면 Azure 설명서를 참조하세요.
그룹 클레임 추가
Token Configuration(으)로 이동합니다.
좌측 탐색의 Manage 섹션에서 Token Configuration을 클릭합니다.
Add groups claim를 클릭합니다.
Edit groups claim 0} 모달에서 을 Security 선택합니다.
선택하는 그룹은 Azure 환경에서 구성한 그룹 유형에 따라 다릅니다. 적절한 그룹 정보를 전송하려면 다른 그룹 유형을 선택해야 할 수도 있습니다.
Customize token properties by type 섹션에서 Group ID 만 선택합니다.
Add를 클릭합니다.
그룹 클레임 추가에 대해 자세히 학습하려면 Azure 설명서를 참조하세요.
매니페스트 업데이트
좌측 탐색의 Manage 섹션에서 Manifest을 클릭합니다.
0}을 requestedAccessTokenVersion
null에서2로 업데이트합니다.숫자
2는 Microsoft의 액세스 토큰 버전 2를 나타냅니다. 다른 애플리케이션에서는 이를 Active Directory에서 관리하는 사용자 ID의 서명된 증명으로 사용합니다. 버전 2는 토큰이 MongoDB가 이해할 수 있는 JSON Web Token인지 확인합니다.Save를 클릭합니다.
선택적 클레임을 추가하는 방법에 대해 자세히 학습하려면 Azure 설명서를 참조하세요.
메타데이터 기억
왼쪽 탐색에서 Overview을 클릭합니다.
Application (client) ID 값을 복사합니다.
상단 탐색에서 Endpoints을 클릭합니다.
/.well-known/openid-configuration부분을 제외한 OpenID Connect metadata document 값을 복사합니다.OpenID Connect metadata document URL 에서
issuer값을 복사하여 이 값을 가져올 수도 있습니다.
다음 표는 이러한 Microsoft Entra ID UI 값이 MongoDB oidcIdentityProviders 매개변수에서 매핑되는 것을 보여줍니다.
Microsoft Entra ID UI | MongoDB oidcIdentityProviders 매개변수 필드 |
|---|---|
Application (client) ID |
|
OpenID Connect metadata document (without /.well-known/openid-configuration) |
|
페더레이션 서비스 식별자를 업데이트하세요.
In Server Manager, go to Tools → AD FS Management.
Edit Federation Service Properties를 클릭합니다.
In the Federation Service identifier field, change the value from
https://<domain>/adfs/services/trusttohttps://<domain>/adfs.<domain>부분은 AD FS 서버가 속한 Active Directory 도메인 이름으로 바꿔야 합니다.OK를 클릭합니다.
이 단계에서 업데이트하는 페더레이션 서비스 식별자는 MongoDB에서 OIDC 공급자를 구성할 때 사용하는 발급자 URI입니다. 이 값이 일치하지 않으면 토큰 발급자 불일치로 인해 인증이 실패합니다.
Add the groups and sub claims to the access token.
MongoDB reads the groups and sub claims from the access token. By default, AD FS includes sub only in the ID token and sends an idsub claim in the access token instead. To add both claims to the access token, create an issuance transform rule on your web API:
AD FS 관리에서 애플리케이션 그룹의 속성을 엽니다.
In the Applications section, select your web API and click Edit.
On the Issuance Transform Rules tab, click Add Rule.
In the Claim rule template field, select Send LDAP Attributes as Claims and click Next.
In the Claim rule name field, enter a name for the rule.
Attribute store 필드 에서 Active Directory을(를) 선택합니다.
다음 LDAP 속성을 발신 클레임 유형에 매핑합니다.
LDAP 속성발신 청구 유형Token-Groups - Unqualified Names
groupsUser-Principal-Name
subOK를 클릭합니다.
Okta에서 애플리케이션 생성합니다.
Okta Admin 대시보드 에서 왼쪽 탐색 창을 사용하여 Applications → Applications(으)로 고 (Go) .
Applications 화면에서 Create App Integration을 클릭합니다.
Sign-in method 섹션에서 OIDC - OpenID Connect를 선택합니다.
Application type 섹션에서 Native Application를 선택합니다.
Next를 클릭합니다.
자세한 학습 은 OIDC 앱 통합 생성을 참조하세요.
을(를) New Native App Integration 구성합니다.
앱 통합을 생성하면 자동으로 New Native App Integration 화면으로 리디렉션됩니다.
App integration name 필드 에 애플리케이션 의 이름을 입력합니다.
In the Grant type field, select the grant types.
다음 권한 부여 유형을 활성화합니다.
Authorization Code, Device Authorization, or both
(선택 사항) Refresh Token
새로 고침 토큰을 활성화하면 사용자 경험이 향상됩니다. 새로 고침 토큰을 활성화하지 않으면 사용자는 액세스 토큰이 만료될 때마다 ID 공급자에게 다시 인증해야 합니다.
Sign-in redirect URIs 섹션에 URL 입력합니다.
다음 URL 입력합니다:
http://localhost:27097/redirect.In the Assignments section, configure the Controlled access and Enable immediate access fields with the appropriate settings for your security policies.
Save를 클릭합니다.
자세한 학습 은 OIDC 앱 통합 생성을 참조하세요.
권한 부여 서버 추가합니다.
왼쪽 탐색 창에서 Security → API(으)로 고 (Go) . Add Authorization Server을(를) 클릭합니다.
Name 필드 에 서버 의 이름을 입력합니다.
Fill in the Audience field.
The Audience is the entity that OIDC intends the token for. While this can be any valid URI, generally, this is the client ID of your application you copied in the previous step.
(선택 사항) Description 필드 에 서버 에 대한 설명을 입력합니다.
Save를 클릭합니다.
(Conditionally Required) Add a Groups claim.
이 단계는 Okta 그룹을 사용하여 사용자를 인증하려는 경우에만 필요합니다. 사용자 ID를 사용하여 인증할 계획이라면 이 단계를 건너뛸 수 있습니다.
권한 부여 서버 화면에서 Claims 탭 으로 고 (Go) Add Claim을 클릭합니다.
Configure the Groups claim with the following configuration information:
필드값Name
클레임의 이름을 입력합니다.
Include in token type
드롭다운을 클릭하고 Access Token을 선택합니다.
Value type
드롭다운을 클릭하고 Groups을 선택합니다.
Filter
드롭다운을 클릭하고 Matches regex을 선택합니다. 드롭다운 엽에 Atlas 권한 부여에 사용되는 그룹에만 일치하는 정규 표현식을 입력합니다. 예시, Atlas 권한 부여 그룹에서 공통 명명 접두어를 사용하는 경우,
<mongodb-atlas-group-prefix>는 선택한 접두어이므로^<mongodb-atlas-group-prefix>.*을 입력합니다.Disable claim
확인하지 마세요.
Include in
Any scope0}을 선택합니다.
Create를 클릭합니다.
중요
.*을(를) 필터 값으로 사용하지 마십시오. .* 표현식은 Atlas 권한 부여와 관련이 없는 그룹도 포함하여 사용자에게 할당된 모든 그룹에 대해 일치합니다. 광범위한 필터는 액세스 토큰 크기를 증가시키고, 토큰이 preAuthMaximumMessageSizeBytes 제한(기본값 16 KiB)을 초과할 경우 인증 실패를 발생시키실 수 있습니다.
토큰 크기를 줄이려면 Atlas 권한 부여 그룹에 대한 전용 명명 규칙을 만들고 해당 규칙에 따라 필터링합니다.
If your deployment intentionally requires a large groups claim, you can increase the preAuthMaximumMessageSizeBytes parameter on your cluster. However, increasing this limit has resource and security implications and should not be used as a workaround for an unnecessarily broad claim.
액세스 정책에 대한 규칙을 만듭니다.
Access Policies 탭 에서 Add Rule을(를) 클릭합니다.
Rule Name 필드 에 액세스 정책의 이름을 입력합니다.
IF Grant Type is에 대해 부여 유형을 선택합니다.
권한 부여 유형을 구성할 때 클라이언트 동작에 따라 적절한 옵션을 선택합니다.
클라이언트 자체를 대행하는 경우 Client Credentials를 선택합니다.
클라이언트 사용자를 대신하는 경우 다음을 선택합니다.
Authorization Code
Device Authorization
조직의 보안 정책에 따라 규칙 구성을 추가합니다.
Okta 규칙 구성 예시:
필드값AND user is
Any user assigned to the app0}을 선택합니다.
AND Scopes requested
Any scopes0}을 선택합니다.
THEN Use this inline hook
없음(비활성화)
AND Access token lifetime is
1 Hours
AND Refresh token lifetime is
두 번째 드롭다운을 클릭하고 Unlimited을 선택합니다.
but will expire if not used every
7 days을(를) 입력합니다.
Create Rule를 클릭합니다.
그룹 만듭니다.
왼쪽 탐색 창에서 Directory → Groups(으)로 고 (Go) 하여 Add Group을(를) 클릭합니다.
Name 필드 에서 디렉토리 이름을
OIDC로 지정합니다.(선택 사항) Description 필드 에 규칙에 대한 설명을 입력합니다.
Save를 클릭합니다.
Okta 설명서에 따라 그룹에 사람을 수동으로 할당합니다.
조직 에 사용자를 추가합니다.
왼쪽 탐색 창에서 Directory → People(으)로 고 (Go) 하여 Add Person을(를) 클릭합니다.
해당 필드에 다음 값을 입력하여 사용자 세부 정보를 제공합니다.
필드값User type
User0}을 선택합니다.
First name
필요에 따라 이름을 입력하세요.
Last name
필요에 따라 이름을 입력하세요.
Username
사용자 이름 으로 이메일 입력합니다.
Primary email
이메일 입력합니다. 이메일 Username 필드 에 사용된 이메일과 동일해야 합니다.
Secondary email
선택 사항.
Groups
OIDC을(를) 입력합니다.
Activation
Activate Now 을(를) 선택하고 I will set password을(를) 확인합니다.
Password
비밀번호를 입력합니다.
User must change password on first login
SELECT Optional
Save를 클릭합니다.
자세히 학습 수동으로 사용자 추가를 참조하세요.
(선택 사항) 더 나은 사용자 경험을 위해 MongoDB 클라이언트가 토큰을 새로 고치도록 하려면 토큰 새로 고침 허용
(선택 사항) 데이터베이스 연결 세션 시간에 맞게 액세스 토큰 수명(exp 클레임)을 구성합니다.
애플리케이션 을 등록한 후 구성의 다음 단계에서 사용할 issuer, clientId 및 audience 값을 저장합니다.