Conceder acesso programático - Amazon Rekognition

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

Conceder acesso programático

Você pode executar os exemplos de código da AWS CLI e neste guia em seu computador local ou em outros ambientes AWS, como uma instância do Amazon Elastic Compute Cloud. Para executar os exemplos, você precisa conceder acesso às operações do AWS SDK que os exemplos usam.

Executando código em seu computador local

Para executar código em um computador local, recomendamos que você use credenciais de curto prazo para conceder a um usuário acesso às operações do AWS SDK. Para obter informações específicas sobre como executar os exemplos de código da AWS CLI e em um computador local, consulte Usando um perfil em seu computador local.

Os usuários precisam de acesso programático se quiserem interagir com a AWS de fora do AWS Management Console. A forma de conceder acesso programático depende do tipo de usuário que está acessando a AWS.

Para conceder acesso programático aos usuários, selecione uma das seguintes opções:

Qual usuário precisa de acesso programático? Para Por

Identificação da força de trabalho

(Usuários gerenciados no Centro de Identidade do IAM)

Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

IAM Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS. Siga as instruções em Como usar credenciais temporárias com recursos da AWS no Guia do usuário do IAM.
IAM

(Não recomendado)

Use credenciais de longo prazo para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

Usando um perfil em seu computador local

É possível executar a AWS CLI e os exemplos de código neste guia com as credenciais de curto prazo que você criou em Executando código em seu computador local. Para obter as credenciais e outras informações de configurações, os exemplos usam um perfil chamado profile-name, por exemplo:

session = boto3.Session(profile_name="profile-name") rekognition_client = session.client("rekognition")

O usuário que o perfil representa deve ter permissões para chamar as operações do SDK do Rekognition e outras operações do AWS SDK necessárias pelos exemplos.

Para criar um perfil que funcione com a AWS CLI e os exemplos de código, escolha uma das opções a seguir. Verifique se o nome do perfil que você criou é profile-name.

nota

Você pode usar o código para obter credenciais de curto prazo. Para obter mais informações, consulte Mudar para um perfil do IAM (API da AWS). Para o IAM Identity Center, obtenha as credenciais de curto prazo para uma função seguindo as instruções em Obter credenciais de perfil do IAM para acesso à CLI.

Executar código em ambientes AWS

Você não deve usar credenciais de usuário para assinar chamadas de AWS SDK em ambientes da AWS, como código de produção em execução em uma função AWS Lambda. Em vez disso, você configura uma função que define as permissões de que seu código precisa. Em seguida, você atribui a função ao ambiente em que seu código é executado. A forma como você atribui a função e disponibiliza credenciais temporárias varia de acordo com o ambiente em que seu código é executado:

  • AWS Lambda função — Use as credenciais temporárias que o Lambda fornece automaticamente à sua função ao assumir a função de execução da função do Lambda. As credenciais estão disponíveis nas variáveis de ambiente do Lambda. Você não precisa especificar um perfil. Para obter mais informações, consulte Função de execução do Lambda.

  • Amazon EC2 — Use o provedor de credenciais de endpoint de metadados da instância Amazon EC2. O provedor gera e atualiza automaticamente as credenciais para você usando o perfil da instância do Amazon EC2 que você anexa à instância do Amazon EC2. Para obter mais informações, consulte Usar um perfil do IAM para conceder permissões a aplicativos executados em instâncias do Amazon EC2

  • Amazon Elastic Container Service — Use o provedor de credenciais do Container. O Amazon ECS envia e atualiza as credenciais para um endpoint de metadados. Um perfil do IAM de tarefa que você especifica fornece uma estratégia para gerenciar as credenciais que seu aplicativo usa. Para obter mais informações, consulte Interagir com os serviços da AWS.

Para obter mais informações sobre provedores de credenciais, consulte Provedores de credenciais padronizados.