Exemplos de políticas baseadas em identidade do Amazon CloudFront
Por padrão, usuários e funções não têm permissão para criar nem modificar recursos do CloudFront. Eles também não podem executar tarefas usando o AWS Management Console, a AWS Command Line Interface (AWS CLI) ou a API AWS. Para conceder permissões de usuários para executar ações nos recursos que eles precisam, um administrador do IAM pode criar políticas do IAM. O administrador pode então adicionar as políticas do IAM aos perfis, e os usuários podem assumir os perfis.
Para saber como criar uma política baseada em identidade do IAM usando esses exemplos de documento de política JSON, consulte Criação de políticas do IAM no Guia do Usuário do IAM.
Para obter detalhes sobre ações e tipos de recurso definidos pelo CloudFront, por exemplo, o formato dos ARNs para cada um dos tipos de recurso, consulte Ações, recursos e chaves de condição do Amazon CloudFront na Referência de autorização do serviço.
Tópicos
- Melhores práticas de política
- Usar o console do CloudFront
- Permitir que usuários visualizem suas próprias permissões
- Permissões para acessar o CloudFront programaticamente
- Permissões necessárias para usar o console do CloudFront
- Políticas gerenciadas (predefinidas) da AWS para o CloudFront
- Exemplos de política gerenciada pelo cliente
Melhores práticas de política
As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir recursos do CloudFront em sua conta. Essas ações podem incorrer em custos para seus Conta da AWS. Ao criar ou editar políticas baseadas em identidade, siga estas diretrizes e recomendações:
-
Comece a usar as políticas gerenciadas pela AWS e avance para as permissões de privilégio mínimo: para começar a conceder permissões a seus usuários e workloads, use as políticas gerenciadas pela AWS que concedem permissões para muitos casos de uso comuns. Elas estão disponíveis em seus Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo cliente AWS específicas para seus casos de uso. Para obter mais informações, consulte Políticas Gerenciadas pela AWS ou AWS Políticas Gerenciadas para Funções de Trabalho no Guia do Usuário do IAM.
-
Aplique permissões de privilégio mínimo: ao definir permissões com as políticas do IAM, conceda apenas as permissões necessárias para executar uma tarefa. Você faz isso definindo as ações que podem ser executadas em atributos específicos sob condições específicas, também conhecidas como permissões de privilégio mínimo. Para obter mais informações sobre como usar o IAM para aplicar permissões, consulte Políticas e Permissões no IAM no Guia do Usuário do IAM.
-
Utilize condições nas políticas do IAM para restringir ainda mais o acesso: você pode adicionar uma condição às políticas para limitar o acesso a ações e recursos. Por exemplo, você pode gravar uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. Você também pode usar condições para conceder acesso a ações de serviço, se elas forem usadas por meio de um Serviço da AWS específico, como o AWS CloudFormation. Para obter mais informações, consulte Condição de Elementos de Política JSON do IAM no Guia do Usuário do IAM.
-
Use o IAM Access Analyzer para validar suas políticas do IAM para garantir permissões seguras e funcionais: o IAM Access Analyzer valida as políticas novas e existentes para que elas sigam o idioma de política do IAM (JSON) e as práticas recomendadas do IAM. O IAM Access Analyzer oferece mais de 100 verificações de política e ações recomendadas para ajudar você a criar políticas seguras e funcionais. Para obter mais informações, consulte Validação de Política do IAM Access Analyzer no Guia do Usuário do IAM.
-
Require multi-factor authentication (MFA) (Exigir autenticação multifator (MFA)): se houver um cenário que exija usuários do IAM ou um usuário raiz em sua Conta da AWS, ative a MFA para obter segurança adicional. Para exigir MFA quando as operações de API forem chamadas, adicione condições de MFA às suas políticas. Para obter mais informações, consulte Configurando Acesso à API Protegido por MFA no Guia do Usuário do IAM.
Para obter mais informações sobre as práticas recomendadas do IAM, consulte Práticas Recomendadas de Segurança no IAM no Guia do Usuário do IAM.
Usar o console do CloudFront
Para acessar o console do Amazon CloudFront, você deve ter um conjunto mínimo de permissões. Essas permissões devem dar autorização para que você liste e visualize detalhes sobre os recursos do CloudFront em sua Conta da AWS. Se você criar uma política baseada em identidade que seja mais restritiva do que as permissões mínimas necessárias, o console não funcionará como pretendido para entidades (usuários ou perfis) com essa política.
Não é necessário conceder permissões mínimas do console para usuários fazendo chamadas somente para AWS CLI ou para a API do AWS. Em vez disso, permita o acesso somente a ações que correspondam a operação de API que estiverem tentando executar.
Para garantir que usuários e perfis ainda possam usar o console do CloudFront, anexe também a política
ou ConsoleAccess
gerenciada pela AWS do CloudFront às entidades. Para obter mais informações, consulte Adicionando Permissões a um Usuário no Guia do Usuário do IAM.ReadOnly
Permitir que usuários visualizem suas próprias permissões
Este exemplo mostra como criar uma política que permita que os usuários do IAM visualizem as políticas gerenciadas e em linha anexadas a sua identidade de usuário. Essa política inclui permissões para concluir essa ação no console ou de forma programática usando a AWS CLI ou a AWS API.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "ViewOwnUserInfo", "Effect": "Allow", "Action": [ "iam:GetUserPolicy", "iam:ListGroupsForUser", "iam:ListAttachedUserPolicies", "iam:ListUserPolicies", "iam:GetUser" ], "Resource": ["arn:aws:iam::*:user/${aws:username}"] }, { "Sid": "NavigateInConsole", "Effect": "Allow", "Action": [ "iam:GetGroupPolicy", "iam:GetPolicyVersion", "iam:GetPolicy", "iam:ListAttachedGroupPolicies", "iam:ListGroupPolicies", "iam:ListPolicyVersions", "iam:ListPolicies", "iam:ListUsers" ], "Resource": "*" } ] }
Permissões para acessar o CloudFront programaticamente
Veja a seguir uma política de permissões. O Sid
, ou o ID de instrução, é opcional.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowAllCloudFrontPermissions", "Effect": "Allow", "Action": ["cloudfront:*"], "Resource": "*" } ] }
A política concede permissões para executar todas as operações do CloudFront, o que é suficiente para acessar o CloudFront de forma programática. Se estiver usando o console para acessar o CloudFront, consulte Permissões necessárias para usar o console do CloudFront.
Para visualizar uma lista de ações e o ARN que podem ser especificadas para conceder ou negar permissão para usar cada ação, consulte Ações, recursos e chaves de condição do Amazon CloudFront na Referência de autorização do serviço.
Permissões necessárias para usar o console do CloudFront
Para permitir acesso total ao console do CloudFront, conceda as permissões na seguinte política de permissões:
{ "Version": "2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "acm:ListCertificates", "cloudfront:*", "cloudwatch:DescribeAlarms", "cloudwatch:PutMetricAlarm", "cloudwatch:GetMetricStatistics", "elasticloadbalancing:DescribeLoadBalancers", "iam:ListServerCertificates", "sns:ListSubscriptionsByTopic", "sns:ListTopics", "waf:GetWebACL", "waf:ListWebACLs" ], "Resource":"*" }, { "Effect":"Allow", "Action":[ "s3:ListAllMyBuckets", "s3:PutBucketPolicy" ], "Resource":"arn:aws:s3:::*" } ] }
Veja por que as permissões são necessárias:
acm:ListCertificates
-
Permite que você visualize uma lista de certificados do ACM quando estiver criando e atualizando distribuições por meio do console do CloudFront e quiser configurar o CloudFront para exigir HTTPS entre o visualizador e o CloudFront ou entre o CloudFront e a origem.
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
cloudfront:*
-
Permite executar todas as ações do CloudFront.
cloudwatch:DescribeAlarms
ecloudwatch:PutMetricAlarm
-
Permite criar e exibir alarmes do CloudWatch no console do CloudFront. Consulte também
sns:ListSubscriptionsByTopic
esns:ListTopics
.Essas permissões não serão necessárias se você não estiver usando o console do CloudFront.
cloudwatch:GetMetricStatistics
-
Permite que o CloudFront renderize as métricas do CloudWatch no console do CloudFront.
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
elasticloadbalancing:DescribeLoadBalancers
-
Quando estiver criando e atualizando distribuições, permite que você visualize uma lista de balanceadores de carga do Elastic Load Balancing na lista de origens disponíveis.
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
iam:ListServerCertificates
-
Permite que você visualize uma lista de certificados no repositório de certificados do IAM quando estiver criando e atualizando distribuições por meio do console do CloudFront e quiser configurar o CloudFront para exigir HTTPS entre o visualizador e o CloudFront ou entre o CloudFront e a origem.
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
s3:ListAllMyBuckets
-
Quando estiver criando e atualizando distribuições, permite que você execute as seguintes operações:
-
Visualizar uma lista de buckets do S3 na lista de origens disponíveis.
-
Visualizar uma lista de buckets do S3 nos quais você pode salvar logs de acesso..
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
-
S3:PutBucketPolicy
-
Ao criar ou atualizar distribuições que restringem o acesso a buckets do S3, permite que um usuário atualize a política do bucket para conceder acesso à identidade de acesso de origem do CloudFront. Para ter mais informações, consulte Usar uma identidade de acesso à origem (herdada, não recomendado).
Essa permissão não é necessária se você não estiver usando o console do CloudFront.
sns:ListSubscriptionsByTopic
esns:ListTopics
-
Ao criar alarmes do CloudWatch no console do CloudFront, permite escolher um tópico do SNS para notificações.
Essas permissões não serão necessárias se você não estiver usando o console do CloudFront.
waf:GetWebACL
ewaf:ListWebACLs
-
Permite exibir uma lista de ACLs da Web do AWS WAF no console do CloudFront.
Essas permissões não serão necessárias se você não estiver usando o console do CloudFront.
Políticas gerenciadas (predefinidas) da AWS para o CloudFront
A AWS aborda muitos casos de uso comuns fornecendo políticas autônomas do IAM que são criadas e administradas pela AWS. Essas políticas gerenciadas pela AWS concedem as permissões indispensáveis para casos de uso comuns para que você não precise investigar quais permissões são necessárias. Para obter mais informações, consulte Políticas gerenciadas da AWS no Guia do usuário do IAM. Para o CloudFront, o IAM fornece duas políticas gerenciadas:
-
CloudFrontFullAccess: concede acesso total aos recursos do CloudFront.
Importante
Para que o CloudFront crie e salve logs de acesso, você precisa conceder outras permissões. Para obter mais informações, consulte Permissões necessárias para configurar o registro em log padrão e acessar os arquivos de log.
-
CloudFrontReadOnlyAccess: concede acesso somente leitura aos recursos do CloudFront.
Exemplos de política gerenciada pelo cliente
Você pode criar suas próprias políticas personalizadas do IAM para conceder permissões a ações da API do CloudFront. Você pode anexar essas políticas personalizadas a usuários ou grupos do IAM que exijam as permissões especificadas. Essas políticas funcionam quando você está usando a API do CloudFront, os AWS SDKs ou a AWS CLI. Os exemplos a seguir mostram permissões para alguns casos de uso comuns. Para a política que concede acesso total a um usuário ao CloudFront, consulte Permissões necessárias para usar o console do CloudFront.
Exemplos
Exemplo 1: permitir acesso de leitura a todas as distribuições
A política a seguir concede ao usuário permissões para visualizar todas as distribuições no console do CloudFront:
{ "Version": "2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "acm:ListCertificates", "cloudfront:GetDistribution", "cloudfront:GetDistributionConfig", "cloudfront:ListDistributions", "cloudfront:ListCloudFrontOriginAccessIdentities", "elasticloadbalancing:DescribeLoadBalancers", "iam:ListServerCertificates", "sns:ListSubscriptionsByTopic", "sns:ListTopics", "waf:GetWebACL", "waf:ListWebACLs" ], "Resource":"*" }, { "Effect":"Allow", "Action":[ "s3:ListAllMyBuckets" ], "Resource":"arn:aws:s3:::*" } ] }
Exemplo 2: permitir criar, atualizar e excluir distribuições
A política a seguir concede aos usuários permissão para criar, atualizar e excluir distribuições usando o console do CloudFront:
{ "Version": "2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "acm:ListCertificates", "cloudfront:CreateDistribution", "cloudfront:DeleteDistribution", "cloudfront:GetDistribution", "cloudfront:GetDistributionConfig", "cloudfront:ListDistributions", "cloudfront:UpdateDistribution", "cloudfront:ListCloudFrontOriginAccessIdentities", "elasticloadbalancing:DescribeLoadBalancers", "iam:ListServerCertificates", "sns:ListSubscriptionsByTopic", "sns:ListTopics", "waf:GetWebACL", "waf:ListWebACLs" ], "Resource":"*" }, { "Effect":"Allow", "Action":[ "s3:ListAllMyBuckets", "s3:PutBucketPolicy" ], "Resource":"arn:aws:s3:::*" } ] }
Com a permissão cloudfront:ListCloudFrontOriginAccessIdentities
, os usuários podem conceder automaticamente a uma identidade de acesso de origem a permissão para acessar objetos em um bucket do Amazon S3. Se você quiser que os usuários também possam criar identidades de acesso de origem, é necessário conceder a permissão cloudfront:CreateCloudFrontOriginAccessIdentity
.
Exemplo 3: permitir a criação e a listagem de invalidações
A política de a seguir permite que os usuários criem e indiquem invalidações. Ela inclui acesso de leitura a distribuições do CloudFront, pois você cria e visualiza invalidações exibindo as configurações de uma distribuição:
{ "Version": "2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "acm:ListCertificates", "cloudfront:GetDistribution", "cloudfront:GetStreamingDistribution", "cloudfront:GetDistributionConfig", "cloudfront:ListDistributions", "cloudfront:ListCloudFrontOriginAccessIdentities", "cloudfront:CreateInvalidation", "cloudfront:GetInvalidation", "cloudfront:ListInvalidations", "elasticloadbalancing:DescribeLoadBalancers", "iam:ListServerCertificates", "sns:ListSubscriptionsByTopic", "sns:ListTopics", "waf:GetWebACL", "waf:ListWebACLs" ], "Resource":"*" }, { "Effect":"Allow", "Action":[ "s3:ListAllMyBuckets" ], "Resource":"arn:aws:s3:::*" } ] }
Exemplo 4: permitir criar uma distribuição
A política a seguir concede ao usuário permissão para criar e listar as distribuições no console do CloudFront. Para a ação CreateDistribution
, especifique o caractere curinga (*) para o Resource
em vez de um curinga para o ARN (arn:aws:cloudfront::123456789012:distribution/*
) de distribuição. Para ter mais informações sobre o elemento Resource
, consulte Elementos de política JSON do IAM: recurso no Guia do usuário do IAM.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "cloudfront:CreateDistribution", "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "cloudfront:ListDistributions", "Resource": "*" } ] }