Creación de una plantilla de configuración

Considere la posibilidad de utilizar plantillas de configuración cuando tenga muchas cuentas secundarias que requieran la misma configuración de IAM. Por ejemplo, su organización podría tener normas internas o exigir el cumplimiento de la normativa del sector.

Para crear una plantilla de configuración, sigue estos pasos:

1. Ve a «Gestionar» > «Acceso (IAM)» > «Plantillas» en IBM Cloud.
2. Haga clic en Configuración > Crear.
3. Introduzca un nombre y una descripción para la plantilla de configuración que describa su propósito para los usuarios empresariales.
4. Pulse Crear.

Revisar su plantilla de configuración

Revise la plantilla de configuración y confírmela para que no se puedan realizar más cambios en la versión. De esta manera, el administrador de asignación de plantillas puede estar seguro de que asigna la versión cuando usted confirma que está lista.

1. Haga clic en Resumen > Revisar.
2. Verifique que la plantilla de configuración esté configurada según sus expectativas.
3. Haga clic en la casilla de verificación para confirmar que no puede editar la versión.
4. Pulse Confirmar.

Asignación de una plantilla de configuración a cuentas secundarias

En tu empresa solo puedes asignar las versiones de una única plantilla de configuración a la vez. Puede asignar diferentes versiones de la misma plantilla de configuración, pero no puede utilizar varias plantillas de configuración en una empresa. Puede que desee asignar versiones diferentes a cuentas con requisitos diferentes, como cuentas de producción y de prueba.

No puede asignar una plantilla de IAM a la cuenta de empresa, solo a las cuentas secundarias.

Para asignar una plantilla de configuración, sigue estos pasos:

1. Haga clic en Administrar > Acceso (IAM) > Plantillas > Configuración en la consola de IBM Cloud®.
2. Selecciona tu plantilla de configuración.
3. Haga clic en Asignar cuentas.
4. Seleccione cuentas específicas o grupos de cuentas completos en su empresa.

Cuando selecciona un grupo de cuentas, todas las cuentas futuras que añada a ese grupo de cuentas heredan la configuración que usted asigne.

1. Haga clic en Asignar cuentas.

Si una asignación falla, haga clic en Reintentar.

Crear una nueva versión

Para crear una nueva versión de una plantilla de configuración, sigue estos pasos:

1. Haga clic en Administrar > Acceso (IAM) > Plantillas > Configuración en la consola de IBM Cloud®.

2. Selecciona tu plantilla de configuración.

3. Haga clic en el icono Nueva versión. .

4. Introduzca un nuevo nombre y descripción de plantilla o mantenga los que ya está utilizando.

   Al introducir un nuevo nombre de plantilla, se actualiza el nombre de la plantilla para esta versión y todas las versiones anteriores. La descripción de la plantilla se almacena por separado para cada versión.

5. Seleccione la configuración que desea transferir a su nueva versión.

6. Pulse Crear.

7. Realiza cualquier otro ajuste en la configuración.

8. Haga clic en Revisar y confirme la nueva versión. Para obtener más información, consulte Revisar su plantilla de grupo de acceso.

Para asignar una nueva versión de una plantilla de configuración, sigue estos pasos:

1. Ve a «Gestionar» > «Acceso (IAM)» > «Plantillas» en la consola de IBM Cloud.
2. Pulse Valores.
3. Haga clic en el icono de Expandir tabla en la plantilla con la que desea trabajar.
4. Seleccione la versión asignada a las cuentas secundarias.
5. Haga clic en Asignaciones.
6. Haga clic en Actualizar en la cuenta o en la asignación de grupo de cuentas donde desee asignar una versión diferente.
7. Haz clic en « Seleccionar una versión ».
   1. Seleccione la versión que desea reemplazar por la versión actual.
8. Pulse Actualizar.
9. Repita estos pasos para cada cuenta o grupo de cuentas a las que desee asignar una versión diferente.

La nueva versión de plantilla que asignas reemplaza a la versión antigua. Más información sobre Asignación de una nueva versión.

Eliminar una asignación

Puede eliminar la asignación de una plantilla de una cuenta o grupo de cuentas a la que esté asignada. Puede que desee hacerlo si la plantilla no funciona como debería. Cuando eliminas una asignación de plantilla de una cuenta, por defecto se restablece la versión anterior de la plantilla. Si la asignación que eliminas es para la primera o única versión de una plantilla, se eliminan las preferencias de configuración asignadas en la cuenta secundaria.

Para eliminar una asignación, sigue estos pasos:

1. Haga clic en Administrar > Acceso (IAM) > Plantillas > Configuración en la consola de IBM Cloud®.
2. Haga clic en Configuración y seleccione su plantilla de configuración.
3. Haga clic en Asignaciones.
4. Haga clic en el icono > Eliminar en la cuenta o grupo de cuentas donde desea eliminar la asignación.

Cuando elimina todas las asignaciones de plantillas de configuración, se restablece la configuración definida en el nivel de la cuenta secundaria.

Eliminar una plantilla de configuración

Antes de poder eliminar una plantilla de configuración, debe eliminar todas las asignaciones de todas las versiones de la plantilla. Al eliminar una plantilla de configuración se eliminan todas las versiones.

Para eliminar una plantilla de configuración, sigue estos pasos:

1. Haga clic en Administrar > Acceso (IAM) > Plantillas > Configuración en la consola de IBM Cloud®.
2. Pulse Valores.
3. Haga clic en el icono en la plantilla de configuración que desea eliminar.
4. Haga clic en Eliminar plantilla.
5. Confirma que deseas eliminar la plantilla de configuración.

Creación de una plantilla de configuración mediante la CLI

Considere la posibilidad de utilizar plantillas de configuración cuando tenga muchas cuentas secundarias que requieran la misma configuración de IAM. Por ejemplo, su organización podría tener normas internas o exigir el cumplimiento de la normativa del sector.

Para crear una plantilla de configuración mediante la CLI, sigue estos pasos:

1. Cree un archivo JSON que configure la definición de la plantilla de ajustes. Para obtener más información sobre los atributos que puede utilizar en su archivo JSON, consulte la API de identidad IAM.

   El siguiente archivo JSON de ejemplo especifica el account_id de la cuenta de empresa, el name de la plantilla y el account_settings. La creación de claves API está restringida a usuarios con el rol de creador de claves API en el servicio de identidad. La creación de ID de servicio no está restringida, por lo que todos los miembros pueden crear ID de servicio en las cuentas a las que se haya asignado la plantilla de configuración. El número máximo de sesiones por identidad se ha establecido en 5, y la autenticación multifactor se ha establecido en LEVEL3, lo que requiere que todos los usuarios utilicen la autenticación multifactor (MFA) de U2F.

   {
      "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",
      }
   }
   

2. Cree la plantilla de configuración utilizando el comando account-settings-template-create como se muestra en la siguiente solicitud de ejemplo:

   ibmcloud iam account-settings-template-create AccountSettingsTemplate --file /path/to/account_settings_template.json
   

Actualización de una plantilla de configuración mediante la CLI

Puede actualizar una plantilla de configuración en cualquier momento antes de confirmarla. Para actualizar una versión específica de una plantilla de configuración de cuenta, siga estos pasos:

1. Actualice su archivo JSON con la nueva configuración de plantilla de ajustes. Para obtener más información sobre los atributos que puede utilizar en su archivo JSON, consulte la API de identidad IAM.

   El siguiente archivo JSON de ejemplo especifica el account_id de la cuenta de empresa, el name de la plantilla y el account_settings. La nueva configuración restablece MFA a NONE y elimina los demás ajustes.

   {
    "account_id": "5bbe28be34524sdbdaa34d37d1f2294a",
    "name": "AccountSettingsTemplateUpdated",
    "account_settings": {
        "mfa": "NONE",
    },
   }
   

   Cuando actualizas el nombre de la plantilla, se actualiza el nombre de todas las versiones.

2. Para actualizar una versión específica de una plantilla de configuración de cuenta, utilice el comando account-settings-template-version-update como se muestra en la siguiente solicitud de muestra:

   ibmcloud iam account-settings-template-version-update AccountSettingsTemplateUpdated 1 --file /path/to/account_settings_template.json
   

Configurar una plantilla de ajustes

Revise la plantilla de configuración y confírmela para que no se puedan realizar más cambios en la versión. Comprometer una versión es un paso necesario antes de poder asignarla a cuentas secundarias. De esta manera, el administrador de asignación de plantillas puede estar seguro de que asigna la versión solo cuando usted haya confirmado que está lista.

La siguiente solicitud de muestra compromete la versión 1 de la plantilla de configuración denominada AccountSettingsTemplateUpdated:

ibmcloud iam account-settings-template-commit AccountSettingsTemplateUpdated 1

Asignación de una plantilla de configuración a cuentas secundarias mediante la CLI

En tu empresa solo puedes asignar las versiones de una única plantilla de configuración a la vez. Puede asignar diferentes versiones de la misma plantilla de configuración, pero no puede utilizar varias plantillas de configuración en una empresa. Puede que desee asignar versiones diferentes a cuentas con requisitos diferentes, como cuentas de producción y de prueba.

No puede asignar una plantilla de IAM a la cuenta de empresa, solo a las cuentas secundarias.

Para crear una asignación para una plantilla de configuración de cuenta, siga estos pasos:

1. Enumere las plantillas de configuración en su cuenta de empresa y anote el nombre de la plantilla y el número de versión de la plantilla de configuración que desea asignar a las cuentas secundarias:

   ibmcloud iam account-settings-templates
   

2. Asigne la plantilla a un Account o AccountGroup mediante el comando account-settings-assignment-create.

   ibmcloud iam account-settings-assignment-create AccountSettingsTemplateUpdated 1 AccountGroup 955fc2274567474f8da802d5c376504b
   

Si una asignación falla, utilice el método account-settings-assigment-update para volver a intentarlo.

Creación de una nueva versión mediante la CLI

Cree una nueva versión de una plantilla de configuración de cuenta cuando necesite realizar actualizaciones en una versión confirmada. Para crear una nueva versión, sigue estos pasos.

1. Actualice su archivo JSON con la nueva configuración de plantilla de ajustes. Para obtener más información sobre los atributos que puede utilizar en su archivo JSON, consulte la API de identidad IAM.

2. Utilice el método account-settings-template-version-create para crear una nueva versión. La siguiente solicitud de muestra crea una nueva versión de la plantilla AccountSettingsUpdated.

   ibmcloud iam account-settings-template-version-create AccountSettingsUpdated --file /path/to/account_settings_template.json
   

Actualización de una asignación mediante la CLI

Actualizar una asignación para reintentar una asignación fallida o migrar a una nueva versión.

La nueva versión de plantilla que asignas reemplaza a la versión antigua. Más información sobre Asignación de una nueva versión.

1. Enumere las asignaciones en la cuenta utilizando el método de asignación de tareas ( account-settings-assignments ). Tome nota de la dirección de correo electrónico ( ASSIGNMENT_ID ) de la tarea que desea actualizar.

2. Actualiza la asignación de la configuración de la cuenta. Si vuelve a intentar una tarea, utilice el mismo número de versión. La siguiente solicitud de muestra migra la asignación AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b a la versión 2.

   ibmcloud iam account-settings-assignment-update AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b 2
   

Eliminar una asignación mediante la CLI

Puede eliminar la asignación de una plantilla de una cuenta o grupo de cuentas a la que esté asignada. Puede que desee hacerlo si la plantilla no funciona como debería. Cuando eliminas una asignación de plantilla de una cuenta, por defecto se restablece la versión anterior de la plantilla. Si la asignación que eliminas es para la primera o única versión de una plantilla, se eliminan las preferencias de configuración gestionadas por la empresa en la cuenta secundaria.

Para eliminar una asignación, sigue estos pasos:

1. Enumere las asignaciones en la cuenta utilizando el método de asignación de tareas ( account-settings-assignments ). Tome nota de la dirección de correo electrónico ( ASSIGNMENT_ID ) de la tarea que desea eliminar.

2. Elimine la asignación mediante el método account-settings-assigment-delete. La siguiente solicitud de muestra elimina la asignación AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b.

   ibmcloud iam account-settings-assignment-delete AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b
   

Cómo eliminar una versión mediante la CLI

Antes de poder eliminar una versión de plantilla de configuración, debe eliminar todas las asignaciones de esa versión de la plantilla. Para eliminar una versión específica, siga estos pasos:

1. Enumere las plantillas de configuración en su cuenta de empresa y anote el nombre de la plantilla y el número de versión de la versión que desea eliminar:

   ibmcloud iam account-settings-templates
   

2. Eliminar la versión:

   ibmcloud iam account-settings-template-delete AccountSettingsTemplateUpdated 2
   

3. Para eliminar todas las versiones, repita estos pasos. Asegúrese de eliminar primero las asignaciones de cada versión.

Creación de una plantilla de configuración mediante la API

Considere la posibilidad de utilizar plantillas de configuración cuando tenga muchas cuentas secundarias que requieran la misma configuración de IAM. Por ejemplo, su organización podría tener normas internas o exigir el cumplimiento de la normativa del sector.

Para crear una plantilla de configuración mediante la API, sigue estos pasos:

1. Configurar la definición de la plantilla de ajustes. Para obtener más información sobre los atributos que puede utilizar en su archivo JSON, consulte la API de identidad IAM.

   El siguiente archivo JSON de ejemplo especifica el account_id de la cuenta de empresa, el name de la plantilla y el account_settings. La creación de claves API está restringida a usuarios con el rol de creador de claves API en el servicio de identidad. La creación de ID de servicio no está restringida, por lo que todos los miembros pueden crear ID de servicio en las cuentas a las que se haya asignado la plantilla de configuración. El número máximo de sesiones por identidad se ha establecido en 5, y la autenticación multifactor se ha establecido en LEVEL3, lo que requiere que todos los usuarios utilicen la autenticación multifactor (MFA) de U2F.

   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")
   

Actualización de una plantilla de configuración mediante la API

Puede actualizar una plantilla de configuración en cualquier momento antes de confirmarla. Para actualizar una versión específica de una plantilla de configuración de cuenta, siga estos pasos:

1. Enumere las plantillas de configuración en su cuenta de empresa y anote el ID de AccountSettingsTemplate y el ETag en la respuesta para la versión de plantilla que desea actualizar.

   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))
   

2. Actualizar la definición de la plantilla de configuración.

   Cuando actualizas el nombre de la plantilla, se actualiza el nombre de todas las versiones.

   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")
   

Configurar una plantilla de configuración mediante la API

Revise la plantilla de configuración y confírmela para que no se puedan realizar más cambios en la versión. Comprometer una versión es un paso necesario antes de poder asignarla a cuentas secundarias. De esta manera, el administrador de asignación de plantillas puede estar seguro de que asigna la versión solo cuando usted haya confirmado que está lista.

1. Obtenga la versión de una plantilla de perfil de confianza que desee revisar y 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")
   

2. Revise la respuesta para confirmar que está listo para confirmar.

3. Comprometer la versión de la plantilla de perfil de confianza.

   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)
   

Asignación de una plantilla de configuración a cuentas secundarias mediante el uso de la API

En tu empresa solo puedes asignar las versiones de una única plantilla de configuración a la vez. Puede asignar diferentes versiones de la misma plantilla de configuración, pero no puede utilizar varias plantillas de configuración en una empresa. Puede que desee asignar versiones diferentes a cuentas con requisitos diferentes, como cuentas de producción y de prueba.

No puede asignar una plantilla de IAM a la cuenta de empresa, solo a las cuentas secundarias.

Para crear una asignación para una plantilla de configuración de cuenta, siga estos pasos:

1. Enumere las plantillas de configuración en su cuenta de empresa y anote el ID de AccountSettingsTemplate y el ETag en la respuesta para la versión de plantilla que desea asignar a las cuentas secundarias.

   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))
   

2. Asigne la plantilla de configuración a un Account o AccountGroup.

   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
   

Si una asignación falla, utilice el método account-settings-assigment-update para volver a intentarlo.

Creación de una nueva versión mediante la API

Si desea realizar cambios en una plantilla de configuración que está confirmada o asignada, cree una nueva versión.

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

Guarde el ID de AccountSettingsTemplate y la versión de la nueva versión para usarla en llamadas posteriores.