Generate User Token API

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

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

지정된 사용자에 대한 인증 토큰을 생성해요.

토큰은 서비스 계정, 즉 service와 enabled 속성이 true로 설정된 상태로 생성된 내부 사용자에 대해서만 발급할 수 있어요. 그 외 다른 사용자에 대한 요청은 실패해요. 자세한 내용은 서비스 계정을 참고하세요.

POST /_plugins/_security/api/internalusers/{username}/authtoken

다음 표에서 사용 가능한 경로 파라미터를 확인할 수 있어요.

파라미터	필수 여부	데이터 타입	설명
`username`	필수	String	인증 토큰을 발급할 사용자의 이름이에요.

다음 요청은 svc-account 서비스 계정에 대한 토큰을 생성해요:

POST _plugins/_security/api/internalusers/svc-account/authtoken

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

생성된 토큰은 message 필드에 반환돼요:

{
  "status": "OK",
  "message": "'svc-account' authtoken generated Basic auth token with user=svc-account, password=4Yz0kQJsliaQ35"
}

응답 본문은 다음 필드를 가진 JSON 객체예요.

필드	데이터 타입	설명
`status`	String	요청의 상태예요. `OK`는 OpenSearch가 토큰을 생성했음을 나타내요.
`message`	String	생성된 자격 증명이에요. `'<username>' authtoken generated Basic auth token with user=<username>, password=<password>` 형식으로 표현돼요.