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á.
# Como o OpsWorks CM funciona com o IAM
Antes de usar o IAM para gerenciar o acesso ao OpsWorks CM, você deve entender quais recursos do IAM estão disponíveis para uso com o OpsWorks CM. Para ter uma visão de alto nível de como o OpsWorks CM e outros AWS serviços funcionam com o IAM, consulte [AWS os serviços que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do IAM*.
**Topics**
+ [OpsWorks Políticas baseadas em identidade do CM](#security_iam_service-with-iam-id-based-policies-opscm)
+ [OpsWorks CM e políticas baseadas em recursos](#security_iam_resource-based-policies)
+ [Autorização baseada em tags OpsWorks CM](#security_iam_tags)
+ [OpsWorks Funções do CM IAM](#security_iam_roles)
## OpsWorks Políticas baseadas em identidade do CM
Com as políticas baseadas em identidade do IAM, você pode especificar ações e recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. OpsWorks O CM oferece suporte a ações, recursos e chaves de condição específicos. Para saber mais sobre todos os elementos usados em uma política JSON, consulte [Referência de elementos de política JSON do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) no *Guia do usuário do IAM*.
No OpsWorks CM, você pode anexar uma declaração de política personalizada a um usuário, função ou grupo.
### Ações
O elemento `Action` de uma política baseada em identidade do IAM descreve a ação ou ações específicas que serão permitidas ou negadas pela política. As ações de política geralmente têm o mesmo nome da operação de AWS API associada. A ação é usada em uma política para conceder permissões para executar a operação associada.
As ações políticas no OpsWorks CM usam o seguinte prefixo antes da ação:`opsworks-cm:`. Por exemplo, para conceder a alguém permissão para criar um servidor do OpsWorks CM usando uma operação de API, inclua a ação `opsworks-cm:CreateServer` na política da pessoa. As declarações de política devem incluir um `NotAction` elemento `Action` ou. OpsWorks O CM define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.
Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:
```
"Action": [
"opsworks-cm:action1",
"opsworks-cm:action2"
```
Você também pode especificar várias ações usando caracteres curinga (\*). Por exemplo, para especificar todas as ações que começam com a palavra `Describe`, inclua a seguinte ação:
```
"Action": "opsworks-cm:Describe*"
```
Ao usar caracteres curinga para permitir várias ações em uma instrução de política, tenha cuidado para permitir essas ações somente a serviços ou a usuários autorizados.
Para ver uma lista de ações do OpsWorks CM, consulte [Ações, recursos e chaves de condição para a AWS OpsWorks](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsopsworks.html) no *Guia do usuário do IAM*.
### Recursos
O elemento `Resource` especifica o objeto ou os objetos aos quais a ação se aplica. As instruções devem incluir um elemento `Resource` ou um elemento `NotResource`. Você especifica um recurso usando um ARN ou usando o caractere curinga (\*) para indicar que a instrução se aplica a todos os recursos.
Você pode obter o Amazon Resource Number (ARN) de um servidor OpsWorks CM ou backup executando as [https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeServers.html](https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeServers.html)operações de [https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeBackups.html](https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_DescribeBackups.html)API e basear as políticas em nível de recurso nesses recursos.
Um recurso de servidor OpsWorks CM tem um ARN no seguinte formato:
```
arn:aws:opsworks-cm:{Region}:${Account}:server/${ServerName}/${UniqueId}
```
Um recurso de backup do OpsWorks CM tem um ARN no seguinte formato:
```
arn:aws:opsworks-cm:{Region}:${Account}:backup/${ServerName}-{Date-and-Time-Stamp-of-Backup}
```
Para obter mais informações sobre o formato de ARNs, consulte [Amazon Resource Names (ARNs) e AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Por exemplo, para especificar o servidor `test-chef-automate` do Chef Automate na instrução, use o seguinte ARN:
```
"Resource": "arn:aws:opsworks-cm:us-west-2:123456789012:server/test-chef-automate/EXAMPLE-d1a2bEXAMPLE"
```
Para especificar todos os servidores OpsWorks CM que pertencem a uma conta específica, use o caractere curinga (\*):
```
"Resource": "arn:aws:opsworks-cm:us-west-2:123456789012:server/*"
```
O exemplo a seguir especifica um backup do servidor OpsWorks CM como um recurso:
```
"Resource": "arn:aws:opsworks-cm:us-west-2:123456789012:backup/test-chef-automate-server-2018-05-20T19:06:12.399Z"
```
Algumas ações do OpsWorks CM, como aquelas para criar recursos, não podem ser executadas em um recurso específico. Nesses casos, você deve utilizar o caractere curinga (\*).
```
"Resource": "*"
```
Muitas ações da API do envolvem vários recursos. Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas.
```
"Resource": [
"resource1",
"resource2"
```
Para ver uma lista dos tipos de recursos do OpsWorks CM e seus ARNs, consulte [Ações, recursos e chaves de condição para o AWS OpsWorks CM](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsopsworksconfigurationmanagement.html) no *Guia do usuário do IAM*. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte [Ações, recursos e chaves de condição para o AWS OpsWorks CM no Guia](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsopsworksconfigurationmanagement.html) *do usuário do IAM*.
### Chaves de condição
OpsWorks O CM não tem chaves de contexto específicas do serviço que possam ser usadas no `Condition` elemento das declarações de política. Para obter a lista das chaves de contexto globais que estão disponíveis para todos os serviços, consulte [chaves de contexto de condição globais da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#AvailableKeys) na *Referência de política do IAM*. Para ver todas as chaves de condição AWS globais, consulte as [chaves de contexto de condição AWS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*.
O elemento `Condition` (ou *bloco* `Condition`) permite que você especifique condições nas quais uma instrução estiver em vigor. O elemento `Condition` é opcional. É possível criar expressões condicionais que usam [operadores de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), como "igual a" ou "menor que", para fazer a condição da política corresponder aos valores na solicitação.
Se você especificar vários elementos de `Condition` em uma declaração ou várias chaves em um único elemento de `Condition`, a AWS os avaliará usando uma operação lógica `AND`. Se você especificar vários valores para uma única chave de condição, AWS avalia a condição usando uma `OR` operação lógica. Todas as condições devem ser atendidas antes que as permissões da instrução sejam concedidas.
Você também pode usar variáveis de espaço reservado ao especificar condições. Por exemplo, você pode conceder a um usuário permissão para acessar um recurso somente se ele estiver marcado com seu nome de usuário. Para obter mais informações, consulte [Elementos de política do IAM: variáveis e tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html) no *Guia do usuário do IAM*.
### Exemplos
Para ver exemplos de políticas baseadas em identidade do OpsWorks CM, consulte. [AWS OpsWorks Exemplos de políticas baseadas em identidade do CM](security_iam_id-based-policy-examples.md)
## OpsWorks CM e políticas baseadas em recursos
OpsWorks O CM não oferece suporte a políticas baseadas em recursos.
As políticas baseadas em recursos são documentos de políticas JSON que especificam quais ações uma entidade principal especificada pode executar em um recurso e sob quais condições.
## Autorização baseada em tags OpsWorks CM
Você pode anexar tags aos recursos do OpsWorks CM ou passar tags em uma solicitação para o OpsWorks CM. Para controlar o acesso com base em tags, forneça informações sobre as tags no [elemento de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de uma política usando as chaves de condição `aws:RequestTag/{{key-name}}` ou `aws:TagKeys`. Para obter mais informações sobre a marcação de recursos de OpsWorks CM, consulte [Trabalhando com tags em AWS OpsWorks for Chef Automate recursos](opscm-tags.md) ou [Trabalhando com tags em AWS OpsWorks for Puppet Enterprise recursos](opspup-tags.md) neste guia.
## OpsWorks Funções do CM IAM
Uma [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) é uma entidade dentro da sua AWS conta que tem permissões específicas.
OpsWorks O CM usa duas funções:
+ Uma função de serviço que concede ao serviço OpsWorks CM permissões para trabalhar na AWS conta de um usuário. Se você usar a função de serviço padrão fornecida pelo OpsWorks CM, o nome dessa função será`aws-opsworks-cm-service-role`.
+ Uma função de perfil de instância que permite que o serviço OpsWorks CM chame a API OpsWorks CM. Essa função concede acesso ao Amazon S3 e CloudFormation à criação do servidor e do bucket do S3 para backups. Se você usar o perfil de instância padrão fornecido pelo OpsWorks CM, o nome dessa função de perfil de instância será`aws-opsworks-cm-ec2-role`.
OpsWorks O CM não usa funções vinculadas a serviços.
### Usar credenciais temporárias com o OpsWorks CM
OpsWorks O CM suporta o uso de credenciais temporárias e herda esse recurso de. AWS Security Token Service
É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir um perfil entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)ou [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html).
### perfis vinculados ao serviço
OpsWorks O CM não usa funções vinculadas a serviços.
[As funções vinculadas ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) permitem que AWS os serviços acessem recursos em outros serviços para concluir uma ação em seu nome. Os perfis vinculados a serviço aparecem em sua conta do IAM e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para perfis vinculados a serviço.
### Perfis de serviço
Esse atributo permite que um serviço assuma um [perfil de serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) em seu nome. O perfil permite que o serviço acesse recursos em outros serviços para concluir uma ação em seu nome. Os perfis de serviço aparecem em sua conta do IAM e são de propriedade da conta. Isso significa que um administrador do IAM pode alterar as permissões para esse perfil. Porém, fazer isso pode alterar a funcionalidade do serviço.
OpsWorks O CM usa duas funções:
+ Uma função de serviço que concede ao serviço OpsWorks CM permissões para trabalhar na AWS conta de um usuário. Se você usar a função de serviço padrão fornecida pelo OpsWorks CM, o nome dessa função será`aws-opsworks-cm-service-role`.
+ Uma função de perfil de instância que permite que o serviço OpsWorks CM chame a API OpsWorks CM. Essa função concede acesso ao Amazon S3 e CloudFormation à criação do servidor e do bucket do S3 para backups. Se você usar o perfil de instância padrão fornecido pelo OpsWorks CM, o nome dessa função de perfil de instância será`aws-opsworks-cm-ec2-role`.
### Selecionar um perfil do IAM no OpsWorks CM
Ao criar um servidor no OpsWorks CM, você deve escolher uma função para permitir que o OpsWorks CM acesse a Amazon EC2 em seu nome. Se você já criou uma função de serviço, o OpsWorks CM fornece uma lista de funções para você escolher. OpsWorks O CM pode criar a função para você, se você não especificar uma. É importante escolher uma função que permita o acesso para iniciar e interromper as EC2 instâncias da Amazon. Para acessar mais informações, consulte [Criar um servidor Chef Automate](gettingstarted-opscm-create.md) ou [Criar um Puppet Enterprise master](gettingstarted-opspup-create.md).