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 para configuração AWS Config com o AWS CLI
Antes de configurar AWS com o AWS CLI, você precisa criar um bucket do Amazon S3, um tópico do Amazon SNS e uma função do IAM com políticas anexadas como pré-requisitos. Você pode então usar o AWS CLI para especificar o bucket, o tópico e a função para AWS Config. Siga este procedimento para configurar seus pré-requisitos para o AWS Config.
Tópicos
Etapa 1: criar um bucket do Amazon S3
Se você já tem um bucket do S3 em sua conta e deseja usá-lo, ignore esta etapa e vá para Etapa 2: criar um tópico do Amazon SNS.
Para criar um bucket
Abra o console do Amazon S3 em https://console.aws.amazon.com/s3/
. -
Selecione Criar bucket.
-
Em Nome do bucket, insira um DNS-compliant nome para seu balde.
O nome do bucket deve:
-
Seja exclusivo em todo o Amazon S3.
-
Ter entre 3 e 63 caracteres.
-
Não contém caracteres maiúsculos.
-
Começar com uma letra minúscula ou um número.
Depois de criado o bucket, você não pode mudar seu nome. Garanta que o nome do bucket escolhido seja exclusivo entre todos os nomes de buckets existentes no Amazon S3. Para obter mais informações sobre as regras e convenções de nomeação buckets, consulte Restrições e limitações de buckets no Guia do usuário do Amazon Simple Storage Service.
ImportanteEvite incluir informações confidenciais no nome do bucket. O nome do bucket é visível nos URLs que apontam para os objetos no bucket.
-
-
Em Região, escolha o AWS Região em que você deseja que o bucket resida.
Escolha uma região próxima de você para minimizar a latência e os custos e atender aos requisitos regulatórios. Os objetos armazenados em uma região nunca saem dessa região, a menos que você os transfira para outra região. Para obter uma lista do Amazon S3 AWS Regiões, consulte AWS endpoints de serviço na Referência geral da Amazon Web Services.
-
Em Bucket settings for Block Public Access (Configurações de bucket para o Bloqueio de acesso público), escolha as configurações de bloqueio de acesso público que deseja aplicar ao bucket.
Recomendamos que você deixe todas as configurações ativadas, a menos que saiba que precisa desativar uma ou mais delas para seu caso de uso, como para hospedar um site público. As configurações de bloqueio de acesso público que você habilitar para o bucket também serão ativadas para todos os pontos de acesso criados no bucket. Para obter mais informações sobre como bloquear o acesso público, consulte Usar o bloqueio de acesso público do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.
-
(Opcional) Se você quiser habilitar o bloqueio de objetos do S3:
-
Escolha Configurações avançadas e leia a mensagem exibida.
ImportanteVocê só pode habilitar o bloqueio de objetos do S3 para um bucket ao criá-lo. Se você habilitar o bloqueio de objetos para o bucket, não poderá desabilitá-lo mais tarde. A ativação do bloqueio de objetos também permite o versionamento para o bucket. Depois de habilitar o bloqueio de objetos para o bucket, você deve definir as configurações de bloqueio de objetos antes que qualquer objeto no bucket seja protegido. Para obter mais informações sobre como configurar a proteção de objetos, consulte Configurar o bloqueio de objetos do S3 usando o console do Amazon S3.
-
Se quiser ativar o bloqueio de objetos, insira enable na caixa de texto e escolha Confirm (Confirmar).
Para obter mais informações sobre o recurso Bloqueio de Objetos do S3, consulte Usar o bloqueio de objetos do S3 no Guia do usuário do Amazon Simple Storage Service.
-
-
Escolha Criar bucket.
Quando você usa o AWS SDKs para criar um bucket, você precisa criar um cliente e depois usar o cliente para enviar uma solicitação para criar um bucket. Como prática recomendada, crie o cliente e o bucket na mesma Região da AWS. Se você não especificar uma região ao criar um cliente ou um bucket, o Amazon S3 usará a região padrão Leste dos EUA (Norte da Virgínia).
Para criar um cliente para acessar um endpoint de pilha dupla, você deve especificar um Região da AWS. Para obter mais informações, consulte Endpoints de pilha dupla do Amazon S3. Para obter uma lista dos disponíveis Regiões da AWS, veja Regiões e terminais na Referência geral da AWS.
Quando você cria um cliente, a Região é mapeada para o Region-specific ponto final. O cliente usa esse endpoint para se comunicar com o Amazon S3: s3.. Se a sua região foi lançada após 20 de março de 2019,, seu cliente e bucket devem estar na mesma região. No entanto, é possível usar um cliente na região Leste dos EUA (Norte da Virgínia) para criar um bucket em qualquer região iniciada antes de 20 de março de 2019. Para obter mais informações, consulte Endpoints herdados.<region>.amazonaws.com
Esses AWS Os exemplos de código do SDK realizam as seguintes tarefas:
-
Crie um cliente especificando explicitamente uma região da Região da AWS: no exemplo, o cliente usa o endpoint
s3---us-west-2.amazonaws.com.rproxy.goskope.compara se comunicar com o Amazon S3. É possível especificar qualquer Região da AWS. Para obter uma lista de Regiões da AWS, veja Regiões e terminais na AWS Referência geral. -
Envie uma solicitação de bucket de criação especificando apenas um nome de bucket — O cliente envia uma solicitação ao Amazon S3 para criar o bucket na região onde você criou um cliente.
-
Recupere as informações sobre a localização do bucket. O Amazon S3 armazena as informações de localização do bucket no sub-recurso location que está associado ao bucket.
Os exemplos de código a seguir mostram como usar o CreateBucket.
Você também pode usar um bucket do Amazon S3 de uma conta diferente, mas pode ser necessário criar uma política para o bucket que conceda permissões de acesso para o AWS Config. Para obter informações sobre a concessão de permissões para um bucket do S3, consulte Permissões para o Amazon S3 Bucket para o AWS Config Canal de entrega e, em seguida, vá para Etapa 2: criar um tópico do Amazon SNS.
Etapa 2: criar um tópico do Amazon SNS
Se você já tem um tópico do Amazon SNS em sua conta e deseja usá-lo, ignore esta etapa e vá para Etapa 3: criar um perfil do IAM.
Para criar um tópico do Amazon SNS
Abra o console do Amazon SNS em https://console.aws.amazon.com/sns/v3/home
. -
Execute um destes procedimentos:
-
Se nenhum tópico tiver sido criado em seu Conta da AWS antes, leia a descrição do Amazon SNS na página inicial.
-
Se os tópicos foram criados em seu Conta da AWS antes, no painel de navegação, escolha Tópicos.
-
-
Na página Tópicos, escolha Criar tópico.
-
Na página Criar tópico, na seção Detalhes, faça o seguinte:
-
Em Tipo, escolha um tipo de tópico (Standard ou FIFO).
-
Insira um Nome para o tópico. Para um tópico FIFO, adicione .fifo ao final do nome.
-
(Opcional) Insira um Nome de exibição para o tópico.
-
(Opcional) Para um tópico FIFO, você pode escolher a desduplicação de mensagens baseada em conteúdo para habilitar a desduplicação de mensagens padrão. Para obter mais informações, consulte Desduplicação de mensagens para tópicos FIFO.
-
-
(Opcional) Expanda a seção Criptografia e faça o seguinte. Para obter mais informações, consulte Criptografia em repouso.
-
Selecione Habilitar criptografia.
-
Especifique a chave mestra de cliente (CMK). Para obter mais informações, consulte Termos de chaves.
Para cada tipo de CMK, a Descrição, a Conta e o ARN da CMK são exibidos.
ImportanteSe você não for o proprietário da CMK ou se fizer login com uma conta que não tenha permissões
kms:ListAliasesekms:DescribeKey, não será possível visualizar as informações sobre a CMK no console do Amazon SNS.Peça ao proprietário da CMK para conceder essas permissões a você. Para obter mais informações, consulte Permissões da API do AWS KMS : referência de ações e recursos no Guia do desenvolvedor do AWS Key Management Service .
-
O AWS CMK gerenciada para Amazon SNS (Padrão) alias/aws/sns é selecionado por padrão.
notaLembre-se do seguinte:
-
A primeira vez que você usa o Console de gerenciamento da AWS para especificar o AWS CMK gerenciada para Amazon SNS para um tópico, AWS KMS cria o AWS CMK gerenciada para Amazon SNS.
-
Como alternativa, na primeira vez que você usa o
Publishação sobre um tópico com o SSE ativado, AWS KMS cria o AWS CMK gerenciada para Amazon SNS.
-
-
Para usar uma CMK personalizada do seu Conta da AWS, escolha o Chave mestra do cliente (CMK) campo e, em seguida, escolha a CMK personalizada na lista.
notaPara obter instruções sobre como criar CMKs personalizadas, consulte Creating Keys (“Criar chaves”) no Guia do desenvolvedor do AWS Key Management Service .
-
Para usar um ARN CMK personalizado do seu Conta da AWS ou de outro AWS conta, insira-a no Chave mestra do cliente (CMK) campo.
-
-
-
(Opcional) Por padrão, somente o proprietário do tópico pode publicar ou assinar o tópico. Para configurar permissões de acesso adicionais, expanda a seção Política de acesso. Para obter mais informações, consulte Gerenciamento de identidade e acesso no Amazon SNS e Casos de exemplo do controle de acesso do Amazon SNS.
notaQuando você cria um tópico usando o console, a política padrão usa a chave de condição
aws:SourceOwner. Essa chave é semelhante aaws:SourceAccount. -
(Opcional) Para configurar como o Amazon SNS repete as tentativas de entrega de mensagens que falharam, expanda a Política de nova tentativa de entrega (HTTP/S) seção. Para obter mais informações, consulte Novas tentativas de entrega de mensagens do Amazon SNS.
-
(Opcional) Para configurar como o Amazon SNS registra a entrega de mensagens para CloudWatch, expanda o Registro do status de entrega seção. Para obter mais informações, consulte Status de entrega de mensagens do Amazon SNS.
-
(Opcional) Para adicionar tags de metadados ao tópico, expanda a seção Tags, insira uma Chave e um Valor (opcional) e escolha Adicionar tag. Para obter mais informações, consulte Marcação de tópicos do Amazon SNS.
-
Escolha Criar tópico.
O tópico é criado e o
MyTopica página é exibida.O nome do tópico, o ARN (opcional), o nome de exibição e o proprietário do tópico e o ID da conta da AWS estão disponíveis na seção Detalhes.
-
Copie o ARN do tópico para a área de transferência, por exemplo:
arn:aws:sns:us-east-2:123456789012:MyTopic
Como inscrever um endereço de e-mail no tópico do Amazon SNS
Abra o console do Amazon SNS em https://console.aws.amazon.com/sns/v3/home
. -
No painel de navegação à esquerda, selecione Assinaturas.
-
Na página Assinaturas, escolha Criar assinatura.
-
Na página Criar assinatura, na seção Detalhes, faça o seguinte:
-
Em Topic ARN (ARN do tópico), escolha o nome do recurso da Amazon (ARN) de um tópico.
-
Em Protocol (Protocolo), escolha um tipo de endpoint. Os tipos de endpoint disponíveis são:
-
nota
Para se inscrever em um tópico FIFO do SNS, escolha esta opção.
-
Em Endpoint, insira o valor do endpoint, como um endereço de e-mail ou o ARN de uma fila do Amazon SQS.
-
Somente endpoints do Firehose: em ARN da função de assinatura, especifique o ARN do perfil do IAM que você criou para gravar em fluxos de entrega do Firehose. Para obter mais informações, consulte Pré-requisitos para assinatura de fluxos de entrega do Firehose para tópicos do Amazon SNS.
-
(Opcional) Para Firehose, Amazon SQS, HTTP/S endpoints, você também pode ativar a entrega de mensagens brutas. Para obter mais informações, consulte Entrega de mensagens brutas do Amazon SNS.
-
(Opcional) Para configurar uma política de filtros, expanda a seção Subscription filter policy (Política de filtro de assinatura). Para obter mais informações, consulte Políticas de filtro de assinatura do Amazon SNS.
-
(Opcional) Para configurar uma fila de mensagens não entregues para a assinatura, expanda a seção Redrive policy (dead-letter queue) (Política de redirecionamento (fila de mensagens não entregues)). Para obter mais informações, consulte Filas de mensagens não entregues (DLQs) do Amazon SNS.
-
Selecione Criar assinatura.
O console cria a assinatura e abre a página Details (Detalhes) da assinatura.
-
Para usar um AWS SDK, você deve configurá-lo com suas credenciais. Para obter mais informações, consulte The shared config and credentials files (“Os arquivos compartilhados de configuração e de credenciais”) no Guia de referência de AWS SDKs e ferramentas.
Os exemplos de código a seguir mostram como usar o CreateTopic.
Você também pode usar um tópico do Amazon SNS em uma conta diferente, mas nesse caso, pode ser necessário criar uma política para o tópico que conceda permissões de acesso para o AWS Config. Para informações sobre a concessão de permissões para um tópico do Amazon SNS, consulte Permissões para o tópico do Amazon SNS e, em seguida, vá para Etapa 3: criar um perfil do IAM.
Etapa 3: criar um perfil do IAM
(Recomendado) Use o AWS Config função vinculada ao serviço
Recomenda-se usar o AWS Config função vinculada ao serviço: AWSServiceRoleForConfig. Service-linked as funções são predefinidas e incluem todas as permissões que AWS Config requer ligar para outro Serviços da AWS. O AWS Config a função vinculada ao serviço é necessária para gravadores de configuração vinculados ao serviço.
Para obter mais informações, consulte Usando Service-Linked Funções para AWS Config.
Você pode usar o console do IAM para criar uma função do IAM que conceda AWS Config permissões para acessar seu bucket do Amazon S3, acessar seu tópico do Amazon SNS e obter detalhes de configuração para suporte AWS recursos. Quando você usa o console para criar um perfil do IAM, o AWS Config associa automaticamente as permissões necessárias ao perfil para você.
Se você já usou um AWS serviço que usa AWS Config (como AWS Security Hub ou AWS Torre de Controle) e um AWS Config a função já foi criada, você deve se certificar de que a função do IAM que você usa ao configurar AWS Config mantém os mesmos privilégios mínimos que os já criados AWS Config papel em ordem para o outro AWS serviço para continuar funcionando conforme o esperado.
Por exemplo, se AWS A Control Tower tem uma função de IAM que permite AWS Config para ler objetos do Amazon S3, você deve garantir que as mesmas permissões sejam concedidas dentro da função do IAM que você usa ao configurar AWS Config. Caso contrário, isso pode interferir com AWS Operações da Torre de Controle.
Para obter mais informações sobre as funções do IAM para AWS Config, veja AWS Gerenciamento de identidade e acesso.
Para criar uma função para um AWS service
Faça login no Console de gerenciamento da AWS e abra o console do IAM em https://console.aws.amazon.com/iam/
. -
No painel de navegação do console do IAM, escolha Roles (Perfis) e, em seguida, Create role (Criar perfil).
-
Em Select trusted entity (Selecionar entidade confiável), escolha AWS Service (Serviço).
-
Escolha o caso de uso que você deseja AWS Config: Configuração - Personalizável, Configuração - Organizações, Configuração, ou Configuração - Pacotes de conformidade. Em seguida, escolha Próximo.
-
Na página Nomear, revisar e criar, analise os detalhes do perfil e selecione Criar perfil.
Para usar um AWS SDK, você deve configurá-lo com suas credenciais. Para obter mais informações, consulte The shared config and credentials files (“Os arquivos compartilhados de configuração e de credenciais”) no Guia de referência de AWS SDKs e ferramentas.
Os exemplos de código a seguir mostram como usar o CreateRole.