View a markdown version of this page

OpenSearch UI에 대한 IAM 인증 - Amazon OpenSearch Service

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

OpenSearch UI에 대한 IAM 인증

이 주제에서는 없이 IAM 인증을 사용하는 OpenSearch UI 애플리케이션에 액세스하는 데 필요한 최소 IAM 권한을 다룹니다 AWS IAM Identity Center. 이 단계를 완료하면 IAM 역할이 애플리케이션에 로그인하고 데이터 소스를 쿼리할 수 있습니다.

사전 조건

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 정책 참조.