Désactivation ou limitation des GitHub Actions pour votre organisation

À propos des droits GitHub Actions pour votre organisation

Par défaut, GitHub Actions est activé pour tous les référentiels et toutes les organisations. Vous pouvez choisir de désactiver GitHub Actions ou de le limiter aux actions et aux workflows réutilisables dans votre organisation. Pour plus d’informations sur GitHub Actions, consultez Écriture de workflows.

Vous pouvez activer GitHub Actions pour tous les dépôts de votre organisation. Lorsque vous activez GitHub Actions, les flux de travail peuvent exécuter des actions et des flux de travail réutilisables situés dans votre dépôt et dans tout autre dépôt public. Vous pouvez désactiver GitHub Actions pour tous les dépôts de votre organisation. Quand vous désactivez GitHub Actions, aucun workflow ne s’exécute dans votre dépôt.

Vous pouvez également activer GitHub Actions tous les référentiels de votre organisation, mais limiter les actions et les flux de travail réutilisables qu’un flux de travail peut exécuter.

Gestion des GitHub Actions autorisations pour votre organisation

Vous pouvez choisir de désactiver GitHub Actions tous les dépôts de votre organisation ou d’autoriser uniquement des dépôts spécifiques. Vous pouvez également limiter l’utilisation d’actions publiques et de flux de travail réutilisables, afin que les utilisateurs puissent uniquement utiliser des actions locales et des flux de travail réutilisables qui existent dans votre d’entreprise.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Sous « Stratégies », sélectionnez une option.

   Si vous choisissez Autoriser les actions de PROPRIÉTAIRE, les autres actions ne relevant pas d’un PROPRIÉTAIRE sélectionnées et les workflows réutilisables, les actions et les workflows réutilisables au sein de votre organisation sont autorisé(e)s, et il existe d’autres options pour autoriser d’autres actions spécifiques et workflows réutilisables. Pour plus d'informations, voir Autoriser l'exécution d'actions sélectionnées et de flux de travail réutilisables.

   Quand vous autorisez des actions et des workflows réutilisables uniquement dans votre organisation, la stratégie bloque tout accès aux actions créées par GitHub. Par exemple, l’action actions/checkout n’est pas accessible.

   Lorsque vous activez Exiger que les actions soient attachées à un SHA de commit complet, toutes les actions doivent être attachées à un SHA de commit complet pour pouvoir être utilisées. Cela inclut les actions provenant de votre organisation ainsi que les actions créées par GitHub. Les flux de travail réutilisables peuvent toujours être référencés par balise. Pour plus d’informations, consultez Informations de référence sur l’utilisation sécurisée.

6. Cliquez sur Enregistrer.

Autorisation de sélectionner des actions et des flux de travail réutilisables à exécuter

Lorsque vous choisissez Autoriser les actions de PROPRIÉTAIRE, les autres actions ne relevant pas d’un PROPRIÉTAIRE sélectionnées et les workflows réutilisables, les actions locales et les flux de travail réutilisables sont autorisés, et il existe des options supplémentaires pour autoriser d’autres actions spécifiques et flux de travail réutilisables :

• Autoriser les actions créées par GitHub: Vous pouvez autoriser toutes les actions créées par GitHub à être utilisées par les flux de travail. Les actions créées par GitHub se trouvent dans les organisations actions et github. Pour en savoir plus, consultez les organisations actions et github.

• Autoriser les actions de la Place de marché par les créateurs vérifiés : Vous pouvez autoriser toutes les GitHub Marketplace actions créées par les créateurs vérifiés à utiliser par les flux de travail. Lorsque GitHub a vérifié le créateur de l’action en tant qu’organisation partenaire, le badge s’affiche en regard de l’action dans GitHub Marketplace.

• Autoriser ou bloquer les actions spécifiées et les flux de travail réutilisables : vous pouvez restreindre les flux de travail pour utiliser des actions et des flux de travail réutilisables dans des organisations et référentiels spécifiques. Les actions spécifiées ne peuvent pas dépasser 1 000.

  Pour restreindre l’accès à des étiquettes spécifiques ou valider des contrats SHA d’une action ou d’un flux de travail réutilisable, utilisez la même syntaxe que celle utilisée dans le flux de travail pour sélectionner l’action ou le flux de travail réutilisable.

  • Pour une action, la syntaxe est OWNER/REPOSITORY@TAG-OR-SHA. Par exemple, utilisez actions/javascript-action@v1.0.1 pour sélectionner une étiquette ou actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f pour sélectionner un SHA. Pour plus d’informations, consultez « Utilisation de blocs élémentaires pré-écrits dans votre workflow ».
  • Pour un workflow réutilisable, la syntaxe est OWNER/REPOSITORY/PATH/FILENAME@TAG-OR-SHA. Par exemple : octo-org/another-repo/.github/workflows/workflow.yml@v1. Pour plus d’informations, consultez « Réutiliser des workflows ».

  Vous pouvez utiliser le caractère générique *pour faire correspondre les modèles. Par exemple, pour autoriser toutes les actions et flux de travail réutilisables dans les organisations qui commencent par space-org, vous pouvez spécifier space-org*/*. Pour autoriser toutes les actions et flux de travail réutilisables dans les référentiels qui commencent par octocat, vous pouvez utiliser */octocat**@*. Pour en savoir plus sur l’utilisation du caractère générique *, consultez Syntaxe de flux de travail pour GitHub Actions.

  Utilisez , pour séparer les modèles. Par exemple, pour autoriser toutes les actions et les workflows réutilisables des organisations octocat et octokit, vous pouvez spécifier octocat/*, octokit/*.

  Utilisez le ! préfixe pour bloquer les modèles. Par exemple, pour autoriser toutes les actions et flux de travail réutilisables de l’organisation space-org , mais bloquer une action spécifique comme space-org/action, vous pouvez spécifier space-org/*, !space-org/action@*. Par défaut, seules les actions et les flux de travail réutilisables spécifiés dans la liste sont autorisés. Pour autoriser toutes les actions et flux de travail réutilisables tout en bloquant des actions spécifiques, vous pouvez spécifier *, !space-org/action@*.

Cette procédure montre comment ajouter des actions spécifiques et des flux de travail réutilisables à la liste.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Sous « Stratégies », sélectionnez Autoriser les actions de PROPRIÉTAIRE, les autres actions ne relevant pas d’un PROPRIÉTAIRE sélectionnées et les workflows réutilisables et ajoutez vos actions requises et flux de travail réutilisables à la liste.

6. Cliquez sur Enregistrer.

Limitation de l’utilisation d’exécuteurs auto-hébergés

Rien ne garantit que les exécuteurs auto-hébergés pour GitHub seront hébergés sur des machines virtuelles éphémères propres. Par conséquent, ils peuvent être compromis par du code non approuvé dans un workflow.

De même, toute personne pouvant dupliquer le dépôt et ouvrir une demande de tirage (généralement celles qui ont un accès en lecture au dépôt) peut compromettre l’environnement des exécuteurs auto-hébergés, notamment en accédant aux secrets et au GITHUB_TOKEN qui, en fonction de ses paramètres, permet d’octroyer l’accès en écriture au dépôt. Bien que les workflows puissent contrôler l’accès aux secrets d’environnement à l’aide d’environnements et de révisions nécessaires, ces workflows ne sont pas exécutés dans un environnement isolé et encourent toujours les mêmes risques lors de l’exécution sur un exécuteur auto-hébergé.

Pour ces raisons, entre autres, vous pouvez décider d’empêcher les utilisateurs de créer des exécuteurs auto-hébergés au niveau du dépôt.

Si un dépôt a déjà des exécuteurs auto-hébergés lorsque vous désactivez leur utilisation, ceux-ci sont listés avec l’état « Désactivé » et aucun nouveau travail de workflow ne leur est attribué.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Sous « Exécuteurs », utilisez le menu déroulant pour choisir votre paramètre préféré :

   • Tous les référentiels : les exécuteurs auto-hébergés peuvent être utilisés pour n’importe quel dépôt de votre organisation.
   • Référentiels sélectionnés : les exécuteurs auto-hébergés peuvent être seulement utilisés pour les dépôts que vous sélectionnez.
   • Désactivé - Les exécuteurs auto-hébergés ne peuvent pas être créés au niveau du référentiel.

6. Si vous choisissez Dépôts sélectionnés :

   1. Cliquez sur .
   2. Cochez les cases des dépôts pour lesquels vous souhaitez autoriser les exécuteurs auto-hébergés.
   3. Cliquez sur Sélectionner les dépôts.

Désactivation des exécuteurs hébergés standard

Vous pouvez désactiver les exécuteurs standard hébergés sur GitHub au niveau de l’organisation. Ce paramètre nécessite des flux de travail pour cibler des exécuteurs par le biais de groupes d’exécuteurs et permet d’appliquer des contrôles d’accès et une gouvernance cohérents.

Pour plus d’informations sur les limites de concurrence des travaux pour les GitHubles exécuteurs hébergés, consultez Limites d’Actions.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Faites défiler jusqu’à la section « Exécuteurs hébergés standard », puis cliquez sur Désactiver pour tous les référentiels.

6. Cliquez sur Enregistrer.

Configurer l’approbation requise pour les workflows provenant de forks publics

Tout le monde peut créer un fork d’un dépôt public, puis soumettre une pull request proposant des modifications aux workflows du dépôt GitHub Actions. Bien que les workflows issus de duplications n’aient pas accès aux données sensibles comme les secrets, ils peuvent embêter les chargés de maintenance s’ils sont modifiés à des fins abusives.

Pour éviter cela, les workflows sur les pull requests vers des dépôts publics provenant de certains contributeurs externes ne s’exécutent pas automatiquement et peuvent d’abord nécessiter une approbation. Selon le paramètre « Approbation de l’exécution des workflows de pull requests de fork par les contributeurs », les workflows pour les pull requests vers des dépôts publics ne s’exécutent pas automatiquement et peuvent nécessiter une approbation si :

• La pull request est créée par un utilisateur nécessitant des approbations conformément à la stratégie sélectionnée.
• L’événement de pull request est déclenché par un utilisateur et nécessite des approbations conformément à la stratégie sélectionnée.

Par défaut, tout nouveau contributeur nécessite une approbation pour exécuter des workflows.

Les flux de travail déclenchés par des événements pull_request_target sont exécutés dans le contexte de la branche de base. Étant donné que la branche de base est considérée comme approuvée, les workflows déclenchés par ces événements s’exécutent toujours, quels que soient les paramètres d’approbation. Pour plus d’informations sur l’événement pull_request_target, consultez Événements qui déclenchent des flux de travail.

Vous pouvez configurer ce comportement pour une organisation en suivant la procédure ci-dessous. La modification de ce paramètre remplace la configuration définie au niveau de l’entreprise.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Sous Approbation pour l’exécution des workflows de pull requests provenant de forks créées par des contributeurs, choisissez quels utilisateurs devront obtenir une approbation avant l’exécution des workflows sur leurs pull requests. L'auteur de la demande de retrait et l'acteur de l'événement de demande de retrait qui déclenche le flux de travail seront vérifiés pour déterminer si une approbation est nécessaire. Si une approbation est requise, un utilisateur ayant un accès en écriture au référentiel doit approuver l'exécution du flux de travail de la demande de retrait. Consultez Approbation d’exécutions de workflow à partir de duplications.

   Avertissement

   Lorsque les approbations ne sont requises que pour les nouveaux contributeurs (les deux premiers paramètres), un utilisateur ayant déjà eu au moins un commit ou une pull request fusionné dans le dépôt n’aura pas besoin d’être approuvé. Un utilisateur malveillant pourrait remplir cette condition en faisant accepter par un mainteneur une simple faute de frappe ou une autre modification anodine, soit dans le cadre d’une pull request dont il est l’auteur, soit dans le cadre de la pull request d’un autre utilisateur.

   • Exiger une approbation pour les nouveaux contributeurs sur GitHub. Seuls les utilisateurs qui sont à la fois nouveaux sur GitHub et qui n’ont jamais eu de commit ni de pull request fusionné dans ce dépôt devront être approuvés pour pouvoir exécuter des workflows.
   • Exiger une approbation pour les nouveaux contributeurs. Seuls les utilisateurs qui n'ont jamais eu de commit ni de pull request fusionné sur ce dépôt devront être approuvés pour pouvoir exécuter des workflows.
   • Exiger l’approbation de tous les contributeurs externes Tous les utilisateurs qui ne sont pas membres ou propriétaires de ce référentiel et non d’un membre de l’organisation nécessitent une approbation pour exécuter des flux de travail.

6. Cliquez sur Enregistrer pour appliquer les paramètres.

Pour plus d’informations sur l’approbation d’exécutions de workflow auxquelles cette stratégie s’applique, consultez Approbation d’exécutions de workflow à partir de duplications.

Activation des workflows pour les forks de référentiels privés

Si vous vous appuyez sur l’utilisation de duplications de vos référentiels privés, vous pouvez configurer des stratégies qui contrôlent la façon dont des utilisateurs peuvent exécuter des workflow sur des événements pull_request. En ce qui concerne les paramètres de stratégie disponibles uniquement pour les dépôts privés, vous pouvez les configurer pour des organisations ou des dépôts.

Si une stratégie est désactivée pour une organisation, elle ne peut pas être activée pour les référentiels. Si une organisation active une stratégie, celle-ci peut être désactivée pour des référentiels individuels.

• Exécuter des workflows à partir de demandes de tirage de duplication : permet aux utilisateurs d’exécuter des workflows à partir de demandes de tirage de duplication, avec une autorisation GITHUB_TOKEN en lecture seule et sans accès aux secrets.
• Envoyer des jetons d’écriture aux workflows à partir de demandes de tirage : permet aux demandes de tirage provenant de duplications d’utiliser un GITHUB_TOKEN avec autorisation d’accès en écriture.
• Envoyer des secrets aux workflows à partir de demandes de tirage : rend tous les secrets disponibles pour la demande de tirage.
• Exiger l’approbation des workflows de demande de tirage (pull request) - Les exécutions de workflow sur des demandes de tirage provenant de collaborateurs sans autorisation d'écriture devront être approuvées par une personne disposant d'une autorisation d'écriture avant d'être exécutées.

Configuration de la stratégie de duplication privée d’une organisation

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

5. Sous Dupliquer les workflows de demande de tirage, sélectionnez vos options.

6. Cliquez sur Enregistrer pour appliquer les paramètres.

Définition des autorisations GITHUB_TOKEN de votre organisation

Vous pouvez définir les autorisations par défaut accordées au GITHUB_TOKEN. Pour plus d’informations sur GITHUB_TOKEN, consultez Utiliser GITHUB_TOKEN pour l’authentification dans les flux de travail. Vous pouvez choisir un ensemble restreint d’autorisations par défaut, ou appliquer des paramètres permissifs.

Vous pouvez définir les autorisations GITHUB_TOKEN par défaut dans les paramètres de votre organisation ou de vos référentiels. Si vous sélectionnez une option restrictive comme option par défaut dans les paramètres de votre organisation, la même option est sélectionnée dans les paramètres des référentiels de votre organisation, et l’option permissive est désactivée. Si votre organisation appartient à un GitHub Enterprise compte et qu’une valeur par défaut plus restrictive a été sélectionnée dans les paramètres d’entreprise, vous ne pourrez pas sélectionner la valeur par défaut plus permissive dans les paramètres de votre organisation.

Toute personne disposant d’un accès en écriture à un dépôt peut modifier les autorisations accordées au GITHUB_TOKEN en ajoutant ou supprimant l’accès selon le besoin, en modifiant la clé permissions dans le fichier de workflow. Pour plus d’informations, consultez permissions.

Configuration des autorisations GITHUB_TOKEN par défaut

Par défaut, lorsque vous créez une organisation, GITHUB_TOKEN n’a qu’un accès en lecture pour les portées contents et packages.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

   

2. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

3. Sélectionnez une organisation en cliquant dessus.

4. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

5. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

6. Sous « Autorisations du flux de travail », choisissez si vous souhaitez que le GITHUB_TOKEN ait un accès en lecture et en écriture pour toutes les autorisations (paramètre permissif), ou seulement un accès en lecture pour les autorisations contents et packages (paramètre restreint).

7. Cliquez sur Enregistrer pour appliquer les paramètres.

Empêcher GitHub Actions de créer ou d’approuver des pull requests

Vous pouvez choisir d’autoriser ou d’empêcher les flux de travail GitHub Actions de créer ou d’approuver des demandes de tirage.

Par défaut, lorsque vous créez une nouvelle organisation, les flux de travail ne sont pas autorisés à créer ou à approuver des pull requests.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

   

2. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

3. Sélectionnez une organisation en cliquant dessus.

4. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

5. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

6. Sous « Autorisations de flux de travail », utilisez le paramètre Allow GitHub Actions pour créer et approuver des demandes de tirage (pull requests) pour configurer si GITHUB_TOKEN peut créer et approuver des demandes de tirage.

7. Cliquez sur Enregistrer pour appliquer les paramètres.

Gestion du GitHub Actions stockage du cache pour votre organisation

Les administrateurs d’organisation peuvent afficher GitHub Actions le stockage du cache pour tous les référentiels de l’organisation.

Affichage du GitHub Actions stockage en cache par dépôt

Pour chaque dépôt de votre organisation, vous pouvez voir la quantité de stockage en cache utilisée par un dépôt, le nombre de caches actifs et si un dépôt est proche de la limite de taille totale du cache. Pour plus d’informations sur l’utilisation et le processus d’éviction du cache, consultez Référence sur la mise en cache des dépendances.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

   

2. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

3. Sélectionnez une organisation en cliquant dessus.

4. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

5. Dans la barre latérale gauche, cliquez sur Actions, puis sur Caches.

6. Consultez la liste des référentiels pour obtenir des informations sur leurs GitHub Actions caches. Vous pouvez cliquer sur le nom d’un dépôt pour voir plus de détails sur les caches du dépôt.

Configuration des paramètres de GitHub Actions cache pour votre organisation

Vous pouvez configurer les paramètres de rétention et de taille du cache qui s’appliquent à tous les référentiels de votre organisation. Cette fonctionnalité est opt-in et disponible pour les utilisateurs disposant d’un mode de paiement enregistré.

Si votre organisation appartient à une entreprise qui a configuré les paramètres de cache, vous pouvez uniquement configurer des limites jusqu’au maximum défini par l’entreprise. Si votre organisation n’appartient pas à une entreprise (ou si l’entreprise n’a pas configuré de paramètres de cache), vous pouvez configurer jusqu’aux maximums globaux.

Les administrateurs de référentiels peuvent choisir de configurer des limites pour leurs référentiels, mais ne peuvent pas dépasser les limites définies au niveau de l’organisation.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

   

2. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

3. Sélectionnez une organisation en cliquant dessus.

4. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

5. Dans la barre latérale gauche, cliquez sur Actions, puis sur Général.

6. Dans la section « Cache », configurez et enregistrez vos modifications dans les paramètres suivants :

   • Rétention du cache : nombre maximal de jours pour conserver les caches avant la suppression automatique. La valeur par défaut est de 7 jours. Vous pouvez configurer jusqu’à 365 jours (ou jusqu’à la limite définie par votre entreprise). Cliquez sur Enregistrer pour appliquer les modifications que vous apportez.
   • Limite d’éviction de la taille du cache : taille totale maximale de tous les caches d’un référentiel. La valeur par défaut est de 10 Go. Vous pouvez configurer jusqu’à 10 000 Go par dépôt (ou jusqu’à la limite définie par votre entreprise). Lorsque cette limite est dépassée, les caches plus anciens sont supprimés pour faire place aux nouveaux caches. Cliquez sur Enregistrer pour appliquer les modifications que vous apportez.

Pour plus d’informations sur l’éviction du cache, consultez Référence sur la mise en cache des dépendances.