Amazon Transcribe ejemplos de políticas basadas en la identidad

De forma predeterminada, los usuarios y roles no tienen permiso para crear, ver ni modificar recursos de Amazon Transcribe . Tampoco pueden realizar tareas mediante la AWS Management Console, AWS Command Line Interface (AWS CLI) o AWS la API. Un administrador de IAM puedes crear políticas de IAM para conceder permisos a los usuarios para realizar acciones en los recursos que necesitan. A continuación, el administrador puedes añadir las políticas de IAM a roles y los usuarios puedes asumirlos.

Para obtener información acerca de cómo crear una política basada en identidades de IAM mediante el uso de estos documentos de políticas JSON de ejemplo, consulte Creación de políticas de IAM (consola) en la Guía del usuario de IAM.

Para obtener más información sobre las acciones y los tipos de recursos definidos por Amazon Transcribe, incluido el formato de cada uno de los tipos de recursos, consulte Acciones, recursos y claves de condición de Amazon Transcribe en la Referencia de autorización de servicio. ARNs

Temas

Prácticas recomendadas sobre las políticas
Uso del AWS Management Console
Se requieren permisos para los IAM roles
Se requieren permisos para las claves Amazon S3 de cifrado
Cómo permitir a los usuarios consultar sus propios permisos
AWS KMS política de contexto de cifrado
Prevención del suplente confuso
Visualización de trabajos de transcripción basados en etiquetas

Prácticas recomendadas sobre las políticas

Las políticas basadas en la identidad determinan si alguien puede crear Amazon Transcribe recursos de su cuenta, acceder a ellos o eliminarlos. Estas acciones pueden generar costos adicionales para su Cuenta de AWS. Siga estas directrices y recomendaciones al crear o editar políticas basadas en identidades:

Comience con las políticas AWS administradas y avance hacia los permisos con privilegios mínimos: para empezar a conceder permisos a sus usuarios y cargas de trabajo, utilice las políticas AWS administradas que otorgan permisos para muchos casos de uso comunes. Están disponibles en su. Cuenta de AWS Le recomendamos que reduzca aún más los permisos definiendo políticas administradas por el AWS cliente que sean específicas para sus casos de uso. Con el fin de obtener más información, consulta las políticas administradas por AWS o las políticas administradas por AWS para funciones de tarea en la Guía de usuario de IAM.
Aplique permisos de privilegio mínimo: cuando establezca permisos con políticas de IAM, conceda solo los permisos necesarios para realizar una tarea. Para ello, debe definir las acciones que se puedes llevar a cabo en determinados recursos en condiciones específicas, también conocidos como permisos de privilegios mínimos. Con el fin de obtener más información sobre el uso de IAM para aplicar permisos, consulta Políticas y permisos en IAM en la Guía del usuario de IAM.
Utiliza condiciones en las políticas de IAM para restringir aún más el acceso: puedes agregar una condición a sus políticas para limitar el acceso a las acciones y los recursos. Por ejemplo, puedes escribir una condición de políticas para especificar que todas las solicitudes deben enviarse utilizando SSL. También puedes usar condiciones para conceder el acceso a las acciones del servicio si se utilizan a través de una acción específica Servicio de AWS, por ejemplo AWS CloudFormation. Para obtener más información, consulta Elementos de la política de JSON de IAM: Condición en la Guía del usuario de IAM.
Utiliza el analizador de acceso de IAM para validar las políticas de IAM con el fin de garantizar la seguridad y funcionalidad de los permisos: el analizador de acceso de IAM valida políticas nuevas y existentes para que respeten el lenguaje (JSON) de las políticas de IAM y las prácticas recomendadas de IAM. El analizador de acceso de IAM proporciona más de 100 verificaciones de políticas y recomendaciones procesables para ayudar a crear políticas seguras y funcionales. Para más información, consulte Validación de políticas con el Analizador de acceso de IAM en la Guía del usuario de IAM.
Requerir autenticación multifactor (MFA): si tiene un escenario que requiere usuarios de IAM o un usuario raíz en Cuenta de AWS su cuenta, active la MFA para mayor seguridad. Para exigir la MFA cuando se invoquen las operaciones de la API, añada condiciones de MFA a sus políticas. Para más información, consulte Acceso seguro a la API con MFA en la Guía del usuario de IAM.

Para obtener más información sobre las prácticas recomendadas de IAM, consulte Prácticas recomendadas de seguridad en IAM en la Guía del usuario de IAM.

Uso del AWS Management Console

Para acceder a la consola de Amazon Transcribe, debe tener un conjunto mínimo de permisos. Estos permisos deben permitirle enumerar y ver detalles sobre los Amazon Transcribe recursos de su Cuenta de AWS. Si crea una política basada en identidades que sea más restrictiva que el mínimo de permisos necesarios, la consola no funcionará del modo esperado para las entidades (usuarios o roles) que tengan esa política.

No es necesario que concedas permisos mínimos de consola a los usuarios que solo realicen llamadas a la API AWS CLI o a la AWS API. En su lugar, permite el acceso únicamente a las acciones que coincidan con la operación de API que intentan realizar.

Para garantizar que una entidad (usuarios y roles) pueda utilizarla AWS Management Console, adjúntele una de las siguientes políticas AWS administradas.

AmazonTranscribeFullAccess: Otorga acceso completo para crear, leer, actualizar, eliminar y ejecutar todos los Amazon Transcribe recursos. También permite el acceso a los bukets de Amazon S3 utilizando transcribe en el nombre del bucket.
AmazonTranscribeReadOnlyAccess: concede acceso de sólo lectura a los recursos de Amazon Transcribe para que pueda obtener y enumerar los trabajos de transcripción y los vocabularios personalizadas.

nota

Puede revisar las políticas de permisos administradas iniciando sesión en AWS Management Console de IAM y buscando por nombre de política. Si busca «transcribir», obtendrá las dos políticas enumeradas anteriormente (AmazonTranscribeReadOnlyy AmazonTranscribeFullAccess).

También puedes crear tus propias IAM políticas personalizadas para permitir permisos para las acciones de la Amazon Transcribe API. Puede asociar estas políticas personalizadas a las entidades que requieran esos permisos.

Se requieren permisos para los IAM roles

Si crea un IAM rol al que llamar Amazon Transcribe, debe tener permiso para acceder al Amazon S3 bucket. Si corresponde, KMS key también se debe usar para cifrar el contenido del bucket. Consulte las secciones siguientes para obtener ejemplos de políticas.

Políticas de confianza

La IAM entidad que utilices para realizar tu solicitud de transcripción debe tener una política de confianza que Amazon Transcribe permita asumir esa función. Utilice la siguiente política de Amazon Transcribe confianza. Tenga en cuenta que si realiza una solicitud de Call Analytics en tiempo real con el análisis posterior a la llamada activado, debe usar “Política de confianza para Call Analytics en tiempo real”.

Política de confianza para Amazon 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:*"
        }
      }
    }
  ]
}

Política de confianza para Call Analytics en tiempo real


{
  "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 S3 política de cubos de entrada

La siguiente política otorga a un IAM rol permiso para acceder a los archivos del depósito de entrada especificado.


{
    "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 S3 política de depósito de salida

La siguiente política otorga a un IAM rol permiso para escribir archivos en el depósito de salida especificado.


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

Se requieren permisos para las claves Amazon S3 de cifrado

Si utilizas un depósito KMS key para cifrar un Amazon S3 depósito, incluye lo siguiente en la KMS key política. Esto da Amazon Transcribe acceso al contenido del depósito. Para obtener más información sobre cómo permitir el acceso a un elemento externo KMS keys, consulte Permitir el acceso Cuentas de AWS a un elemento externo KMS key en la Guía para AWS KMS desarrolladores.


{
  "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"
    }
  ]
}

Cómo permitir a los usuarios consultar sus propios permisos

En este ejemplo, se muestra cómo podría crear una política que permita a los usuarios de IAM ver las políticas gestionadas e insertadas que se asocian a la identidad de sus usuarios. Esta política incluye permisos para completar esta acción en la consola o mediante programación mediante la API AWS CLI o 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 KMS política de contexto de cifrado

La siguiente política concede al IAM rol «ExampleRole» permiso para utilizar las operaciones de AWS KMS descifrado y cifrado para esta función concreta. KMS key Esta política sólo funciona para las solicitudes con al menos un par de contextos de cifrado, en este caso “color:indigoBlue”. Para obtener más información sobre el contexto AWS KMS de cifrado, consulte. AWS KMS contexto de cifrado


{
  "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"
              }
           }
        }
   ]
}

Prevención del suplente confuso

A continuación, se muestra un ejemplo de una política de asunción de funciones que muestra cómo utilizarla aws:SourceArn y aws:SourceAccount con la Amazon Transcribe que evitar un problema confuso como diputado. Para obtener más información sobre la prevención del suplente confuso, consulte Prevención de la sustitución confusa entre servicios.


{
  "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:*"
        }
      }
    }
  ]
}

Visualización de trabajos de transcripción basados en etiquetas

Puede utilizar las condiciones de su política basada en identidad para controlar el acceso a los recursos de Amazon Transcribe basados en etiquetas. En este ejemplo, se muestra cómo crear una política que permita visualizar un trabajo de transcripción. Sin embargo, los permisos sólo se conceden si la etiqueta del trabajo de transcripción Owner tiene el valor del nombre de usuario de dicho usuario. Esta política también proporciona los permisos necesarios para llevar a cabo esta acción en AWS Management Console.

Puedes adjuntar esta política a las IAM entidades de tu cuenta. Si un rol denominado test-role intenta ver un trabajo de transcripción, el trabajo de transcripción debe estar etiquetado como Owner=test-role o owner=test-role (los nombres de las claves de condición no distinguen mayúsculas de minúsculas); de lo contrario, se le deniega el acceso. Para obtener más información, consulte Elementos de la política JSON de IAM : condición en la Guía del usuario de IAM .

Para obtener más información sobre cómo etiquetar Amazon Transcribe, consulteEtiquetado de recursos.


{
    "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}"}
            }
        }
    ]
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Prevención del suplente confuso

Solución de problemas