As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como o Amazon Textract funciona com o IAM

Antes de usar o IAM para gerenciar o acesso ao Amazon Textract, você deve entender quais recursos do IAM estão disponíveis para uso com o Amazon Textract. Para obter uma visão de alto nível de como o Amazon Textract e outros AWS serviços funcionam com o IAM, consulte AWS Serviços que funcionam com o IAM no Guia do usuário do IAM.

Políticas do Amazon Textract Identity-Based

Com as políticas baseadas em identidade do IAM, é possível especificar ações ou recursos permitidos ou negados, além das condições sob as quais as ações são permitidas ou negadas. O Amazon Textract oferece suporte a ações, recursos e chaves de condição específicas. Para conhecer todos os elementos usados em uma política JSON, consulte Referência de elementos de política JSON do IAM no Guia do usuário do IAM.

Ações

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso a quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O elemento Action de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. Incluem ações em uma política para conceder permissões para executar a operação associada.

As ações assíncronas no Amazon Textract exigem que duas permissões de ação sejam concedidas, uma para ações Iniciar e outra para ações Obter. Além disso, se você estiver usando um bucket do Amazon S3 para passar documentos, precisará conceder acesso de leitura à sua conta.

No Amazon Textract, todas as ações políticas começam com:textract:. Por exemplo, para conceder permissão a alguém para executar uma operação Amazon Textract com a operação Amazon TextractAnalyzeDocument, você inclui a textract:AnalyzeDocument ação na política dessa pessoa. As instruções de política devem incluir um elemento Action ou NotAction. O Amazon Textract define seu próprio conjunto de ações que descrevem as tarefas que você pode realizar com esse serviço.

Para especificar várias ações em uma única declaração, separe-as com vírgulas, conforme a seguir.

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

Você também pode especificar várias ações utilizando caracteres curinga (*). Por exemplo, para especificar todas as ações que começam com a palavra Describe, inclua a ação a seguir:

"Action": "textract:Describe*"

Para obter uma lista das ações do Amazon Textract, consulte Ações definidas pelo Amazon Textract no Guia do usuário do IAM.

Recursos

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso a quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O elemento de política JSON Resource especifica o objeto ou os objetos aos quais a ação se aplica. Como prática recomendada, especifique um recurso usando seu nome do recurso da Amazon (ARN). Para ações que não oferecem compatibilidade com permissões em nível de recurso, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

Para ações que oferecem suporte à permissão em nível de recurso, como as GetAdapter operações AnalyzeDocument e, use o ARN para indicar os recursos:

"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/*"
]    

Chaves de condição

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso a quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.

O elemento Condition especifica quando as instruções são executadas com base em critérios definidos. É possível criar expressões condicionais que usem agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia do usuário do IAM.

O Amazon Textract não fornece nenhuma chave de condição específica do serviço, mas oferece suporte ao uso de algumas chaves de condição globais. Para obter uma lista de todas as chaves de condição AWS globais, consulte Chaves de contexto de condição AWS global no Guia do usuário do IAM.

Exemplos

Para ver exemplos de políticas baseadas em identidade do Amazon Textract, consulte. Exemplos de Identity-Based políticas do Amazon Textract

Políticas do Amazon Textract Resource-Based

O Amazon Textract não oferece suporte a políticas baseadas em recursos.

Autorização baseada em tags do Amazon Textract

Os recursos do Amazon Textract oferecem suporte à marcação de recursos e ao controle do acesso com base em tags. Você pode usar as ListTagsForResource operações TagResource UntagResource, e para gerenciar tags de recursos.

Para controle de acesso com base em tags, você pode consultar AccessTags.

Funções do Amazon Textract IAM

Uma função do IAM é uma entidade em sua AWS conta que tem permissões específicas.

Usando credenciais temporárias com o Amazon Textract

É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir um perfil entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como AssumeRole ou GetFederationToken.

O Amazon Textract oferece suporte ao uso de credenciais temporárias.

Service-Linked Funções

Service-linked as funções permitem que os AWS serviços acessem recursos em outros serviços para concluir uma ação em seu nome. Service-linked as funções aparecem na sua conta do IAM e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para perfis vinculados a serviço.

O Amazon Textract não oferece suporte a funções vinculadas a serviços.

Perfis de serviço

Esse atributo permite que um serviço assuma um perfil de serviço em seu nome. O perfil permite que o serviço acesse recursos em outros serviços para concluir uma ação em seu nome. Os perfis de serviço aparecem em sua conta do IAM e são de propriedade da conta. Isso significa que um administrador do IAM pode alterar as permissões para esse perfil. Porém, fazer isso pode alterar a funcionalidade do serviço.

O Amazon Textract oferece suporte a funções de serviço.

Se você estiver usando uma função de serviço, você deve garantir que sua conta esteja segura limitando o escopo do acesso ao Amazon Textract somente aos recursos que você está usando. Para fazer isso, anexe uma política de confiança à sua função de serviço do IAM. Para obter mais informações, consulte Prevenção Cross-service confusa de delegados.