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

Exemplos de políticas baseadas em identidade para AWS CodeArtifact

Por padrão, usuários e funções não têm permissão para criar ou modificar CodeArtifact recursos. Eles também não podem realizar tarefas usando o AWS Management Console, AWS Command Line Interface (AWS CLI) ou AWS API. Para conceder permissão aos usuários para realizar ações nos recursos de que precisam, um IAM administrador pode criar IAM políticas. O administrador pode então adicionar as IAM políticas às funções e os usuários podem assumir as funções.

Para saber como criar uma política IAM baseada em identidade usando esses exemplos de documentos de JSON política, consulte Criar IAM políticas (console) no Guia do IAMusuário.

Para obter detalhes sobre ações e tipos de recursos definidos por CodeArtifact, incluindo o formato do ARNs para cada um dos tipos de recursos, consulte Ações, recursos e chaves de condição AWS CodeArtifact na Referência de Autorização de Serviço.

Melhores práticas de política

As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir CodeArtifact recursos 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:

Para obter mais informações sobre as melhores práticas emIAM, consulte as melhores práticas de segurança IAM no Guia IAM do usuário.

Usando o CodeArtifact console

Para acessar o AWS CodeArtifact console, você deve ter um conjunto mínimo de permissões. Essas permissões devem permitir que você liste e visualize detalhes sobre os CodeArtifact recursos em seu 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.

Você não precisa permitir permissões mínimas do console para usuários que estão fazendo chamadas somente para AWS CLI o. ou AWS API o. Em vez disso, permita o acesso somente às ações que correspondam à API operação que eles estão tentando realizar.

Para garantir que usuários e funções ainda possam usar o CodeArtifact console, anexe também a política AWSCodeArtifactAdminAccess ou a política AWSCodeArtifactReadOnlyAccess AWS gerenciada às entidades. Para obter mais informações, consulte Adicionar permissões a um usuário no Guia do IAM usuário.

AWSpolíticas gerenciadas (predefinidas) para AWS CodeArtifact

AWS aborda muitos casos de uso comuns fornecendo IAM políticas autônomas que são criadas e administradas pela AWS. Essas políticas AWS gerenciadas concedem as permissões necessárias 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 AWS gerenciadas no Guia IAM do usuário.

As políticas AWS gerenciadas a seguir, que você pode anexar aos usuários em sua conta, são específicas de AWS CodeArtifact.

Para criar e gerenciar funções CodeArtifact de serviço, você também deve anexar a política AWS gerenciada chamadaIAMFullAccess.

Você também pode criar suas próprias IAM políticas personalizadas para permitir permissões para CodeArtifact ações e recursos. Você pode anexar essas políticas personalizadas aos IAM usuários ou grupos que exigem essas permissões.

Permitir que os usuários visualizem as próprias permissões

Este exemplo mostra como você pode criar uma política que permita IAM aos usuários visualizar as políticas embutidas e gerenciadas que estão anexadas à identidade do usuário. Essa política inclui permissões para concluir essa ação no console ou programaticamente usando o AWS CLI ou. 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": "*"
        }
    ]
}

Permitir que um usuário obtenha informações sobre repositórios e domínios

A política a seguir permite que um IAM usuário ou função liste e descreva qualquer tipo de CodeArtifact recurso, incluindo domínios, repositórios, pacotes e ativos. A política também inclui a codeArtifact:ReadFromRepository permissão, que permite ao diretor buscar pacotes de um CodeArtifact repositório. Ele não permite a criação de novos domínios ou repositórios e não permite a publicação de novos pacotes.

As sts:GetServiceBearerToken permissões codeartifact:GetAuthorizationToken e são necessárias para chamar GetAuthorizationToken API o.

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*",
            "codeartifact:Get*",
            "codeartifact:Read*"
         ],
         "Resource": "*"      
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      }
   ]
}

Permitir que um usuário obtenha informações sobre domínios específicos

O exemplo a seguir mostra uma política de permissões que permite que um usuário listar domínios apenas na região us-east-2, para a conta 123456789012, para qualquer domínio que comece com o nome my.

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": "codeartifact:ListDomains",
         "Resource": "arn:aws:codeartifact:us-east-2:123456789012:domain/my*"      
      }
   ]
}

Permitir que um usuário obtenha informações sobre repositórios específicos

Veja a seguir um exemplo de uma política de permissões que permite ao usuário obter informações sobre repositórios que terminam com test, incluindo informações sobre os pacotes neles contidos. O usuário não poderá publicar, criar ou excluir recursos.

As sts:GetServiceBearerToken permissões codeartifact:GetAuthorizationToken e são necessárias para chamar GetAuthorizationToken API o.

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*",
            "codeartifact:Get*",
            "codeartifact:Read*"
         ],
         "Resource": "arn:aws:codeartifact:*:*:repository/*/*test"      
      },
      {
         "Effect": "Allow",
         "Action": [
            "codeartifact:List*",
            "codeartifact:Describe*"
         ],
         "Resource": "arn:aws:codeartifact:*:*:package/*/*test/*/*/*"   
      },
      {
         "Effect": "Allow",
         "Action": "sts:GetServiceBearerToken",
         "Resource": "*",
         "Condition": {
            "StringEquals": {
               "sts:AWSServiceName": "codeartifact.amazonaws.com"
            }
         }
      },
      {
         "Effect": "Allow",
         "Action": "codeartifact:GetAuthorizationToken",
         "Resource": "*"
      }
   ]
}

Limitar a duração do token de autorização

Os usuários devem se autenticar CodeArtifact com tokens de autorização para publicar ou consumir versões do pacote. Os tokens de autorização são válidos somente durante a vida útil configurada. Os tokens têm uma vida útil padrão de 12 horas. Para obter mais informações sobre a tokens de autorização, consulte AWS CodeArtifact autenticação e tokens.

Ao buscar um token, os usuários podem configurar a vida útil dele. Os valores válidos para a vida útil de um token de autorização são 0 e qualquer número entre 900 (15 minutos) e 43200 (12 horas). Um valor de 0 criará um token com uma duração igual às credenciais temporárias do perfil do usuário.

Os administradores podem limitar os valores válidos durante a vida útil de um token de autorização usando a chave de condição sts:DurationSeconds na política de permissões anexada ao usuário ou grupo. Se o usuário tentar criar um token de autorização com uma vida útil fora dos valores válidos, a criação do token falhará.

O exemplo de políticas a seguir limita as possíveis durações de um token de autorização criado pelos CodeArtifact usuários.

Exemplo de política: limite a vida útil do token a exatamente 12 horas (43.200 segundos)

Com essa política, os usuários só poderão criar tokens de autorização com uma vida útil de 12 horas.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "codeartifact:*",
            "Resource": "*"
        },
        {
            "Sid": "sts",
            "Effect": "Allow",
            "Action": "sts:GetServiceBearerToken",
            "Resource": "*",
            "Condition": {
                "NumericEquals": {
                    "sts:DurationSeconds": 43200
                },
                "StringEquals": {
                    "sts:AWSServiceName": "codeartifact.amazonaws.com"
                }
            }
        }
    ]
}
           

Exemplo de política: limite a vida útil do token entre 15 minutos e 1 hora ou igual ao período de credenciais temporárias do usuário

Com essa política, os usuários poderão criar tokens válidos entre 15 minutos e 1 hora. Os usuários também poderão criar um token que dure a duração das credenciais temporárias de do perfil especificando 0 para --durationSeconds.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "codeartifact:*",
            "Resource": "*"
        },
        {
            "Sid": "sts",
            "Effect": "Allow",
            "Action": "sts:GetServiceBearerToken",
            "Resource": "*",
            "Condition": {
                "NumericLessThanEquals": {
                    "sts:DurationSeconds": 3600
                },
                "StringEquals": {
                    "sts:AWSServiceName": "codeartifact.amazonaws.com"
                }
            }
        }
    ]
}