Esempi di policy di Amazon Transcribe basate su identità

Per impostazione predefinita, gli utenti e i ruoli non dispongono dell'autorizzazione per creare o modificare risorse Amazon Transcribe. Inoltre, non sono in grado di eseguire attività utilizzando la AWS Management Console, la AWS Command Line Interface (AWS CLI) o l'API AWS. Per concedere agli utenti l'autorizzazione per eseguire operazioni sulle risorse di cui hanno bisogno, un amministratore IAM può creare policy IAM. L'amministratore può quindi aggiungere le policy IAM ai ruoli e gli utenti possono assumere i ruoli.

Per informazioni su come creare una policy basata su identità IAM utilizzando questi documenti di policy JSON di esempio, consulta Creazione di policy IAM nella Guida per l'utente di IAM.

Per informazioni dettagliate sulle azioni e sui tipi di risorse definiti da Amazon Transcribe, incluso il formato degli ARN per ogni tipo di risorsa, consulta Operazioni, risorse e chiavi di condizione per Amazon Transcribe nella Guida di riferimento per l'autorizzazione del servizio.

Best practice per le policy

Le policy basate su identità determinano se qualcuno può creare, accedere o eliminare risorse Amazon Transcribe nel tuo account. Queste operazioni possono comportare costi aggiuntivi per il proprio Account AWS. Quando crei o modifichi policy basate su identità, segui queste linee guida e suggerimenti:

• Nozioni di base sulle policy gestite da AWS e passaggio alle autorizzazioni con privilegio minimo: per le informazioni di base su come concedere autorizzazioni a utenti e carichi di lavoro, utilizza le policy gestite da AWS che concedono le autorizzazioni per molti casi d'uso comuni. Sono disponibili nel tuo Account AWS. Ti consigliamo pertanto di ridurre ulteriormente le autorizzazioni definendo policy gestite dal cliente di AWS specifiche per i tuoi casi d'uso. Per ulteriori informazioni, consulta Policy gestite da AWS o Policy gestite da AWS per le funzioni di processo nella Guida per l'utente di IAM.

• Applica le autorizzazioni con privilegio minimo: quando imposti le autorizzazioni con le policy IAM, concedi solo le autorizzazioni richieste per eseguire un'attività. Puoi farlo definendo le azioni che possono essere intraprese su risorse specifiche in condizioni specifiche, note anche come autorizzazioni con privilegi minimi. Per ulteriori informazioni sull'utilizzo di IAM per applicare le autorizzazioni, consulta Policy e autorizzazioni in IAM nella Guida per l'utente di IAM.

• Condizioni d'uso nelle policy IAM per limitare ulteriormente l'accesso: per limitare l'accesso a operazioni e risorse puoi aggiungere una condizione alle tue policy. Ad esempio, è possibile scrivere una condizione di policy per specificare che tutte le richieste devono essere inviate utilizzando SSL. Puoi inoltre utilizzare le condizioni per concedere l'accesso alle operazioni di servizio, ma solo se vengono utilizzate tramite uno specifico Servizio AWS, ad esempio AWS CloudFormation. Per ulteriori informazioni, consulta la sezione Elementi delle policy JSON di IAM: condizione nella Guida per l'utente IAM.

• Utilizzo di IAM Access Analyzer per convalidare le policy IAM e garantire autorizzazioni sicure e funzionali: IAM Access Analyzer convalida le policy nuove ed esistenti in modo che aderiscano al linguaggio della policy IAM (JSON) e alle best practice di IAM. IAM Access Analyzer fornisce oltre 100 controlli delle policy e consigli utili per creare policy sicure e funzionali. Per ulteriori informazioni, consulta Convalida delle policy per IAM Access Analyzer nella Guida per l'utente di IAM.

• Richiesta dell'autenticazione a più fattori (MFA): se hai uno scenario che richiede utenti IAM o utenti root nel tuo Account AWS, attiva MFA per una maggiore sicurezza. Per richiedere l'AMF quando vengono chiamate le operazioni API, aggiungi le condizioni MFA alle policy. Per ulteriori informazioni, consulta Configurazione dell'accesso alle API protetto con MFA nella Guida per l'utente di IAM.

Per maggiori informazioni sulle best practice in IAM, consulta Best practice di sicurezza in IAM nella Guida per l'utente di IAM.

Utilizzo di AWS Management Console

Per accedere alla console Amazon Transcribe, è necessario disporre di un set di autorizzazioni minimo. Queste autorizzazioni devono consentire di elencare e visualizzare i dettagli relativi alle risorse Amazon Transcribe nel tuo Account AWS. Se crei una policy basata sull'identità più restrittiva rispetto alle autorizzazioni minime richieste, la console non funzionerà nel modo previsto per le entità (utenti o ruoli) associate a tale policy.

Non sono necessarie le autorizzazioni minime della console per gli utenti che effettuano chiamate solo alla AWS CLI o all'API AWS. Al contrario, concedere l'accesso solo alle operazioni che corrispondono all'operazione API che si sta cercando di eseguire.

Per garantire che un'entità (utenti e ruoli) possa utilizzarli AWS Management Console, allega ad essa una delle seguenti policyAWS gestite.

• AmazonTranscribeFullAccess: concede l'accesso completo per creare, leggere, aggiornare, eliminare ed eseguire tutte leAmazon Transcribe risorse. Consente inoltre l'accesso aiAmazon S3 bucket contranscribe il nome del bucket.

• AmazonTranscribeReadOnlyAccess: consente l'accesso in sola lettura alleAmazon Transcribe risorse in modo da poter ottenere ed elencare i lavori di trascrizione e i vocabolari personalizzati.

Nota

Per esaminare le policy di autorizzazione gestite da, accediIAMAWS Management Console ed esegui la ricerca per nome della policy. Una ricerca per «trascrivi» restituisce entrambe le politiche sopra elencate (AmazonTranscribeReadOnlye AmazonTranscribeFullAccess).

Puoi anche creare le tue policy IAM personalizzate per consentire autorizzazioni per operazioni API di Amazon Transcribe. È possibile allegare queste policy personalizzate alle entità che hanno bisogno di queste autorizzazioni.

Autorizzazioni richieste perIAM i ruoli

Se crei unIAM ruolo da chiamareAmazon Transcribe, deve avere l'autorizzazione per accedere alAmazon S3 bucket. Se applicabile,KMS key deve essere utilizzato anche per crittografare il contenuto del bucket. Per esempio delle policy, fai riferimento alle seguenti sezioni.

Politiche di fiducia

L'IAMentità utilizzata per effettuare la richiesta di trascrizione deve disporre di una politica di fiducia cheAmazon Transcribe consenta di assumere quel ruolo. Utilizza la seguente policyAmazon Transcribe di attendibilità. Tieni presente che se stai effettuando una richiesta di analisi delle chiamate in tempo reale con l'analisi post-chiamata abilitata, devi utilizzare la «Politica di fiducia per l'analisi delle chiamate in tempo reale».

Politica fiduciaria perAmazon Transcribe

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "transcribe.amazonaws.com"
        ]
      },
      "Action": [
        "sts:AssumeRole"
      ],      
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

Politica di fiducia per l'analisi delle chiamate in tempo reale

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "transcribe.streaming.amazonaws.com"
        ]
      },
      "Action": [
        "sts:AssumeRole"
      ],      
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

Amazon S3politica dei bucket di input

La seguente politica fornisce a unIAM ruolo il permesso di accedere ai file dal bucket di input specificato.

{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Action": [
            "s3:GetObject",
            "s3:ListBucket"
        ],
        "Resource": [
            "arn:aws:s3:::DOC-EXAMPLE-INPUT-BUCKET",
            "arn:aws:s3:::DOC-EXAMPLE-INPUT-BUCKET/*"
        ]
    }
}

Amazon S3politica del bucket di output

La seguente politica concede a unIAM ruolo il permesso di scrivere file nel bucket di output specificato.

{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Action": [
            "s3:PutObject"
        ],
        "Resource": [
            "arn:aws:s3:::DOC-EXAMPLE-OUTPUT-BUCKET/*"
        ]
    }
}

Autorizzazioni richieste per le chiavi diAmazon S3 crittografia

Se stai usando un bucketKMS key per crittografare unAmazon S3 bucket, includi quanto segue nellaKMS key politica. Questa operazione fornisce a Amazon Transcribe l'accesso ai contenuti del bucket. Per ulteriori informazioni su come consentire l'accesso aKMS keys, vedi Consentire l'accessoAccount AWS a un utente esternoKMS key nella Guida per gliAWS KMS sviluppatori.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": [
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId"
    }
  ]
}

Consentire agli utenti di visualizzare le loro autorizzazioni

Questo esempio mostra in che modo è possibile creare una policy che consente agli utenti IAM di visualizzare le policy inline e gestite che sono allegate alla relativa identità utente. La policy include le autorizzazioni per completare questa operazione sulla console o a livello di programmazione utilizzando la AWS CLI o l'API AWS.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}

AWS KMSpolicy del contesto di crittografia

La seguente politica concede alIAM ruolo «ExampleRole» il permesso di utilizzare le operazioniAWS KMS Decrypt and Encrypt per questo particolareKMS key. Questa politica funziona solo per le richieste con almeno una coppia di contesti di crittografia, in questo caso "color:indigoBlue». Per ulteriori informazioni sul contesto diAWS KMS crittografia, vedereContesto di crittografia AWS KMS.

{
  "Version": "2012-10-17",
  "Statement": [
      {
          "Effect": "Allow",
          "Principal": {
              "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
          },
          "Action": [
              "kms:Decrypt",
              "kms:DescribeKey",
              "kms:Encrypt",
              "kms:GenerateDataKey*",
              "kms:ReEncrypt*"
          ],
          "Resource": "*",
          "Condition": {
              "StringEquals": {
                  "kms:EncryptionContext:color":"indigoBlue"
              }
           }
        }
   ]
}

Politica di prevenzione del «confused deputy»

Ecco un esempio di politica di assunzione di ruoli che mostra come utilizzareaws:SourceArn eaws:SourceAccount con cuiAmazon Transcribe evitare un problema confuso con il sostituto. Per ulteriori informazioni sulla prevenzione confusa dei supplenti, vederePrevenzione del problema "confused deputy" tra servizi.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "transcribe.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
      ],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

Visualizzazione dei processi di trascrizione in base ai tag

Puoi utilizzare le condizioni nella policy basata sulle identità per controllare l'accesso alle risorse di Amazon Transcribe in base ai tag. Questo esempio mostra come creare una policy che consente di visualizzare un processo di trascrizione. Tuttavia, l'autorizzazione viene concessa solo se il tag del processo di trascrizioneOwner ha il valore del nome utente di quell'utente. Questa policy concede inoltre le autorizzazioni necessarie per completare questa operazione utilizzando ilAWS Management Console.

Puoi collegare questa policy alleIAM entità nel tuo account. Se un ruolo denominatotest-role tenta di visualizzare un processo di trascrizione, il processo di trascrizione deve essere etichettatoOwner=test-role oowner=test-role (i nomi delle chiavi di condizione non fanno distinzione tra maiuscole e minuscole), altrimenti viene negato l'accesso. Per ulteriori informazioni, consulta Elementi delle policyIAM JSON: Condizioni nella Guida per l'IAMutente.

Per ulteriori informazioni sull'aggiunta di tagAmazon Transcribe, consultaAssegnazione di tag alle risorse.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ListTranscriptionJobsInConsole",
            "Effect": "Allow",
            "Action": "transcribe:ListTranscriptionJobs",
            "Resource": "*"
        },
        {
            "Sid": "ViewTranscriptionJobsIfOwner",
            "Effect": "Allow",
            "Action": "transcribe:GetTranscriptionJobs",
            "Resource": "arn:aws:transcribe:*:*:transcription-job/*",
            "Condition": {
                "StringEquals": {"aws:ResourceTag/Owner": "${aws:username}"}
            }
        }
    ]
}