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 consulter la liste des registres qui prennent en charge des autorisations granulaires et obtenir plus d’informations sur les autorisations des paquets, les portées liées aux paquets pour les PATs ou la gestion des autorisations de vos GitHub Actions flux de travail, 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.
Par défaut, si vous publiez un package lié à un référentiel, le package hérite automatiquement des autorisations d’accès (mais pas de la visibilité) du référentiel lié. Par exemple, un utilisateur disposant d’un accès en lecture au dépôt lié a également un accès en lecture au package. Lorsqu’un package hérite automatiquement des autorisations d’accès, GitHub Actions les flux de travail du référentiel lié obtiennent également automatiquement l’accès au package.
Un package hérite automatiquement des autorisations d’accès d’un dépôt lié si vous liez le dépôt au package avant de publier le package, par exemple en ajoutant l’étiquette org.opencontainers.image.source Docker à une image conteneur. Si vous connectez un package publié à un dépôt à partir de la page des paramètres du package, le package conserve ses autorisations d’accès existantes et n’hérite pas des autorisations d’accès du dépôt, sauf si vous sélectionnez explicitement cette option. De plus, les organisations peuvent désactiver l’héritage automatique des autorisations d’accès pour tous les nouveaux paquets attribués à leur organisation. Pour plus d’informations, consultez Désactivation de l’héritage automatique des autorisations d’accès dans une organisation ci-dessous.
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 paramètres d’autorisations du dépôt lié. Si vous souhaitez définir les paramètres d’accès d’un package séparément du référentiel lié au package, vous devez supprimer les autorisations héritées du package lié. Pour plus d’informations, consultez Sélectionner si un package hérite des autorisations d’un référentiel 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.
Remarque
Si vous publiez un package qui est lié à un dépôt, le package hérite de ses autorisations par défaut. Pour accéder aux paramètres des autorisations granulaires du package, vous devez supprimer les autorisations héritées du package. Si vous êtes propriétaire d’une organisation, vous pouvez désactiver l’héritage automatique des autorisations pour tous les nouveaux packages délimités à votre organisation. Pour plus d’informations, consultez « Configuration du contrôle d’accès et de la visibilité d’un package » et « Configuration du contrôle d’accès et de la visibilité d’un package ».
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 en utilisant le bouton Ajouter un dépôt sous « Gérer l’accès à Actions » dans les paramètres du package. Pour plus d’informations, consultez « Configuration du contrôle d’accès et de la visibilité d’un package ».
| Autorisation | Description de l’accès |
|---|---|
| Lire | Peut télécharger le package. Peut lire les métadonnées du package. |
| Write | Peut charger et télécharger ce package. Peut lire et écrire des métadonnées de package. |
| Administrateur | Peut 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 préversion publique 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.
-
Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.
-
Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.
-
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.
-
Sur GitHub, accédez à la page principale de votre organisation.
-
Sous le nom de votre organisation, cliquez sur l’onglet Paquets.
-
Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.
-
Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.
-
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 à tous les membres de l’équipe l’accès.
-
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
Par défaut, si vous publiez un package lié à un dépôt, le package hérite des autorisations d’accès du dépôt 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é.
Si vous souhaitez configurer les paramètres d’accès d’un package à un niveau granulaire, séparément du référentiel lié, vous devez supprimer les autorisations héritées du package.
Remarque
Si vous modifiez la façon dont un paquet obtient ses autorisations d'accès, toutes les autorisations existantes pour le paquet sont écrasées.
Sélection des paramètres d’héritage pour les packages associés à votre compte personnel
-
Sur GitHub, accédez à la page principale de votre compte personnel.
-
Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.
-
Sur votre page de profil, dans l'en-tête, cliquez sur l’onglet Paquets.
-
Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.
-
Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.
-
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
Conseil
Si vous êtes propriétaire d’une organisation, vous pouvez empêcher tous les nouveaux packages délimités à votre organisation d’hériter automatiquement des autorisations d’un référentiel lié. Pour plus d’informations, consultez Désactivation de l’héritage automatique des autorisations d’accès dans une organisation ci-dessous.
-
Sur GitHub, accédez à la page principale de votre organisation.
-
Sous le nom de votre organisation, cliquez sur l’onglet Paquets.
-
Recherchez le nom du package que vous souhaitez gérer et cliquez dessus.
-
Dans la page d’accueil de votre package, sur le côté droit, cliquez sur Paramètres du package.
-
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.
Désactivation de l’héritage automatique des autorisations d’accès dans une organisation
Par défaut, si vous publiez un package lié à un dépôt, le package hérite automatiquement des autorisations d’accès du dépôt lié. En tant que propriétaire d’organisation, vous pouvez désactiver l’héritage automatique pour tous les packages délimités à votre organisation.
Si vous désactivez l’héritage automatique des autorisations d’accès, les nouveaux packages délimités à votre organisation n’héritent pas automatiquement des autorisations d’un dépôt lié. Toutefois, toute personne disposant d’autorisations d’administrateur sur un package de votre organisation peut activer ou désactiver l’héritage des autorisations pour ce package.
-
Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
-
Sélectionnez une organisation en cliquant dessus.
-
Sous le nom de votre organisation, cliquez sur