Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création et utilisation des autorisations gérées par le client dans AWS RAM
AWS Resource Access Manager (AWS RAM) fournit au moins un AWS autorisation gérée pour chaque type de ressource que vous pouvez partager. Cependant, ces autorisations gérées peuvent ne pas fournir accès avec le moindre privilège pour votre cas d'utilisation en matière de partage. Lorsque l'un des AWS les autorisations gérées ne fonctionnent pas, vous pouvez créer les vôtres autorisation gérée par le client.
Les autorisations gérées par le client sont des autorisations gérées que vous créez et gérez en spécifiant précisément quelles actions peuvent être effectuées dans quelles conditions avec les ressources partagées à l'aide de AWS RAM. Par exemple, vous souhaitez limiter l'accès en lecture à vos pools Amazon VPC IP Address Manager (IPAM), afin de vous aider à gérer vos adresses IP à grande échelle. Vous pouvez créer des autorisations gérées par le client pour que vos développeurs attribuent des adresses IP, mais ne pas afficher la plage d'adresses IP attribuée par d'autres comptes de développeur. Vous pouvez suivre la meilleure pratique du moindre privilège, en n'accordant que les autorisations requises pour effectuer des tâches sur des ressources partagées.
En outre, vous pouvez mettre à jour ou supprimer les autorisations gérées par le client selon vos besoins.
Vous pouvez également ajouter des paramètres au modèle de politique d'une autorisation gérée par le client. Cette approche réutilise une autorisation sur des partages de ressources qui nécessitent des valeurs de condition différentes. Vous fournissez les valeurs lorsque vous associez l'autorisation à un partage de ressources. Pour plus d’informations, consultez Utilisation d'autorisations gérées paramétrées dans AWS RAM.
Création d'une autorisation gérée par le client
Les autorisations gérées par le client sont spécifiques à Région AWS. Assurez-vous de créer cette autorisation gérée par le client dans la région appropriée.
- Console
-
Pour créer une autorisation gérée par le client
-
Effectuez l’une des actions suivantes :
-
Pour Détails des autorisations gérées par le client, entrez un nom d'autorisation géré par le client.
-
Choisissez le type de ressource auquel s'applique cette autorisation gérée.
-
Pour Modèle de politique, vous définissez quelles opérations peuvent être effectuées sur ce type de ressource.
-
Vous pouvez choisir Importer des autorisations gérées pour utiliser les actions d'une autorisation gérée existante.
-
Sélectionnez ou désélectionnez les informations de niveau d'accès en fonction de vos besoins dans l'éditeur visuel.
-
Ajoutez ou modifiez des conditions à l'aide du éditeur JSON.
-
(Facultatif) Pour associer des balises à l'autorisation gérée, pour Balises, entrez une clé de balise et une valeur. Ajoutez des balises supplémentaires en choisissant Ajouter un nouveau tag. Répétez cette étape si nécessaire.
-
Lorsque vous avez terminé, choisissez Créer une autorisation gérée par le client.
- AWS CLI
-
Pour créer une autorisation gérée par le client
-
Exécutez la commande autorisation de création et spécifiez un nom, le type de ressource auquel s'applique l'autorisation gérée par le client et le corps du texte du modèle de politique.
L'exemple de commande suivant crée une autorisation gérée pour imagebuilder:Component type de ressource.
$ aws ram create-permission \
--name TestCMP \
--resource-type imagebuilder:Component \
--policy-template "{\"Effect\":\"Allow\",\"Action\":[\"imagebuilder:ListComponents\"]}"
{
"permission": {
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "1",
"defaultVersion": true,
"isResourceTypeDefault": false,
"name": "TestCMP",
"resourceType": "imagebuilder:Component",
"status": "ATTACHABLE",
"creationTime": 1680033769.401,
"lastUpdatedTime": 1680033769.401
}
}
Création d'une nouvelle version d'une autorisation gérée par le client
Si le cas d'utilisation de l'autorisation gérée par votre client change, vous pouvez créer une nouvelle version de l'autorisation gérée. Cela n'affectera pas vos partages de ressources existants, mais uniquement les nouveaux partages de ressources à venir qui utiliseront cette autorisation gérée par le client.
Chaque autorisation gérée peut avoir jusqu'à cinq versions, mais vous ne pouvez associer que la version par défaut.
- Console
-
Pour créer une nouvelle version d'une autorisation gérée par le client
-
Naviguez jusqu'au Bibliothèque d'autorisations gérées.
-
Filtrer la liste des autorisations gérées par Géré par le client, ou recherchez le nom de l'autorisation gérée par le client que vous souhaitez modifier.
-
Sur la page des détails des autorisations gérées, sous Versions d'autorisations gérées section, choisissez Créer une version.
-
Pour Modèle de politique, vous pouvez ajouter ou supprimer des actions et des conditions à l'aide de l'éditeur visuel ou de l'éditeur JSON.
Vous avez également la possibilité de choisir Importer des autorisations gérées pour utiliser un modèle de politique existant.
-
Lorsque vous avez terminé, choisissez Créer une version au bas de la page.
- AWS CLI
-
Pour créer une nouvelle version d'une autorisation gérée par le client
-
Recherchez l'Amazon Resource Name (ARN) de l'autorisation gérée pour laquelle vous souhaitez créer une nouvelle version. Pour ce faire, appelez lister les autorisations avec le --permission-type
CUSTOMER_MANAGED paramètre pour inclure uniquement les autorisations gérées par le client.
$ aws ram list-permissions --permission-type CUSTOMER_MANAGED
{
"permissions": [
{
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "2",
"defaultVersion": true,
"isResourceTypeDefault": false,
"name": "TestCMP",
"permissionType": "CUSTOMER_MANAGED",
"resourceType": "imagebuilder:Component",
"status": "ATTACHABLE",
"creationTime": 1680035597.346,
"lastUpdatedTime": 1680035597.346
}
]
}
-
Une fois que vous avez l'ARN, vous pouvez appeler le version avec autorisation de création fonctionnement et fourniture du modèle de politique mis à jour.
$ aws ram create-permission-version \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP \
--policy-template {"Effect":"Allow","Action":["imagebuilder:ListComponents"]}
{
"permission": {
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "2",
"defaultVersion": true,
"isResourceTypeDefault": false,
"name": "TestCMP",
"status": "ATTACHABLE",
"resourceType": "imagebuilder:Component",
"permission": "{\"Effect\":\"Allow\",\"Action\":[\"imagebuilder:ListComponents\"]}",
"creationTime": 1680038973.79,
"lastUpdatedTime": 1680038973.79
}
}
La sortie inclut le numéro de version de la nouvelle version.
Choisissez une autre version comme version par défaut pour une autorisation gérée par le client
Vous pouvez définir une autre version des autorisations gérées par le client comme nouvelle version par défaut.
- Console
-
Pour définir une nouvelle version par défaut pour une autorisation gérée par le client
-
Naviguez jusqu'au Bibliothèque d'autorisations gérées.
-
Filtrer la liste des autorisations gérées par Géré par le client, ou recherchez le nom de l'autorisation gérée par le client que vous souhaitez modifier.
-
Sur la page des détails des autorisations gérées par le client, sous Versions d'autorisations gérées section, utilisez la liste déroulante pour choisir la version que vous souhaitez définir comme nouvelle version par défaut.
-
Choisissez Définir comme version par défaut.
-
Lorsque la boîte de dialogue apparaît, confirmez que vous souhaitez que cette version soit la version par défaut pour tous les nouveaux partages de ressources qui utilisent cette autorisation gérée par le client. Si vous êtes d'accord, choisissez Définir comme version par défaut.
- AWS CLI
-
Pour définir une nouvelle version par défaut pour une autorisation gérée par le client
-
Trouvez le numéro de version que vous souhaitez définir comme version par défaut en appelant versions avec autorisation de liste.
L'exemple de commande suivant récupère les versions actuelles pour l'autorisation gérée spécifiée.
$ aws ram list-permission-versions \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP
{
"permissions": [
{
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "1",
"defaultVersion": false,
"isResourceTypeDefault": false,
"name": "TestCMP",
"permissionType": "CUSTOMER_MANAGED",
"featureSet": "STANDARD",
"resourceType": "imagebuilder:Component",
"status": "UNATTACHABLE",
"creationTime": 1680033769.401,
"lastUpdatedTime": 1680035597.345
},
{
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "2",
"defaultVersion": true,
"isResourceTypeDefault": false,
"name": "TestCMP",
"permissionType": "CUSTOMER_MANAGED",
"featureSet": "STANDARD",
"resourceType": "imagebuilder:Component",
"status": "ATTACHABLE",
"creationTime": 1680035597.346,
"lastUpdatedTime": 1680035597.346
}
]
}
-
Une fois que vous avez défini le numéro de version par défaut, vous pouvez appeler définir la version des autorisations par défaut opération.
$ aws ram set-default-permission-version \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP \
--permission-version 2
{
"returnValue": true
}
Tu peux courir versions avec autorisation de liste à nouveau et vérifiez que le defaultVersion le champ de la version choisie est désormais défini sur true.
Déprécier une autorisation gérée par le client
Dépréciez l'autorisation gérée par le client pour la retirer sans compromettre les partages de ressources qui l'utilisent déjà. Une fois que vous désapprouvez une autorisation gérée par le client, les règles suivantes s'appliquent à chaque version de celle-ci :
-
Personne, y compris vous, ne peut l'associer à un partage de ressources. Cela inclut d'autres Comptes AWS avec qui vous l'avez partagé.
-
Vous ne pouvez pas l'ajouter à un partage de ressources en tant que ressource pour le partager.
-
Les partages de ressources qui l'utilisent déjà continuent de fonctionner et leurs propriétaires peuvent toujours la dissocier. Ils ne peuvent pas modifier les valeurs de ses paramètres avec --replace.
-
Vous ne pouvez pas en créer une nouvelle version.
-
Son statut est DEPRECATED.
Après aucun partage de ressources dans aucun Compte AWS utilise une autorisation gérée par le client obsolète, vous pouvez la supprimer.
Dépréciation et quotas :
-
Les autorisations gérées par le client obsolètes ne sont pas prises en compte dans les quotas relatifs au nombre d'autorisations gérées par le client ou au nombre d'autorisations gérées par le client par type de ressource.
-
Un quota distinct limite le nombre d'autorisations gérées par les clients obsolètes que vous pouvez avoir.
-
Undeprecating ramène les autorisations gérées par le client aux quotas habituels. Si vous en êtes déjà à l'un d'entre eux, la dépréciation échoue avec un PermissionLimitExceededException erreur.
Pour plus d’informations, consultez Quotas de services pour AWS RAM.
- Console
-
Pour rendre obsolète une autorisation gérée par le client
-
Ouvrez le Bibliothèque d'autorisations gérées.
-
Choisissez l'autorisation gérée par le client que vous souhaitez rendre obsolète. Pour le trouver, vous pouvez filtrer la liste par Géré par le client ou recherchez son nom.
-
Choisissez Déprécier.
-
Dans le Déprécier les autorisations gérées par le client boîte de dialogue, choisissez Déprécier.
Pour annuler la dépréciation de l'autorisation gérée par le client, choisissez-la, choisissez Non obsolète, puis confirmez dans le Autorisation gérée par le client obsolète boîte de dialogue.
- AWS CLI
-
Pour rendre obsolète une autorisation gérée par le client
-
Exécutez le autorisation de mise à jour commande avec --status DEPRECATED.
$ aws ram update-permission \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP \
--status DEPRECATED
{
"permissionStatus": "DEPRECATED"
}
-
Pour annuler la dépréciation de l'autorisation gérée par le client, exécutez la même commande avec --status ATTACHABLE.
Supprimer une version des autorisations gérées par le client
Vous pouvez avoir jusqu'à cinq versions de chaque autorisation gérée par le client. Lorsqu'une version n'est plus nécessaire et n'est plus utilisée, vous pouvez la supprimer. Vous ne pouvez pas supprimer la version par défaut d'une autorisation gérée par le client. Les versions supprimées restent visibles dans la console pendant deux heures au maximum avec un statut de suppression avant d'être complètement supprimées.
- Console
-
Pour supprimer une version des autorisations gérées par le client
-
Naviguez jusqu'au Bibliothèque d'autorisations gérées.
-
Filtrer la liste des autorisations gérées par Géré par le client, ou recherchez le nom de l'autorisation gérée par le client avec la version que vous souhaitez supprimer.
-
Assurez-vous que la version que vous souhaitez supprimer n'est pas actuellement la version par défaut.
-
Pour Versions section de la page, choisissez Partages de ressources associés onglet pour voir si des partages utilisent cette version.
Si des partages sont associés, vous devez modifier la version des autorisations gérées par le client avant de pouvoir supprimer cette version.
-
Choisissez Supprimer la version sur le côté droit du Version section.
-
Dans la boîte de dialogue de confirmation, sélectionnez Supprimer pour confirmer que vous souhaitez supprimer cette version de votre autorisation gérée par le client.
Choisissez Annuler si vous ne souhaitez pas supprimer cette version de votre autorisation gérée par le client.
- AWS CLI
-
Pour supprimer une version d'une autorisation gérée par le client
-
Appelez le versions avec autorisation de liste opération pour récupérer les numéros de version disponibles.
-
Une fois que vous avez le numéro de version, fournissez-le en tant que paramètre pour version avec autorisation de suppression.
$ aws ram delete-permission-version \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP \
--permission-version 1
{
"returnValue": true,
"permissionStatus": "DELETING"
}
Tu peux courir versions avec autorisation de liste à nouveau et vérifiez que la version n'est plus incluse dans la sortie.
Supprimer une autorisation gérée par le client
Si une autorisation gérée par le client n'est plus nécessaire et n'est pas utilisée, vous pouvez la supprimer. Vous ne pouvez pas supprimer une autorisation gérée par le client associée à un partage de ressources. L'autorisation gérée par le client supprimée disparaît au bout de deux heures. D'ici là, il reste visible dans Bibliothèque d'autorisations gérée avec un statut supprimé.
- Console
-
Pour supprimer une autorisation gérée par le client
-
Naviguez jusqu'au Bibliothèque d'autorisations gérées.
-
Filtrer la liste des autorisations gérées par Géré par le client, ou recherchez le nom de l'autorisation gérée par le client que vous souhaitez supprimer.
-
Vérifiez qu'aucun partage n'est associé dans la liste des autorisations gérées avant de sélectionner l'autorisation gérée par le client.
S'il existe toujours des partages de ressources associés à l'autorisation gérée, vous devez attribuer une autre autorisation gérée à tous les partages de ressources avant de pouvoir continuer.
-
Dans le coin supérieur droit de la page des détails des autorisations gérées par le client, choisissez Supprimer l'autorisation gérée.
-
Lorsque la boîte de dialogue de confirmation apparaît, choisissez Supprimer pour supprimer l'autorisation gérée.
- AWS CLI
-
Pour supprimer une autorisation gérée par le client
-
Trouvez l'ARN de l'autorisation gérée que vous souhaitez supprimer en appelant lister les autorisations avec le --permission-type
CUSTOMER_MANAGED paramètre pour inclure uniquement les autorisations gérées par le client.
$ aws ram list-permissions --permission-type CUSTOMER_MANAGED
{
"permissions": [
{
"arn": "arn:aws:ram:us-east-1:123456789012:permission/TestCMP",
"version": "2",
"defaultVersion": true,
"isResourceTypeDefault": false,
"name": "TestCMP",
"permissionType": "CUSTOMER_MANAGED",
"resourceType": "imagebuilder:Component",
"status": "ATTACHABLE",
"creationTime": 1680035597.346,
"lastUpdatedTime": 1680035597.346
}
]
}
-
Une fois que vous disposez de l'ARN de l'autorisation gérée à supprimer, fournissez-le en tant que paramètre pour autorisation de suppression.
$ aws ram delete-permission \
--permission-arn arn:aws:ram:us-east-1:123456789012:permission/TestCMP
{
"returnValue": true,
"permissionStatus": "DELETING"
}