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 Kendra con IAM

Prima di utilizzare IAM per gestire l'accesso ad Amazon Kendra, è necessario comprendere quali funzionalità IAM sono disponibili per l'uso con Amazon Kendra. Per avere una visione di alto livello di come Amazon Kendra AWS e altri servizi funzionano con IAM AWS , consulta Services That Work with IAM nella IAM User Guide.

Politiche basate sull'identità di Amazon Kendra

Con le policy basate su identità di IAM, è possibile specificare quali azioni e risorse sono consentite o rifiutate, nonché le condizioni in base alle quali le azioni sono consentite o rifiutate. Amazon Kendra supporta azioni, risorse e chiavi di condizione specifiche. Per informazioni su tutti gli elementi utilizzati in una policy JSON, consulta Documentazione di riferimento degli elementi delle policy JSON IAM nella Guida per l'utente IAM.

Azioni

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 Actiondi 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.

Le azioni politiche in Amazon Kendra utilizzano il seguente prefisso prima dell'azione:. kendra: Ad esempio, per concedere a qualcuno l'autorizzazione a elencare gli indici Amazon Kendra con ListIndicesl'operazione API, kendra:ListIndices includi l'azione nella sua politica. Le istruzioni della policy devono includere un elemento Action o NotAction. Amazon Kendra definisce il proprio set di azioni che descrivono le attività che puoi eseguire con questo servizio.

Per specificare più azioni in una sola istruzione, separa ciascuna di esse con una virgola come mostrato di seguito:

"Action": [
      "kendra:action1",
      "kendra:action2"

È possibile specificare più azioni tramite caratteri jolly (*). Ad esempio, per specificare tutte le azioni che iniziano con la parola Describe, includi la seguente azione:

"Action": "kendra:Describe*"

Per visualizzare un elenco di azioni Amazon Kendra, consulta Actions Defined by Amazon Kendra nella IAM User Guide.

Risorse

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 Resourcedella policy specifica l'oggetto o gli oggetti ai quali si applica l'operazione. Le istruzioni devono includere un elemento Resourceo un elemento NotResource. Come best practice, specifica una risorsa utilizzando il suo nome della risorsa Amazon (ARN). È 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 (*) per indicare che l'istruzione si applica a tutte le risorse.

"Resource": "*"

La risorsa dell'indice Amazon Kendra ha il seguente ARN:

arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}

Per ulteriori informazioni sul formato di ARNs, consulta Amazon Resource Names (ARNs) e AWS Service Namespaces.

Ad esempio, per specificare un indice nella dichiarazione, utilizzate il GUID dell'indice nel seguente ARN:

"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"

Per specificare tutti gli indici che appartengono a un account specifico, usa il carattere jolly (*):

"Resource": "arn:aws:${Region}:${Account}:index/*"

Alcune azioni di Amazon Kendra, come quelle per la creazione di risorse, non possono essere eseguite su una risorsa specifica. In questi casi, è necessario utilizzare il carattere jolly (*).

"Resource": "*"

Per visualizzare un elenco dei tipi di risorse di Amazon Kendra e ARNs relativi, consulta Resources Defined by Amazon Kendra nella IAM User Guide. Per sapere con quali azioni puoi specificare l'ARN di ogni risorsa, consulta Azioni definite da Amazon Kendra.

Chiavi di condizione

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, ad esempio uguale a o minore di, per soddisfare la condizione nella policy con i valori nella richiesta.

Se specifichi più elementi Conditionin un'istruzione o più chiavi in un singolo elemento Condition, questi vengono valutati da AWS utilizzando un'operazione ANDlogica. 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 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 per l'utente IAM.

Amazon Kendra non fornisce chiavi di condizione specifiche del servizio, ma supporta l'utilizzo di alcune chiavi di condizione globali. Per visualizzare tutte le chiavi di condizione AWS globali, consulta AWS Global Condition Context Keys nella Guida per l'utente IAM.

Esempi

Per visualizzare esempi di politiche basate sull'identità di Amazon Kendra, consulta. Esempi di policy basate sull'identità di Amazon Kendra

Politiche basate sulle risorse di Amazon Kendra

Amazon Kendra non supporta politiche basate sulle risorse.

Elenchi di controllo degli accessi () ACLs

Amazon Kendra non supporta gli elenchi di controllo degli accessi ACLs () per l'accesso AWS a servizi e risorse.

Autorizzazione basata sui tag Amazon Kendra

Puoi associare tag a determinati tipi di risorse Amazon Kendra per autorizzare l'accesso a tali risorse. Per controllare l'accesso in base ai tag, fornisci le informazioni sui tag nell'elemento condition di una policy utilizzando i tasti aws:RequestTag/key-name o aws:TagKeys condition.

La tabella seguente elenca le azioni, i tipi di risorse corrispondenti e le chiavi di condizione per il controllo degli accessi basato su tag. Ogni azione è autorizzata in base ai tag associati al tipo di risorsa corrispondente.

Per informazioni su come etichettare le risorse di Amazon Kendra, consulta. Tag Per un esempio di politica basata sull'identità che limita l'accesso a una risorsa in base ai tag delle risorse, consulta. Esempi di policy basate su tag Per ulteriori informazioni sull'utilizzo dei tag per limitare l'accesso alle risorse, consulta Controlling access using tags nella IAM User Guide.

Ruoli IAM di Amazon Kendra

Un ruolo IAM è un'entità all'interno del tuo AWS account che dispone di autorizzazioni specifiche.

Utilizzo di credenziali temporanee con Amazon Kendra

È possibile utilizzare credenziali temporanee per effettuare l'accesso con la federazione, assumere un ruolo IAM o un ruolo multi-account. Puoi ottenere credenziali di sicurezza temporanee chiamando operazioni AWS STS API come o. AssumeRoleGetFederationToken

Amazon Kendra supporta l'utilizzo di credenziali temporanee.

Ruoli dei servizi

Questa caratteristica consente a un servizio di assumere un ruolo di servizio per conto dell'utente. Questo ruolo consente al servizio di accedere alle risorse in altri servizi per completare un'azione per conto dell'utente. I ruoli dei servizi sono visualizzati nell'account IAM e sono di proprietà dell'account. Ciò significa che un amministratore IAM può modificare le autorizzazioni per questo ruolo. Tuttavia, questo potrebbe pregiudicare la funzionalità del servizio.

Amazon Kendra supporta i ruoli di servizio.

Scelta di un ruolo IAM in Amazon Kendra

Quando crei un indice, chiami l'BatchPutDocumentoperazione, crei un'origine dati o crei una FAQ, devi fornire un ruolo di accesso Amazon Resource Name (ARN) che Amazon Kendra utilizza per accedere alle risorse richieste per tuo conto. Se hai già creato un ruolo, la console Amazon Kendra ti fornisce un elenco di ruoli tra cui scegliere. È importante scegliere un ruolo che consenta l'accesso alle risorse di cui hai bisogno. Per ulteriori informazioni, consulta IAM ruoli di accesso per Amazon Kendra.