Create or Update Allow List API

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

허용 목록 생성 또는 업데이트 API

2.1에서 도입됨 {: .label .label-purple }

허용 목록 설정을 생성하거나 교체해요.

이 API는 슈퍼어드민 전용이에요. 사용자 이름과 비밀번호 대신 어드민 인증서로 인증하세요. 자세한 내용은 API 접근 제어를 참고하세요. {: .note}

엔드포인트

PUT /_plugins/_security/api/allowlist

요청 본문 필드

요청 본문은 필수예요. 다음 필드를 포함하는 JSON 객체예요.

필드	데이터 타입	설명	필수
`enabled`	Boolean	허용 목록을 강제할지 여부예요. `true`이면 어드민 권한이 없는 사용자는 `requests`에 나열된 요청만 호출할 수 있어요.	예
`requests`	Object	허용되는 요청이에요. 각 키는 `/_cat/nodes` 같은 경로이고, 각 값은 해당 경로에 허용되는 HTTP 메서드 배열이에요.	예

요청 예제

PUT _plugins/_security/api/allowlist
{
  "enabled": true,
  "requests": {
    "/_cat/nodes": [
      "GET"
    ],
    "/_cat/indices": [
      "GET"
    ],
    "/_plugins/_security/whoami": [
      "GET"
    ]
  }
}

{% include copy-curl.html security=true %}

응답 예제

{
  "status": "OK",
  "message": "'config' updated."
}

더 알아보기 (Learn more)

원문 전체: https://docs.opensearch.org/latest/security/api/allowlist/create-allowlist/