Criação de modelos de grupos de acesso gerenciados pela empresa
Em uma empresa com muitas contas secundárias, pode ser demorado e propenso a erros configurar manualmente os grupos de acesso para cada conta. Use modelos de grupos de acesso gerenciados pela empresa para economizar tempo e garantir a consistência em todas as contas.
Quando um administrador corporativo atribui um modelo de grupo de acesso a contas secundárias, um grupo de acesso gerenciado pela empresa é criado em cada conta. Os atributos associados que você adiciona ao modelo, como políticas, membros ou regras dinâmicas, são incluídos.
Membros
Ao criar um modelo de grupo de acesso na conta corporativa, juntamente com o conjunto de políticas de acesso associadas que concedem permissões aos membros desse grupo, você pode incluir usuários corporativos e IDs de serviço. Os usuários aos quais você adiciona o modelo de grupo de acesso devem ser convidados para as contas-filhas às quais o modelo é atribuído para obter acesso. Em seguida, os usuários são adicionados automaticamente aos grupos de acesso nas contas de destino às quais você atribui o modelo.
Configure regras dinâmicas em um modelo de grupo de acesso para adicionar automaticamente usuários federados em contas secundárias a grupos de acesso gerenciados pela empresa com base em atributos de identidade específicos.
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar membros ao grupo de acesso gerenciado pela empresa em suas contas. Para ativar esse recurso, o administrador da conta corporativa deve definir esse comportamento no modelo de grupo de acesso usando um controle de ação. Quando ativado, esse controle de ação permite que os administradores de grupos de acesso adicionem membros ao grupo em suas contas, mesmo que esses membros não estejam definidos no modelo de grupo de acesso. Para obter mais informações, consulte Controles de ação para membros.
Antes de Iniciar
-
Para saber como os modelos de IAM alterados pela empresa tornam sua empresa mais segura, consulte Como funciona o acesso ao IAM gerenciado pela empresa.
-
Você deve ser membro da conta corporativa para criar e atribuir modelos de IAM gerenciados pela empresa.
-
Para criar um modelo de IAM gerenciado pela empresa, certifique-se de que o seguinte acesso tenha sido atribuído a você:
- Uma política com a função de Administrador de Modelos em todos os serviços de gerenciamento de contas do IAM
-
Para atribuir um modelo de IAM gerenciado pela empresa a contas secundárias, certifique-se de que o seguinte acesso tenha sido atribuído a você:
- Uma política com a função Administrador de atribuição de modelo em todos os serviços de gerenciamento de contas do IAM
- Uma política com pelo menos a função Viewer no Enterprise Service
Por padrão, nenhum usuário tem as funções Template Administrator ou Template Assignment Administrator, incluindo o proprietário da conta.
-
As contas novas e existentes em sua empresa devem optar pelo IAM gerenciado pela empresa. Para obter mais informações, consulte Como optar pelo IAM gerenciado pela empresa.
Criação de um modelo de grupo de acesso
Considere o uso de modelos de grupos de acesso quando você tiver muitas contas secundárias, requisitos de acesso comuns entre contas ou requisitos de segurança rigorosos.
Para criar um modelo de grupo de acesso, siga estas etapas:
-
Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
-
Clique em Criar.
-
Digite um nome e uma descrição para o modelo de grupo de acesso que descreva sua finalidade para os usuários corporativos.
-
Digite um nome e uma descrição para o grupo de acesso gerenciado pela empresa que descreva sua finalidade para os usuários da conta secundária. Use um nome exclusivo para o grupo de acesso, que não entre em conflito com os grupos de acesso já existentes em nenhuma conta subordinada.
Ocorrerá um erro quando você atribuir o modelo se uma conta contiver um nome de grupo de acesso conflitante.
-
Clique em Criar.
(Opcional) Adicionar membros
Os membros da empresa que você adicionar a um modelo devem estar presentes tanto na conta da empresa quanto na conta secundária. Se um usuário corporativo ainda não for membro de uma conta secundária à qual você atribui um modelo, adicione-o à conta secundária.
Os administradores de grupos de acesso em contas secundárias podem adicionar membros ao grupo de acesso em suas contas quando você ativar o controle de ação Adicionar membros. Dessa forma, você pode delegar o gerenciamento da associação aos administradores do grupo de acesso em contas secundárias.
Para adicionar membros da empresa ao modelo de grupo de acesso, conclua as etapas a seguir:
-
Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
-
Selecione o modelo do seu grupo de acesso.
-
Clique em Membros > Adicionar.
-
Selecione os usuários que precisam de acesso.
-
Clique em Incluir.
-
Clique em Service IDs > Add para adicionar IDs de serviço.
-
Selecione os IDs de serviço que precisam de acesso em contas secundárias.
As equipes que usam um script podem adicionar IDs de serviço para ajudar a automatizar a configuração da conta.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar ou remover membros de grupos de acesso gerenciados pela empresa em suas contas. Talvez você queira permitir que eles adicionem membros para que possam incluir membros de suas contas que não podem ser adicionados a um modelo como um usuário corporativo. Os administradores do grupo de acesso sempre podem remover os membros que adicionaram quando alguém do grupo de acesso deixa a organização.
Para alterar o comportamento padrão, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Membros.
- Defina o controle de ação de Add members (Adicionar membros ) como Yes (Sim ) para permitir que os administradores de grupos de acesso adicionem membros ao grupo de acesso gerenciado pela empresa em suas contas. Um administrador de grupo de acesso pode remover qualquer membro que tenha adicionado.
- Defina o controle de ação de Remover membros como Sim para permitir que os administradores de grupos de acesso removam membros do grupo de acesso gerenciado pela empresa em suas contas que foram adicionadas pela empresa. Esse controle de ação não afeta os membros que o administrador do grupo de acesso adiciona ao grupo.
(Opcional) Adicionar regras dinâmicas
É possível criar regras dinâmicas para adicionar automaticamente usuários federados em contas subordinadas a grupos de acesso gerenciados pela empresa, com base em atributos de identidade específicos. Defina as condições que devem corresponder aos dados configurados no provedor de identidade ( IdP ) e transmitidos com o ID federado de um usuário durante o login. Antes de adicionar regras dinâmicas, você deve habilitar a autenticação de um provedor de identidade externo.
-
Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
-
Selecione o modelo do seu grupo de acesso.
-
Clique em Regras dinâmicas > Adicionar.
-
Dê à regra dinâmica um nome que descreva o tipo de usuário que a regra adiciona ao grupo de acesso.
-
Selecione “Usuários federados por IBMid ” ou “Usuários federados por IBM Cloud® App ID ” como método de autenticação e insira o provedor de identidade ( IdP ).
-
Adicione condições com base nos dados do site IdP para definir quais usuários federados serão adicionados ao grupo.
- Ao clicar em Incluir uma condição, é possível definir várias condições. Os usuários federados devem atender a todas as condições para obter associação ao grupo de acesso. Para obter mais informações sobre os campos que são usados para criar condições, consulte Propriedades de condição de IAM.
-
Defina a duração da sessão em horas.
A associação ao grupo de acesso é revogada depois que esse período expira. Os usuários devem fazer login novamente para atualizar a sua associação ao grupo de acesso.
Controles de ação
Por padrão, os administradores de grupos de acesso não podem adicionar, remover ou atualizar regras dinâmicas para um grupo de acesso gerenciado pela empresa.
Para alterar o comportamento padrão ao adicionar regras, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Regras dinâmicas.
- Defina o controle de ação de Add dynamic rules (Adicionar regras dinâmicas ) como Yes (Sim ) para permitir que os administradores de grupos de acesso adicionem regras dinâmicas ao grupo de acesso gerenciado pela empresa em suas contas. Um administrador de grupo de acesso pode remover ou atualizar qualquer regra dinâmica que tenha adicionado.
Para alterar o comportamento padrão de remoção e atualização de regras gerenciadas pela empresa, conclua as etapas a seguir:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Regras dinâmicas.
- Defina o controle de ação de Remove dynamic rules (Remover regras dinâmicas ) como Yes (Sim ) para permitir que os administradores de grupos de acesso removam regras dinâmicas do grupo de acesso gerenciado pela empresa em suas contas, que são adicionadas pela empresa. Esse controle de ação não afeta as regras dinâmicas que o administrador do grupo de acesso adiciona ao grupo.
- Defina o controle de ação de Update dynamic rules (Atualizar regras dinâmicas ) como Yes (Sim ) para permitir que os administradores de grupos de acesso atualizem as regras dinâmicas do grupo de acesso gerenciado pela empresa em suas contas que são adicionadas pela empresa. Esse controle de ação não afeta as regras dinâmicas que os administradores de grupos de acesso em contas secundárias adicionam ao grupo.
- Configure controles de ação para regras dinâmicas específicas.
- Clique na regra dinâmica.
- Defina o controle de ação de Remove dynamic rule (Remover regra dinâmica ) como Yes (Sim ) para permitir que os administradores de grupos de acesso em contas secundárias removam essa regra dinâmica específica.
- Defina o controle de ação para Atualizar regra dinâmica como Sim para permitir que os administradores de grupos de acesso em contas secundárias atualizem essa regra dinâmica específica.
- Clique em Salvar.
- Clique na regra dinâmica.
(Opcional) Adicionar políticas de acesso
As políticas de acesso concedem acesso em contas secundárias aos membros do seu grupo de acesso gerenciado pela empresa.
-
Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
-
Selecione o modelo do seu grupo de acesso.
-
Clique em Acesso > Adicionar.
-
Selecione um modelo de política existente e clique em Add (Adicionar ).
-
Ou crie um novo modelo de política clicando em Criar.
-
Nomeie e descreva a política que você deseja atribuir.
Você cria um modelo de política com cada política que configura para um modelo de grupo de acesso. Você pode fazer referência a um modelo de política para atribuir acesso em outros modelos de IAM corporativo.
-
Selecione um serviço ou grupo de serviços e clique em Next.
-
Escopo do acesso a Todos os recursos ou selecione Recursos específicos com base em atributos e clique em Avançar.
-
Na seção Funções e ações, selecione as funções que definem o escopo do acesso. Você pode criar modelos de função personalizados em um fluxo de modelo de política e também selecionar uma função personalizada nos modelos de função personalizados existentes para o serviço selecionado.
- Clique em Criar função personalizada para definir uma combinação personalizada de ações.
- Digite um nome de modelo.
- (Opcional) Insira uma descrição do modelo.
- Digite um nome para a função personalizada.
- Insira um ID para a função personalizada.
- (Opcional) Insira uma descrição para a função personalizada.
- Selecione as ações e clique em Criar. A função personalizada é listada e selecionada junto com quaisquer outras funções já selecionadas para a política.
- (Opcional) Adicione condições para especificar quando você deseja que a política conceda acesso.
Use a barra de pesquisa para procurar funções que suportem ações específicas. Por exemplo, pesquise por ler, editar ou visualizar para exibir a lista de funções às quais essas ações se aplicam.
-
-
Clique em Incluir.
Remover políticas de acesso
Você pode remover políticas antes que um modelo seja confirmado e atribuído.
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Acessar
- Clique no ícone de ações na política que você deseja remover.
- Clique em Remove.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar políticas de acesso a um grupo de acesso gerenciado pela empresa. Para permitir que os administradores de grupos de acesso adicionem políticas, conclua as etapas a seguir:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Acessar
- Defina o controle de ação de Adicionar políticas como Sim para permitir que os administradores de grupos de acesso em contas secundárias adicionem políticas de acesso ao grupo de acesso gerenciado pela empresa em suas contas.
Qualquer política que os administradores de grupos de acesso adicionarem ao grupo de acesso gerenciado pela empresa em sua conta também poderá ser removida e atualizada.
Atualização dos detalhes do modelo
Você pode atualizar o nome do modelo, o nome do grupo de acesso e as descrições a qualquer momento antes de confirmar o modelo. Para atualizar os detalhes do modelo, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo de grupo de acesso que você deseja atualizar.
- Clique no ícone Editar
na seção Detalhes.
- Faça as atualizações necessárias no nome do modelo, no nome do grupo de acesso e nas descrições.
- Clique em Salvar.
Se você precisar fazer atualizações depois de confirmar o modelo, crie uma nova versão.
Revisão do seu modelo de grupo de acesso
Revise o modelo de grupo de acesso e confirme-o para que nenhuma outra alteração possa ser feita na versão. Dessa forma, o administrador de atribuição de modelos pode ter certeza de que atribuirá a versão somente quando você confirmar que ela está pronta.
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo de grupo de acesso que você deseja revisar.
- Clique em Revisar.
- Verifique se o modelo de grupo de acesso está configurado corretamente.
- Clique na caixa de seleção para confirmar que você não pode fazer alterações na versão.
- Clique em Confirmar.
Atribuição de um modelo de grupo de acesso a contas secundárias
Atribua o modelo de grupo de acesso a contas secundárias em sua empresa.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
-
Clique em Assign accounts (Atribuir contas ).
-
Selecione as contas e os grupos de contas aos quais você deseja atribuir o modelo de grupo de acesso.
Em cada uma das contas-filhas às quais você atribui o modelo, você cria um grupo de acesso gerenciado pela empresa. Os usuários da conta secundária podem determinar que um grupo de acesso vem de um modelo de IAM gerenciado pela empresa pela tag{: tag-cyan} [gerenciada] pela empresa no grupo.
-
Clique em Designar.
Se uma atribuição falhar, clique em Retry (Tentar novamente ).
Criação de uma nova versão
Se você quiser fazer alterações em um modelo de grupo de acesso que foi confirmado ou atribuído, crie uma nova versão. Você pode criar uma nova versão com base em sua versão mais recente ou em uma versão diferente que você selecionar.
Para criar uma nova versão de um modelo de grupo de acesso, conclua as etapas a seguir:
-
Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
-
Selecione o modelo do seu grupo de acesso.
-
Clique no ícone Nova versão Ícone de nova
.
-
Selecione a versão que você deseja usar como base para sua nova versão.
-
Insira um novo nome e descrição de modelo ou mantenha os que já estão sendo usados.
A inserção de um novo nome de modelo atualiza o nome do modelo desta versão e de todas as versões anteriores. A descrição do modelo é armazenada separadamente para cada versão.
-
Insira um novo nome e descrição de grupo de acesso ou mantenha os que já estão sendo usados.
A inserção de um novo nome do grupo de acesso substitui o nome do grupo de acesso anterior mostrado nas contas filhas após a designação da nova versão.
-
Selecione os objetos que você deseja transferir para a nova versão.
- (Opcional) Selecione Membros.
- (Opcional) Selecione “Regras dinâmicas ”.
- (Opcional) Selecione Acesso.
-
Clique em Criar.
-
Faça quaisquer outros ajustes na configuração.
-
Clique em Review (Revisar ) e confirme a nova versão. Para obter mais informações, consulte Revisão do modelo de grupo de acesso.
Para atribuir uma nova versão de um modelo de grupo de acesso, conclua as etapas a seguir:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Clique no ícone de expansão da tabela
no modelo com o qual você deseja trabalhar.
- Selecione a versão que está atualmente atribuída às contas secundárias.
- Clique em Assignments (Atribuições ).
- Clique em Update (Atualizar ) na atribuição de conta ou grupo de contas à qual você deseja atribuir uma versão diferente.
- Clique em “Selecionar uma versão ”.
- Selecione a versão que você deseja substituir a versão atual.
- Clique em Atualizar.
- Repita essas etapas para cada conta ou grupo de contas ao qual você deseja atribuir uma versão diferente.
A nova versão do modelo que você atribui substitui a versão antiga. Saiba mais sobre a atribuição de uma nova versão.
Remoção de uma atribuição
Você pode remover uma atribuição de modelo de uma ou mais contas às quais o modelo está atribuído. Talvez você queira fazer isso se o modelo não estiver funcionando como pretendido. Quando você remove uma atribuição de modelo de uma conta, por padrão, a versão anterior do modelo é restabelecida. Se a atribuição que você remover for para a primeira ou única versão de um modelo, o grupo de acesso na conta secundária será removido.
Para remover uma atribuição, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Selecione o modelo do seu grupo de acesso.
- Clique em Atualizar atribuições.
- Para remover uma atribuição de uma ou algumas contas, desmarque as contas em que você deseja remover a atribuição de modelo.
- Para remover uma atribuição de todas as contas às quais o modelo está atribuído, clique em Unassign all (Desatribuir tudo ).
Criação de um modelo de grupo de acesso usando a API
Considere o uso de modelos de grupos de acesso quando você tiver muitas contas secundárias, requisitos de acesso comuns entre contas, requisitos de segurança rigorosos ou precisar fazer alterações nas políticas de acesso.
É possível criar um modelo de grupo de acesso programaticamente, chamando a API de Grupos de Acesso do IAM, conforme mostrado na solicitação de exemplo a seguir. O exemplo cria um modelo de grupo de acesso para gerentes que precisam de acesso de administrador a todos os serviços de gerenciamento de contas do IAM em contas secundárias para que possam gerenciar o acesso:
{
curl -X POST --location
--header "Authorization: Bearer {iam_token}"
--header "Accept: application/json" --header "Content-Type: application/json"
--data "name": "IAM Admin Group template",
"description": "This access group template allows admin access to all IAM platform services in the account.",
"account_id": "06a2e9d0614447e295824de8c8df7b4f",
"access_group": {
"name": "IAM Admin Group",
"description": "This enterprise-managed access group allows admin access to all IAM platform services in the account. Managers are dynamically added.",
"members": {
"users": [
"IBMid-1234",
"IBMid-2345"
],
"services": [
"iam-ServiceId-123",
"iam-ServiceId-234"
],
"action_controls": {
"add": "true",
"remove": "false"
}
},
"assertions": {
"rules": [
{
"name": "Manager group rule",
"expiration": 12,
"realm_name": "https://idp.example.org/SAML2",
"conditions": [
{
"claim": "isManager",
"operator": "EQUALS",
"value": "true"
}
],
"action_controls": {
"remove": "true",
"update": "false"
}
}
],
"action_controls": {
"add": "false"
}
},
"action_controls": {
"access": {
"add": true
}
}
},
"policy_template_references": [
{
"id": "policyTemplateId-123",
"version": "1"
},
{
"id": "policyTemplateId-234",
"version": "1"
}
],
"externals": {
"profile_template_ids": [
"profileTemplateId-123",
"profileTemplateId-234"
]
}
}
(Opcional) Adicionar membros
No exemplo anterior, dois usuários corporativos e dois IDs de serviço são adicionados ao modelo de grupo de acesso especificando seus IBMids.
Os membros da empresa que você adiciona a um modelo devem estar presentes tanto na conta da empresa quanto nas contas filhas às quais você deseja atribuir o modelo. Se um usuário ainda não for membro de uma conta secundária à qual você atribuiu um modelo, você poderá adicioná-lo a essa conta secundária.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar ou remover membros de grupos de acesso gerenciados pela empresa em suas contas. Talvez você queira permitir que eles adicionem membros para que possam incluir membros de suas contas que não podem ser adicionados a um modelo como um usuário corporativo. Os administradores do grupo de acesso sempre podem remover os membros que adicionaram quando alguém do grupo de acesso deixa a organização.
No exemplo anterior, o action_controls permite que os administradores de grupos de acesso em contas secundárias adicionem membros de suas próprias contas porque o add está definido como true e restringe
a remoção de membros da empresa porque o remove está definido como false.
(Opcional) Adicionar regras dinâmicas
É possível criar regras dinâmicas para adicionar automaticamente usuários federados em contas subordinadas a grupos de acesso gerenciados pela empresa, com base em atributos de identidade específicos. Defina as condições que devem ser atendidas pelos dados configurados no provedor de identidade ( IdP ) e transmitidos junto com a identificação federada do usuário durante o login. Antes de adicionar regras dinâmicas, você deve habilitar a autenticação de um provedor de identidade externo.
No exemplo anterior, os gerentes são adicionados dinamicamente ao grupo pelo site rules especificado na seção assertions. A duração da sessão é definida como 12 horas para usuários adicionados dinamicamente.
A associação ao grupo de acesso é revogada depois que esse período expira. Os usuários devem fazer login novamente para atualizar a sua associação ao grupo de acesso.
Controles de ação
Por padrão, os administradores de grupos de acesso não podem adicionar, remover ou atualizar regras dinâmicas para um grupo de acesso gerenciado pela empresa. Há dois níveis de controles de ação para a regra dinâmica:
- Controles de ação para cada regra específica que determinam se os administradores do grupo de acesso podem remover ou atualizar uma regra dinâmica específica
- Controles de ação que determinam se os administradores do grupo de acesso podem adicionar, remover ou atualizar regras dinâmicas para o grupo de acesso
Se ambos os níveis estiverem configurados, os controles de ação do nível interno para uma regra dinâmica específica terão precedência.
No exemplo anterior, os controles de ação de nível interno definem remove como true, o que permite que os administradores do grupo de acesso removam a regra. update é definido como false,
de modo que os administradores do grupo de acesso não podem atualizar a regra. O controle de ação de nível externo add está definido como false, portanto, os administradores de grupos de acesso não podem adicionar
novas regras dinâmicas.
(Opcional) Adicionar políticas de acesso
As políticas de acesso concedem acesso aos membros do seu grupo de acesso gerenciado pela empresa em contas secundárias. No exemplo anterior, os modelos de política existentes atribuem acesso no modelo de grupo de acesso usando policy_template_references.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar políticas de acesso a um grupo de acesso gerenciado pela empresa. No exemplo anterior, o controle de ação access para add é definido como true, para que os administradores de contas secundárias possam adicionar políticas ao grupo em suas contas.
Atualização de modelos de grupos de acesso usando a API
Você pode atualizar um modelo de grupo de acesso a qualquer momento antes que um modelo seja confirmado.
Para atualizar um modelo de grupo de acesso, chame a API de gerenciamento de políticas do IAM, conforme mostrado na solicitação de amostra a seguir:
curl -X PUT --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" --header "If-Match: {if_match}" --header "Content-Type: application/json" --data '{ "name": "IAM Admin Group template 2", "description": "This access group template allows admin access to all IAM platform services in the account.", "group": { "name": "IAM Admin Group 8", "description": "This access group template allows admin access to all IAM platform services in the account.", "members": { "users": [ "IBMid-665000T8WY" ], "services": [ "iam-ServiceId-e371b0e5-1c80-48e3-bf12-c6a8ef2b1a11" ], "action_controls": { "add": true, "remove": false } }, "assertions": { "rules": [ { "name": "Manager group rule", "expiration": 12, "realm_name": "https://idp.example.org/SAML2", "conditions": [ { "claim": "blueGroup", "operator": "CONTAINS", "value": "test-bluegroup-saml" } ], "action_controls": { "remove": false, "update": false } } ], "action_controls": { "add": false } }, "action_controls": { "access": { "add": false } } }, "policy_template_references": [ { "id": "policyTemplateId-123", "version": "1" }, { "id": "policyTemplateId-234", "version": "1" } ] }' "{base_url}/v1/group_templates/{template_id}/versions/{version_num}"
Revisar e confirmar seu modelo de grupo de acesso usando a API
Revise o modelo de grupo de acesso e confirme-o para que nenhuma outra alteração possa ser feita na versão. Dessa forma, o administrador de atribuição de modelos pode ter certeza de que atribuirá a versão somente quando você confirmar que ela está pronta.
-
Liste os modelos de grupos de acesso em sua conta corporativa e anote o endereço
iddo modelo que deseja revisar e confirmar.curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_templates?account_id=accountID-123&limit=50&offset=0&verbose=false" -
Obtenha a versão do modelo e analise a resposta.
curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_templates/{template_id}/versions/{version_num}" -
Confirmar a versão do modelo.
curl -X POST --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" --header "If-Match: {if_match}" "{base_url}/v1/group_templates/{template_id}/versions/{version_num}/commit"
Atribuição de um modelo de grupo de acesso a contas secundárias usando a API
Atribua o modelo de grupo de acesso a contas secundárias em sua empresa.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote o endereço
iddo modelo que deseja atribuir às contas secundárias.curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_templates?account_id=accountID-123&limit=50&offset=0&verbose=false" -
Atribua o modelo de grupo de acesso a um
AccountouAccountGroup.curl -X POST --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" --header "Content-Type: application/json" --data '{ "template_id": "AccessGroupTemplateId-4be4", "template_version": "1", "target_type": "AccountGroup", "target": "0a45594d0f-123" }' "{base_url}/v1/group_assignments"
Criação de uma nova versão usando a API
Se você quiser fazer alterações em um modelo de grupo de acesso que foi confirmado ou atribuído, crie uma nova versão. A inserção de um novo nome de modelo atualiza o nome do modelo desta versão e de todas as versões anteriores.
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote o endereço
iddo modelo para o qual você deseja criar uma nova versão.curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_templates?account_id=accountID-123&limit=50&offset=0&verbose=false" -
Crie uma nova versão e inclua as atualizações que você deseja fazer.
curl -X POST --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" --header "Content-Type: application/json" --data '{ "name": "IAM Admin Group template 2", "description": "This access group template allows admin access to all IAM platform services in the account.", "group": { "name": "IAM Admin Group 8", "description": "This access group template allows admin access to all IAM platform services in the account.", "members": { "users": [ "IBMid-123", "IBMid-234" ], "services": [ "iam-ServiceId-345" ], "action_controls": { "add": true, "remove": false } }, "assertions": { "rules": [ { "name": "Manager group rule", "expiration": 12, "realm_name": "https://idp.example.org/SAML2", "conditions": [ { "claim": "blueGroup", "operator": "CONTAINS", "value": "test-bluegroup-saml" } ], "guardrails": { "remove": false, "update": false } } ], "action_controls": { "add": false } }, "action_controls": { "access": { "add": false } } }, "policy_template_references": [ { "id": "policyTemplateId-123", "version": "1" }, { "id": "policyTemplateId-234", "version": "1" } ] }' "{base_url}/v1/group_templates/{template_id}/versions"
Depois de criar e configurar uma nova versão do seu modelo de grupo de acesso, revise-o e atribua-o a contas secundárias. Você pode atribuir uma nova versão a contas secundárias que contenham uma versão anterior do modelo de grupo de acesso para atualizar uma atribuição sem problemas. Para obter mais informações, consulte Atribuição de um modelo de grupo de acesso a contas secundárias usando a API.
Exclusão de uma atribuição por meio da API
Você pode remover uma atribuição de modelo de uma conta ou grupo de contas ao qual o modelo está atribuído. Talvez você queira fazer isso se o modelo não estiver funcionando como pretendido ou não for mais necessário. Quando você remove uma atribuição de modelo de uma conta, por padrão, a versão anterior do modelo é restabelecida, caso exista. Se a atribuição que você remover for para a primeira ou única versão de um modelo, o grupo de acesso gerenciado pela empresa nas contas secundárias será removido.
Para remover uma atribuição, siga estas etapas:
-
Liste as atribuições e anote o endereço
AccessGroupAssignmentIdna resposta da atribuição que você deseja remover.curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_assignments?account_id=accountID-123&limit=50&offset=0" -
Remova a designação.
curl -X DELETE --location --header "Authorization: Bearer {iam_token}" "{base_url}/v1/group_assignments/{assignment_id}"
Excluindo uma versão por meio da API
Antes de excluir uma versão de modelo de grupo de acesso, você deve remover todas as atribuições dessa versão do modelo. Exclua uma versão específica executando as etapas a seguir:
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote a ID e a versão
AccessGroupTemplateIdna resposta da versão do modelo que você deseja excluir.curl -X GET --location --header "Authorization: Bearer {iam_token}" --header "Accept: application/json" "{base_url}/v1/group_templates?account_id=accountID-123&limit=50&offset=0&verbose=true" -
Excluir a versão.
curl -X DELETE --location --header "Authorization: Bearer {iam_token}" "{base_url}/v1/group_templates/{template_id}/versions/{version_num}"
Criação de um modelo de grupo de acesso usando a CLI
Considere o uso de modelos de grupos de acesso quando tiver muitas contas secundárias, requisitos de acesso comuns entre contas, requisitos de segurança rigorosos ou precisar fazer alterações nas políticas de acesso em sua empresa.
Você pode criar um modelo de grupo de acesso seguindo estas etapas:
-
Crie um arquivo JSON com sua definição de modelo de grupo de acesso. Para obter mais informações sobre os atributos que você pode usar, consulte a API de grupos de acesso IAM. O exemplo a seguir cria um modelo de grupo de acesso para gerentes que precisam de acesso de administrador a todos os serviços de gerenciamento de contas do IAM em contas secundárias para que possam gerenciar o acesso:
{ "name": "IAM Admin Group template", "description": "This access group template allows admin access to all IAM platform services in the account.", "account_id": "06a2e9d0614447e295824de8c8df7b4f", "access_group": { "name": "IAM Admin Group", "description": "This enterprise-managed access group allows admin access to all IAM platform services in the account. Managers are dynamically added.", "members": { "users": [ "IBMid-1234", "IBMid-2345" ], "services": [ "iam-ServiceId-123", "iam-ServiceId-234" ], "action_controls": { "add": "true", "remove": "false" } }, "assertions": { "rules": [ { "name": "Manager group rule", "expiration": 12, "realm_name": "https://idp.example.org/SAML2", "conditions": [ { "claim": "isManager", "operator": "EQUALS", "value": "true" } ], "action_controls": { "remove": "true", "update": "false" } } ], "action_controls": { "add": "false" } }, "action_controls": { "access": { "add": true } } }, "policy_template_references": [ { "id": "policyTemplateId-123", "version": "1" }, { "id": "policyTemplateId-234", "version": "1" } ], "externals": { "profile_template_ids": [ "profileTemplateId-123", "profileTemplateId-234" ] } } -
Use o método access-group-template-create, conforme mostrado na solicitação de exemplo a seguir:
ibmcloud iam access-group-template-create --output JSON --file /path/to/access_group_template.json
(Opcional) Adicionar membros
No exemplo anterior, dois usuários corporativos e dois IDs de serviço são adicionados ao modelo de grupo de acesso especificando seus IBMids.
Os membros da empresa que você adiciona a um modelo devem estar presentes tanto na conta da empresa quanto nas contas filhas às quais você deseja atribuir o modelo. Se um usuário ainda não for membro de uma conta secundária à qual você atribuiu um modelo, você poderá adicioná-lo a essa conta secundária.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar ou remover membros de grupos de acesso gerenciados pela empresa em suas contas. Talvez você queira permitir que eles adicionem membros para que possam incluir membros de suas contas que não podem ser adicionados a um modelo como um usuário corporativo. Os administradores do grupo de acesso sempre podem remover os membros que adicionaram quando alguém do grupo de acesso deixa a organização.
No exemplo anterior, o action_controls permite que os administradores de grupos de acesso em contas secundárias adicionem membros de suas próprias contas porque o add está definido como true e restringe
a remoção de membros da empresa porque o remove está definido como false.
(Opcional) Adicionar regras dinâmicas
É possível criar regras dinâmicas para adicionar automaticamente usuários federados em contas subordinadas a grupos de acesso gerenciados pela empresa, com base em atributos de identidade específicos. Defina as condições que devem ser atendidas pelos dados configurados no provedor de identidade ( IdP ) e transmitidos junto com a identificação federada do usuário durante o login. Antes de adicionar regras dinâmicas, você deve habilitar a autenticação de um provedor de identidade externo.
No exemplo anterior, os gerentes são adicionados dinamicamente ao grupo pelo site rules especificado na seção assertions. A duração da sessão é definida como 12 horas para usuários adicionados dinamicamente.
A associação ao grupo de acesso é revogada depois que esse período expira. Os usuários devem fazer login novamente para atualizar a sua associação ao grupo de acesso.
Controles de ação
Por padrão, os administradores de grupos de acesso não podem adicionar, remover ou atualizar regras dinâmicas para um grupo de acesso gerenciado pela empresa. Há dois níveis de controles de ação para a regra dinâmica:
- Controles de ação para cada regra específica que determinam se os administradores do grupo de acesso podem remover ou atualizar uma regra dinâmica específica
- Controles de ação que determinam se os administradores do grupo de acesso podem adicionar, remover ou atualizar regras dinâmicas para o grupo de acesso
Se ambos os níveis estiverem configurados, os controles de ação do nível interno para uma regra dinâmica específica terão precedência.
No exemplo anterior, os controles de ação de nível interno definem remove como true, o que permite que os administradores do grupo de acesso removam a regra. update é definido como false,
de modo que os administradores do grupo de acesso não podem atualizar a regra. O controle de ação de nível externo add está definido como false, portanto, os administradores de grupos de acesso não podem adicionar
novas regras dinâmicas.
(Opcional) Adicionar políticas de acesso
As políticas de acesso concedem acesso aos membros do seu grupo de acesso gerenciado pela empresa em contas secundárias. No exemplo anterior, os modelos de política existentes atribuem acesso no modelo de grupo de acesso usando policy_template_references.
Controles de ação
Por padrão, os administradores de grupos de acesso em contas secundárias não podem adicionar políticas de acesso a um grupo de acesso gerenciado pela empresa. No exemplo anterior, o controle de ação access para add é definido como true, para que os administradores de contas secundárias possam adicionar políticas ao grupo em suas contas.
Atualização de modelos de grupos de acesso usando a CLI
Você pode atualizar um modelo de grupo de acesso a qualquer momento antes que um modelo seja confirmado.
Para atualizar um modelo de grupo de acesso, siga estas etapas:
-
Atualize seu arquivo JSON com a nova definição de modelo de grupo de acesso. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de grupos de acesso IAM.
-
Use o método
access-group-template-version-updateconforme mostrado no exemplo de solicitação a seguir:ibmcloud iam access-group-template-version-update example-template-name 1 --file /path/to/access_group_template.jsonEsse exemplo de solicitação atualiza a versão
1de um modeloexample-template-name.
Revisão e confirmação do modelo de grupo de acesso usando a CLI
Revise o modelo de grupo de acesso e confirme-o para que nenhuma outra alteração possa ser feita na versão. Dessa forma, o administrador de atribuição de modelos pode ter certeza de que atribuirá a versão somente quando você confirmar que ela está pronta.
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote o endereço
iddo modelo que você deseja revisar e confirmar.ibmcloud iam access-group-templates -
Obtenha a versão do modelo e analise a resposta.
ibmcloud iam access-group-template example-template-name 1 -
Confirmar a versão do modelo.
ibmcloud iam access-group-template-version-commit example-template-name 1
Atribuição de um modelo de grupo de acesso a contas secundárias usando a CLI
Atribua o modelo de grupo de acesso a contas secundárias em sua empresa.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote o endereço
iddo modelo que deseja atribuir às contas secundárias.ibmcloud iam access-group-templates -
Atribua o modelo de grupo de acesso a um
AccountouAccountGroup.ibmcloud iam access-group-assignment-create example-template-name 1 --target-type Account --target example-account-id
Criação de uma nova versão usando a CLI
Se você quiser fazer alterações em um modelo de grupo de acesso que foi confirmado ou atribuído, crie uma nova versão. A inserção de um novo nome de modelo atualiza o nome do modelo desta versão e de todas as versões anteriores.
-
Liste os modelos de grupo de acesso em sua conta corporativa e anote o endereço
iddo modelo para o qual você deseja criar uma nova versão.ibmcloud iam access-group-templates -
Crie um arquivo JSON que inclua todas as atualizações que você deseja fazer. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de grupos de acesso IAM.
-
Crie uma nova versão usando o método
access-group-template-version-create, conforme mostrado na solicitação de exemplo a seguir:ibmcloud iam access-group-template-version-create example-template-id 1
Depois de criar e configurar uma nova versão do seu modelo de grupo de acesso, confirme-o e atribua-o às contas secundárias. Você pode atribuir uma nova versão a contas secundárias que contenham uma versão anterior do modelo de grupo de acesso. Nesse caso, a nova versão do modelo substitui a versão antiga. Para obter mais informações, consulte Atribuição de um modelo de grupo de acesso a contas secundárias usando a CLI.