Skip to main content

Cette version de GitHub Enterprise Server ne sera plus disponible le 2024-06-29. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Configuration du contrôle d’accès et de la visibilité d’un package

Choisissez qui a un accès en lecture, en écriture ou d’administrateur à votre package ainsi que la visibilité de vos packages sur GitHub.

Remarque : Container registry est actuellement en version bêta pour GitHub Enterprise Server et susceptible d’être modifié.

GitHub Packages et l’isolation de sous-domaine doivent être activés pour utiliser Container registry. Pour plus d’informations, consultez « Utilisation du registre de conteneurs ».

Un package peut hériter des autorisations de visibilité et d’accès d’un dépôt, ou, pour les registres qui prennent en charge les autorisations granulaires, vous pouvez définir la visibilité et les autorisations du package à part du dépôt.

Pour obtenir la liste des registres qui prennent en charge les autorisations granulaires et pour plus d’informations sur les autorisations des packages, les étendues liées aux packages pour les jetons PAT ou la gestion des autorisations pour vos workflows GitHub Actions, consultez « À propos des autorisations pour les packages GitHub ».

À propos de l’héritage des autorisations d’accès

Dans les registres qui prennent en charge les autorisations granulaires, les packages sont délimités à un compte personnel ou à une organisation. Dans ces registres, vous pouvez publier un package sans le lier à un dépôt, puis déterminer qui peut accéder au package en définissant les autorisations d’accès et la visibilité dans les paramètres du package.

Vous pouvez définir qu’un package doit hériter des autorisations d’accès d’un référentiel lié. Pour plus d’informations, consultez « Choix qu’un package hérite des autorisations d’un dépôt ou non » ci-dessous.

Si vous publiez un package dans un registre qui prend uniquement en charge les autorisations délimitées au dépôt, le package est toujours lié à un dépôt et hérite toujours des autorisations du dépôt lié.

À propos de la définition de la visibilité et des autorisations d’accès pour les packages

Si un package appartient à un registre qui prend en charge les autorisations granulaires, toute personne disposant d’autorisations d’administrateur sur le package peut définir le package sur privé ou public, et peut accorder des autorisations d’accès pour le package qui sont distinctes des autorisations définies au niveau de l’organisation et du dépôt. Pour obtenir la liste des registres prenant en charge les autorisations granulaires, consultez « À propos des autorisations pour les packages GitHub ».

Dans la plupart des registres, pour extraire un package, vous devez vous authentifier avec un personal access token ou GITHUB_TOKEN, que le package soit public ou privé. Toutefois, dans Container registry, les packages publics autorisent l’accès anonyme et peuvent être extraits sans authentification ni connexion via l’interface CLI.

Quand vous publiez un package, vous bénéficiez automatiquement d’autorisations d’administrateur sur le package. Si vous publiez un package dans une organisation, toute personne ayant le rôle owner dans l’organisation obtient également des autorisations d’administrateur sur le package.

Pour les packages délimités à un compte personnel, vous pouvez attribuer un rôle d’accès à n’importe quelle personne. Pour les packages délimités à une organisation, vous pouvez attribuer un rôle d’accès à toute personne ou équipe de l’organisation.

Si vous utilisez un workflow GitHub Actions pour gérer vos packages, vous pouvez accorder un rôle d’accès au dépôt dans lequel le workflow est stocké dans via l’option de menu Accès à Actions. Pour plus d’informations, consultez « Configuration du contrôle d’accès et de la visibilité d’un package ».

AutorisationDescription de l’accès
LirePeut télécharger le package.
Peut lire les métadonnées du package.
WritePeut charger et télécharger ce package.
Peut lire et écrire des métadonnées de package.
AdministrateurPeut charger, télécharger, supprimer et gérer ce package.
Peut lire et écrire des métadonnées de package.
Peut accorder des autorisations sur le package.

Remarque : la capacité des workflows GitHub Actions de supprimer et de restaurer des packages à l’aide de l’API REST est actuellement en version bêta publique et susceptible d’être modifiée.

Configuration de l’accès aux packages pour votre compte personnel

Si vous disposez d’autorisations d’administrateur sur un package délimité à un compte personnel, vous pouvez attribuer des rôles de lecture, d’écriture ou d’administrateur à d’autres utilisateurs. Pour plus d’informations sur ces rôles d’autorisation, consultez « À propos de l’héritage des autorisations d’accès ».

Si votre package est privé ou interne et est délimité à une organisation, vous pouvez uniquement accorder l’accès à d’autres membres ou équipes de l’organisation.

  1. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  2. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  3. Sous « Gérer l’accès » ou « Accès hérité », cliquez sur Inviter des équipes ou des personnes et entrez le nom, le nom d’utilisateur ou l’e-mail de la personne à laquelle vous souhaitez accorder l’accès. Il n’est pas possible d’accorder aux équipes l’accès à un package délimité à un compte personnel.

  4. En regard du nom d’utilisateur ou de l’équipe, utilisez le menu déroulant Rôle pour sélectionner un niveau d’autorisation souhaité.

L’accès est automatiquement accordé aux utilisateurs sélectionnés qui n’ont pas besoin d’accepter d’abord une invitation.

Configuration de l’accès aux packages pour une organisation

Si vous disposez d’autorisations d’administrateur sur un package délimité à une organisation, vous pouvez attribuer des rôles de lecture, d’écriture ou d’administrateur à d’autres utilisateurs et équipes. Pour plus d’informations sur ces rôles d’autorisation, consultez « À propos de l’héritage des autorisations d’accès ».

Si votre package est privé ou interne et est délimité à une organisation, vous pouvez uniquement accorder l’accès à d’autres membres ou équipes de l’organisation.

  1. Sur GitHub, accédez à la page principale de votre organisation.

  2. Sous le nom de votre organisation, cliquez sur l’onglet Packages.

    Capture d’écran de la page de profil de @octo-org. L’onglet « Packages » est mis en évidence avec un encadré orange.

  3. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  4. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  5. Sous « Gérer l’accès » ou « Accès hérité », cliquez sur Inviter des équipes ou des personnes et entrez le nom, le nom d’utilisateur ou l’e-mail de la personne à laquelle vous souhaitez accorder l’accès. Vous pouvez également entrer un nom d’équipe de l’organisation pour donner l’accès à tous les membres d’équipe.

  6. En regard du nom d’utilisateur ou de l’équipe, utilisez le menu déroulant Rôle pour sélectionner un niveau d’autorisation souhaité.

L’accès est automatiquement accordé aux équipes ou utilisateurs sélectionnés qui n’ont pas besoin d’accepter d’abord une invitation.

Choix qu’un package hérite des autorisations d’un dépôt ou non

Si vous liez un package à un référentiel, vous pouvez choisir si le package hérite ou non des autorisations d’accès du référentiel lié. Nous vous recommandons de laisser les packages hériter des autorisations d’un dépôt, car cela simplifie le processus de gestion de l’accès à un package.

Lorsqu’un package hérite des autorisations d’un dépôt, pour accorder ou supprimer l’accès à votre package, vous devez configurer les autorisations du dépôt lié.

Remarque : Si vous changez la façon dont un package obtient ses autorisations d’accès, toutes les autorisations existantes pour le package sont remplacées.

Sélection du paramètre d’héritage pour les packages délimités à votre compte personnel

  1. Sur GitHub, accédez à la page principale de votre compte personnel.

  2. En haut à droite de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Votre profil » est délimité en orange foncé.

  3. Dans la page de votre profil, dans l’en-tête, cliquez sur l’onglet Packages.

  4. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  5. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  6. Pour choisir si un package hérite ou non des autorisations d’accès du dépôt lié, sous « Gérer l’accès » ou « Accès hérité », sélectionnez ou désélectionnez Hériter de l’accès d’un dépôt (recommandé) .

    Remarque : Le nom de cette section change selon que le package hérite déjà de ses autorisations d’un dépôt.

Sélection du paramètre d’héritage pour les packages délimités à une organisation

  1. Sur GitHub, accédez à la page principale de votre organisation.

  2. Sous le nom de votre organisation, cliquez sur l’onglet Packages.

    Capture d’écran de la page de profil de @octo-org. L’onglet « Packages » est mis en évidence avec un encadré orange.

  3. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  4. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  5. Pour choisir si un package hérite ou non des autorisations d’accès du dépôt lié, sous « Gérer l’accès » ou « Accès hérité », sélectionnez ou désélectionnez Hériter de l’accès d’un dépôt (recommandé) .

    Remarque : Le nom de cette section change selon que le package hérite déjà de ses autorisations d’un dépôt.

Garantie de l’accès du workflow à votre package

Pour garantir l’accès d’un workflow GitHub Actions à un package délimité à un compte personnel ou à une organisation, vous devez donner un accès explicite au dépôt dans lequel le workflow est stocké.

Le dépôt spécifié n’a pas besoin d’être le dépôt où le code source du package est conservé. Vous pouvez accorder à un workflow dans plusieurs dépôts l’accès à un package.

Remarques :

  • La synchronisation de votre package avec un dépôt via l’option de menu Accès à Actions et la connexion de votre package à un dépôt sont deux choses différentes. Pour plus d’informations sur la liaison d’un dépôt à votre package, consultez « Connexion d’un dépôt à un package ».
  • Vous pouvez choisir de limiter les autorisations aux tâches de workflow en utilisant la clé permissions et l'étendue packages. Pour plus d’informations, consultez « Affectation d’autorisations à des travaux ».
  • Si vous accordez un dépôt public l’accès aux packages privés, les duplications du référentiel peuvent être en mesure d’accéder aux packages privés.

Configurer l’accès de GitHub Actions pour les packages délimités à des comptes personnels

  1. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  2. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  3. Dans la barre latérale de gauche, cliquez sur Accès à Actions.

  4. Pour garantir l’accès de votre workflow à votre package, vous devez ajouter le dépôt où le workflow est stocké. Cliquez sur Ajouter un dépôt et recherchez le dépôt que vous souhaitez ajouter.

    Capture d’écran de la section « Gérer l’accès à Actions » dans la page des paramètres du package. Le bouton « Ajouter un dépôt » est mis en évidence avec un encadré orange.

  5. Utiliser le menu déroulant Rôle pour sélectionner le niveau d’accès par défaut dont vous aimeriez que votre dépôt dispose sur votre package.

Pour personnaliser davantage l’accès à votre package, consultez « Configuration de l’accès aux packages pour votre compte personnel ».

Configurer l’accès de GitHub Actions pour les packages délimités à des organisations

  1. Sur GitHub, accédez à la page principale de votre organisation.

  2. Sous le nom de votre organisation, cliquez sur l’onglet Packages.

    Capture d’écran de la page de profil de @octo-org. L’onglet « Packages » est mis en évidence avec un encadré orange.

  3. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  4. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  5. Dans la barre latérale de gauche, cliquez sur Accès à Actions.

  6. Cliquez sur Ajouter un dépôt et recherchez le dépôt que vous souhaitez ajouter.

    Capture d’écran de la section « Gérer l’accès à Actions » dans la page des paramètres du package. Le bouton « Ajouter un dépôt » est mis en évidence avec un encadré orange.

  7. Utiliser le menu déroulant Rôle pour sélectionner le niveau d’accès par défaut dont vous aimeriez que votre dépôt dispose sur votre package.

Pour personnaliser davantage l’accès à votre package, consultez « Configuration de l’accès aux packages pour une organisation ».

Configuration de la visibilité des packages pour votre compte personnel

Quand vous publiez pour la première fois un package délimité à votre compte personnel, la visibilité par défaut est privée et vous seul pouvez voir le package. Vous pouvez changer l’accès d’un package privé ou public en modifiant les paramètres d’accès.

  1. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  2. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  3. En bas de la page, sous « Zone de danger », cliquez sur Changer la visibilité.

  4. Sélectionnez un paramètre de visibilité :

    • Pour étendre la visibilité du package à tout le monde, sélectionnez Publique.

      Avertissement : Une fois que vous avez rendu un package public, il ne peut plus redevenir privé.

    • Pour limiter la visibilité du package à une sélection personnalisée de personnes, sélectionnez Privée.

  5. Pour confirmer, tapez le nom du package et cliquez sur Je comprends les conséquences, changer la visibilité du package.

Visibilité de la création de packages pour les membres de l’organisation

Pour les registres qui prennent en charge les autorisations granulaires, vous pouvez choisir la visibilité des packages que les membres de l’organisation peuvent publier par défaut. Pour obtenir la liste de ces registres, consultez « À propos des autorisations pour les packages GitHub ».

  1. Dans le coin supérieur droit de GitHub, sélectionnez votre photo de profil, puis cliquez sur Vos organisations.
  2. En regard de l’organisation, cliquez sur Paramètres.
  3. Sur la gauche, cliquez sur Packages.
  4. Sous « Création de packages », choisissez si vous souhaitez activer la création de packages publics, privés ou internes.
    • Pour permettre aux membres de l’organisation de créer des packages publics, cliquez sur Public.
    • Pour permettre aux membres de l’organisation de créer des packages privés qui ne sont visibles que par d’autres membres de l’organisation, cliquez sur Privé. Vous pouvez personnaliser davantage la visibilité des packages privés.
    • Pour permettre aux membres de l’organisation de créer des packages internes visibles par tous les membres de l’organisation, cliquez sur Interne. Si l’organisation appartient à une grande entreprise, les packages sont visibles par tous les membres de l’entreprise.

Configuration de la visibilité des packages pour une organisation

Lorsque vous publiez un package pour la première fois, la visibilité par défaut est privée et vous seul pouvez voir le package. Vous pouvez accorder aux utilisateurs ou aux équipes différents rôles d’accès pour votre package par le biais des paramètres d’accès. Une fois que vous avez rendu votre package public, il ne peut plus redevenir privé.

  1. Sur GitHub, accédez à la page principale de votre organisation.

  2. Sous le nom de votre organisation, cliquez sur l’onglet Packages.

    Capture d’écran de la page de profil de @octo-org. L’onglet « Packages » est mis en évidence avec un encadré orange.

  3. Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.

  4. Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.

    Capture d’écran de la page d’accueil d’un package. Dans le coin inférieur droit, « Paramètres du package » est mis en évidence avec un encadré orange.

  5. En bas de la page, sous « Zone de danger », cliquez sur Changer la visibilité et choisissez un paramètre de visibilité :

    • Pour étendre la visibilité du package à tout le monde, cliquez sur Publique.

      Avertissement : Une fois que vous avez rendu un package public, il ne peut plus redevenir privé.

    • Pour limiter la visibilité du package à une sélection personnalisée de personnes de votre organisation, cliquez sur Privée.

    • Pour étendre la visibilité du package à tous les membres de l’organisation, cliquez sur Interne. Si l’organisation appartient à une grande entreprise, les packages sont visibles par tous les membres de l’entreprise.