Digite para filtrar os verbetes do Glossário.

    Git e qualidade · Vibe Coding: Do Zero ao MVP

    O que é trusted publishing?

    O trusted publishing autentica a publicação pela identidade da automação. No npm, usa o OpenID Connect e o publicador autorizado na configuração do pacote.

    Também chamado de: publicação confiável, trusted publisher

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano