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.
Simplifié Service AWS informations pour l'accès programmatique
AWS fournit des informations de référence de service au format JSON afin de rationaliser l'automatisation des flux de travail de gestion des politiques. Grâce aux informations de référence du service, vous pouvez accéder aux opérations, actions, ressources et clés de condition disponibles sur Services AWS à partir de fichiers lisibles par machine. Les informations de référence des services incluent des métadonnées allant au-delà des détails d'autorisation, notamment les informations relatives aux dernières actions IAM consultées et les données de génération de politiques IAM Access Analyzer.
Les administrateurs de sécurité peuvent établir des garde-fous et les développeurs peuvent garantir un accès approprié aux applications en identifiant les actions, les ressources et les clés de condition disponibles pour chacune Service AWS. AWS fournit des informations de référence de service pour Services AWS pour vous permettre d'intégrer les métadonnées dans vos flux de gestion des politiques.
AWS fournit également une liste consolidée des clés de condition globales qui s'appliquent à Services AWS. Vous pouvez découvrir le aws:-clés préfixées disponibles pour être utilisées dans les politiques IAM de n'importe quel service à partir d'un seul fichier lisible par machine.
-
Pour obtenir un inventaire des actions, des ressources et des clés de condition à utiliser dans les politiques IAM, consultez Référence d'autorisation de service page pour Service AWS. Les actions, les ressources et les clés de condition pour les services qui partagent un préfixe de service peuvent être réparties sur plusieurs pages dans la référence d'autorisation des services.
-
Pour une liste des Services AWS et les actions pour lesquelles les informations relatives à l'action IAM ayant accédé pour la dernière fois sont affichées, voir L'action IAM a accédé aux derniers services d'information et actions dans le guide de l'utilisateur IAM.
-
Pour une liste des Services AWS et les actions pour lesquelles IAM Access Analyzer génère des politiques avec des informations au niveau de l'action, voir Services de génération de politiques IAM Access Analyzer dans le guide de l'utilisateur IAM.
Le contenu présenté dans la référence d'autorisation de service peut être présenté différemment ou contenir des métadonnées différentes. Pour plus d’informations, consultez Définitions de champs supplémentaires.
Les informations de référence des services proposent également des métadonnées sur les opérations, notamment des informations sur les actions autorisées et les noms des méthodes dans les kits de développement logiciel.
Un contexte supplémentaire concernant la valeur des clés de condition peut être disponible pour aider à définir la portée des autorisations. Par exemple, la valeur de iam:PassedToService peut apparaître lorsque l'action iam:PassRole est autorisé par une opération.
Ce mappage d'opération à action n'est pas pris en charge pour tous les services. Les services qui ne prennent pas encore en charge ce mappage omettront le AuthorizedAction propriété. En outre, les informations relatives aux actions autorisées pour les opérations n'incluent pas les autorisations qui peuvent être requises pour les opérations appelées en votre nom avec Sessions d'accès direct.
Les modifications apportées aux informations de référence du service peuvent prendre jusqu'à 24 heures pour être prises en compte dans la liste des métadonnées du service.
Accès Service AWS informations de référence
-
Accédez aux informations de référence du service pour accéder à la liste des Services AWS pour lesquels des informations de référence sont disponibles.
Il existe trois points d'entrée principaux :
https://servicereference.us-east-1.amazonaws.com/
affiche la liste des Services AWS pour lesquels des informations de référence sont disponibles. L'exemple suivant présente une liste partielle de services et d'URL pour leurs informations de référence respectives :
[ { "service": "s3", "url": "https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json" }, { "service": "dynamodb", "url": "https://servicereference.us-east-1.amazonaws.com/v1/dynamodb/dynamodb.json" }, … ]https://servicereference.us-east-1.amazonaws.com/v1/global-condition-keys.json
affiche les clés de condition globales que vous pouvez utiliser dans les politiques IAM dans Services AWS. L'exemple suivant présente une liste partielle des clés de condition globales :
[ { "Name" : "aws:AssumedRoot", "Description" : "Filters access based on whether the request was made using temporary security credentials for AssumeRoot", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html", "Types" : [ "Bool" ] }, { "Name" : "aws:CalledVia", "Description" : "Filters access by the services that make the request on behalf of the IAM principal", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-calledvia", "Types" : [ "ArrayOfString" ] }, { "Name" : "aws:ChatbotSourceArn", "Description" : "This key identifies the chatbot configuration ARN associated with the assume role session initiated by AWS Chatbot.", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-chatbotsourcearn", "Types" : [ "ARN", "String" ] }, { "Name" : "aws:CurrentTime", "Description" : "Filters access by the time and date when the request was made", "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-currenttime", "Types" : [ "Date" ] } ]https://servicereference.us-east-1.amazonaws.com/v1/mapping.json
affiche un mappage entre les services du SDK et l'emplacement dans la référence de service sous laquelle les informations se trouvent. L'exemple suivant montre une liste partielle des mappages :
{ "SDK" : { "Python" : { "Boto3" : { "accessanalyzer" : { "service" : "access-analyzer", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/access-analyzer/access-analyzer.json" }, "account" : { "service" : "account", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/account/account.json" }, "amp" : { "service" : "aps", "url" : "https://servicereference.us-east-1.amazonaws.com/v1/aps/aps.json" }, ... } } } } -
Choisissez un service et accédez à la page d'informations sur le service dans
urlchamp permettant au service d'afficher une liste d'actions, de ressources et de clés de condition pour le service.L'exemple suivant présente une liste partielle des informations de référence de service pour Amazon S3 :
{ "Name": "s3", "ServiceName": "S3", "Actions": [ { "Name": "GetObject", "ActionConditionKeys": [ "s3:AccessGrantsInstanceArn", "s3:AccessPointNetworkOrigin", "s3:DataAccessPointAccount", "s3:DataAccessPointArn", "s3:ExistingObjectTag/key", "s3:ResourceAccount", "s3:TlsVersion", "s3:authType", "s3:if-match", "s3:if-none-match", "s3:signatureAge", "s3:signatureversion", "s3:x-amz-content-sha256" ], "Annotations" : { "Properties" : { "IsDataPlane" : true, "IsList" : false, "IsPermissionManagement" : false, "IsTaggingOnly" : false, "IsWrite" : false } }, "Resources": [ { "Name": "object" } ], "SupportedBy" : { "IAM Access Analyzer Policy Generation" : false, "IAM Action Last Accessed" : false } }, { "Name": "ListBucket", "ActionConditionKeys": [ "s3:AccessGrantsInstanceArn", "s3:AccessPointNetworkOrigin", "s3:DataAccessPointAccount", "s3:DataAccessPointArn", "s3:ResourceAccount", "s3:TlsVersion", "s3:authType", "s3:delimiter", "s3:max-keys", "s3:prefix", "s3:signatureAge", "s3:signatureversion", "s3:x-amz-content-sha256" ], "Annotations" : { "Properties" : { "IsDataPlane" : true, "IsList" : true, "IsPermissionManagement" : false, "IsTaggingOnly" : false, "IsWrite" : false } }, "Resources": [ { "Name": "bucket" } ], "SupportedBy" : { "IAM Access Analyzer Policy Generation" : false, "IAM Action Last Accessed" : false } }, ... ], "ConditionKeys": [ { "Name": "s3:TlsVersion", "Types": [ "Numeric" ] }, { "Name": "s3:authType", "Types": [ "String" ] }, ... ], "Operations": [ { "Name" : "GetObject", "AuthorizedActions" : [ { "Name" : "GetObject", "Service" : "s3" }, { "Name" : "GetObject", "Service" : "s3-object-lambda" }, { "Name" : "GetObjectLegalHold", "Service" : "s3" }, { "Name" : "GetObjectRetention", "Service" : "s3" }, { "Name" : "GetObjectTagging", "Service" : "s3" }, { "Name" : "GetObjectVersion", "Service" : "s3" } ], "SDK" : [ { "Name" : "s3", "Method" : "get_object", "Package" : "Boto3" } ] }, ... ], "Resources": [ { "Name": "accesspoint", "ARNFormats": [ "arn:${Partition}:s3:${Region}:${Account}:accesspoint/${AccessPointName}" ] }, { "Name": "bucket", "ARNFormats": [ "arn:${Partition}:s3:::${BucketName}" ] } ... ], "Version": "v1.5" }Le
ServiceNamele champ fournit un nom lisible par l'homme pour Service AWS, tels queS3pours3service. Il apparaît au niveau supérieur du fichier de référence du service, immédiatement aprèsNamechamp. -
Téléchargez le fichier JSON à partir de l'URL du service à utiliser dans vos flux de travail de création de politiques.
Glossaire
-
Fonctionnement : API qui peut être appelée, généralement via un SDK
-
Action : autorisation autorisée lors de l'exécution d'une opération
Définitions de champs supplémentaires
Propriétés de l'action fournir des métadonnées supplémentaires sur les actions de service afin de les classer en fonction de l'étendue de leurs autorisations. Ces propriétés se trouvent dans la Annotations champ pour chaque action. Les métadonnées se composent de cinq valeurs booléennes :
-
IsDataPlane— Indique que l'action agit sur les données ou le contenu contenus dans une ressource, plutôt que sur la création, la configuration ou la gestion de la ressource elle-même. Cette propriété est dérivée de AWS CloudTrail catégories d'événements des opérations qui autorisent l'action.Exemple — Cette propriété est
truepour Amazon S3GetObjectaction, qui lit le contenu de l'objet, etfalsepourCreateBucket, qui crée et configure la ressource (opération du plan de contrôle).Certaines actions omettent cette propriété. Une action entraîne
IsDataPlaneuniquement lorsqu'au moins une opération qui l'autorise possède un CloudTrail catégorie d'événement. Si la propriété n'existe pas, c'est que l'action n'est pas encore classée. -
IsList— Indique que l'action découvre et répertorie les ressources, y compris les métadonnées de base, sans accéder au contenu des ressources.Exemple — Cette propriété est
truepour Amazon S3ListBucketaction, qui renvoie des listes de compartiments sans accéder aux objets eux-mêmes. -
IsPermissionManagement— Indique que l'action peut modifier les autorisations IAM ou les informations d'accès.Exemple — Cette propriété est
truepour la plupart des IAM et AWS Organizations actions, et pour Amazon S3, des actions telles quePutBucketPolicyetDeleteBucketPolicy. -
IsTaggingOnly— Indique que l'action ne modifie que les balises.Exemple — Cette propriété est
truepour les actions IAMTagRoleetUntagRole, etfalsepourCreateRole, qui accorde des autorisations plus étendues que le balisage. -
IsWrite— Indique que l'action peut modifier les ressources, ce qui peut inclure des modifications de balises.Exemple — Cette propriété est
truepour les actions Amazon S3CreateBucket,DeleteBucket, etPutObject, qui modifient les ressources.
Ces propriétés ne s'excluent pas mutuellement. Une action peut avoir plusieurs propriétés définies sur true.
Il est également possible que toutes les propriétés soient false, comme on peut le voir avec Amazon S3 GetBucketPolicy action. Cela indique que l'action accorde uniquement des autorisations de lecture sur la configuration du bucket.
Ces propriétés peuvent être utilisées pour générer des informations sur les services. L'exemple suivant montre quelles autorisations sont associées à s3 le préfixe autorise la mutation des ressources :
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \ jq '.Actions[] | select(.Annotations.Properties.IsWrite == true) | .Name' "AssociateAccessGrantsIdentityCenter" "BypassGovernanceRetention" "CreateAccessGrant" "CreateAccessGrantsInstance" "CreateAccessGrantsLocation" ...
L'exemple suivant montre quelles autorisations sont associées à s3 le préfixe autorise l'accès aux données plutôt qu'à la configuration du service :
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \ jq '.Actions[] | select(.Annotations.Properties.IsDataPlane == true) | .Name' "AbortMultipartUpload" "BypassGovernanceRetention" "DeleteObject" "DeleteObjectVersion" "GetObject" ...
L'exemple suivant montre quelles sont les touches de condition d'action avec lambda préfixe que vous pouvez utiliser pour limiter l'accès aux actions de gestion des autorisations :
> curl https://servicereference.us-east-1.amazonaws.com/v1/lambda/lambda.json | \ jq '.Actions[] | select(.Annotations.Properties.IsPermissionManagement == true) | {Name: .Name, ActionConditionKeys: (.ActionConditionKeys // [])}' { "Name": "AddLayerVersionPermission", "ActionConditionKeys": [] } { "Name": "AddPermission", "ActionConditionKeys": [ "lambda:FunctionUrlAuthType", "lambda:Principal" ] } { "Name": "DisableReplication", "ActionConditionKeys": [] } { "Name": "EnableReplication", "ActionConditionKeys": [] } { "Name": "RemoveLayerVersionPermission", "ActionConditionKeys": [] } { "Name": "RemovePermission", "ActionConditionKeys": [ "lambda:FunctionUrlAuthType", "lambda:Principal" ] }