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à.
# Come funziona Amazon QLDB con IAM
Prima di utilizzare IAM per gestire l'accesso a QLDB, scopri quali funzionalità IAM sono disponibili per l'uso con QLDB.
**Importante**
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).
**Funzionalità IAM che puoi usare con Amazon QLDB**
| Funzionalità IAM | Supporto QLDB |
| --- | --- |
| [Policy basate su identità](#security_iam_service-with-iam-id-based-policies) | Sì |
| [Policy basate su risorse](#security_iam_service-with-iam-resource-based-policies) | No |
| [Azioni di policy](#security_iam_service-with-iam-id-based-policies-actions) | Sì |
| [Risorse relative alle policy](#security_iam_service-with-iam-id-based-policies-resources) | Sì |
| [Chiavi di condizione delle policy](#security_iam_service-with-iam-id-based-policies-conditionkeys) | Sì |
| [ACLs](#security_iam_service-with-iam-acls) | No |
| [ABAC (tag nelle policy)](#security_iam_service-with-iam-tags) | Sì |
| [Credenziali temporanee](#security_iam_service-with-iam-roles-tempcreds) | Sì |
| [Autorizzazioni del principale](#security_iam_service-with-iam-principal-permissions) | No |
| [Ruoli di servizio](#security_iam_service-with-iam-roles-service) | Sì |
| [Ruoli collegati al servizio](#security_iam_service-with-iam-roles-service-linked) | No |
*Per avere una panoramica di alto livello su come QLDB e Servizi AWS altri funzionano con la maggior parte delle funzionalità IAM, [Servizi AWS consulta la sezione dedicata all'utilizzo di IAM nella IAM User](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) Guide.*
## Politiche basate sull'identità per QLDB
**Supporta le policy basate su identità:** sì
Le policy basate su identità sono documenti di policy di autorizzazione JSON che è possibile allegare a un'identità (utente, gruppo di utenti o ruolo IAM). Tali policy definiscono le operazioni che utenti e ruoli possono eseguire, su quali risorse e in quali condizioni. Per informazioni su come creare una policy basata su identità, consulta [Definizione di autorizzazioni personalizzate IAM con policy gestite dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) nella *Guida per l'utente IAM*.
Con le policy basate su identità di IAM, è possibile specificare quali operazioni e risorse sono consentite o respinte, nonché le condizioni in base alle quali le operazioni sono consentite o respinte. Non è possibile specificare l'entità principale in una policy basata sull'identità perché si applica all'utente o al ruolo a cui è associato. Per informazioni su tutti gli elementi utilizzabili in una policy JSON, consulta [Guida di riferimento agli elementi delle policy JSON IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) nella *Guida per l'utente di IAM*.
### Esempi di policy basate sull'identità per QLDB
Per visualizzare esempi di policy basate sull'identità QLDB, vedere. [Esempi di policy basate sull'identità per Amazon QLDB](security_iam_id-based-policy-examples.md)
## Politiche basate sulle risorse all'interno di QLDB
**Supporta le policy basate su risorse:** no
Le policy basate su risorse sono documenti di policy JSON che è possibile collegare a una risorsa. Esempi di policy basate sulle risorse sono le *policy di attendibilità dei ruoli* IAM e le *policy dei bucket* Amazon S3. Nei servizi che supportano policy basate sulle risorse, gli amministratori dei servizi possono utilizzarli per controllare l'accesso a una risorsa specifica. Quando è collegata a una risorsa, una policy definisce le operazioni che un principale può eseguire su tale risorsa e a quali condizioni. È necessario [specificare un principale](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) in una policy basata sulle risorse. I principali possono includere account, utenti, ruoli, utenti federati o. Servizi AWS
Per consentire l'accesso multi-account, puoi specificare un intero account o entità IAM in un altro account come principale in una policy basata sulle risorse. L'aggiunta di un principale multi-account a una policy basata sulle risorse rappresenta solo una parte della relazione di trust. Quando il principale e la risorsa sono diversi Account AWS, un amministratore IAM dell'account affidabile deve inoltre concedere all'entità principale (utente o ruolo) l'autorizzazione ad accedere alla risorsa. L'autorizzazione viene concessa collegando all'entità una policy basata sull'identità. Tuttavia, se una policy basata su risorse concede l'accesso a un principale nello stesso account, non sono richieste ulteriori policy basate su identità. Per ulteriori informazioni, consulta [Accesso a risorse multi-account in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) nella *Guida per l'utente IAM*.
## Azioni politiche per QLDB
**Supporta le operazioni di policy:** si
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **principale** può eseguire **operazioni** su quali **risorse**, e in quali **condizioni**.
L'elemento `Action`di una policy JSON descrive le operazioni che è possibile utilizzare per consentire o negare l'accesso a un criterio. Le azioni politiche in genere hanno lo stesso nome dell'operazione AWS API associata. Ci sono alcune eccezioni, ad esempio le *operazioni di sola autorizzazione* che non hanno un'operazione API corrispondente. Esistono anche alcune operazioni che richiedono più operazioni in una policy. Queste operazioni aggiuntive sono denominate *operazioni dipendenti*.
Includi le operazioni in una policy per concedere le autorizzazioni a eseguire l'operazione associata.
*Per visualizzare un elenco di azioni QLDB, [consulta Azioni definite da Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions) nel Service Authorization Reference.*
Le azioni politiche in QLDB utilizzano il seguente prefisso prima dell'azione:
```
qldb
```
Per specificare più operazioni in una sola istruzione, occorre separarle con la virgola.
```
"Action": [
"qldb:action1",
"qldb:action2"
]
```
È possibile specificare più azioni tramite caratteri jolly (\$1). Ad esempio, per specificare tutte le azioni che iniziano con la parola `Describe`, includi la seguente azione:
```
"Action": "qldb:Describe*"
```
Per interagire con l'API dei dati transazionali QLDB *(sessione QLDB*) [eseguendo](ql-reference.md) istruzioni PartiQL su un registro, è necessario concedere l'autorizzazione all'azione come segue. `SendCommand`
```
"Action": "qldb:SendCommand"
```
Per i registri in modalità `STANDARD` autorizzazioni, vedere le autorizzazioni aggiuntive richieste [Riferimento alle autorizzazioni PartiQL](getting-started-standard-mode.md#security_iam_partiql-reference) per ogni comando PartiQL.
Per visualizzare esempi di policy basate sull'identità QLDB, vedere. [Esempi di policy basate sull'identità per Amazon QLDB](security_iam_id-based-policy-examples.md)
## Risorse politiche per QLDB
**Supporta le risorse di policy:** sì
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **principale** può eseguire **operazioni** su quali **risorse**, e in quali **condizioni**.
L'elemento JSON `Resource`della policy specifica l'oggetto o gli oggetti ai quali si applica l'operazione. Le istruzioni devono includere un elemento `Resource`o un elemento `NotResource`. Come best practice, specifica una risorsa utilizzando il suo [nome della risorsa Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). È possibile eseguire questa operazione per operazioni che supportano un tipo di risorsa specifico, note come *autorizzazioni a livello di risorsa*.
Per le azioni che non supportano le autorizzazioni a livello di risorsa, ad esempio le operazioni di elenco, utilizza un carattere jolly (\$1) per indicare che l'istruzione si applica a tutte le risorse.
```
"Resource": "*"
```
*Per visualizzare un elenco dei tipi di risorse QLDB e ARNs relativi, [consulta Resources defined by Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-resources-for-iam-policies) nel Service Authorization Reference.* Per sapere con quali azioni puoi specificare l'ARN di ogni risorsa, consulta [Azioni definite da Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions).
*In QLDB, le risorse principali sono i registri.* *QLDB supporta anche tipi di risorse aggiuntivi*:* tabelle e stream.* Tuttavia, è possibile creare tabelle e stream solo nel contesto di un registro esistente.
Una tabella QLDB è una visualizzazione materializzata di una raccolta non ordinata di revisioni di documenti dal giornale contabile. Nella modalità `STANDARD` autorizzazioni di un registro, è necessario creare politiche IAM che concedano le autorizzazioni per eseguire istruzioni PartiQL su questa risorsa della tabella. Con le autorizzazioni su una risorsa della tabella, puoi eseguire istruzioni che accedono allo stato corrente della tabella. È inoltre possibile interrogare la cronologia delle revisioni della tabella utilizzando la funzione integrata`history()`. Per ulteriori informazioni, consulta [Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB](getting-started-standard-mode.md).
**Nota**
L'`CREATE TABLE`istruzione crea una tabella con un ID univoco e il nome della tabella fornito. Il nome della tabella fornito deve essere univoco tra tutte le tabelle attive. Tuttavia, QLDB consente di disattivare le tabelle, quindi potrebbero esserci più tabelle inattive che condividono lo stesso nome di tabella. Pertanto, le risorse della tabella ARNs si riferiscono all'ID univoco assegnato dal sistema anziché al nome della tabella definito dall'utente.
Ogni libro mastro fornisce anche una risorsa di catalogo definita dal sistema su cui è possibile interrogare per elencare tutte le tabelle e gli indici in un registro. Per ulteriori informazioni sul modello di oggetti dati QLDB, vedere. [Concetti e terminologia fondamentali in Amazon QLDB](ledger-structure.md)
A queste risorse sono ARNs associate informazioni univoche, come illustrato nella tabella seguente.
****
| Tipo di risorsa | ARN |
| --- | --- |
| ledger | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1 |
| table | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/table/\$1\$1TableId\$1 |
| catalog | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/information\$1schema/user\$1tables |
| stream | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:stream/\$1\$1LedgerName\$1/\$1\$1StreamId\$1 |
Ad esempio, per specificare la `myExampleLedger` risorsa nella dichiarazione, utilizzare il seguente ARN.
```
"Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger"
```
Per specificare più risorse in un'unica istruzione, separale ARNs con virgole.
```
"Resource": [
"arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1",
"arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2"
]
```
Per visualizzare esempi di policy basate sull'identità QLDB, vedere. [Esempi di policy basate sull'identità per Amazon QLDB](security_iam_id-based-policy-examples.md)
## Chiavi relative alle condizioni delle policy per QLDB
**Supporta le chiavi di condizione delle policy specifiche del servizio:** sì
Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale **principale** può eseguire **operazioni** su quali **risorse**, e in quali **condizioni**.
L'elemento `Condition`(o *blocco* `Condition`) consente di specificare le condizioni in cui un'istruzione è in vigore. L'elemento `Condition`è facoltativo. È possibile compilare espressioni condizionali che utilizzano [operatori di condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), ad esempio uguale a o minore di, per soddisfare la condizione nella policy con i valori nella richiesta.
Se specifichi più elementi `Condition`in un'istruzione o più chiavi in un singolo elemento `Condition`, questi vengono valutati da AWS utilizzando un'operazione `AND`logica. Se si specificano più valori per una singola chiave di condizione, AWS valuta la condizione utilizzando un'operazione logica. `OR` Tutte le condizioni devono essere soddisfatte prima che le autorizzazioni dell'istruzione vengano concesse.
È possibile anche utilizzare variabili segnaposto quando specifichi le condizioni. Ad esempio, è possibile autorizzare un utente IAM ad accedere a una risorsa solo se è stata taggata con il relativo nome utente IAM. Per ulteriori informazioni, consulta [Elementi delle policy IAM: variabili e tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html) nella *Guida per l'utente di IAM*.
AWS supporta chiavi di condizione globali e chiavi di condizione specifiche del servizio. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le chiavi di [contesto delle condizioni AWS globali nella Guida](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) per l'*utente IAM*.
*Per visualizzare un elenco di chiavi di condizione QLDB, [consulta Condition keys for Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-policy-keys) nel Service Authorization Reference.* Per sapere con quali azioni e risorse puoi utilizzare una chiave di condizione, consulta [Azioni definite da Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions).
Le `PartiQLDropTable` azioni `PartiQLDropIndex` and supportano la chiave di `qldb:Purge` condizione. Questa chiave condizionale filtra l'accesso in base al valore specificato in un'istruzione PartiQL`DROP`. `purge` Tuttavia, QLDB attualmente supporta `purge = true` solo le istruzioni e `DROP INDEX` le istruzioni. `purge = false` `DROP TABLE` Altre azioni QLDB supportano alcune chiavi di condizione globali.
Per visualizzare esempi di policy basate sull'identità QLDB, vedere. [Esempi di policy basate sull'identità per Amazon QLDB](security_iam_id-based-policy-examples.md)
## Elenchi di controllo degli accessi (ACLs) in QLDB
**Supporti ACLs**: No
Le liste di controllo degli accessi (ACLs) controllano quali principali (membri dell'account, utenti o ruoli) dispongono delle autorizzazioni per accedere a una risorsa. ACLs sono simili alle politiche basate sulle risorse, sebbene non utilizzino il formato del documento di policy JSON.
## Controllo degli accessi basato sugli attributi (ABAC) con QLDB
**Supporta ABAC (tag nelle policy):** sì
Il controllo dell'accesso basato su attributi (ABAC) è una strategia di autorizzazione che definisce le autorizzazioni in base agli attributi. *In, questi attributi sono chiamati AWS tag.* Puoi allegare tag a entità IAM (utenti o ruoli) e a molte AWS risorse. L'assegnazione di tag alle entità e alle risorse è il primo passaggio di ABAC. In seguito, vengono progettate policy ABAC per consentire operazioni quando il tag dell'entità principale corrisponde al tag sulla risorsa a cui si sta provando ad accedere.
La strategia ABAC è utile in ambienti soggetti a una rapida crescita e aiuta in situazioni in cui la gestione delle policy diventa impegnativa.
Per controllare l'accesso basato su tag, fornisci informazioni sui tag nell'[elemento condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) di una policy utilizzando le chiavi di condizione `aws:ResourceTag/key-name`, `aws:RequestTag/key-name`o `aws:TagKeys`.
Se un servizio supporta tutte e tre le chiavi di condizione per ogni tipo di risorsa, il valore per il servizio è **Yes (Sì)**. Se un servizio supporta tutte e tre le chiavi di condizione solo per alcuni tipi di risorsa, allora il valore sarà **Parziale**.
Per ulteriori informazioni su ABAC, consulta [Definizione delle autorizzazioni con autorizzazione ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) nella *Guida per l'utente IAM*. Per visualizzare un tutorial con i passaggi per l'impostazione di ABAC, consulta [Utilizzo del controllo degli accessi basato su attributi (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) nella *Guida per l'utente di IAM*.
Per ulteriori informazioni sull'etichettatura delle risorse QLDB, vedere. [Etichettare le risorse Amazon QLDB](tagging.md)
Per visualizzare una policy basata sulle identità di esempio per limitare l'accesso a una risorsa basata su tag su tale risorsa, consulta [Aggiornamento dei registri QLDB in base ai tag](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-update-ledger-tags).
## Utilizzo di credenziali temporanee con QLDB
**Supporta le credenziali temporanee:** sì
Alcune Servizi AWS non funzionano quando accedi utilizzando credenziali temporanee. Per ulteriori informazioni, incluse quelle che Servizi AWS funzionano con credenziali temporanee, consulta la sezione relativa alla [Servizi AWS compatibilità con IAM nella IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) *User Guide*.
Stai utilizzando credenziali temporanee se accedi Console di gestione AWS utilizzando qualsiasi metodo tranne nome utente e password. Ad esempio, quando accedete AWS utilizzando il link Single Sign-On (SSO) della vostra azienda, tale processo crea automaticamente credenziali temporanee. Le credenziali temporanee vengono create in automatico anche quando accedi alla console come utente e poi cambi ruolo. Per ulteriori informazioni sullo scambio dei ruoli, consulta [Passaggio da un ruolo utente a un ruolo IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) nella *Guida per l'utente IAM*.
È possibile creare manualmente credenziali temporanee utilizzando l'API or. AWS CLI AWS È quindi possibile utilizzare tali credenziali temporanee per accedere. AWS AWS consiglia di generare dinamicamente credenziali temporanee anziché utilizzare chiavi di accesso a lungo termine. Per ulteriori informazioni, consulta [Credenziali di sicurezza provvisorie in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html).
## Autorizzazioni principali multiservizio per QLDB
**Supporta l'inoltro delle sessioni di accesso (FAS):** no
Quando utilizzi un utente o un ruolo IAM per eseguire azioni AWS, sei considerato un principale. Quando si utilizzano alcuni servizi, è possibile eseguire un'operazione che attiva un'altra operazione in un servizio diverso. FAS utilizza le autorizzazioni del principale che chiama an Servizio AWS, in combinazione con la richiesta Servizio AWS per effettuare richieste ai servizi downstream. Le richieste FAS vengono effettuate solo quando un servizio riceve una richiesta che richiede interazioni con altri Servizi AWS o risorse per essere completata. In questo caso è necessario disporre delle autorizzazioni per eseguire entrambe le azioni. Per i dettagli delle policy relative alle richieste FAS, consulta [Forward access sessions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).
## Ruoli di servizio per QLDB
**Supporta i ruoli di servizio:** sì
Un ruolo di servizio è un [ruolo IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) che un servizio assume per eseguire operazioni per tuo conto. Un amministratore IAM può creare, modificare ed eliminare un ruolo di servizio dall'interno di IAM. Per ulteriori informazioni, consulta la sezione [Create a role to delegate permissions to an Servizio AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) nella *Guida per l'utente IAM*.
**avvertimento**
La modifica delle autorizzazioni per un ruolo di servizio potrebbe interrompere la funzionalità QLDB. Modifica i ruoli di servizio solo quando QLDB fornisce indicazioni in tal senso.
QLDB supporta i ruoli di servizio per `ExportJournalToS3` le operazioni `StreamJournalToKinesis` e le API, come descritto nella sezione seguente.
### Scelta di un ruolo IAM in QLDB
Quando esportate o trasmettete in streaming blocchi di journal in QLDB, dovete scegliere un ruolo per consentire a QLDB di scrivere oggetti nella destinazione specificata per vostro conto. Se in precedenza hai creato un ruolo di servizio, QLDB ti fornisce un elenco di ruoli tra cui scegliere. È importante scegliere un ruolo che consenta l'accesso alla scrittura nel bucket Amazon S3 specificato per un'esportazione o alla risorsa Amazon Kinesis Data Streams specificata per uno stream. Per ulteriori informazioni, consulta [Autorizzazioni di esportazione del diario in QLDB](export-journal.perms.md) o [Autorizzazioni di streaming in QLDB](streams.perms.md).
**Nota**
Per passare un ruolo a QLDB quando si richiede un'esportazione o uno stream del journal, è necessario disporre delle autorizzazioni per eseguire `iam:PassRole` l'azione sulla risorsa del ruolo IAM. Ciò si aggiunge alle autorizzazioni da eseguire `qldb:ExportJournalToS3` sulla risorsa registro QLDB o `qldb:StreamJournalToKinesis` sulla sottorisorsa del flusso QLDB.
## Ruoli collegati ai servizi per QLDB
**Supporta i ruoli collegati ai servizi:** no
Un ruolo collegato al servizio è un tipo di ruolo di servizio collegato a un. Servizio AWS Il servizio può assumere il ruolo per eseguire un'azione per tuo conto. I ruoli collegati al servizio vengono visualizzati nel tuo account Account AWS e sono di proprietà del servizio. Un amministratore IAM può visualizzare le autorizzazioni per i ruoli collegati ai servizi, ma non modificarle.
[Per informazioni dettagliate sulla creazione o la gestione di ruoli collegati ai servizi, consulta Servizi AWS That work with IAM.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) Trova un servizio nella tabella che include un `Yes` nella colonna **Service-linked role (Ruolo collegato ai servizi)**. Scegli il collegamento **Sì** per visualizzare la documentazione relativa al ruolo collegato ai servizi per tale servizio.