기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
OpenSearch UI에 대한 IAM 인증
이 주제에서는 없이 IAM 인증을 사용하는 OpenSearch UI 애플리케이션에 액세스하는 데 필요한 최소 IAM 권한을 다룹니다 AWS IAM Identity Center. 이 단계를 완료하면 IAM 역할이 애플리케이션에 로그인하고 데이터 소스를 쿼리할 수 있습니다.
사전 조건
-
IAM 인증으로 생성된 OpenSearch UI 애플리케이션입니다. 애플리케이션 생성에 대한 지침은 섹션을 참조하세요Amazon OpenSearch Service에서 OpenSearch 사용자 인터페이스 시작하기.
-
애플리케이션에 액세스해야 하는 IAM 역할입니다.
-
자격 증명으로 AWS CLI 구성된 .
1단계: IAM 권한 부여
다음 IAM 정책은 애플리케이션 인터페이스에 대한 액세스 권한을 부여합니다. 액세스가 필요한 IAM 역할에 연결하고 자리 표시자 값을 자신의 정보로 바꿉니다.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" } ] }
리소스를 단일 애플리케이션 ID로 범위를 지정하면 역할에 필요한 최소 권한이 부여됩니다. 대신 계정 및 리전의 모든 애플리케이션에 대한 액세스 권한을 부여하려면 와일드카드를 사용합니다.
"Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*"
동일한 정책을 AWS CLI다음과 함께 연결할 수 있습니다.
aws iam put-role-policy \ --role-name {{role-name}} \ --policy-name OpenSearchAppAccess \ --policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":"opensearch:ApplicationAccessAll", "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" }] }'
애플리케이션 인터페이스에 대한 액세스 권한을 부여하는 작업은 입니다opensearch:ApplicationAccessAll. 애플리케이션에 필요한 권한에 대한 자세한 내용은 섹션을 참조하세요OpenSearch UI에 대한 IAM 정책 참조.
사용자가에서 애플리케이션도 열면 콘솔에서 애플리케이션을 볼 수 있도록 다음 문을 AWS Management Console추가합니다.
{ "Effect": "Allow", "Action": "es:GetApplication", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" }
2단계: 대시보드 관리자 구성
OpenSearch UI 내에서 관리자 권한을 받는 IAM 보안 주체를 설정합니다. 인증된 모든 사용자에게 관리자 권한을 부여하려면 다음 명령을 실행합니다.
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"*"}]' \ --region {{region}}
단일 역할에 관리자 권한을 부여하려면 역할 ARN을 지정합니다.
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"arn:aws:iam::{{account-id}}:role/{{role-name}}"}]' \ --region {{region}}
대시보드 관리자 설정은 인터페이스 내에서 인덱스 패턴 관리 및 저장된 객체와 같은 관리자 기능을 제어합니다. 로그인하는 데 필요하지 않습니다. 1단계의 IAM 정책만으로도 애플리케이션에 액세스할 수 있습니다.
3단계: 액세스 확인
미리 서명된 URL을 사용하여 브라우저에서 액세스를 확인하거나 서명 버전 4 요청 헤더를 사용하여 프로그래밍 방식으로 액세스를 확인할 수 있습니다.
브라우저에서 액세스 확인
다음 Python 코드 예제에서는 브라우저에서 여는 서명 버전 4 미리 서명된 URL을 생성합니다.
from botocore.session import Session from botocore.auth import SigV4QueryAuth from botocore.awsrequest import AWSRequest session = Session() cred = session.get_credentials().get_frozen_credentials() endpoint = "{{application-endpoint}}" region = "{{region}}" url = f"https://{endpoint}/_login/" request = AWSRequest(method="GET", url=url) SigV4QueryAuth(cred, "opensearch", region, expires=300).add_auth(request) print(request.url) # Open this URL in a browser
/_login/ 미리 서명된 URL은 브라우저에서만 작동합니다. curl 또는 다른 HTTP 클라이언트에서는 작동하지 않습니다.
프로그래밍 방식으로 액세스 확인
다음 Python 코드 예제는 서명 버전 4 헤더를 사용하여 애플리케이션 엔드포인트에 대한 요청에 서명합니다.
from botocore.session import Session from botocore.auth import SigV4Auth from botocore.awsrequest import AWSRequest import subprocess session = Session() cred = session.get_credentials().get_frozen_credentials() endpoint = "{{application-endpoint}}" region = "{{region}}" url = f"https://{endpoint}/" request = AWSRequest(method="GET", url=url) SigV4Auth(cred, "opensearch", region).add_auth(request) cmd = ["curl", "-s", "-w", "\nHTTP: %{http_code}\n", "-D", "-"] for k, v in request.headers.items(): cmd.extend(["-H", f"{k}: {v}"]) cmd.append(url) result = subprocess.run(cmd, capture_output=True, text=True) print(result.stdout)
요청이 성공하면 location 헤더가 HTTP/1.1 302 Found 인가 반환됩니다/app/workspace_initial. 가 반환하는 요청은 IAM 정책에 문제가 있음을 HTTP/1.1 403 Forbidden 나타냅니다.
서명 버전 4 서명 세부 정보
다음 표에는 OpenSearch UI에 필요한 서명 버전 4 파라미터가 나열되어 있습니다.
| 파라미터 | 값 |
|---|---|
| 서비스 이름 | opensearch |
| Algorithm | AWS4-HMAC-SHA256 |
| 서명된 헤더 | host, 최소한 |
| 미리 서명된 URL 만료 | 300초 이하 권장 |
서명 버전 4 서비스 이름은 입니다opensearch. es 또는를 사용하여 서명aoss하면 요청이 실패합니다.
구성 요약
다음 표에는 각 구성 계층이 제어하는 항목이 나열되어 있습니다.
| 계층 | 구성 | 로그인하는 데 필요합니까? |
|---|---|---|
| IAM 정책 | opensearch:ApplicationAccessAll 애플리케이션 ARN의 |
예 |
| IAM 정책 | es:GetApplication 애플리케이션 ARN의 |
에서 애플리케이션을 여는 경우에만 AWS Management Console |
| 애플리케이션 구성 | opensearchDashboards.dashboardAdmin.users |
아니요 - 관리자 기능만 제어합니다. |
IAM 인증 문제 해결
IAM 인증 문제는 일반적으로 누락된 정책 작업, 브라우저 외부에서 사용되는 미리 서명된 URL 또는 잘못된 서비스 이름으로 서명된 요청에서 발생합니다. 다음 표에는 일반적인 증상, 가능한 원인 및 각 증상 해결 방법이 나와 있습니다.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
403 Forbidden 애플리케이션 URL을 열 때 |
opensearch:ApplicationAccessAll 권한이 누락되었습니다. |
1단계의 IAM 정책 추가 |
403 수행할 권한이 없는 메시지와 함께 es:GetApplication |
콘솔 권한이 누락되었습니다. | 애플리케이션 ARNes:GetApplication에를 추가합니다. 이는 AWS Management Console 액세스에만 필요합니다. |
400 Bad Request를 /_login/ 사용한의 curl |
/_login/ 엔드포인트는 브라우저에서만 작동합니다. |
프로그래밍 방식 액세스를 / 위해에서 서명 버전 4 헤더 인증 사용 |
미리 서명된 URL은를 반환합니다. SignatureDoesNotMatch |
서명 버전 4 서비스 이름이 잘못되었습니다. | es 또는가 opensearch아닌를 사용하여 요청에 서명 aoss |
| 애플리케이션을 열 수 있지만 관리자 기능이 누락되었습니다. | 대시보드 관리자가 구성되지 않았습니다. | 2단계에 설명된 opensearchDashboards.dashboardAdmin.users대로 update-application로 실행 |
| 미리 서명된 URL이 만료되었습니다. | URL이 300초 이상 전에 생성되었습니다. | 미리 서명된 새 URL을 생성합니다. 미리 서명된 URLs은 수명이 짧습니다. |
OpenSearch UI가 사용하는 IAM 작업에 대한 자세한 내용은 섹션을 참조하세요OpenSearch UI에 대한 IAM 정책 참조.