Certificate APIs
출처: 문서
본문
인증서 API
인증서 API는 클러스터에서 사용 중인 인증서를 반환하고, 노드를 재시작하지 않고 인증서를 다시 로드해요.
OpenSearch는 다음 인증서 API를 지원해요.
| API | 설명 |
|---|---|
| Get Certificates API | 요청을 수신하는 노드에서 사용 중인 HTTP 및 transport 인증서를 반환해요. |
| Get All Certificates API | 클러스터의 모든 노드에서 사용 중인 인증서를 반환해요. |
| Get Node Certificates API | 지정된 노드에서 사용 중인 인증서를 반환해요. |
| Reload Transport Certificates API | 노드를 재시작하지 않고 transport 레이어 인증서를 다시 로드해요. |
| Reload HTTP Certificates API | 노드를 재시작하지 않고 HTTP 레이어 인증서를 다시 로드해요. |
필수 권한
인증서 API는 슈퍼 관리자로 제한돼요. plugins.security.restapi.roles_enabled에 나열된 역할에 매핑되는 것만으로는 충분하지 않아요. all_access 역할을 가진 사용자도 403 Forbidden을 받게 돼요. 이 API를 호출하려면 다음 방법 중 하나를 사용하세요.
- 관리자 인증서로 인증하세요. 자세한 내용은 관리자 인증서 구성을 참조하세요.
- 역할에 다음 클러스터 권한 중 하나를 부여하고
opensearch.yml에서plugins.security.restapi.admin.enabled를true로 설정하세요. 이 권한들은 독립적으로 부여되므로, 역할이plugins.security.restapi.roles_enabled에 나열될 필요는 없어요.
| 작업 | 필요한 권한 |
|---|---|
| 인증서 조회 | restapi:admin/ssl/certs/info |
| 인증서 다시 로드 | restapi:admin/ssl/certs/reload |
예약된 security_rest_api_full_access 역할에는 두 권한이 모두 포함되어 있어요. restapi:admin 권한을 하나라도 포함하는 역할은 Role APIs를 통해 생성하거나 수정할 수 없으므로, roles.yml에서 직접 그런 역할을 정의하고 securityadmin.sh로 적용하세요. 자세한 내용은 구성 파일에 변경 사항 적용을 참조하세요.
역할이 이 API를 사용하지 못하게 하려면 plugins.security.restapi.endpoints_disabled를 사용해 해당 역할의 SSL 엔드포인트를 비활성화하세요.