Etapa 4: Começando a usar o console do Amazon Rekognition

Esta seção mostra como usar um subconjunto dos recursos do Amazon Rekognition, como detecção de objetos e cenas, análise facial e comparação de faces em um conjunto de imagens. Para ter mais informações, consulte Como o Amazon Rekognition funciona. Você também pode usar a AWS CLI API Amazon Rekognition ou para detectar objetos e cenas, detectar faces e comparar e pesquisar faces. Para ter mais informações, consulte Etapa 3: Começar a usar a API AWS CLI e AWS SDK.

Esta seção também mostra como ver as CloudWatch métricas agregadas da Amazon para o Rekognition usando o console do Rekognition.

Tópicos

• Configurar permissões do console
• Exercício 1: Detecte objetos e cenas (console)
• Exercício 2: Analisar faces em uma imagem (console)
• Exercício 3: Compare faces em imagens (console)
• Exercício 4: Ver métricas agregadas (console)

Configurar permissões do console

Para usar o console do Rekognition, você precisa ter as permissões apropriadas para a função ou conta que está acessando o console. Para algumas operações, o Rekognition criará automaticamente um bucket do Amazon S3 para armazenar arquivos manipulados durante a operação. Se quiser armazenar seus arquivos de treinamento em um bucket diferente desse bucket de console, você precisará de permissões adicionais.

Permitindo acesso ao console

Para usar o console do Rekognition, você pode usar uma política do IAM como a seguinte, que abrange o Amazon S3 e o console do Rekognition. Para obter informações sobre como atribuir permissões, consulte Atribuição de permissões.

                {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RekognitionFullAccess",
            "Effect": "Allow",
            "Action": [
                "rekognition:*"
            ],
            "Resource": "*"
        },
        {
            "Sid": "RekognitionConsoleS3BucketSearchAccess",
            "Effect": "Allow",
            "Action": [
                "s3:ListAllMyBuckets",
                "s3:ListBucket",
                "s3:GetBucketAcl",
                "s3:GetBucketLocation"
            ],
            "Resource": "*"
        },
        {
            "Sid": "RekognitionConsoleS3BucketFirstUseSetupAccess",
            "Effect": "Allow",
            "Action": [
                "s3:CreateBucket",
                "s3:PutBucketVersioning",
                "s3:PutLifecycleConfiguration",
                "s3:PutEncryptionConfiguration",
                "s3:PutBucketPublicAccessBlock",
                "s3:PutCors",
                "s3:GetCors"
            ],
            "Resource": "arn:aws:s3:::rekognition-custom-projects-*"
        },
        {
            "Sid": "RekognitionConsoleS3BucketAccess",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning"
            ],
            "Resource": "arn:aws:s3:::rekognition-custom-projects-*"
        },
        {
            "Sid": "RekognitionConsoleS3ObjectAccess",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:HeadObject",
                "s3:DeleteObject",
                "s3:GetObjectAcl",
                "s3:GetObjectTagging",
                "s3:GetObjectVersion",
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::rekognition-custom-projects-*/*"
        },
        {
            "Sid": "RekognitionConsoleManifestAccess",
            "Effect": "Allow",
            "Action": [
                "groundtruthlabeling:*",
            ],
            "Resource": "*"
        },
        {
            "Sid": "RekognitionConsoleTagSelectorAccess",
            "Effect": "Allow",
            "Action": [
                "tag:GetTagKeys",
                "tag:GetTagValues"
            ],
            "Resource": "*"
        },
        {
            "Sid": "RekognitionConsoleKmsKeySelectorAccess",
            "Effect": "Allow",
            "Action": [
                "kms:ListAliases"
            ],
            "Resource": "*"
        }
    ]
}
            

Acessando buckets externos do Amazon S3

Quando você abre o console do Rekognition pela primeira vez em uma nova AWS região, o Rekognition cria um bucket (bucket do console) que é usado para armazenar arquivos do projeto. Como alternativa, você pode usar seu próprio bucket do Amazon S3 (bucket externo) para carregar as imagens ou o arquivo de manifesto no console. Para usar um bucket externo, adicione o seguinte bloco de políticas à política anterior. Substitua my-bucket pelo nome do bucket.

{
            "Sid": "s3ExternalBucketPolicies",
            "Effect": "Allow",
            "Action": [
                "s3:GetBucketAcl",
                "s3:GetBucketLocation",
                "s3:GetObject",
                "s3:GetObjectAcl",
                "s3:GetObjectVersion",
                "s3:GetObjectTagging",
                "s3:ListBucket",
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::my-bucket*"
            ]
}
            

Atribuindo permissões

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:

• Usuários e grupos no Centro de Identidade do AWS IAM (sucessor do AWS Single Sign-On):

  Crie um conjunto de permissões. Siga as instruções em Criar um conjunto de permissões no Guia do usuário do Centro de Identidade do AWS IAM (sucessor do AWS Single Sign-On).

• Usuários gerenciados no IAM com provedor de identidades:

  Crie um perfil para a federação de identidades. Siga as instruções em Criar um perfil para um provedor de identidades de terceiros (federação) no Guia do usuário do IAM.

• Usuários do IAM:

  • Crie um perfil que seu usuário possa assumir. Siga as instruções em Criação de um perfil para um usuário do IAM no Guia do usuário do IAM.

  • (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em Adição de permissões a um usuário (console) no Guia do usuário do IAM.