security_exception: security_exception: unable to authenticate / action [...] is unauthorized for user [...] (HTTP 401/403)

O que significa?

A autenticação (401 Unauthorized) ou a autorização (403 Forbidden) falhou. 401 indica credenciais ausentes/incorretas; 403 indica que o usuário está autenticado, mas não tem a role/o privilégio necessário para esta ação/este índice.

Por que acontece?

Nome de usuário/senha ou API key errados, header Authorization ausente, token expirado/inválido, o usuário sem o privilégio de índice ou de cluster correspondente, ou atribuição de role ausente/incorreta.

Como resolver

Para 401: envie as credenciais/API key corretas e verifique o header Authorization. Para 403: inspecione as roles e os privilégios do usuário (GET _security/user/app_user, GET _security/role/app_role) e adicione os privilégios de índice/cluster necessários. Siga o princípio do menor privilégio. Se você usa uma API key, verifique sua expiração e permissões.