Web et développement

GitHub Actions OIDC : Comment sécuriser vos déploiements sans secrets à long terme

GitHub Actions OIDC: How to Secure Your Deployments Without Long-Lived Secrets

Apprenez à renforcer la sécurité des déploiements GitHub Actions avec OIDC. Remplacez les identifiants cloud à long terme par des jetons à court terme, restreignez l'accès à l'aide de politiques de confiance IAM, et protégez vos pipelines CI/CD.

GitHub Actions OIDC : Comment sécuriser vos déploiements sans secrets à longue durée de vie

Le déploiement d'une application depuis GitHub Actions nécessite généralement un accès à l'infrastructure externe. Un workflow peut envoyer des fichiers à Amazon S3, publier des conteneurs ou mettre à jour des ressources cloud. Traditionnellement, les équipes stockent une clé d'accès cloud dans GitHub Secrets. Cela fonctionne, mais une identité durable reste utile à un attaquant si un workflow, une dépendance ou un journal l'expose.

OpenID Connect (OIDC) aide à renforcer la sécurité CI/CD en remplaçant les identifiants cloud durables par un accès temporaire accordé uniquement aux identités de workflow autorisées. Cela réduit l'exposition des identifiants, limite l'accès non autorisé et prend en charge des déploiements de production plus strictement contrôlés.

Ce tutoriel explique les avantages de sécurité, montre une configuration AWS pratique et identifie les protections nécessaires. OIDC n'est pas un interrupteur de sécurité magique : la politique de confiance, les permissions de rôle et les contrôles de workflow comptent tout autant que l'échange de jetons.

Pourquoi la sécurité des déploiements est importante

Les pipelines CI/CD sont une automatisation privilégiée. Ils peuvent remplacer le code de production, téléverser des actifs, lire des configurations de déploiement ou modifier des infrastructures. Un pipeline compromis peut donc avoir un impact plus large qu'un poste de travail développeur compromis.

Trois risques courants méritent une attention particulière :

  • L'exposition des identifiants : une clé cloud statique volée depuis un environnement de build peut rester valide jusqu'à ce que quelqu'un la révoque.
  • Privilèges excessifs : un identifiant de déploiement avec des permissions d'administrateur peut affecter des services sans rapport.
  • Déploiement non autorisé : une branche ou un workflow non fiable pourrait obtenir un accès en production si les vérifications d'identité sont trop larges.

OIDC aborde une partie de ce problème en liant l'authentification à une identité de workflow courte durée et vérifiable. Cela ne remplace pas le principe du moindre privilège IAM, la revue de code ou les protections d'environnement.

Qu'est-ce que OIDC dans GitHub Actions ?

OpenID Connect est une couche d'identité construite sur OAuth 2.0. GitHub Actions peut demander un JSON Web Token (JWT) signé au fournisseur OIDC de GitHub :

https://token.actions.githubusercontent.com

Le jeton contient des revendications décrivant l'identité et le contexte d'exécution du job. Un service d'identité cloud valide la signature, l'émetteur, le destinataire et les revendications pertinentes, puis décide s'il doit délivrer des identifiants temporaires.

Le service externe doit explicitement faire confiance à l'identité de workflow GitHub prévue. Il suffit simplement d'activer OIDC dans un fichier YAML pour que cela n'ait pas lieu.

Voir la documentation OpenID Connect de GitHub.

Identifiants statiques vs OIDC : comparaison de sécurité

Considération de sécurité Clé d'accès durable Fédération OIDC
Identifiant cloud permanent dans GitHub Généralement requis Non requis pour les fournisseurs pris en charge
Durée de validité de l'identifiant Jusqu'à expiration ou révocation Session temporaire
Responsabilité de la rotation L'équipe doit gérer le cycle de vie de la clé Le fournisseur cloud délivre des identifiants temporaires
Restrictions d'identité D'après le stockage des identifiants et IAM La politique de confiance peut restreindre l'identité du workflow
Autorisation Permissions IAM Les permissions IAM sont toujours requises
Risque résiduel Vol et réutilisation de la clé statique Workflow autorisé compromis ou confiance trop large

OIDC réduit le risque et l'impact du vol d'identifiants ; elle ne supprime pas tous les secrets. Les applications peuvent encore avoir besoin de mots de passe de base de données, de clés de signature ou de jetons d'API tiers.

Comment fonctionne le flux d'authentification OIDC

  1. Un job GitHub Actions autorisé demande un jeton d'identité.
  2. GitHub émet un JWT signé pour ce job.
  3. Le workflow présente le jeton au service d'identité cloud.
  4. Le fournisseur cloud valide le jeton et évalue ses conditions de confiance configurées.
  5. Si l'identité est autorisée, le fournisseur délivre des identifiants temporaires.
  6. Le workflow utilise ces identifiants dans le champ d'action autorisé du rôle.

Le fournisseur cloud doit rejeter un jeton dont le sujet, le destinataire ou d'autres conditions requises ne correspondent pas. Cette validation est la limite entre un déploiement sécurisé et celui qui en fait trop confiance.

Étape 1 : Configurer le fournisseur OIDC de GitHub dans AWS

AWS IAM prend en charge les fournisseurs d'identité OpenID Connect. Créez un fournisseur d'identité en utilisant :

Paramètre Valeur
URL du fournisseur https://token.actions.githubusercontent.com
Destinataire sts.amazonaws.com
Type de fournisseur OpenID Connect

Le destinataire identifie le destinataire prévu du jeton. L'action de credentials AWS utilise normalement sts.amazonaws.com.

Voir configuration de rôle IAM OIDC AWS.

Étape 2 : Restreindre qui peut supposer le rôle de déploiement

Créez un rôle IAM dont la politique de confiance permet sts:AssumeRoleWithWebIdentity uniquement depuis le fournisseur d'identité GitHub et l'identité de workflow prévue.

L'exemple suivant utilise le format de sujet traditionnel basé sur les branches de GitHub :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Federated": "arn:aws:iam::123456789012:oidc-provider/token.actions.githubusercontent.com"
      },
      "Action": "sts:AssumeRoleWithWebIdentity",
      "Condition": {
        "StringEquals": {
          "token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
          "token.actions.githubusercontent.com:sub": "repo:example-org/example-app:ref:refs/heads/main"
        }
      }
    }
  ]
}

Remplacez le numéro de compte AWS, l'organisation et le dépôt.

Ne copiez pas aveuglément la condition de sujet. GitHub a introduit un format de sujet par défaut immuable pour les dépôts créés après le 15 juillet 2026. Vérifiez le format de sujet réel utilisé par votre dépôt et configurez AWS pour qu'il corresponde. Les workflows basés sur les environnements peuvent aussi utiliser une forme de sujet différente. Consultez la référence des jetons OIDC de GitHub.

Une politique de confiance restrictive est l'un des moyens les plus importants de empêcher les workflows non autorisés d'obtenir des identifiants de production. Évitez les sujets génériques qui autorisent accidentellement des dépôts ou contextes non liés.

Étape 3 : Limiter ce que le rôle peut faire

La confiance détermine qui peut supposer un rôle. Les permissions IAM déterminent ce que le rôle peut faire après l'authentification.

Pour un déploiement qui ne téléverse que des fichiers vers un bucket S3 donné, une politique simplifiée est :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::example-deploy-bucket/*"
    }
  ]
}
Illustration of the article's main concept

Cet exemple permet le téléversement d'objets, pas l'administration du compte ou la suppression du bucket. Si votre déploiement supprime également des fichiers obsolètes ou liste le contenu du bucket, accordez uniquement les opérations supplémentaires nécessaires, comme s3:DeleteObject ou s3:ListBucket.

Ne donnez jamais AdministratorAccess simplement pour faire fonctionner un déploiement. Les identifiants temporaires avec des privilèges excessifs peuvent encore causer de graves dommages.

Étape 4 : Demander des identifiants temporaires depuis un workflow

Un job de déploiement doit être autorisé à demander un jeton OIDC. L'exemple suivant téléverse un répertoire dist/ préconstruit vers S3 :

name: Deploy website

on:
  push:
    branches:
      - main

permissions:
  contents: read

jobs:
  deploy:
    runs-on: ubuntu-latest

    permissions:
      contents: read
      id-token: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/github-deploy-role
          aws-region: eu-west-1

      - name: Deploy website
        run: |
          aws s3 cp ./dist/ s3://example-deploy-bucket/ --recursive

L'exemple utilise des références d'action de version majeure pour la lisibilité. En production, examinez les versions actuellement prises en charge et, idéalement, épinglez les actions tierces à des SHAs de commit complets. L'exemple suppose que le site web a déjà été construit dans dist/.

Remarquez ce qui manque : aucune clé d'accès AWS permanente ni secret d'accès n'est stocké dans le workflow.

L'action officielle des credentials AWS échange le jeton OIDC contre des identifiants AWS temporaires.

Étape 5 : Comprendre id-token: write

Cette autorisation :

permissions:
  id-token: write

permet à un job de demander un jeton d'identité GitHub OIDC. Elle ne donne pas, par elle-même, au job la permission d'écrire dans les dépôts GitHub ou d'accéder à AWS.

Le fournisseur cloud décide toujours si l'identité est digne de confiance, et le rôle IAM contrôle toujours les opérations autorisées.

Accordez id-token: write uniquement aux jobs qui authentifient réellement le cloud. Les jobs de build, de lint et de test n'en ont généralement pas besoin.

Étape 6 : Protéger les environnements de production

OIDC ne peut pas compenser un workflow autorisé exécutant du code malveillant. Si un attaquant peut modifier un workflow de déploiement de confiance ou exécuter du code non revu dans ce contexte, il pourrait obtenir des identifiants temporaires.

Les environnements GitHub peuvent ajouter des contrôles tels que les restrictions de branche de déploiement et les revues requises, sous réserve des paramètres du dépôt et de la disponibilité du plan.

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production

    permissions:
      contents: read
      id-token: write

Lorsque le workflow utilise un environnement, le sujet OIDC peut identifier cet environnement plutôt qu'une branche. Mettez à jour la politique de confiance IAM pour correspondre aux revendications réelles et protéger l'environnement lui-même.

Pour la production, combinez les identités restreintes avec la protection des branches, la revue de code, les permissions limitées des workflows et les règles d'approbation des environnements lorsque cela est approprié. C'est ainsi que OIDC devient partie intégrante d'une posture de sécurité de déploiement plus solide plutôt que de simples remplacements d'identifiants.

Étape 7 : Vérifier l'identité supposée et tester les refus

Après avoir configuré l'authentification AWS, ajoutez une étape de diagnostic :

- name: Verify AWS identity
  run: aws sts get-caller-identity

Vérifiez que la réponse identifie le compte AWS et le rôle de déploiement prévus. La commande ne révèle pas la clé d'accès secrète.

Testez également qu'une branche, un dépôt ou un environnement non autorisé ne peut pas supposer le rôle de production. Un déploiement non autorisé échoué est un test de sécurité réussi.

Ne journalisez pas les jetons OIDC bruts ni les identifiants temporaires pendant le débogage.

Erreurs courantes de sécurité et de configuration OIDC

Absence de id-token: write

Le job ne peut pas demander un jeton OIDC s'il n'a pas la permission. Les permissions au niveau du job peuvent remplacer les permissions au niveau du workflow.

Technical workflow illustration

AWS renvoie AccessDenied pour la supposition de rôle

Vérifiez le fournisseur d'identité, le destinataire, l'ARN du rôle et la condition de sujet. En particulier, vérifiez le format de sujet GitHub réel plutôt que de supposer que chaque dépôt utilise le même format par défaut.

L'authentification réussit, mais le téléversement échoue

La relation de confiance peut être correcte tandis que le rôle manque les permissions S3 requises. Corrigez la politique de permissions IAM étroitement définie plutôt que d'élargir la confiance d'identité.

L'accès à la production est autorisé depuis trop de contextes

Un sujet générique ou des restrictions d'environnement insuffisantes peuvent rendre les identifiants de production disponibles pour des workflows qui ne devraient jamais les recevoir. Restreignez la politique de confiance et testez les cas non autorisés.

Une pull request ne peut pas déployer

Les pull requests peuvent avoir des revendications différentes et du code non fiable. Ne restreignez pas les conditions de confiance de production uniquement pour permettre à une pull request de supposer le rôle de déploiement. Exécutez la validation séparément du déploiement de production.

Pouvez-vous utiliser OIDC avec Azure ou Google Cloud ?

Oui. Le mécanisme de fédération est similaire, mais la configuration d'identité diffère.

Cloud Mécanisme de fédération Action GitHub
AWS Fournisseur IAM OIDC et rôle aws-actions/configure-aws-credentials
Microsoft Azure Identifiants fédérés azure/login
Google Cloud Fédération d'identités de charge de travail google-github-actions/auth

Azure associe généralement un identifiant fédéré à une application ou un identifiant géré. Google Cloud utilise un pool et un fournisseur d'identités de charge de travail, avec un accès direct aux ressources ou une impersonation de compte de service selon la configuration.

Chaque plateforme a ses propres règles de destinataire, de correspondance de sujet et d'autorisation. Consultez la documentation officielle actuelle du fournisseur avant de copier un exemple.

Que faire pour les sites web PHP sur un hébergement traditionnel ?

Tous les hébergeurs web ne acceptent pas les identités GitHub OIDC. L'hébergement mutualisé et l'hébergement PHP géré peuvent encore utiliser des clés SSH, des identifiants SFTP, des webhooks de déploiement ou des jetons d'API fournisseurs.

Activer OIDC dans GitHub Actions ne remplace pas automatiquement une clé SSH si le serveur de destination n'a pas de mécanisme de fédération.

Là où OIDC n'est pas disponible, utilisez un compte de déploiement dédié, des permissions étroitement définies, des secrets protégés et une rotation des identifiants. Restreignez l'accès au système de fichiers et aux commandes lorsque cela est possible.

L'objectif de sécurité est le moindre privilège et une exposition limitée des identifiants, que OIDC soit pris en charge ou non.

Liste de contrôle de sécurité de déploiement

Avant de déployer en production, vérifiez que :

  • L'émetteur et le destinataire OIDC sont correctement configurés.
  • La politique de confiance correspond uniquement au dépôt et au contexte de déploiement prévus.
  • La condition de sujet reflète le format réel de jeton GitHub de votre dépôt.
  • Le rôle IAM n'a que les permissions nécessaires au déploiement.
  • Seuls les jobs de déploiement reçoivent id-token: write.
  • Les branches et environnements de production ont une protection appropriée.
  • Les actions tierces sont examinées et, idéalement, épinglées à des SHAs de commit immuables.
  • Les pull requests non fiables ne peuvent pas supposer les rôles de production.
  • Les branches et dépôts non autorisés échouent à l'authentification.
  • Les jetons et les identifiants temporaires ne sont jamais journalisés ou stockés inutilement.

Questions fréquemment posées

L'OIDC est-il plus sécurisé que les clés d'accès AWS statiques ?

Il réduit l'exposition au vol de clés durables. Des politiques de confiance solides, des permissions limitées et des workflows protégés sont toujours essentiels.

OIDC élimine-t-il les GitHub Secrets ?

Il remplace certains identifiants d'authentification cloud, mais pas tous les secrets applicatifs ou clés d'API.

Que fait id-token: write ?

Il permet à un workflow de demander un jeton d'identité. Les permissions cloud sont déterminées séparément par le fournisseur.

Les pull requests non fiables peuvent-elles utiliser des identifiants OIDC de production ?

Elles ne devraient pas. Configurez des conditions de confiance restrictives et gardez les déploiements de production séparés du code non fiable.

OIDC fonctionne-t-il avec tout fournisseur d'hébergement ?

Non. Le service de destination ou un courtier d'identités doit prendre en charge et faire confiance aux jetons OIDC de GitHub.

Conclusion : renforcez la sécurité, pas seulement l'authentification

GitHub Actions OIDC est un moyen efficace d'augmenter la sécurité des déploiements pour les services cloud pris en charge. Il élimine le besoin de garder des clés cloud permanentes dans GitHub, permet un accès temporaire et permet aux politiques de confiance cloud de restreindre les workflows qui peuvent déployer.

Mais la conception la plus forte combine OIDC avec le principe du moindre privilège IAM, les environnements protégés, le code de workflow revu et des tests explicites que les identités non autorisées sont rejetées.

L'objectif n'est pas simplement de remplacer un secret. Il est de s'assurer que seul le bon workflow peut accéder aux bonnes ressources, avec les permissions minimales et pour la durée pratique la plus courte.

Références officielles