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

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

Politiche di Amazon Textract Identity-Based

Con le policy IAM basate su identità, puoi specificare operazioni e risorse consentite o rifiutate, nonché le condizioni in base alle quali le operazioni sono consentite o rifiutate. Amazon Textract 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 entità 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 in una policy. Includere le operazioni in una policy per concedere le autorizzazioni di eseguire l’operazione associata.

Le azioni asincrone in Amazon Textract richiedono l'assegnazione di due autorizzazioni di azione, una per le azioni Start e una per le azioni Get. Inoltre, se utilizzi un bucket Amazon S3 per passare i documenti, dovrai concedere al tuo account l'accesso in lettura.

In Amazon Textract, tutte le azioni relative alle policy iniziano con:. textract: Ad esempio, per concedere a qualcuno il permesso di eseguire un'operazione Amazon Textract con l'operazione Amazon TextractAnalyzeDocument, includi l'textract:AnalyzeDocumentazione nella sua politica. Le istruzioni della policy devono includere un elemento Action o NotAction. Amazon Textract definisce un proprio set di azioni che descrivono le attività che puoi eseguire con questo servizio.

Per specificare più operazioni  in una singola istruzione, separarle con una virgola come mostrato di seguito.

"Action": [
      "textract:action1",
      "textract:action2"

Puoi specificare più operazioni tramite caratteri jolly (*). Ad esempio, per specificare tutte le operazioni che iniziano con la parola Describe, includi la seguente operazione.

"Action": "textract:Describe*"

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

Resources

Gli amministratori possono utilizzare le policy AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale entità 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. Come best practice, specifica una risorsa utilizzando il suo nome della risorsa Amazon (ARN). Per le azioni che non supportano le autorizzazioni a livello di risorsa, si utilizza un carattere jolly (*) per indicare che l’istruzione si applica a tutte le risorse.

"Resource": "*"

Per le azioni che supportano l'autorizzazione a livello di risorsa, come GetAdapter le operazioni AnalyzeDocument e, utilizza l'ARN per indicare le risorse:

"Resource": [
  # Adapter ARN
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>",
  # Adapter version ARN
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>/versions/<version>",
  # Use wildcard to indicate all versions under an adapter
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>/versions/*"
]    

Chiavi di condizione

Gli amministratori possono utilizzare le politiche AWS JSON per specificare chi ha accesso a cosa. In altre parole, quale entità principale può eseguire operazioni su quali risorse e in quali condizioni.

L’elemento Condition specifica quando le istruzioni vengono eseguite in base a criteri definiti. È 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. Per vedere tutte le chiavi di condizione AWS globali, consulta le chiavi di contesto delle condizioni AWS globali nella IAM User Guide.

Amazon Textract non fornisce alcuna chiave di condizione specifica del servizio, ma supporta l'utilizzo di alcune chiavi di condizione globali. Per un elenco di tutte le chiavi di condizione AWS globali, consulta AWS Global Condition Context Keys nella IAM User Guide.

Esempi

Per visualizzare esempi di policy basate sull'identità di Amazon Textract, consulta. Esempi di Identity-Based policy di Amazon Textract

Politiche di Amazon Textract Resource-Based

Amazon Textract non supporta politiche basate sulle risorse.

Autorizzazione basata sui tag Amazon Textract

Le risorse di Amazon Textract supportano l'etichettatura delle risorse e il controllo dell'accesso in base ai tag. Puoi utilizzare le ListTagsForResource operazioni TagResource UntagResource, e per gestire i tag delle risorse.

Per il controllo degli accessi basato sui tag, puoi fare riferimento a AccessTags.

Ruoli IAM di Amazon Textract

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

Utilizzo di credenziali temporanee con Amazon Textract

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

Amazon Textract supporta l'utilizzo di credenziali temporanee.

Service-Linked Ruoli

Service-linked i ruoli consentono ai AWS servizi di accedere alle risorse di altri servizi per completare un'azione per conto dell'utente. Service-linked i ruoli appaiono nel tuo account IAM e sono di proprietà del servizio. Un amministratore IAM può visualizzare le autorizzazioni per i ruoli collegati ai servizi, ma non può modificarle.

Amazon Textract non supporta i ruoli collegati ai servizi.

Ruoli dei servizi

Questa funzionalità 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 Textract supporta i ruoli di servizio.

Se utilizzi un ruolo di servizio, assicurati che il tuo account sia sicuro limitando l'ambito di accesso ad Amazon Textract alle sole risorse che stai utilizzando. A tale scopo, allega una policy di fiducia al tuo ruolo di servizio IAM. Per ulteriori informazioni, consulta Prevenzione dei sostituti Cross-service confusi.