View a markdown version of this page

Semplificato Servizio AWS informazioni per l'accesso programmatico - Service Authorization Reference

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Semplificato Servizio AWS informazioni per l'accesso programmatico

AWS fornisce informazioni di riferimento sui servizi in formato JSON per semplificare l'automazione dei flussi di lavoro di gestione delle policy. Con le informazioni di riferimento del servizio, è possibile accedere alle operazioni, alle azioni, alle risorse e alle chiavi di condizione disponibili in qualsiasi luogo Servizi AWS da file leggibili dalla macchina. Le informazioni di riferimento del servizio includono metadati oltre ai dettagli di autorizzazione, tra cui le informazioni sull'ultima azione di IAM ad accesso e i dati sulla generazione delle policy di IAM Access Analyzer.

Gli amministratori della sicurezza possono stabilire dei guardrail e gli sviluppatori possono garantire un accesso appropriato alle applicazioni identificando le azioni, le risorse e le chiavi di condizione disponibili per ciascuna Servizio AWS. AWS fornisce informazioni di riferimento sul servizio per Servizi AWS per consentirti di incorporare i metadati nei flussi di lavoro di gestione delle politiche.

AWS fornisce anche un elenco consolidato di chiavi di condizione globali che si applicano a tutti Servizi AWS. Puoi scoprire il aws:-chiavi con prefisso disponibili per l'uso nelle policy IAM di qualsiasi servizio da un singolo file leggibile dalla macchina.

Il contenuto presentato nel Service Authorization Reference può essere presentato in modo diverso o contenere metadati diversi. Per ulteriori informazioni, consulta Definizioni di campi aggiuntive.

Le informazioni di riferimento del servizio offrono anche metadati sulle operazioni, comprese le informazioni sulle azioni autorizzate e i nomi dei metodi negli SDK.

Potrebbe essere disponibile un contesto aggiuntivo del valore delle chiavi di condizione per agevolare l'assegnazione delle autorizzazioni. Ad esempio, il valore di iam:PassedToService può apparire quando l'azione iam:PassRole è autorizzato da un'operazione.

Questa mappatura tra operazione e azione non è supportata per tutti i servizi. I servizi che non supportano ancora questa mappatura ometteranno il AuthorizedAction proprietà. Inoltre, le informazioni sulle azioni autorizzate per le operazioni non includono le autorizzazioni che potrebbero essere necessarie per le operazioni eseguite per conto dell'utente con Sessioni di accesso diretto.

Nota

Le modifiche alle informazioni di riferimento del servizio possono richiedere fino a 24 ore per essere riportate nell'elenco dei metadati del servizio.

Accesso Servizio AWS informazioni di riferimento
  1. Accedi alle informazioni di riferimento del servizio per accedere all'elenco di Servizi AWS per i quali sono disponibili informazioni di riferimento.

    I punti di ingresso principali sono tre:

    https://servicereference.us-east-1.amazonaws.com/ visualizza un elenco di Servizi AWS per i quali sono disponibili informazioni di riferimento.

    L'esempio seguente mostra un elenco parziale di servizi e URL per le rispettive informazioni di riferimento:

    [ { "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 visualizza le chiavi di condizione globali che è possibile utilizzare nelle policy IAM in Servizi AWS.

    L'esempio seguente mostra un elenco parziale di chiavi di condizione globali:

    [ { "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 visualizza una mappatura dai servizi SDK alla posizione nel riferimento del servizio in cui si trovano le informazioni.

    L'esempio seguente mostra un elenco parziale di mappature:

    { "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" }, ... } } } }
  2. Scegliete un servizio e accedete alla pagina delle informazioni sul servizio in url campo in cui il servizio visualizza un elenco di azioni, risorse e chiavi di condizione per il servizio.

    L'esempio seguente mostra un elenco parziale di informazioni di riferimento sul servizio per 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" }

    Il ServiceName il campo fornisce un nome leggibile dall'uomo per Servizio AWS, ad esempio S3 per s3 servizio. Viene visualizzato al livello superiore del file di riferimento del servizio, subito dopo Name campo.

  3. Scarica il file JSON dall'URL del servizio da utilizzare nei flussi di lavoro di creazione delle policy.

Glossario

  • Funzionamento: un'API che può essere richiamata, in genere tramite un SDK

  • Azione: autorizzazione autorizzata durante l'esecuzione di un'operazione

Definizioni di campi aggiuntive

Proprietà delle azioni fornisci metadati aggiuntivi sulle azioni del servizio per aiutarle a classificarle in base all'ambito delle autorizzazioni. Queste proprietà si trovano sotto Annotations campo per ogni azione. I metadati sono costituiti da cinque valori booleani:

  • IsDataPlane — Indica che l'azione opera sui dati o sui contenuti contenuti all'interno di una risorsa, anziché creare, configurare o gestire la risorsa stessa. Questa proprietà è derivata da AWS CloudTrail categorie di eventi delle operazioni che autorizzano l'azione.

    Esempio — Questa proprietà è true per Amazon S3 GetObject action, che legge il contenuto dell'oggetto, e false per CreateBucket, che crea e configura la risorsa (un'operazione sul piano di controllo).

    Alcune azioni omettono questa proprietà. Un'azione comporta IsDataPlane solo quando almeno un'operazione che la autorizza ha un CloudTrail categoria di eventi. Se la proprietà non esiste, l'azione non è ancora classificata.

  • IsList — Indica che l'azione rileva ed elenca le risorse, inclusi i metadati di base, senza accedere al contenuto delle risorse.

    Esempio — Questa proprietà è true per Amazon S3 ListBucket action, che restituisce gli elenchi dei bucket senza accedere agli oggetti stessi.

  • IsPermissionManagement — Indica che l'azione può modificare le autorizzazioni IAM o le credenziali di accesso.

    Esempio — Questa proprietà è true per la maggior parte degli IAM e AWS Organizations azioni e, per Amazon S3, azioni come PutBucketPolicy e DeleteBucketPolicy.

  • IsTaggingOnly — Indica che l'azione modifica solo i tag.

    Esempio — Questa proprietà è true per le azioni IAM TagRole e UntagRole, e false per CreateRole, che concede autorizzazioni più ampie oltre all'etichettatura.

  • IsWrite — Indica che l'azione può modificare le risorse, che possono includere modifiche ai tag.

    Esempio — Questa proprietà è true per le azioni di Amazon S3 CreateBucket, DeleteBucket, e PutObject, che modificano le risorse.

Nota

Queste proprietà non si escludono a vicenda. Un'azione può avere più proprietà impostate su true.

È anche possibile che tutte le proprietà lo siano false, come visto con Amazon S3 GetBucketPolicy azione. Ciò indica che l'azione concede solo i permessi di lettura sulla configurazione del bucket.

Queste proprietà possono essere utilizzate per generare informazioni dettagliate sui servizi. L'esempio seguente mostra quali sono le autorizzazioni con s3 il prefisso consente la modifica delle risorse:

> 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'esempio seguente mostra quali sono le autorizzazioni con s3 il prefisso consente l'accesso ai dati anziché alla configurazione del servizio:

> 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'esempio seguente mostra quale condizione di azione è associata a lambda prefisso che puoi usare per limitare l'accesso alle azioni di gestione delle autorizzazioni:

> 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" ] }