Allow list APIs
출처: 문서
본문
허용 목록 API
허용 목록 API는 관리자 권한이 없는 사용자가 접근할 수 있는 API를 제어해요.
OpenSearch는 다음과 같은 허용 목록 API를 지원해요.
| API | 설명 |
|---|---|
| 허용 목록 생성 또는 업데이트 API | 허용 목록 구성을 생성하거나 교체해요. |
| 허용 목록 패치 API | 허용 목록 구성에서 개별 필드를 업데이트해요. |
| 허용 목록 조회 API | 현재 허용 목록 구성을 조회해요. |
필수 권한
허용 목록 API는 슈퍼 관리자만 사용할 수 있어요. plugins.security.restapi.roles_enabled에 나열된 역할에 매핑되는 것만으로는 충분하지 않아요. all_access 역할을 가진 사용자도 403 Forbidden을 받게 돼요. 이 API를 호출하려면 다음 방법 중 하나를 사용하세요.
- 관리자 인증서로 인증하세요. 자세한 내용은 관리자 인증서 구성을 참조하세요.
- 역할에
restapi:admin/allowlist클러스터 권한을 부여하고opensearch.yml에서plugins.security.restapi.admin.enabled를true로 설정하세요. 이 권한은 독립적인 권한이므로, 해당 역할이plugins.security.restapi.roles_enabled에 나열될 필요는 없어요.
예약된 security_rest_api_full_access 역할에는 restapi:admin/allowlist가 포함되어 있어요. restapi:admin 권한을 하나라도 포함하는 역할은 역할 API를 통해 생성하거나 수정할 수 없으므로, roles.yml에서 직접 이런 역할을 정의하고 securityadmin.sh로 적용하세요. 자세한 내용은 구성 파일에 변경 사항 적용하기를 참조하세요.
역할이 이 API를 사용하지 못하도록 하려면 plugins.security.restapi.endpoints_disabled를 사용해 해당 역할의 ALLOWLIST 엔드포인트를 비활성화하세요.