Pré-requisitos - Amazon Kendra
Inscreva-se para um Conta da AWSCriar um usuário com acesso administrativoAmazon Kendra recursos: AWS CLI, SDK, console

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

Pré-requisitos

As etapas a seguir são pré-requisitos para os exercícios de conceitos básicos. As etapas mostram como configurar sua conta, criar uma IAM função que dê Amazon Kendra permissão para fazer chamadas em seu nome e indexar documentos de um Amazon S3 bucket. Um bucket do S3 é usado como exemplo, mas você pode usar outras fontes de dados compatíveis com o Amazon Kendra . Escolha as Fontes de dados.

Inscreva-se para um Conta da AWS

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

Para se inscrever em um Conta da AWS

  1. Abra a https://portal.aws.amazon.com/billing/inscrição.

  2. Siga as instruções online.

    Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

    Quando você se inscreve em um Conta da AWS, um Usuário raiz da conta da AWSé criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

AWS envia um e-mail de confirmação após a conclusão do processo de inscrição. A qualquer momento, você pode visualizar a atividade atual da sua conta e gerenciar sua conta acessando https://aws.amazon.com/e escolhendo Minha conta.

Criar um usuário com acesso administrativo

Depois de se inscrever em um Conta da AWS, proteja seu Usuário raiz da conta da AWS AWS IAM Identity Center, habilite e crie um usuário administrativo para que você não use o usuário root nas tarefas diárias.

Proteja seu Usuário raiz da conta da AWS

  1. Faça login AWS Management Consolecomo proprietário da conta escolhendo Usuário raiz e inserindo seu endereço de Conta da AWS e-mail. Na próxima página, insira a senha.

    Para obter ajuda ao fazer login usando o usuário-raiz, consulte Fazer login como usuário-raiz no Guia do usuário do Início de Sessão da AWS .

  2. Habilite a autenticação multifator (MFA) para o usuário-raiz.

    Para obter instruções, consulte Habilitar um dispositivo de MFA virtual para seu usuário Conta da AWS raiz (console) no Guia do usuário do IAM.

Criar um usuário com acesso administrativo

  1. Habilita o Centro de Identidade do IAM.

    Para obter instruções, consulte Habilitar o AWS IAM Identity Center no Guia do usuário do AWS IAM Identity Center .

  2. No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.

    Para ver um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como fonte de identidade, consulte Configurar o acesso do usuário com o padrão Diretório do Centro de Identidade do IAM no Guia AWS IAM Identity Center do usuário.

Iniciar sessão como o usuário com acesso administrativo

  • Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.

    Para obter ajuda para fazer login usando um usuário do IAM Identity Center, consulte Como fazer login no portal de AWS acesso no Guia Início de Sessão da AWS do usuário.

Atribuir acesso a usuários adicionais

  1. No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.

    Para obter instruções, consulte Criar um conjunto de permissões no Guia do usuário do AWS IAM Identity Center .

  2. Atribua usuários a um grupo e, em seguida, atribua o acesso de autenticação única ao grupo.

    Para obter instruções, consulte Adicionar grupos no Guia do usuário do AWS IAM Identity Center .

  • Se você estiver usando um bucket do S3 contendo documentos para testar Amazon Kendra, crie um bucket do S3 na mesma região que você está usando. Amazon Kendra Para obter instruções, consulte Como criar um bucket do S3 no Guia do usuário do Amazon Simple Storage Service.

    Carregar os documentos no bucket do S3. Para obter mais informações, consulte Upload, download e gerenciamento de objetos no Manual do usuário do Amazon Simple Storage Service.

    Se estiver usando outra fonte de dados, use um site ativo e credenciais para se conectar à fonte de dados.

Se estiver usando o console, comece com Introdução ao Amazon Kendra console.

Amazon Kendra recursos: AWS CLI, SDK, console

Há certas permissões necessárias para usar a CLI, o SDK ou o console.

Amazon Kendra Para usar a CLI, o SDK ou o console, você deve ter permissões Amazon Kendra para criar e gerenciar recursos em seu nome. Dependendo do seu caso de uso, essas permissões incluem acesso à própria Amazon Kendra API, AWS KMS keys se você quiser criptografar seus dados por meio de uma CMK personalizada, o diretório do Identity Center se quiser se integrar AWS IAM Identity Center ou criar uma experiência de pesquisa. Para obter uma lista completa de permissões para diferentes casos de uso, consulte as Funções do IAM.

Primeiro, anexe as permissões abaixo ao seu usuário do IAM.

JSON
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1644430853544",
      "Action": [
        "kms:CreateGrant",
        "kms:DescribeKey"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430878150",
      "Action": "kendra:*",
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430973706",
      "Action": [
        "sso:AssociateProfile",
        "sso:CreateManagedApplicationInstance",
        "sso:DeleteManagedApplicationInstance",
        "sso:DisassociateProfile",
        "sso:GetManagedApplicationInstance",
        "sso:GetProfile",
        "sso:ListDirectoryAssociations",
        "sso:ListProfileAssociations",
        "sso:ListProfiles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430999558",
      "Action": [
        "sso-directory:DescribeGroup",
        "sso-directory:DescribeGroups",
        "sso-directory:DescribeUser",
        "sso-directory:DescribeUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644431025960",
      "Action": [
        "identitystore:DescribeGroup",
        "identitystore:DescribeUser",
        "identitystore:ListGroups",
        "identitystore:ListUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Segundo, se você usa a CLI ou o SDK, também deve criar uma IAM função e uma política para acessar. Amazon CloudWatch Logs Se você estiver usando o console, não precisará criar uma IAM função e uma política para isso. Você cria isso como parte do procedimento do console.

Para criar uma IAM função e uma política para o AWS CLI SDK que permita Amazon Kendra acessar seu Amazon CloudWatch Logs.

  1. Faça login no AWS Management Console e abra o console do IAM em https://console.aws.amazon.com/iam/.

  2. À esquerda, escolha Políticas e selecione Criar política.

  3. Escolha JSON e substitua a política padrão conforme a seguir:

    JSON
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutMetricData"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "AWS/Kendra"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": [
                "arn:aws:logs:region:account ID:log-group:/aws/kendra/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogStreams",
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:region:account ID:log-group:/aws/kendra/*:log-stream:*"
            ]
        }
    ]
}

  4. Escolha Revisar política.

  5. Nomeie a política como "KendraPolicyForGettingStartedIndex" e clique em Criar política.

  6. No painel de navegação, escolha Funções e Criar função.

  7. Escolha Outra AWS conta e, em seguida, digite o ID da sua conta em ID da conta. Escolha Próximo: permissões.

  8. Escolha a política criada acima e, em seguida, escolha Próximo: tags

  9. Não adicione tag nenhuma. Escolha Próximo: revisar.

  10. Nomeie a função como "KendraRoleForGettingStartedIndex" e clique em Criar função.

  11. Encontre a função que você acabou de criar. Escolha o nome da função para abrir o Resumo. Escolha Relações de confiança e selecione Editar relação de confiança.

  12. Substitua o relacionamento de confiança existente pelo seguinte:

    JSON
    {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Selecione Atualizar política de confiança.

Em terceiro lugar, se você usa um Amazon S3 para armazenar seus documentos ou está usando o S3 para testar Amazon Kendra, você também deve criar uma IAM função e uma política para acessar seu bucket. Se estiver usando outra fonte de dados, consulte Funções do IAM para fontes de dados.

Para criar uma IAM função e uma política que permitam Amazon Kendra acessar e indexar seu Amazon S3 bucket.

  1. Faça login no AWS Management Console e abra o console do IAM em https://console.aws.amazon.com/iam/.

  2. À esquerda, escolha Políticas e selecione Criar política.

  3. Escolha JSON e substitua a política padrão conforme a seguir:

    JSON
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name"
            ],
            "Effect": "Allow"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kendra:BatchPutDocument",
                "kendra:BatchDeleteDocument"
            ],
            "Resource": "arn:aws:kendra:region:account ID:index/*"
        }
    ]
}

  4. Escolha Revisar política.

  5. Nomeie a política KendraPolicyForGettingStartedDataSource "" e escolha Criar política.

  6. No painel de navegação, escolha Funções e Criar função.

  7. Escolha Outra AWS conta e, em seguida, digite o ID da sua conta em ID da conta. Escolha Próximo: permissões.

  8. Escolha a política criada acima e, em seguida, escolha Próximo: tags

  9. Não adicione tag nenhuma. Escolha Próximo: revisar.

  10. Nomeie a função KendraRoleForGettingStartedDataSource "" e escolha Criar função.

  11. Encontre a função que você acabou de criar. Escolha o nome da função para abrir o Resumo. Escolha Relações de confiança e selecione Editar relação de confiança.

  12. Substitua o relacionamento de confiança existente pelo seguinte:

    JSON
    {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Selecione Atualizar política de confiança.

Dependendo de como você deseja usar a Amazon Kendra API, faça o seguinte.