기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS IAM Identity Center OpenSearch UI에 대한 인증
를 사용하면 팀이 브라우저 기반 Single Sign-On 경험을 얻을 AWS IAM Identity Center수 있습니다. 사용자는 미리 서명된 URL을 생성하는 대신 자격 AWS IAM Identity Center 증명으로 로그인합니다. URLs
사전 조건
-
기본 및 AWS IAM Identity Center IAM 권한이 모두 있는 AWS 계정입니다. 필요한 권한에 대한 자세한 정보는 OpenSearch UI에 대한 IAM 정책 참조 섹션을 참조하세요.
-
AWS IAM Identity Center 계정 또는 조직에서 활성화됩니다. 일부 구성 단계에 영향을 미치므로 조직 인스턴스가 있는지 계정 인스턴스가 있는지 확인합니다.
-
필요한 권한 정책과 신뢰 정책이 모두 있는 IAM 역할입니다. 에서이 역할을 생성합니다2단계: IAM 역할 생성.
-
리전에 하나 이상의 OpenSearch 도메인 또는 서버리스 컬렉션. AWS
-
하나 이상의 사용자 또는 그룹이 생성되었습니다 AWS IAM Identity Center.
고객 관리형 키를 사용하는 조직 인스턴스에 대한 추가 사전 조건
의 조직 인스턴스가 유휴 시 암호화에 고객 관리형 키를 AWS IAM Identity Center 사용하는 경우 해당 키를 사용하여 자격 증명 데이터를 복호화할 수 있는 OpenSearch UI 권한을 부여해야 합니다. 이 권한이 없으면 OpenSearch UI가 권한 부여 코드를 검증하는 AccessDeniedException 동안에서 Single Sign-On이 실패합니다.
인스턴스가 고객 관리형 키를 사용하는지 확인하려면 콘솔을 AWS IAM Identity Center 열고 설정을 선택한 다음 관리 탭을 선택하고 저장된 IAM Identity Center 데이터를 암호화하기 위한 키를 검토합니다. AWS 소유 키가 아닌 고객 관리형 키 ARN을 표시하는 경우 AWS IAM Identity Center 가 활성화된 관리 계정의 키 정책에 다음 문을 추가합니다. organization-id를 형식의 AWS Organizations 조직 ID로 바꿉니다o-xxxxxxxxxx.
{ "Sid": "Allow_AWS_app_admins_in_the_same_AWS_organization_to_use_the_KMS_key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "aws:PrincipalOrgID": "{{organization-id}}" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] } } }, { "Sid": "Allow_managed_apps_to_use_the_KMS_Key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "Bool": { "aws:PrincipalIsAWSService": "true" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] }, "StringEquals": { "aws:SourceOrgID": "{{organization-id}}" } } }
자세한 내용은 AWS IAM Identity Center 사용 설명서의 고객 관리형 키를 참조하세요.
1단계: AWS IAM Identity Center 가 활성화되어 있는지 확인
AWS IAM Identity Center 가 활성화되었는지 확인하려면
-
콘솔에 인스턴스 세부 정보가 포함된 대시보드가 표시되면 AWS IAM Identity Center 이 활성화됩니다. 인스턴스가 조직 인스턴스인지 계정 인스턴스인지 확인합니다.
-
콘솔에 설정 페이지가 표시되면 계속하기 AWS IAM Identity Center 전에를 활성화합니다.
조직 인스턴스는 AWS Organizations 조직의 모든 계정에서 작동하며 프로덕션 용도로 사용하는 것이 좋습니다. 계정 인스턴스는 테스트 및 격리된 설정에 적합한 단일 계정으로 범위가 지정됩니다. 계정이 다른 사용자가 관리하는 조직에 속한 경우 관리자에게 조직 수준에서를 활성화 AWS IAM Identity Center 해야 하는지 여부를 문의하세요.
2단계: IAM 역할 생성
AWS IAM Identity Center 는 사용자가 OpenSearch UI 애플리케이션에 액세스할 때 IAM 역할을 수임합니다. 이 역할에는 역할이 수행할 수 있는 작업을 정의하는 권한 정책과 역할을 수임할 수 있는 사용자를 정의하는 신뢰 정책이 필요합니다.
다음 권한 정책을 사용합니다. 자리 표시자를 자신의 정보로 바꿉니다.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }
가 역할을 수임 AWS IAM Identity Center 하도록 허용하는 다음 신뢰 정책을 사용합니다.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
역할을 생성하고에 권한 정책을 연결하려면 다음 명령을 AWS CLI실행합니다.
aws iam create-role \ --role-name OpenSearchUI-IDC-Role \ --assume-role-policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Principal":{"Service":"sso.amazonaws.com"}, "Action":"sts:AssumeRole" }] }' aws iam put-role-policy \ --role-name OpenSearchUI-IDC-Role \ --policy-name OpenSearchAppAccess \ --policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":"opensearch:ApplicationAccessAll", "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/*" }] }'
역할 ARN을 기록해 둡니다. 다음 단계에서 지정합니다. ARN의 형식은 arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role입니다.
3단계: AWS IAM Identity Center 활성화된를 사용하여 애플리케이션 생성
애플리케이션 생성을 시작하려면
-
탐색 메뉴에서 OpenSearch UI(대시보드)를 선택합니다.
-
애플리케이션 생성을 선택합니다.
-
애플리케이션 이름을 입력합니다.
-
OpenSearch 도메인 또는 서버리스 컬렉션 중 하나 이상의 데이터 소스를 추가합니다.
동일한 형식으로 계속 진행하여 Single Sign-On을 켜고 애플리케이션 생성을 완료합니다.
애플리케이션을 활성화 AWS IAM Identity Center 하고 생성하려면
-
IAM Identity Center를 사용한 인증 확인란을 선택합니다.
-
에서 생성한 IAM 역할을 선택합니다2단계: IAM 역할 생성.
-
(선택 사항) 대시보드 관리자를 구성합니다.
-
생성을 선택합니다.
를 사용하여 동일한 애플리케이션을 생성하려면 다음 명령을 AWS CLI실행합니다. 자리 표시자를 자신의 정보로 바꿉니다.
aws opensearch create-application \ --name "{{application-name}}" \ --iam-identity-center-options '{ "enabled": true, "iamRoleForIdentityCenterApplicationArn": "arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role" }' \ --data-sources '[{ "dataSourceArn": "arn:aws:es:{{region}}:{{account-id}}:domain/{{domain-name}}" }]' \ --region {{region}}
4단계:에서 사용자 할당 AWS IAM Identity Center
애플리케이션에 사용자 또는 그룹을 할당하려면
-
탐색 메뉴에서 애플리케이션을 선택합니다.
-
OpenSearch UI가 자동으로 등록한 애플리케이션을 선택합니다. 이름은 OpenSearch UI 애플리케이션 이름과 일치합니다.
-
사용자 및 그룹 할당을 선택합니다.
-
액세스 권한이 필요한 사용자 또는 그룹을 선택한 다음 할당을 선택합니다.
5단계: 설정 확인
설정을 확인하려면
-
Amazon OpenSearch Service 콘솔에서 애플리케이션 상태가 활성인지 확인합니다. 이는 애플리케이션을 사용할 준비가 되었음을 나타냅니다.
-
애플리케이션 세부 정보 페이지에서 IAM Identity Center를 사용한 인증이 활성화되어 있는지 확인합니다.
-
애플리케이션 세부 정보 페이지에서 애플리케이션 URL을 복사합니다.
-
브라우저에서 애플리케이션 URL을 엽니다. 로그인 페이지로 AWS IAM Identity Center 리디렉션됩니다.
-
자격 AWS IAM Identity Center 증명으로 로그인합니다. OpenSearch UI 워크스페이스 선택기가 나타납니다.
프로그래밍 방식으로 사용자 및 그룹 관리
가 AWS IAM Identity Center 활성화된 상태에서 OpenSearch UI 애플리케이션을 생성하면 OpenSearch UI가 AWS IAM Identity Center 애플리케이션을 등록합니다. 사용자가 로그인하려면 먼저 해당 애플리케이션에 사용자를 할당해야 합니다. 두 가지 액세스 수준이 있습니다.
- 애플리케이션 할당
-
OpenSearch UI에 로그인할 수 있는 사용자를 제어합니다.
sso-admin명령을 사용하여 관리합니다. - 애플리케이션 관리자
-
애플리케이션을 편집 또는 삭제하고 워크스페이스를 관리할 수 있는 사용자를 제어합니다. 를 사용하여 관리합니다
aws opensearch update-application. 애플리케이션 관리자에 대한 자세한 내용은 섹션을 참조하세요애플리케이션 관리자 관리.
할당을 관리하기 전에 세 개의 식별자가 필요합니다.
| 식별자 | 가져오는 방법 |
|---|---|
| AWS IAM Identity Center 애플리케이션 ARN | aws opensearch get-application,의 iamIdentityCenterOptions.iamIdentityCenterApplicationArn |
| 자격 증명 스토어 ID | aws sso-admin list-instances,의 Instances[0].IdentityStoreId |
| 사용자 또는 그룹 ID | aws identitystore list-users 또는 aws identitystore
list-groups |
다음 명령은 사용자 이름으로 사용자를 찾고 표시 이름으로 그룹을 찾습니다. 자리 표시자 값을 자신의 정보로 바꿉니다.
aws identitystore list-users \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"UserName","AttributeValue":"{{user-name}}"}]' \ --region {{region}} \ --query 'Users[0].UserId' --output text aws identitystore list-groups \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"DisplayName","AttributeValue":"{{group-name}}"}]' \ --region {{region}} \ --query 'Groups[0].GroupId' --output text
다음 명령은 사용자 또는 그룹을 애플리케이션에 할당하고 할당을 검토하거나 제거합니다. 그룹의 경우를 --principal-type GROUP 로 설정하고 앞에서 찾은 그룹 ID를 보안 주체 ID로 사용합니다.
aws sso-admin create-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}} aws sso-admin list-application-assignments \ --application-arn {{identity-center-application-arn}} \ --region {{region}} aws sso-admin delete-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}}
사용자 또는 그룹이 아직 자격 증명 스토어에 없는 경우 aws identitystore create-user 또는를 사용하여 생성하고를 사용하여 멤버를 aws identitystore create-group추가합니다aws identitystore create-group-membership.
다음 Python 코드 예제에서는 사용자 이름을 기준으로 사용자를 조회하고 Python용 AWS SDK(Boto3)를 사용하여 해당 사용자를 애플리케이션에 할당합니다.
import boto3 region = "{{region}}" app_id = "{{application-id}}" opensearch = boto3.client("opensearch", region_name=region) sso_admin = boto3.client("sso-admin", region_name=region) identity_store = boto3.client("identitystore", region_name=region) app = opensearch.get_application(id=app_id) idc_app_arn = app["iamIdentityCenterOptions"]["iamIdentityCenterApplicationArn"] identity_store_id = sso_admin.list_instances()["Instances"][0]["IdentityStoreId"] users = identity_store.list_users( IdentityStoreId=identity_store_id, Filters=[{"AttributePath": "UserName", "AttributeValue": "{{user-name}}"}], ) user_id = users["Users"][0]["UserId"] sso_admin.create_application_assignment( ApplicationArn=idc_app_arn, PrincipalId=user_id, PrincipalType="USER", )
AWS IAM Identity Center 인증 문제 해결
AWS IAM Identity Center 인증 문제는 일반적으로를 생략하는 신뢰 정책sso.amazonaws.com, 필요한 작업이 누락된 권한 정책 또는 애플리케이션에 할당되지 않은 사용자에서 비롯됩니다. 다음 표에는 일반적인 증상, 가능한 원인 및 각 증상 해결 방법이 나와 있습니다.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 애플리케이션을 생성하는 동안 활성화 AWS IAM Identity Center 되지 않은 메시지가 나타납니다. | 계정 또는 조직에 인스턴스가 없습니다. | AWS IAM Identity Center 콘솔 AWS IAM Identity Center 에서 활성화 |
| Single Sign-On은 리디렉션하지만 오류를 반환합니다. | 역할 신뢰 정책에는가 포함되지 않습니다. sso.amazonaws.com |
에 설명된 대로 신뢰 정책 업데이트 2단계: IAM 역할 생성 |
| 로그인에 성공했지만 사용자에게 액세스 권한이 없음 | 사용자가 애플리케이션에 할당되지 않았습니다. | 에 설명된 대로 AWS IAM Identity Center 콘솔에서 사용자를 할당합니다. 4단계:에서 사용자 할당 AWS IAM Identity Center |
| 로그인 후 액세스가 거부됨 | 역할 권한 정책에 필요한 작업이 누락되었습니다. | 역할에 데이터 소스에 액세스할 수 있는 opensearch:ApplicationAccessAll 및 권한이 있는지 확인합니다. |
| 애플리케이션이 활성화된 AWS IAM Identity Center 것으로 표시되지만 로그인에 실패합니다. | 역할 ARN이 일치하지 않습니다. | 애플리케이션 설정의 역할 ARN이 올바른 신뢰 및 권한 정책을 가진 역할인지 확인합니다. |
| 를 사용하여 애플리케이션을 생성할 수 없습니다. AWS IAM Identity Center | AWS IAM Identity Center 권한이 누락되었습니다. | IAM 보안 주체에 sso:CreateApplication, sso:PutApplicationGrant및가 있는지 확인합니다. iam:PassRole |
| 로그인 페이지가 표시되지만 로그인할 수 있는 사용자는 없습니다. | 에 사용자가 할당되지 않음 AWS IAM Identity Center | AWS IAM Identity Center 콘솔에서 애플리케이션에 사용자 할당 |
권한 부여 코드를 검증할 수 없다는 메시지 또는를 사용하여 로그인에 실패 AccessDeniedException |
AWS IAM Identity Center 는 필수 키 정책 없이 고객 관리형 키를 사용합니다. | 이 주제의 앞부분에서 설명한 키 정책 설명 추가 |
| 사용자가 할당된 직후 로그인할 수 없음 | 할당이 아직 전파되지 않았습니다. | 1~2분 정도 기다린 다음 다시 시도하세요. |
create-application-assignment에서 AccessDeniedException 발생 |
sso:CreateApplicationAssignment 권한이 누락되었습니다. |
에 나열된 AWS IAM Identity Center 권한 추가 OpenSearch UI에 대한 IAM 정책 참조 |
ConflictException 할당의 |
사용자 또는 그룹이 이미 할당되었습니다. | 를 사용하여 확인 list-application-assignments |