View a markdown version of this page

Azioni, risorse e chiavi di condizione per AWS services - Service Authorization Reference

Azioni, risorse e chiavi di condizione per AWS services

Ogni AWS servizio può definire le operazioni, le azioni, le risorse e le chiavi contestuali delle condizioni da utilizzare nelle politiche IAM. Questo argomento descrive come vengono documentati gli elementi forniti da ciascun servizio.

Ogni argomento è costituito da tabelle che forniscono l'elenco delle operazioni, delle azioni, delle risorse e delle chiavi di condizione disponibili.

La tabella delle operazioni

La tabella Operations elenca le operazioni API definite dal servizio e associa ciascuna di esse alle azioni IAM che le autorizzano. Una singola operazione può autorizzare più di un'azione IAM. Alcuni servizi non dispongono ancora di una tabella delle operazioni. Ciò non significa che non vi siano operazioni per quel servizio. Questa tabella non include ancora le azioni che i servizi downstream autorizzano tramite sessioni di accesso diretto.

  • La colonna Operazione elenca il nome dell'operazione API. Quando un'operazione autorizza più azioni, il nome dell'operazione si estende sulle righe per tutte le azioni autorizzate.

  • La colonna delle azioni IAM elenca ogni azione IAM autorizzata dall'operazione, nel modulo. service:ActionName Quando l'azione appartiene allo stesso servizio dell'operazione, la voce si collega alla riga dell'azione nella tabella Azioni della stessa pagina. Quando l'azione appartiene a un servizio diverso, la voce rimanda alla pagina di riferimento per l'autorizzazione del servizio.

  • Le colonne Condizione chiave e Valore possibile elencano solo le chiavi di condizione che questa operazione imposta su un valore fisso e noto quando autorizza questa azione, insieme al valore impostato. Questo non è il set completo di chiavi condizionali che potrebbero essere disponibili durante l'autorizzazione. Le chiavi mostrate sono quelle con valori determinati staticamente dall'API stessa. Per il set completo di chiavi di condizione supportate dall'azione, consultate la tabella Azioni e la tabella Chiavi di condizione nella stessa pagina.

  • La colonna Livello di accesso mostra la classificazione del livello di accesso dell'azione autorizzata. Per ulteriori informazioni sui livelli di accesso, consulta Dettagli sui riepiloghi dei livelli di accesso all'interno dei riepiloghi delle policy.

La Tabella delle operazioni

La tabella Actions (Operazioni) elenca tutte le operazioni che è possibile utilizzare in un elemento Action di una dichiarazione di policy di IAM Alcuni servizi includono operazioni di sola autorizzazione che non corrispondono direttamente a un'operazione API. Queste azioni sono elencate in una tabella di Permission-only azioni separata nella stessa pagina. Utilizza queste tabelle per determinare quali azioni puoi utilizzare in una policy IAM. Per ulteriori informazioni sugli elementi Action, Resource o Condition, consulta la Documentazione di riferimento delle policy JSON IAM. Le colonne delle tabelle Actions (Operazioni) e Description (Descrizione) sono auto-descrittive.

  • La colonna Access Level (Livello di accesso) descrive il modo in cui l'operazione è classificata (elenco, lettura, scrittura, gestione delle autorizzazioni o gestione dei tag). Questa classificazione può aiutare a comprendere il livello di accesso che un'operazione mette a disposizione quando viene utilizzata in una policy. Per ulteriori informazioni sui livelli di accesso, consulta Dettagli sui riepiloghi dei livelli di accesso all'interno dei riepiloghi delle policy.

  • La colonna Resource Types (Tipi di risorsa) indica se l'operazione supporta le autorizzazioni a livello di risorsa. Se la colonna è vuota, l'operazione non supporta le autorizzazioni a livello di risorsa e devi specificare tutte le risorse ("*") nella policy. Se la colonna include un tipo di risorsa, puoi specificare l'ARN della risorsa nell'elemento Resource della policy. Per ulteriori informazioni su questa risorsa, consultare tale riga nella tabella Resource Types (Tipi di risorsa). Tutte le operazioni e le risorse che sono incluse in una dichiarazione devono essere compatibili l'una con l'altra. Se si specifica una risorsa che non è valida per l'operazione, ogni richiesta di utilizzare tale operazione non si conclude correttamente e la sezione Effect della dichiarazione non ha effetto.

    Le risorse richieste sono indicate nella tabella con un asterisco (*). Se specifichi un ARN di autorizzazione a livello di risorsa in una dichiarazione utilizzando questa operazione, allora deve essere di questo tipo. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzarne uno ma non l'altro.

  • La colonna Condition Keys (Chiavi di condizione) contiene le chiavi che è possibile specificare nell'elemento Condition di una dichiarazione di policy. Le chiavi di condizione potrebbero essere supportate con un'operazione o con un'operazione e una risorsa specifica. Presta particolare attenzione se la chiave si trova nella stessa riga di un tipo di risorsa specifico. Questa tabella non contiene le chiavi di condizione globali disponibili per qualsiasi operazione o in circostanze non correlate. Per ulteriori informazioni sulle chiavi di condizione globali, consulta le chiavi di condizione AWS globali.

La tabella dei tipi di risorse

La tabella Resource Types (Tipi di risorse) elenca tutti i tipi di risorse che è possibile specificare come ARN nell'elemento della policy Resource. Non tutti i tipi di risorsa possono essere specificati con ogni operazione. Alcuni tipi di risorse funzionano solo con determinate operazioni. Per ulteriori informazioni sull'elemento Resource, consulta Elementi JSON della policy IAM: Risorsa.

  • La colonna ARN specifica il formato dell'ARN (Amazon Resource Name) che è necessario utilizzare per fare riferimento alle risorse di questo tipo. Le porzioni precedute da un $ devono essere sostituite con i valori effettivi per il proprio scenario. Ad esempio, se $user-name è presente in un ARN, è necessario sostituire tale stringa con l'effettivo nome dell'utente o con una variabile di policy che contiene il nome di un utente. Per ulteriori informazioni sugli ARN, consulta ARN IAM.

  • La colonna Condition Keys (Chiavi di condizione) specifica le chiavi di condizione contestuali che è possibile includere in una dichiarazione di una policy IAM solo quando sia questa risorsa che un'operazione di supporto della tabella precedente sono incluse nella dichiarazione.

La tabella delle chiavi di condizione

La tabella delle chiavi di condizione elenca tutte le chiavi di condizione che è possibile utilizzare nell'Conditionelemento di una dichiarazione di policy IAM. Non tutte le chiavi possono essere specificate con ogni operazione o risorsa. Alcune chiavi funzionano solo con alcuni tipi di operazioni e risorse. Per ulteriori informazioni sull'elemento Condition, consulta Elementi JSON della policy IAM: Condizione.

  • La colonna Type (Tipo) specifica il tipo di dato della chiave di condizione. Questo tipo di dato determina quali operatori condizionali è possibile utilizzare per confrontare i valori nella richiesta con i valori della dichiarazione nella policy. È necessario utilizzare un operatore appropriato per il tipo di dato. Se si utilizza un operatore errato, la corrispondenza non risulta mai verificata e l'istruzione della policy non viene mai applicata.

    Se la colonna Type specifica "ArrayOf..» uno dei tipi semplici, è necessario utilizzare operatori di set multivalore nelle politiche. Utilizzare il prefisso ForAllValues per specificare che tutti i valori nella richiesta devono corrispondere a un valore nell'istruzione della policy. Utilizzare il prefisso ForAnyValue per specificare che almeno un valore nella richiesta corrisponde a uno dei valori nell'istruzione della policy.

Argomenti