Criação de modelos de configurações gerenciadas pela empresa
Em uma empresa com muitas contas secundárias, pode ser demorado e propenso a erros configurar manualmente as definições do IAM para cada conta. Certifique-se de que todas as contas em sua empresa atendam aos requisitos de segurança da organização usando modelos de configurações.
Você pode atribuir apenas um modelo de configurações a uma conta ou grupo de contas. Crie um modelo de configurações que se aplique à maioria das contas e crie um novo modelo somente para contas que tenham requisitos especiais. Por exemplo, você pode ter requisitos mais rigorosos de autenticação multifator (MFA) em contas de ambiente de produção.
Quando você atribui um modelo de configurações, os usuários de contas secundárias com a função de Administrador no serviço de identidade IAM ainda podem gerenciar as configurações de suas contas. Se houver configurações conflitantes entre as configurações definidas pelo modelo e as configurações gerenciadas na conta, a configuração mais rigorosa será aplicada à conta. Isso significa que a configuração mais restritiva tem precedência e é aplicada a essa conta específica.
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.
-
Seja um 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.
-
A configuração definida no nível da conta secundária será aplicada se a configuração gerenciada pela empresa for menos rigorosa ou removida.
Criação de um modelo de configurações
Considere o uso de modelos de configurações quando você tiver muitas contas secundárias que exigem as mesmas configurações de IAM. Por exemplo, sua organização pode ter padrões internos ou exigir conformidade com as normas do setor.
Para criar um modelo de configurações, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no IBM Cloud.
- Clique em Configurações > Criar.
- Digite um nome e uma descrição para o modelo de configurações que descreva sua finalidade para os usuários corporativos.
- Clique em Criar.
(Opcional) Adicionar configurações de conta IAM
Personalize sua empresa para atender aos requisitos comerciais e regulatórios, definindo as configurações de conta do IAM em contas secundárias.
Restringindo domínios para convites de conta
Por padrão, você pode enviar convites de conta para endereços de e-mail de qualquer domínio. No entanto, se você ativar a configuração Restringir convites de usuários, poderá limitar os convites apenas aos endereços de e-mail que pertencem aos domínios permitidos especificados. Para ativar restrições em domínios específicos, siga estas etapas:
- Ative a configuração Restringir convites de usuários na seção Conta. Quando essa configuração está ativada, a página Convidar usuário nas subcontas limita os convites a endereços de e-mail dos domínios permitidos especificados.
- Selecione Mais rigoroso ou Mais flexível para determinar como as configurações de modelo e subconta são aplicadas.
- Clique em Edit (Editar ) para modificar o domínio existente ou adicionar novos domínios à lista de permitidos. Esse recurso aumenta a segurança da sua conta e oferece a flexibilidade de atualizá-la a qualquer momento e adicionar mais domínios conforme necessário.
As restrições de domínio são implementadas por meio de definição de padrões de e-mail. Por exemplo, **@ibm.com, **@*.ibm.com, **@?.ibm.com. Um único asterisco * representa qualquer sequência
de zero ou mais caracteres em uma sequência, exceto que a sequência termina se for encontrado um ponto . ou um sinal de arroba @. Um asterisco duplo ** representa qualquer sequência de zeros ou mais
caracteres na sequência sem limite. Um ponto de interrogação ? representa qualquer caractere único.
Analisando mais detalhadamente o exemplo **@*.ibm.com. A parte do nome de usuário do endereço de e-mail especifica **. Como a sequência não é limitada por ., um endereço de e-mail como my.name.is.bob@us.ibm.com é válido. O subdomínio us também é válido porque é uma sequência de letras, em que a sequência termina com ..
Restringir a visibilidade do usuário
Por padrão, todos os usuários de uma conta podem ver todos os outros usuários na página Usuários. No entanto, ao ativar a configuração Restrict user list visibility (Restringir visibilidade da lista de usuários ), é possível controlar quais usuários são visíveis, de modo que cada usuário veja os membros da conta aos quais está diretamente associado.
Para aplicar restrições a usuários específicos, ative a configuração Restringir visibilidade da lista de usuários na seção Conta. Ele permite controlar como os usuários visualizam outros membros nas subcontas às quais esse modelo está atribuído.
Restringindo a criação de chaves de API pelos usuários
Por padrão, todos os membros de uma conta podem criar chaves de API do IBM Cloud®. No entanto, ao usar a configuração de criação de chave de API, esse acesso pode ser restrito para que somente os membros com o acesso correto possam criar essas chaves de API de usuário.
Restringir a capacidade de criar chaves de API faz sentido se você quiser que os usuários de uma conta secundária específica sempre façam login de forma interativa, ou seja, se você não quiser que sejam executados scripts de automação capazes de fazer o login dos usuários automaticamente por meio de uma chave de API. Para obter mais informações sobre chaves de API, consulte Gerenciando chaves de API do usuário.
Se você ativar a configuração “Restringir a criação de chaves de API”, os usuários da sua conta precisarão de uma autorização específica para criar chaves de API, inclusive o titular da conta. Para restringir quem pode criar chaves de API, use as etapas a seguir:
A ativação dessa configuração afeta apenas a criação de chaves de API do usuário. Ela não afeta as chaves de API para IDs de serviço.
- Ative a configuração Restrict API key creation (Restringir criação de chave de API ) na seção Account (Conta).
- Clique em Sim para confirmar.
Agora que a configuração que impede os usuários de criarem chaves de API está ativada, você pode criar um modelo de grupo de acesso que conceda o acesso necessário para permitir que usuários específicos continuem criando chaves de API de usuário. Lembre-se de que o titular da conta também precisa ter esse acesso explícito. Para obter mais informações, consulte Atribuição de acesso para criar chaves de API com restrições ativadas.
Impedindo que os usuários criem IDs de serviço
Por padrão, todos os membros de uma conta podem criar IDs de serviço. No entanto, ao usar a configuração de criação de ID de serviço, o acesso pode ser restrito para que somente os membros com o acesso correto possam criar IDs de serviço. Para obter mais informações sobre os IDs de serviço, consulte Criando e trabalhando com IDs de serviço.
Se você ativar a configuração de criação de IDs de serviço, os usuários das contas subordinadas precisarão de acesso específico para criar IDs de serviço, incluindo o titular da conta. Para restringir quem pode criar IDs de serviço, use as etapas a seguir:
- Ative a configuração Restringir criação de ID de serviço na seção Conta.
- Clique em Sim para confirmar.
Agora que a configuração está ativada para impedir que os usuários criem IDs de serviço, você pode criar um modelo de grupo de acesso que conceda o acesso necessário para permitir que usuários específicos continuem criando IDs de serviço. Lembre-se de que o titular da conta também precisa ter esse acesso explícito. Para obter mais informações, consulte “Atribuição de acesso para criar IDs de serviço com restrições ativadas”
Permitindo endereços IP específicos
Por padrão, todos os endereços IP podem ser usados para efetuar login no console do IBM Cloud® e acessar as APIs de infraestrutura clássica. Você pode especificar quais endereços IP têm acesso e quais estão restritos. Você pode especificar esse acesso para contas secundárias. Atualmente, apenas endereços IP públicos são suportados.
Quando você permite que apenas endereços IP específicos acessem uma conta IBM Cloud, os usuários não podem acessar a CLI do Shell IBM Cloud. Isso ocorre porque o Cloud Shell está hospedado em uma plataforma compartilhada que não pode atender à lista de permissões de endereços IP.
Os administradores de contas de crianças podem definir uma restrição de endereço IP para usuários individuais. Quando uma restrição de endereço IP é definida tanto para a conta quanto para o usuário, o endereço IP precisa atender a ambas as especificações para que seja possível gerar um token IAM.
Para restringir todos os usuários a usar apenas endereços IP específicos, conclua as etapas a seguir:
-
Na seção “Conta”, ative a configuração “Restringir acesso por endereço IP ”.
-
Insira os endereços IP. Os endereços IP listados são os únicos a partir dos quais os usuários das contas secundárias podem fazer login no site IBM Cloud®.
É possível inserir um único endereço IP
17.5.7.8, um intervalo de endereço IP17.5.7.8 - 17.5.9.5ou sub-redes IP17.5.7.8.0/16, ou um zona de redenetworkZoneName. Certifique-se de usar endereços IPv4 ou IPv6 e de separar diversos valores com uma vírgula. Se já existir uma restrição de endereço IP, o recurso substituirá a restrição. -
Clique em Salvar.
A conta secundária pode restringir o acesso a um subconjunto de IPs dentro da lista gerenciada pela empresa. Por exemplo, o administrador de uma conta secundária de produção pode especificar uma lista de permissões mais detalhada.
(Opcional) Adicionar configuração de autenticação
É útil considerar as informações a seguir antes de ativar a MFA em contas secundárias para garantir que você saiba como ela afeta todos os usuários nas contas secundárias:
- A ativação da autenticação multifatorial (MFA) para todos os usuários da sua conta afeta todos os membros da conta. Se os usuários da sua conta forem membros de várias contas IBM Cloud, eles deverão se inscrever para a MFA no próximo login, mesmo que não pretendam usar recursos na conta em que a MFA estiver ativada.
- As chaves de API para usuários e IDs de serviço continuam a funcionar após a MFA ser ativada.
- A MFA para as contas secundárias se aplica a logins de usuários, mas não se aplica a chamadas de API. Se um usuário tiver permissão para realizar chamadas de API para recursos na conta, ele poderá fazê-lo sem precisar concluir a autenticação de duas etapas (MFA). Se o usuário pertence a outras contas, o usuário pode fazer chamadas API para recursos em sua conta usando uma chave de API por meio de uma conta que não requereu a MFA.
- Planeje uma estratégia de comunicação e suporte para usuários em sua conta:
- Escolha uma data e hora que você planeja ativar a MFA que resulte no menor impacto para seus negócios.
- Notifique os usuários da sua conta após ativar a autenticação multifatorial (MFA), fornecendo informações sobre como configurá-la.
A ativação da MFA não afeta os usuários que já estão conectados porque a MFA entra em vigor somente no momento do login. Certifique-se de informar aos usuários das contas secundárias que a autenticação multifatorial (MFA) está ativada e explique o impacto que isso terá para eles no próximo login.
Para ativar a MFA em um modelo de configurações, conclua as etapas a seguir:
- Acesse a seção “Autenticação”.
- Selecione o tipo de autenticação multifatorial (MFA) que você deseja ativar na sua conta. Para obter mais informações sobre as opções de MFA, consulte Opções de MFA.
O nível de MFA definido pela conta secundária será aplicado se a configuração gerenciada pela empresa for menos rigorosa ou removida. Por exemplo, o administrador de uma conta secundária de produção pode especificar um nível mais rigoroso de MFA do que o definido pelo modelo de configurações gerenciadas pela empresa.
(Opcional) Adicionar configurações de sessão de login
Aumente a segurança das contas da sua empresa, exigindo que os usuários insiram suas credenciais de login em intervalos personalizados. Você pode selecionar o tempo que a sessão ativa de um usuário pode durar antes que ele precise inserir suas credenciais novamente. Também é possível escolher a duração que um usuário está inativo antes que eles sejam desconectados de sua sessão e tenham que inserir suas credenciais novamente.
Se um usuário for um membro de várias contas, o valor mais baixo de cada configuração será aplicado em sua sessão. Por exemplo, um usuário é titular de duas contas: dev account e prod account. Se prod account tiver um tempo limite de inatividade de 15 minutos e dev account tiver um tempo limite de inatividade de 30 minutos, o tempo limite de inatividade de 15 minutos será aplicado a ambas as contas.
Definir a duração das sessões ativas
Uma sessão ativa é por quanto tempo um usuário está trabalhando continuamente em sua conta. Como uma sessão ativa é calibrada também depende da duração da saída de sua sessão devido ao limite de inatividade. Por exemplo, se você configurar a saída para duas horas, o usuário precisará interagir com a conta uma vez entre essas duas horas.
Para definir as configurações de sessões ativas, conclua as etapas a seguir:
- Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
- Selecione seu modelo de configurações.
- Clique em Sessões de login.
- Vá até a seção “Sessões de login”, clique no ícone “ Editar ”
no bloco “Sessões ativas”.
- Insira o limite de tempo. A sessão mais longa pode durar 720 horas.
- Clique em Salvar.
Revisão de seu modelo de configurações
Revise o modelo de configurações 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 quando você confirmar que ela está pronta.
- Clique em Overview > Review.
- Verifique se o modelo de configurações está configurado de acordo com suas expectativas.
- Clique na caixa de seleção para confirmar que você não pode editar a versão.
- Clique em Confirmar.
Atribuição de um modelo de configurações a contas secundárias
Você pode atribuir as versões de apenas um modelo de configurações por vez na sua empresa. É possível atribuir versões diferentes do mesmo modelo de configurações, mas não é possível usar vários modelos de configurações em uma empresa. Talvez você queira atribuir versões diferentes a contas com requisitos diferentes, como contas de produção e de teste.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
Para atribuir um modelo de configurações, siga estas etapas:
- Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
- Selecione seu modelo de configurações.
- Clique em Assign accounts (Atribuir contas ).
- Selecione contas específicas ou grupos de contas inteiros em sua empresa.
Quando você seleciona um grupo de contas, todas as contas futuras que você adicionar a esse grupo de contas herdarão as configurações que você atribuir.
- Clique em Assign accounts (Atribuir contas ).
Se uma atribuição falhar, clique em Retry (Tentar novamente ).
Criação de uma nova versão
Para criar uma nova versão de um modelo de configurações, siga estas etapas:
-
Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
-
Selecione seu modelo de configurações.
-
Clique no ícone Nova versão Ícone
.
-
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 para esta versão e todas as versões anteriores. A descrição do modelo é armazenada separadamente para cada versão.
-
Selecione as configurações que você deseja transferir para a nova versão.
-
Clique em Criar.
-
Faça quaisquer outros ajustes na configuração.
-
Clique em Review 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 configurações, siga estas etapas:
- Acesse Gerenciar > Acesso (IAM) > Modelos no console do IBM Cloud.
- Clique em Configurações.
- Clique no ícone de expansão da tabela
no modelo com o qual você deseja trabalhar.
- Selecione a versão que é 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 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. 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, as preferências de configurações atribuídas na conta secundária serão removidas.
Para remover uma atribuição, siga estas etapas:
- Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
- Clique em Settings e selecione seu modelo de configurações.
- Clique em Assignments (Atribuições ).
- Clique no ícone Ações
> Remover na conta ou no grupo de contas em que você deseja remover a atribuição.
Quando você remove todas as atribuições de modelos de configurações, a configuração definida no nível da conta secundária é instalada.
Exclusão de um modelo de configurações
Antes de excluir um modelo de configurações, você deve remover todas as atribuições de todas as versões do modelo. A exclusão de um modelo de configuração exclui todas as versões.
Para excluir um modelo de configurações, siga estas etapas:
- Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
- Clique em Configurações.
- Clique no ícone Ações
no modelo de configurações que você deseja excluir.
- Clique em Excluir modelo.
- Confirme se deseja excluir o modelo de configurações.
Excluindo uma versão
Você também pode excluir uma versão específica executando as etapas a seguir: Para excluir um modelo de configurações, siga estas etapas:
- Clique em Gerenciar > Acesso (IAM) > Modelos > Configurações no console IBM Cloud®.
- Clique em Configurações.
- Clique no ícone de expansão da tabela
no modelo com o qual você deseja trabalhar.
- Clique no ícone Ações
na versão que você deseja excluir.
- Clique em Excluir versão.
- Confirme se deseja excluir a versão.
Criação de um modelo de configurações usando a CLI
Considere o uso de modelos de configurações quando você tiver muitas contas secundárias que exigem as mesmas configurações de IAM. Por exemplo, sua organização pode ter padrões internos ou exigir conformidade com as normas do setor.
Para criar um modelo de configurações usando a CLI, siga estas etapas:
-
Crie um arquivo JSON que configure a definição do modelo de configurações. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de identidade do IAM.
O exemplo de arquivo JSON a seguir especifica o
account_idda conta corporativa, onamedo modelo e oaccount_settings. A criação de chaves de API é restrita a usuários com a função API Key Creator no Identity Service. A criação de IDs de serviço não é restrita, portanto, todos os membros podem criar IDs de serviço nas contas em que o modelo de configurações é atribuído. O máximo de sessões por identidade está definido como5e a autenticação multifatorial está definida comoLEVEL3, o que exige que todos os usuários usem U2F MFA.{ "account_id": "5bbe28be34524sdbdaa34d37d1f2294a", "name": "AccountSettingsTemplate", "account_settings": { "restrict_create_platform_apikey": "RESTRICTED", "restrict_create_service_id": "NOT_RESTRICTED", "max_sessions_per_identity": 5, "mfa": "LEVEL3", } } -
Crie o modelo de configurações usando o comando
account-settings-template-create, conforme mostrado no exemplo de solicitação a seguir:ibmcloud iam account-settings-template-create AccountSettingsTemplate --file /path/to/account_settings_template.json
Atualização de um modelo de configurações usando a CLI
Você pode atualizar um modelo de configurações a qualquer momento antes de confirmá-lo. Para atualizar uma versão específica de um modelo de configurações de conta, conclua as etapas a seguir:
-
Atualize seu arquivo JSON com a nova configuração do modelo de definições. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de identidade do IAM.
O exemplo de arquivo JSON a seguir especifica o
account_idda conta corporativa, onamedo modelo e oaccount_settings. A nova configuração redefine o MFA paraNONEe remove as outras configurações.{ "account_id": "5bbe28be34524sdbdaa34d37d1f2294a", "name": "AccountSettingsTemplateUpdated", "account_settings": { "mfa": "NONE", }, }Quando você atualiza o nome do modelo, isso atualiza o nome de todas as versões.
-
Para atualizar uma versão específica de um modelo de configurações de conta, use o comando
account-settings-template-version-update, conforme mostrado no exemplo de solicitação a seguir:ibmcloud iam account-settings-template-version-update AccountSettingsTemplateUpdated 1 --file /path/to/account_settings_template.json
Confirmação de um modelo de configurações
Revise o modelo de configurações e confirme-o para que nenhuma outra alteração possa ser feita na versão. A confirmação de uma versão é uma etapa necessária para que você possa atribuí-la a contas secundárias. 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.
A solicitação de exemplo a seguir faz o commit da versão 1 do modelo de configurações chamado AccountSettingsTemplateUpdated:
ibmcloud iam account-settings-template-commit AccountSettingsTemplateUpdated 1
Atribuição de um modelo de configurações a contas secundárias usando a CLI
Você pode atribuir as versões de apenas um modelo de configurações por vez na sua empresa. É possível atribuir versões diferentes do mesmo modelo de configurações, mas não é possível usar vários modelos de configurações em uma empresa. Talvez você queira atribuir versões diferentes a contas com requisitos diferentes, como contas de produção e de teste.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
Para criar uma atribuição para um modelo de configurações de conta, conclua as etapas a seguir:
-
Liste os modelos de configurações em sua conta corporativa e anote o nome do modelo e o número da versão do modelo de configurações que você deseja atribuir às contas secundárias:
ibmcloud iam account-settings-templates -
Atribua o modelo a um
AccountouAccountGroupusando o comandoaccount-settings-assignment-create.ibmcloud iam account-settings-assignment-create AccountSettingsTemplateUpdated 1 AccountGroup 955fc2274567474f8da802d5c376504b
Se uma atribuição falhar, use o método account-settings-assigment-update para tentar novamente.
Criação de uma nova versão usando a CLI
Crie uma nova versão de um modelo de configurações de conta quando precisar fazer atualizações em uma versão confirmada. Para criar uma nova versão, siga as etapas a seguir.
-
Atualize seu arquivo JSON com a nova configuração do modelo de definições. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de identidade do IAM.
-
Use o método
account-settings-template-version-createpara criar uma nova versão. O exemplo de solicitação a seguir cria uma nova versão do modeloAccountSettingsUpdated.ibmcloud iam account-settings-template-version-create AccountSettingsUpdated --file /path/to/account_settings_template.json
Atualização de uma atribuição por meio da CLI
Atualize uma atribuição para tentar novamente uma atribuição com falha ou migrar para uma nova versão.
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.
-
Liste as atribuições na conta usando o método
account-settings-assignments. Anote o endereçoASSIGNMENT_IDpara a atribuição que você deseja atualizar. -
Atualize a atribuição das configurações da conta. Se estiver tentando novamente uma atribuição, use o mesmo número de versão. A solicitação de exemplo a seguir migra a atribuição
AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05bpara a versão 2.ibmcloud iam account-settings-assignment-update AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b 2
Removendo uma atribuição usando a CLI
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. 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, as preferências de configurações gerenciadas pela empresa na conta secundária serão removidas.
Para remover uma atribuição, siga estas etapas:
-
Liste as atribuições na conta usando o método
account-settings-assignments. Anote o endereçoASSIGNMENT_IDpara a atribuição que você deseja remover. -
Remova a atribuição usando o método
account-settings-assigment-delete. O exemplo de solicitação a seguir remove a atribuiçãoAccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b.ibmcloud iam account-settings-assignment-delete AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b
Excluindo uma versão usando a CLI
Antes de excluir uma versão do modelo de configurações, 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 configurações em sua conta corporativa e anote o nome do modelo e o número da versão que você deseja excluir:
ibmcloud iam account-settings-templates -
Excluir a versão:
ibmcloud iam account-settings-template-delete AccountSettingsTemplateUpdated 2 -
Para excluir todas as versões, repita essas etapas. Certifique-se de remover primeiro as atribuições de cada versão.
Criação de um modelo de configurações usando a API
Considere o uso de modelos de configurações quando você tiver muitas contas secundárias que exigem as mesmas configurações de IAM. Por exemplo, sua organização pode ter padrões internos ou exigir conformidade com as normas do setor.
Para criar um modelo de configurações usando a API, siga estas etapas:
-
Configurar a definição do modelo de configurações. Para obter mais informações sobre os atributos que você pode usar em seu arquivo JSON, consulte a API de identidade do IAM.
O exemplo de arquivo JSON a seguir especifica o
account_idda conta corporativa, onamedo modelo e oaccount_settings. A criação de chaves de API é restrita a usuários com a função API Key Creator no Identity Service. A criação de IDs de serviço não é restrita, portanto, todos os membros podem criar IDs de serviço nas contas em que o modelo de configurações é atribuído. O máximo de sessões por identidade está definido como5e a autenticação multifatorial está definida comoLEVEL3, o que exige que todos os usuários usem U2F MFA.curl -X POST 'https://iam.cloud.ibm.com/v1/account_settings_templates' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' -d '{ "account_id": "5bbe28be34524sdbdaa34d37d1f2294a", "name": "my template", "account_settings": { "restrict_create_platform_apikey": "RESTRICTED", "restrict_create_service_id": "NOT_RESTRICTED", "max_sessions_per_identity": 5, "mfa": "LEVEL3", }, }'AccountSettingsComponent accountSettings = new AccountSettingsComponent.Builder() .mfa("LEVEL1") .systemAccessTokenExpirationInSeconds("3000") .build(); CreateAccountSettingsTemplateOptions createOptions = new CreateAccountSettingsTemplateOptions.Builder() .accountId(enterpriseAccountId) .name(accountSettingsTemplateName) .description("IAM enterprise account settings template example") .accountSettings(accountSettings) .build(); Response<AccountSettingsTemplateResponse> createResponse = service.createAccountSettingsTemplate(createOptions).execute(); AccountSettingsTemplateResponse createResult = createResponse.getResult(); // Save the id for use by other test methods. accountSettingsTemplateId = createResult.getId(); accountSettingsTemplateVersion = createResult.getVersion().longValue(); System.out.println(createResult);const settings = { mfa: "LEVEL1", system_access_token_expiration_in_seconds: "3000", } const templateParams = { name: "Example-Account-Settings-Template", description: "IAM enterprise account settings template example", accountId: enterpriseAccountId, accountSettings: settings, } try { const res = await iamIdentityService.createAccountSettingsTemplate(templateParams); accountSettingsTemplateEtag = res.headers.etag; const { result } = res; accountSettingsTemplateId = result.id; accountSettingsTemplateVersion = result.version; console.log(JSON.stringify(result, null, 2)); } catch (err) { console.warn(err); }account_settings = {} account_settings['mfa'] = 'LEVEL1' account_settings['system_access_token_expiration_in_seconds'] = 3000 create_response = iam_identity_service.create_account_settings_template( name='Example-Account-Settings-Template', description='IAM enterprise account settings template example', account_id=enterprise_account_id, account_settings=account_settings, ) account_settings_template = create_response.get_result() print('\ncreate_account_settings_template() response: ', json.dumps(account_settings_template, indent=2)) global account_settings_template_id account_settings_template_id = account_settings_template['id'] global account_settings_template_version account_settings_template_version = account_settings_template['version']settings := &iamidentityv1.AccountSettingsComponent{ Mfa: core.StringPtr("LEVEL1"), SystemAccessTokenExpirationInSeconds: core.StringPtr("3000"), } createOptions := &iamidentityv1.CreateAccountSettingsTemplateOptions{ Name: &accountSettingsTemplateName, Description: core.StringPtr("GoSDK test Account Settings Template"), AccountID: &enterpriseAccountID, AccountSettings: settings, } createResponse, response, err := iamIdentityService.CreateAccountSettingsTemplate(createOptions) b, _ := json.MarshalIndent(createResponse, "", " ") fmt.Println(string(b)) // Grab the ID and Etag value from the response for use in the update operation. accountSettingsTemplateId = *createResponse.ID accountSettingsTemplateVersion = *createResponse.Version accountSettingsTemplateEtag = response.GetHeaders().Get("Etag")
Atualização de um modelo de configurações por meio da API
Você pode atualizar um modelo de configurações a qualquer momento antes de confirmá-lo. Para atualizar uma versão específica de um modelo de configurações de conta, conclua as etapas a seguir:
-
Liste os modelos de configurações em sua conta corporativa e anote o
AccountSettingsTemplateID e o ETag na resposta da versão do modelo que você deseja atualizar.curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_templates?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'ListAccountSettingsTemplatesOptions listOptions = new ListAccountSettingsTemplatesOptions.Builder() .accountId(enterpriseAccountId) .build(); Response<AccountSettingsTemplateList> response = service.listAccountSettingsTemplates(listOptions).execute(); AccountSettingsTemplateList result = response.getResult(); System.out.println(result);const params = { accountId: enterpriseAccountId, } try { const res = await iamIdentityService.listAccountSettingsTemplates(params); console.log(JSON.stringify(res.result, null, 2)); } catch (err) { console.warn(err); }list_response = iam_identity_service.list_account_settings_templates(account_id=enterprise_account_id) account_settings_template_list = list_response.get_result() print('\nlist_account_settings_templates response: ', json.dumps(account_settings_template_list, indent=2))listOptions := &iamidentityv1.ListAccountSettingsTemplatesOptions{ AccountID: &enterpriseAccountID, } listResponse, response, err := iamIdentityService.ListAccountSettingsTemplates(listOptions) b, _ := json.MarshalIndent(listResponse, "", " ") fmt.Println(string(b)) -
Atualizar a definição do modelo de configurações.
Quando você atualiza o nome do modelo, isso atualiza o nome de todas as versões.
curl -X POST 'https://iam.cloud.ibm.com/v1/account_settings_templates/{template_id}/version' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' -d '{ "account_id": "5bbe28be34524sdbdaa34d37d1f2294a", "name": "my template name", "account_settings": { "mfa": "NONE", }, }'AccountSettingsComponent accountSettings = new AccountSettingsComponent.Builder() .mfa("LEVEL1") .systemAccessTokenExpirationInSeconds("3000") .build(); UpdateAccountSettingsTemplateVersionOptions updateOptions = new UpdateAccountSettingsTemplateVersionOptions.Builder() .accountId(enterpriseAccountId) .templateId(accountSettingsTemplateId) .version(Long.toString(accountSettingsTemplateVersion)) .ifMatch(accountSettingsTemplateEtag) .name(accountSettingsTemplateName) .description("IAM enterprise account settings template example - updated") .accountSettings(accountSettings) .build(); Response<AccountSettingsTemplateResponse> updateResponse = service.updateAccountSettingsTemplateVersion(updateOptions).execute(); AccountSettingsTemplateResponse updateResult = updateResponse.getResult(); accountSettingsTemplateEtag = updateResponse.getHeaders().values("Etag").get(0); System.out.println(updateResult);const settings = { mfa: "LEVEL1", system_access_token_expiration_in_seconds: "3000", } const params = { accountId: enterpriseAccountId, templateId: accountSettingsTemplateId, version: accountSettingsTemplateVersion, ifMatch: accountSettingsTemplateEtag, name: "Example-Account-Settings-Template", description: "IAM enterprise account settings template example - updated", accountSettings: settings, } try { const res = await iamIdentityService.updateAccountSettingsTemplateVersion(params); accountSettingsTemplateEtag = res.headers.etag; console.log(JSON.stringify(res.result, null, 2)); } catch (err) { console.warn(err); }account_settings = {} account_settings['mfa'] = 'LEVEL1' account_settings['system_access_token_expiration_in_seconds'] = 3000 update_response = iam_identity_service.update_account_settings_template_version( account_id=enterprise_account_id, template_id=account_settings_template_id, version=str(account_settings_template_version), if_match=account_settings_template_etag, name='Example-Account-Settings-Template', description='IAM enterprise account settings template example - updated', account_settings=account_settings, ) account_settings_template = update_response.get_result() print('\nupdate_account_settings_template() response: ', json.dumps(account_settings_template, indent=2)) account_settings_template_etag = update_response.get_headers()['Etag']settings := &iamidentityv1.AccountSettingsComponent{ Mfa: core.StringPtr("LEVEL1"), SystemAccessTokenExpirationInSeconds: core.StringPtr("3000"), } updateOptions := &iamidentityv1.UpdateAccountSettingsTemplateVersionOptions{ AccountID: &enterpriseAccountID, TemplateID: &accountSettingsTemplateId, Version: core.StringPtr(strconv.FormatInt(accountSettingsTemplateVersion, 10)), IfMatch: &accountSettingsTemplateEtag, Name: &accountSettingsTemplateName, Description: core.StringPtr("GoSDK test Account Settings Template - updated"), AccountSettings: settings, } updateResponse, response, err := iamIdentityService.UpdateAccountSettingsTemplateVersion(updateOptions) b, _ := json.MarshalIndent(updateResponse, "", " ") fmt.Println(string(b)) accountSettingsTemplateEtag = response.GetHeaders().Get("Etag")
Confirmação de um modelo de configurações usando a API
Revise o modelo de configurações e confirme-o para que nenhuma outra alteração possa ser feita na versão. A confirmação de uma versão é uma etapa necessária para que você possa atribuí-la a contas secundárias. 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.
-
Obtenha a versão de um modelo de perfil confiável que você deseja revisar e confirmar.
curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_templates/AccountSettingsTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9/versions/1' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'GetAccountSettingsTemplateVersionOptions getOptions = new GetAccountSettingsTemplateVersionOptions.Builder() .templateId(accountSettingsTemplateId) .version(Long.toString(accountSettingsTemplateVersion)) .build(); Response<AccountSettingsTemplateResponse> response = service.getAccountSettingsTemplateVersion(getOptions).execute(); AccountSettingsTemplateResponse getResult = response.getResult(); // Grab the Etag value from the response for use in the update operation. accountSettingsTemplateEtag = response.getHeaders().values("Etag").get(0); System.out.println(getResult);get_response = iam_identity_service.get_account_settings_template_version( template_id=account_settings_template_id, version=str(account_settings_template_version) ) account_settings_template = get_response.get_result() print('\nget_account_settings_template response: ', json.dumps(account_settings_template, indent=2)) global account_settings_template_etag account_settings_template_etag = get_response.get_headers()['Etag']get_response = iam_identity_service.get_account_settings_template_version( template_id=account_settings_template_id, version=str(account_settings_template_version) ) account_settings_template = get_response.get_result() print('\nget_account_settings_template response: ', json.dumps(account_settings_template, indent=2)) global account_settings_template_etag account_settings_template_etag = get_response.get_headers()['Etag']getOptions := &iamidentityv1.GetAccountSettingsTemplateVersionOptions{ TemplateID: &accountSettingsTemplateId, Version: core.StringPtr(strconv.FormatInt(accountSettingsTemplateVersion, 10)), } getResponse, response, err := iamIdentityService.GetAccountSettingsTemplateVersion(getOptions) b, _ := json.MarshalIndent(getResponse, "", " ") fmt.Println(string(b)) // Grab the Etag value from the response for use in the update operation. accountSettingsTemplateEtag = response.GetHeaders().Get("Etag") -
Revise a resposta para confirmar que ela está pronta para ser confirmada.
-
Confirmar a versão do modelo de perfil confiável.
curl -X POST 'https://iam.cloud.ibm.com/v1/account_settings_templates/{template_id}/{version}/commit' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'CommitAccountSettingsTemplateOptions commitOptions = new CommitAccountSettingsTemplateOptions.Builder() .templateId(accountSettingsTemplateId) .version(Long.toString(accountSettingsTemplateVersion)) .build(); Response<Void> commitResponse = service.commitAccountSettingsTemplate(commitOptions).execute();const commitParams = { templateId: accountSettingsTemplateId, version: accountSettingsTemplateVersion, } try { const res = await iamIdentityService.commitAccountSettingsTemplate(commitParams); } catch (err) { console.warn(err); }commit_response = iam_identity_service.commit_account_settings_template( template_id=account_settings_template_id, version=str(account_settings_template_version) )commitOptions := &iamidentityv1.CommitAccountSettingsTemplateOptions{ TemplateID: &accountSettingsTemplateId, Version: core.StringPtr(strconv.FormatInt(accountSettingsTemplateVersion, 10)), } response, err := iamIdentityService.CommitAccountSettingsTemplate(commitOptions)
Atribuição de um modelo de configurações a contas secundárias usando a API
Você pode atribuir as versões de apenas um modelo de configurações por vez na sua empresa. É possível atribuir versões diferentes do mesmo modelo de configurações, mas não é possível usar vários modelos de configurações em uma empresa. Talvez você queira atribuir versões diferentes a contas com requisitos diferentes, como contas de produção e de teste.
Não é possível atribuir um modelo IAM à conta corporativa, apenas a contas secundárias.
Para criar uma atribuição para um modelo de configurações de conta, conclua as etapas a seguir:
-
Liste os modelos de configurações em sua conta corporativa e anote o
AccountSettingsTemplateID e o ETag na resposta para a versão do modelo que você deseja atribuir às contas secundárias.curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_templates?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'ListAccountSettingsTemplatesOptions listOptions = new ListAccountSettingsTemplatesOptions.Builder() .accountId(enterpriseAccountId) .build(); Response<AccountSettingsTemplateList> response = service.listAccountSettingsTemplates(listOptions).execute(); AccountSettingsTemplateList result = response.getResult(); System.out.println(result);const params = { accountId: enterpriseAccountId, } try { const res = await iamIdentityService.listAccountSettingsTemplates(params); console.log(JSON.stringify(res.result, null, 2)); } catch (err) { console.warn(err); }list_response = iam_identity_service.list_account_settings_templates(account_id=enterprise_account_id) account_settings_template_list = list_response.get_result() print('\nlist_account_settings_templates response: ', json.dumps(account_settings_template_list, indent=2))listOptions := &iamidentityv1.ListAccountSettingsTemplatesOptions{ AccountID: &enterpriseAccountID, } listResponse, response, err := iamIdentityService.ListAccountSettingsTemplates(listOptions) b, _ := json.MarshalIndent(listResponse, "", " ") fmt.Println(string(b)) -
Atribua o modelo de configurações a um
AccountouAccountGroup.curl -X POST 'https://iam.cloud.ibm.com/v1/account_settings_assignments' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' -d '{ "template_id": "AccountSettingsTemplate-cac1b203-5956-4981-bdec-0a4af4feab4d", "template_version": 1, "target_type": "Account", "target": "5bbe28be34524e88a34d37d1f2294a8a" }'CreateAccountSettingsAssignmentOptions assignOptions = new CreateAccountSettingsAssignmentOptions.Builder() .templateId(accountSettingsTemplateId) .templateVersion(accountSettingsTemplateVersion) .targetType("Account") .target(enterpriseSubAccountId) .build(); Response<TemplateAssignmentResponse> assignResponse = service.createAccountSettingsAssignment(assignOptions).execute(); TemplateAssignmentResponse assignmentResult = assignResponse.getResult(); // Save the id for use by other test methods. accountSettingsTemplateAssignmentId = assignmentResult.getId(); // Grab the Etag value from the response for use in the update operation. accountSettingsTemplateAssignmentEtag = assignResponse.getHeaders().values("Etag").get(0); System.out.println(assignmentResult);const assignParams = { templateId: accountSettingsTemplateId, templateVersion: accountSettingsTemplateVersion, targetType: "Account", target: enterpriseSubAccountId, } try { const assRes = await iamIdentityService.createAccountSettingsAssignment(assignParams); const { result } = assRes; accountSettingsTemplateAssignmentId = result.id; accountSettingsTemplateAssignmentEtag= assRes.headers.etag; console.log(JSON.stringify(result, null, 2)); } catch (err) { console.warn(err); }assign_response = iam_identity_service.create_account_settings_assignment( template_id=account_settings_template_id, template_version=account_settings_template_version, target_type='Account', target=enterprise_subaccount_id, ) assignment = assign_response.get_result() print('\ncreate_account_settings_assignment() response: ', json.dumps(assignment, indent=2)) global account_settings_template_assignment_id account_settings_template_assignment_id = assignment['id'] global account_settings_template_assignment_etag account_settings_template_assignment_etag = assign_response.get_headers()['Etag']assignOptions := &iamidentityv1.CreateAccountSettingsAssignmentOptions{ TemplateID: &accountSettingsTemplateId, TemplateVersion: &accountSettingsTemplateVersion, TargetType: core.StringPtr("Account"), Target: &enterpriseSubAccountID, } assignResponse, response, err := iamIdentityService.CreateAccountSettingsAssignment(assignOptions) b, _ := json.MarshalIndent(assignResponse, "", " ") fmt.Println(string(b)) accountSettingsTemplateAssignmentEtag = response.GetHeaders().Get("Etag") accountSettingsTemplateAssignmentId = *assignResponse.ID
Se uma atribuição falhar, use o método account-settings-assigment-update para tentar novamente.
Criação de uma nova versão usando a API
Se você quiser fazer alterações em um modelo de configurações que foi confirmado ou atribuído, crie uma nova versão.
settings := &iamidentityv1.AccountSettingsComponent{
Mfa: core.StringPtr("LEVEL1"),
SystemAccessTokenExpirationInSeconds: core.StringPtr("2600"),
RestrictCreatePlatformApikey: core.StringPtr("RESTRICTED"),
RestrictCreateServiceID: core.StringPtr("RESTRICTED"),
}
createOptions := &iamidentityv1.CreateAccountSettingsTemplateVersionOptions{
Name: &accountSettingsTemplateName,
Description: core.StringPtr("GoSDK test Account Settings Template - new version"),
AccountID: &enterpriseAccountID,
TemplateID: &accountSettingsTemplateId,
AccountSettings: settings,
}
createResponse, response, err := iamIdentityService.CreateAccountSettingsTemplateVersion(createOptions)
b, _ := json.MarshalIndent(createResponse, "", " ")
fmt.Println(string(b))
accountSettingsTemplateVersion = *createResponse.Version
Salve a ID AccountSettingsTemplate e a versão da nova versão para usar em chamadas subsequentes.
Atualização de uma tarefa por meio da API
Atualize uma atribuição para migrar para uma nova versão ou tente novamente uma atribuição que falhou.
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.
- Liste as atribuições de modelos de configurações em sua conta corporativa e anote o ID da atribuição, o ETag e a versão da atribuição que você deseja atualizar:
curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_assignments?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'
ListAccountSettingsTemplatesOptions listOptions = new ListAccountSettingsTemplatesOptions.Builder()
.accountId(enterpriseAccountId)
.build();
Response<AccountSettingsTemplateList> listResponse = service.listAccountSettingsTemplates(listOptions).execute();
AccountSettingsTemplateList listResult = listResponse.getResult();
System.out.println(listResult);
const params = {
accountId: enterpriseAccountId,
templateId: accountSettingsTemplateId,
}
try {
const res = await iamIdentityService.listAccountSettingsAssignments(params);
console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
console.warn(err);
}
list_response = iam_identity_service.list_account_settings_assignments(
account_id=enterprise_account_id, template_id=account_settings_template_id
)
assignment_list = list_response.get_result()
print('\ncreate_account_settings_assignment() response: ', json.dumps(assignment_list, indent=2))
listOptions := &iamidentityv1.ListAccountSettingsAssignmentsOptions{
AccountID: &enterpriseAccountID,
TemplateID: &accountSettingsTemplateId,
}
listResponse, response, err := iamIdentityService.ListAccountSettingsAssignments(listOptions)
b, _ := json.MarshalIndent(listResponse, "", " ")
fmt.Println(string(b))
- Atualize a atribuição das configurações da conta. Se estiver tentando novamente uma atribuição, use o mesmo número de versão.
curl -X PATCH 'https://iam.cloud.ibm.com/v1/account_settings_assignments/<assignment_id>' -H 'Authorization: Bearer $TOKEN' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN' -d '{
"template_version": 2
}'
UpdateAccountSettingsAssignmentOptions updateOptions = new UpdateAccountSettingsAssignmentOptions.Builder()
.assignmentId(accountSettingsTemplateAssignmentId)
.templateVersion(accountSettingsTemplateVersion)
.ifMatch(accountSettingsTemplateAssignmentEtag)
.build();
Response<TemplateAssignmentResponse> updateResponse = service.updateAccountSettingsAssignment(updateOptions).execute();
TemplateAssignmentResponse updateResult = updateResponse.getResult();
// Grab the Etag value from the response for use in the update operation.
accountSettingsTemplateAssignmentEtag = updateResponse.getHeaders().values("Etag").get(0);
System.out.println(updateResult);
const assignParams = {
assignmentId: accountSettingsTemplateAssignmentId,
templateVersion: accountSettingsTemplateVersion,
ifMatch: accountSettingsTemplateAssignmentEtag,
}
try {
const assRes = await iamIdentityService.updateAccountSettingsAssignment(assignParams);
console.log(JSON.stringify(assRes.result, null, 2));
} catch (err) {
console.warn(err);
}
assign_response = iam_identity_service.update_account_settings_assignment(
assignment_id=account_settings_template_assignment_id,
template_version=account_settings_template_version,
if_match=account_settings_template_assignment_etag,
)
assignment = assign_response.get_result()
print('\nupdate_account_settings_template_assignment response: ', json.dumps(assignment, indent=2))
account_settings_template_assignment_etag = assign_response.get_headers()['Etag']
updateOptions := &iamidentityv1.UpdateAccountSettingsAssignmentOptions{
AssignmentID: &accountSettingsTemplateAssignmentId,
TemplateVersion: &accountSettingsTemplateVersion,
IfMatch: &accountSettingsTemplateAssignmentEtag,
}
updateResponse, response, err := iamIdentityService.UpdateAccountSettingsAssignment(updateOptions)
b, _ := json.MarshalIndent(updateResponse, "", " ")
fmt.Println(string(b))
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. 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, as preferências de configurações gerenciadas pela empresa na conta secundária serão removidas.
Para remover uma atribuição, siga estas etapas:
- Liste as atribuições na conta e anote o ID da atribuição que você deseja remover.
curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_assignments?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'
ListAccountSettingsTemplatesOptions listOptions = new ListAccountSettingsTemplatesOptions.Builder()
.accountId(enterpriseAccountId)
.build();
Response<AccountSettingsTemplateList> listResponse = service.listAccountSettingsTemplates(listOptions).execute();
AccountSettingsTemplateList listResult = listResponse.getResult();
System.out.println(listResult);
const params = {
accountId: enterpriseAccountId,
templateId: accountSettingsTemplateId,
}
try {
const res = await iamIdentityService.listAccountSettingsAssignments(params);
console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
console.warn(err);
}
list_response = iam_identity_service.list_account_settings_assignments(
account_id=enterprise_account_id, template_id=account_settings_template_id
)
assignment_list = list_response.get_result()
print('\ncreate_account_settings_assignment() response: ', json.dumps(assignment_list, indent=2))
listOptions := &iamidentityv1.ListAccountSettingsAssignmentsOptions{
AccountID: &enterpriseAccountID,
TemplateID: &accountSettingsTemplateId,
}
listResponse, response, err := iamIdentityService.ListAccountSettingsAssignments(listOptions)
b, _ := json.MarshalIndent(listResponse, "", " ")
fmt.Println(string(b))
- Remova a designação.
A remoção de uma atribuição pode fazer com que uma atribuição anterior se torne ativa. Para obter mais informações, consulte Trabalho com versões de modelos.
curl -X DELETE 'https://iam.cloud.ibm.com/v1/account_settings_assignments/<assignment_id>' -H 'Authorization: Bearer $TOKEN' }'
DeleteAccountSettingsAssignmentOptions deleteOptions = new DeleteAccountSettingsAssignmentOptions.Builder()
.assignmentId(accountSettingsTemplateAssignmentId)
.build();
Response<ExceptionResponse> deleteResponse = service.deleteAccountSettingsAssignment(deleteOptions).execute();
const params = {
assignmentId: accountSettingsTemplateAssignmentId,
}
try {
const res = await iamIdentityService.deleteAccountSettingsAssignment(params);
} catch (err) {
console.warn(err);
}
delete_response = iam_identity_service.delete_account_settings_assignment(
assignment_id=account_settings_template_assignment_id
)
deleteOptions := &iamidentityv1.DeleteAccountSettingsAssignmentOptions{
AssignmentID: &accountSettingsTemplateAssignmentId,
}
excResponse, response, err := iamIdentityService.DeleteAccountSettingsAssignment(deleteOptions)
Exclusão de uma versão por meio da API
Antes de excluir uma versão do modelo de configurações, 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 configuração em sua conta corporativa e anote o ID do modelo de configuração e o número da versão que você deseja excluir:
curl -X GET 'https://iam.cloud.ibm.com/v1/account_settings_templates?account_id=5bbe28be34524sdbdaa34d37d1f2294a' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'
ListAccountSettingsTemplatesOptions listOptions = new ListAccountSettingsTemplatesOptions.Builder()
.accountId(enterpriseAccountId)
.build();
Response<AccountSettingsTemplateList> response = service.listAccountSettingsTemplates(listOptions).execute();
AccountSettingsTemplateList result = response.getResult();
System.out.println(result);
const params = {
accountId: enterpriseAccountId,
}
try {
const res = await iamIdentityService.listAccountSettingsTemplates(params);
console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
console.warn(err);
}
list_response = iam_identity_service.list_account_settings_templates(account_id=enterprise_account_id)
account_settings_template_list = list_response.get_result()
print('\nlist_account_settings_templates response: ', json.dumps(account_settings_template_list, indent=2))
listOptions := &iamidentityv1.ListAccountSettingsTemplatesOptions{
AccountID: &enterpriseAccountID,
}
listResponse, response, err := iamIdentityService.ListAccountSettingsTemplates(listOptions)
b, _ := json.MarshalIndent(listResponse, "", " ")
fmt.Println(string(b))
- Excluir a versão:
Exclusão de todas as versões usando a API
Certifique-se de remover primeiro as atribuições de cada versão.
curl -X DELETE 'https://iam.cloud.ibm.com/v1/account_settings_templates/AccountSettingsTemplate-767fc1f6-c77c-4196-b3d6-a009a5a536e9' -H 'Content-Type: application/json' -H 'Authorization: Bearer $TOKEN'
DeleteAllVersionsOfAccountSettingsTemplateOptions deleteTeplateOptions = new DeleteAllVersionsOfAccountSettingsTemplateOptions.Builder()
.templateId(accountSettingsTemplateId)
.build();
Response<Void> deleteResponse = service.deleteAllVersionsOfAccountSettingsTemplate(deleteTeplateOptions).execute();
const params = {
templateId: accountSettingsTemplateId,
}
try {
const res = await iamIdentityService.deleteAllVersionsOfAccountSettingsTemplate(params);
} catch (err) {
console.warn(err);
}
delete_response = iam_identity_service.delete_all_versions_of_account_settings_template(
template_id=account_settings_template_id
)
deleteOptions := &iamidentityv1.DeleteAllVersionsOfAccountSettingsTemplateOptions{
TemplateID: &accountSettingsTemplateId,
}
response, err := iamIdentityService.DeleteAllVersionsOfAccountSettingsTemplate(deleteOptions)
Limitações do modelo de configurações
Apenas um modelo de configurações pode ser atribuído em uma empresa. Você pode atribuir várias versões do modelo, mas não modelos diferentes.