

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.
+ Per un inventario delle azioni, delle risorse e delle chiavi di condizione da utilizzare nelle policy IAM, consulta la [Riferimento per l'autorizzazione del servizio](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html) pagina per Servizio AWS. Le azioni, le risorse e le chiavi di condizione per i servizi che condividono un prefisso di servizio possono essere suddivise in più pagine nel Service Authorization Reference.
+ Per un elenco di Servizi AWS e le azioni per le quali vengono visualizzate le informazioni sull'ultimo accesso all'azione IAM, vedi [L'azione IAM ha effettuato l'ultimo accesso alle informazioni, ai servizi e alle azioni](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_last-accessed-action-last-accessed.html) nella IAM User Guide.
+ Per un elenco di Servizi AWS e azioni per le quali IAM Access Analyzer genera policy con informazioni a livello di azione, consulta [Servizi di generazione di policy IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation-action-last-accessed-support.html) nella IAM User Guide.

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](#service-reference-additional-field-definitions).

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).

**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/](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:

   ```JSON
   [ 
       { 
           "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](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:

   ```JSON
   [ {
     "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](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:

   ```JSON
   {
     "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"
           },
           ...
         }
       }
     }
   }
   ```

1. 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:

   ```JSON
   {
       "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.

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

## Glossario
<a name="service-reference-glossary"></a>
+ 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
<a name="service-reference-additional-field-definitions"></a>

**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:

```JSON
> 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:

```JSON
> 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:

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