O trusted publishing é um mecanismo que autentica a publicação de um pacote pela identidade do fluxo de automação. No npm, ele usa o OIDC (OpenID Connect) para conferir se a execução corresponde a um publicador autorizado nas configurações do pacote.
O provedor de automação emite um token de identidade para a execução. Após verificar essa identidade e a relação de confiança cadastrada, o registro permite a autenticação com credenciais de curta duração. O fluxo dispensa um token npm de longa duração armazenado como segredo para publicar.
A autorização de um arquivo de workflow
Neste exemplo didático, um pacote npm autoriza o workflow publicar.yml do repositório empresa-exemplo/biblioteca no GitHub. A identidade apresentada durante a execução precisa corresponder a essa configuração.
Outro arquivo, como testar.yml, não recebe a mesma autorização apenas por estar no repositório. Você precisa conferir os campos cadastrados no npm e a permissão id-token: write no workflow, que permite solicitar o token de identidade. Essa permissão, isoladamente, não autoriza a publicação no registro.
Requisitos e alcance da autenticação
A documentação do npm exige o npm CLI 11.5.1 ou posterior e o Node.js 22.14.0 ou posterior para esse mecanismo. O ambiente de execução também precisa ser aceito pelo registro. No GitHub Actions, o suporte documentado exige runners hospedados pelo GitHub.
A provenance acrescenta declarações verificáveis sobre a origem e a construção do pacote. Ela tem função diferente da autenticação do publicador e não comprova a qualidade do código. A revisão das alterações e os testes continuam necessários para examinar o que a versão publicada faz.
Dúvidas frequentes
Perguntas frequentes sobre trusted publishing
- O fluxo precisa guardar um token npm de longa duração?
- O trusted publishing usa a identidade emitida para a execução e credenciais de curta duração. Essa autenticação dispensa guardar um token npm permanente para a publicação autorizada.
- Qualquer workflow do mesmo repositório pode publicar?
- O npm confere a identidade contra o publicador configurado para o pacote. No GitHub Actions, a configuração identifica o proprietário, o repositório e o arquivo do workflow. A autorização não se estende automaticamente aos demais arquivos.
- O trusted publishing comprova a qualidade do código publicado?
- Ele autentica o publicador. A provenance registra informações verificáveis sobre a origem e a construção do pacote. Nenhum desses mecanismos substitui a revisão do código ou os testes da versão.
Para continuar
Recursos relacionados
Documentação
npm: trusted publishing
Documenta a configuração dos publicadores autorizados, os requisitos do cliente e os ambientes de execução aceitos.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática de Desenvolvimento Colaborativo para revisar a automação de publicação com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A publicação automatizada exige compreender como o registro autentica o fluxo e quais permissões autorizam uma nova versão.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.