Neste artigo
- Bloco 1: OIDC, o token que nasce e morre no mesmo job
- Bloco 2: permissões mínimas por job
- Bloco 3: agendamento estável com concorrência controlada
- O checklist de migração
- OIDC funciona com qualquer provedor de cloud?
- Preciso de OIDC se o meu workflow não acessa nenhuma cloud?
- Por que o meu cron do GitHub Actions atrasa?
- Como limito o que o token interno do workflow pode fazer?
Se você mantém GitHub Actions rodando contra produção, as discussões técnicas que atravessam o r/github no período convergem para um consenso que não admite muito debate: credencial de longa duração armazenada no repositório é o anti-padrão a aposentar. A pergunta de um dos relatos técnicos do sub, sobre os riscos de um workflow acessar o gerenciador de segredos da AWS durante o build, resume o clima: até quem já usa os mecanismos modernos trata o tema com a desconfiança de quem sabe que o segredo, uma vez exposto, não volta para dentro da garrafa.
A urgência veio de um episódio paralelo: a campanha de phishing relatada no sub em que contas em massa usavam a própria infraestrutura da plataforma para disparar e-mails golpistas. Se o canal oficial da plataforma pode ser mobilizado por um atacante, imagine o que um segredo de produção parado num repositório significa para quem encontrar a chave. Esta tutoria organiza o padrão moderno em três blocos: OIDC para acessar a cloud sem credencial armazenada, permissões mínimas por job e agendamento estável com concorrência controlada.
Bloco 1: OIDC, o token que nasce e morre no mesmo job
O problema do segredo tradicional é o ciclo de vida. Você cria uma chave de acesso na cloud, cola no painel de segredos do repositório, referencia no workflow e esquece. A chave vive anos, rotação vira evento e vazamento vira incidente. O padrão de credenciais de workload, que a tutoria da casa sobre credenciais de workload na AWS e automação de segredos detalha, inverte a lógica: em vez de a cloud confiar numa chave que você guarda, a cloud confia no provedor de identidade da plataforma de CI.
Com OIDC ativado, cada execução do workflow recebe um token efêmero assinado pela plataforma, válido por minutos, e a cloud troca esse token por uma sessão temporária com as permissões do papel configurado. Não existe segredo para vazar, porque não existe segredo. O resultado na prática:
| Aspecto | Segredo de longa duração | OIDC com papel assumido |
|---|---|---|
| O que fica armazenado | Chave permanente no painel de segredos | Nada: token gerado a cada execução |
| Vida útil da credencial | Anos, até rotação manual | Minutos, limitada ao job |
| Alcance em caso de vazamento | Tudo que a chave permite, até ser revogada | Janela de minutos, com escopo do papel |
| Rotação | Evento manual, costuma esquecer | Desnecessária: cada job nasce com credencial nova |
| Auditoria na cloud | Uso atribuído à chave, não ao workflow | Cada execução identificável pelo papel e pelo contexto |
O YAML abaixo mostra o desenho completo para uma AWS, com comentários em português. O papel na cloud precisa estar previamente configurado para confiar no provedor OIDC da plataforma, o que é feito uma única vez, do lado da conta de cloud:
name: Deploy producao
on:
push:
branches: [main]
# Teto global de permissoes: nenhum job nasce com mais que isso
permissions:
contents: read
jobs:
deploy:
runs-on: ubuntu-latest
# Permissoes finas deste job: so o necessario para o OIDC
permissions:
id-token: write # permite ao job pedir o token OIDC
contents: read
steps:
- name: Baixa o codigo
uses: actions/checkout@v4
- name: Assume o papel na cloud sem segredo armazenado
uses: aws-actions/configure-aws-credentials@v4
with:
# Papel previamente configurado para confiar no provedor OIDC
role-to-assume: arn:aws:iam::123456789012:role/deploy-producao
aws-region: sa-east-1
- name: Publica
run: ./deploy.sh
⚠️ Atenção: OIDC elimina o segredo armazenado, não elimina a superfície do job. O papel assumido deve ter permissão apenas para a ação que o deploy executa, e o gatilho do workflow deve estar restrito aos ramos que você controla. Papel genérico demais reproduz o mesmo risco com outro nome.
Bloco 2: permissões mínimas por job
O segundo bloco é o mais barato de todos e o menos adotado: declarar explicitamente o que cada job pode fazer. Por padrão, o token interno de execução nasce com um conjunto generoso de permissões, herdadas da configuração do repositório. Em repositórios antigos, essa herança costuma ser ampla demais, e é exatamente o tipo de permissão esquecida que um workflow comprometido agradece.
O padrão de higiene tem duas camadas. No topo do arquivo, declare o teto, a permissão mínima que nenhum job pode ultrapassar. Dentro de cada job que precisa de algo a mais, declare só o acréscimo necessário. O desenho abaixo combina com o exemplo do bloco anterior:
# Teto global: leitura de codigo, nada mais
permissions:
contents: read
jobs:
testes:
runs-on: ubuntu-latest
# Nem precisa declarar: herda o teto global
steps:
- uses: actions/checkout@v4
- run: ./roda-testes.sh
deploy:
runs-on: ubuntu-latest
# Acréscimo justificado: so este job fala com a cloud
permissions:
id-token: write
contents: read
steps:
- uses: actions/checkout@v4
- run: ./deploy.sh
A regra mental é a mesma da revisão de tokens pessoais do guia de higiene da conta: escopo mínimo, prazo mínimo, e todo acréscimo precisa de justificativa legível no próprio arquivo. Equipes que adotam a prática relatam o mesmo efeito colateral positivo: o YAML vira documentação de segurança, porque qualquer pessoa lê em segundos o que cada job tem direito de fazer.
Para quem roda pipelines em mais de uma plataforma, o GitLab tem caminhado na mesma direção de segurança nativa de fluxos, com recursos de IA e de proteção de merge requests descritos no resumo do GitLab 19.0 com IA agêntica e segurança em merge requests. O nome das ferramentas muda, o princípio não: identidade efêmera e privilégio mínimo.
Bloco 3: agendamento estável com concorrência controlada
O terceiro bloco trata do cron, o agendamento de workflows recorrentes, e começa com um relato que qualquer pessoa que mantém rotina agendada reconhece. Um autor descreve no sub um workflow diário de produção cujo início real foi se atrasando ao longo dos dias: o horário programado ficava longe da hora cheia, mas a execução atrasava horas, e no pior dia registrado no relato o evento agendado para o início da madrugada só apareceu depois das cinco da manhã, enquanto um agendamento externo configurado como reserva rodou no horário esperado. A explicação da plataforma para o comportamento, o agrupamento de execuções em janelas de carga alta, está documentada, e o relato segue como observação prática, não como defeito confirmado.
Do relato saem três práticas de estabilidade. A primeira é o desenho do cron: agende longe da hora cheia, quando a fila da plataforma é mais concorrida, e trate o horário declarado como aproximação, não como compromisso de segunda por segundo. A segunda é a concorrência: o bloco que garante que uma nova execução não empilhe sobre a anterior. A terceira é a saída de emergência que o próprio relato usou, um agendamento externo como reserva para as rotinas que realmente não podem atrasar, com alerta quando o caminho principal falha.
on:
schedule:
# 10h07 no fuso da plataforma, longe da hora cheia
- cron: "7 10 * * 1-5"
workflow_dispatch: # permite rodar a mao quando precisar
# Uma execucao por vez: a nova espera a anterior terminar
concurrency:
group: rotina-diaria
cancel-in-progress: false
💡 Dica: para rotinas em que a execução atrasada é pior que a perdida, como limpezas e sincronizações, o valor de cancel-in-progress em true cancela a execução anterior quando a nova chega. Para rotinas em que nenhuma passada pode faltar, mantenha false e deixe a nova esperar.
O terceiro pilar do agendamento estável é a imutabilidade das ferramentas do pipeline. Actions referenciadas por tag podem mudar de conteúdo sob os seus pés, e a prática recomendada por quem pensa cadeia de suprimentos é fixar a referência na versão ou no identificador de commit exato que você auditou. A discussão sobre ferramentas de segurança de cadeia de suprimentos relatada no sub mostra que o mercado inteiro está tratando esse ponto como essencial, e o guia de segurança de IA em produção da casa cobre a outra ponta do mesmo princípio: tudo que entra no seu pipeline sem controle é superfície de ataque.
O checklist de migração
Para transformar os três blocos em plano de adoção, a sequência que minimiza risco é esta:
- Inventarie os segredos: liste cada workflow que referencia credencial de longa duração e o que ela permite na cloud.
- Comece pelo ambiente de teste: configure o provedor OIDC e o papel confiança em sandbox, como fez o relato técnico do sub, antes de tocar produção.
- Migra um workflow por vez: assuma o papel, remova o segredo do painel, valide o deploy completo e só então siga para o próximo.
- Declare o teto de permissões: adicione o bloco global de permissões e ajuste por job o que precisar de acréscimo.
- Revise os crons: afaste-os da hora cheia, adicione o bloco de concorrência e decida, rotina por rotina, se precisa de reserva externa.
- Fixe as versões das actions: referência exata por versão auditada ou identificador de commit, nunca tag solta.
A sequência inteira cabe em uma semana de trabalho para repositórios pequenos, e o retorno é assimétrico: você troca um passivo permanente por uma superfície que existe apenas durante a execução. O guia completo de Git para desenvolvedores cobre os fundamentos de versionamento que tornam cada etapa dessa migração previsível, do histórico de alterações no YAML até o rollback consciente.
Se os seus workflows ainda dependem de um segredo que ninguém sabe há quanto tempo está lá, o consenso técnico do período é claro e o caminho está mapeado: OIDC para a credencial que nasce e morre no job, permissões mínimas declaradas no arquivo e cron que respeita a realidade da plataforma. O repositório deixa de carregar chaves e volta a carregar apenas o que deve, código.
Perguntas frequentes
OIDC funciona com qualquer provedor de cloud?
As principais clouds e a plataforma de CI suportam o mecanismo de confiança entre o provedor de identidade do CI e os papéis da cloud, incluindo AWS, Azure e Google Cloud. O que muda é a configuração do lado da cloud, onde você declara qual provedor e qual contexto o papel aceita. Confira sempre a documentação vigente do seu provedor, porque os detalhes de configuração mudam.
Preciso de OIDC se o meu workflow não acessa nenhuma cloud?
Para workflows que só rodam testes e não tocam recursos externos, o ganho principal está no bloco de permissões mínimas, não no OIDC. Reduzir o token interno ao mínimo declarado já elimina a superfície mais comum, e o OIDC entra no dia em que o pipeline começa a falar com algum serviço externo.
Por que o meu cron do GitHub Actions atrasa?
O agendamento é uma sugestão de janela, não um compromisso de pontualidade: em períodos de carga alta, execuções agendadas entram em fila e podem atrasar, com relatos da comunidade registrando diferença de horas. Agende fora da hora cheia, controle a concorrência e mantenha reserva externa para as rotinas que não podem atrasar.
Como limito o que o token interno do workflow pode fazer?
Declare o bloco de permissões no topo do arquivo como teto global e reabra apenas o que cada job justificar. O mínimo comum é contents: read; permissões de escrita, publicação de pacotes e tokens de identidade devem aparecer só no job que as usa, nunca como herança silenciosa.