설정 템플릿 만들기

동일한 IAM 설정이 필요한 하위 계정이 많은 경우 설정 템플릿을 사용하는 것을 고려해 보십시오. 예를 들어, 조직에 내부 표준이 있거나 업계 규정을 준수해야 할 수도 있습니다.

설정 템플릿을 만들려면 다음 단계를 따르십시오

1. IBM Cloud 에서 [관리] > [액세스(IAM)] > [템플릿] 으로 이동합니다.
2. 설정 > 만들기를 클릭합니다.
3. 기업 사용자를 위한 설정의 목적을 설명하는 설정 템플릿의 이름과 설명을 입력합니다.
4. 작성을 클릭하십시오.

설정 템플릿 검토

설정 템플릿을 검토하고 커밋하여 버전에서 더 이상 변경할 수 없도록 합니다. 이렇게 하면 템플릿 할당 관리자가 준비가 완료되었다는 확인을 받을 때 버전을 할당했는지 확인할 수 있습니다.

1. 개요 > 검토를 클릭합니다.
2. 설정 템플릿이 원하는 대로 구성되어 있는지 확인하십시오.
3. 버전을 편집할 수 없음을 확인하려면 체크박스를 클릭하십시오.
4. 커미트를 클릭하십시오.

하위 계정에 설정 템플릿 할당

기업 내에서는 한 번에 하나의 설정 템플릿 버전에 대해서만 할당할 수 있습니다. 동일한 설정 템플릿의 다른 버전을 할당할 수 있지만, 기업에서 여러 설정 템플릿을 사용할 수는 없습니다. 생산 계정과 테스트 계정처럼 요구 사항이 다른 계정에 다른 버전을 할당할 수 있습니다.

기업 계정에는 IAM 템플릿을 할당할 수 없고, 하위 계정에만 할당할 수 있습니다.

설정 템플릿을 할당하려면 다음 단계를 완료하십시오

1. IBM Cloud® 콘솔에서 관리 > 접근(IAM) > 템플릿 > 설정을 클릭합니다.
2. 설정 템플릿을 선택하세요.
3. 계정 할당을 클릭합니다.
4. 기업 내의 특정 계정 또는 전체 계정 그룹을 선택합니다.

계정 그룹을 선택하면, 그 계정 그룹에 추가하는 모든 미래의 계정이 그 그룹에 할당된 설정을 상속받습니다.

1. 계정 할당을 클릭합니다.

작업을 실패한 경우, 다시 시도를 클릭합니다.

새 버전 만들기

설정 템플릿의 새 버전을 만들려면 다음 단계를 따르십시오

1. IBM Cloud® 콘솔에서 관리 > 접근(IAM) > 템플릿 > 설정을 클릭합니다.

2. 설정 템플릿을 선택하세요.

3. 새 버전 아이콘을 클릭하십시오. .

4. 새로운 템플릿 이름과 설명을 입력하거나, 이미 사용 중인 것을 그대로 사용해도 됩니다.

   새로운 템플릿 이름을 입력하면 이 버전과 모든 이전 버전의 템플릿 이름이 업데이트됩니다. 템플릿 설명은 각 버전별로 별도로 저장됩니다.

5. 새 버전으로 옮기고 싶은 설정을 선택하세요.

6. 작성을 클릭하십시오.

7. 구성에 필요한 기타 조정 사항을 적용하십시오.

8. 검토를 클릭하고 새 버전을 적용합니다. 자세한 내용은 액세스 그룹 템플릿 검토하기를 참고하세요.

설정 템플릿의 새 버전을 할당하려면 다음 단계를 따르십시오

1. IBM Cloud 콘솔에서 [ 관리] > [액세스(IAM)] > [템플릿] 으로 이동합니다.
2. 설정 을 클릭하십시오.
3. 작업하려는 템플릿에서 " 표 펼치기 " 아이콘( )을 클릭합니다.
4. 하위 계정에 할당된 버전을 선택합니다.
5. 할당을 클릭합니다.
6. 다른 버전을 할당하려는 계정 또는 계정 그룹 할당에서 업데이트를 클릭합니다.
7. “버전 선택”을 클릭하세요.
   1. 현재 버전을 대체할 버전을 선택합니다.
8. 업데이트 를 클릭하십시오.
9. 다른 버전을 할당하려는 각 계정 또는 계정 그룹에 대해 이 단계를 반복합니다.

새로 할당된 템플릿 버전이 이전 버전을 대체합니다. 새 버전 할당에 대해 자세히 알아보세요.

할당 제거

템플릿이 할당된 계정이나 계정 그룹에서 템플릿 할당을 제거할 수 있습니다. 템플릿이 의도한 대로 작동하지 않는 경우 그렇게 할 수 있습니다. 계정에서 템플릿 할당을 제거하면 기본적으로 템플릿의 이전 버전이 복원됩니다. 제거한 할당이 템플릿의 첫 번째 버전 또는 유일한 버전인 경우, 하위 계정에 할당된 설정 환경설정이 제거됩니다.

과제를 삭제하려면 다음 단계를 따르세요:

1. IBM Cloud® 콘솔에서 관리 > 접근(IAM) > 템플릿 > 설정을 클릭합니다.
2. 설정을 클릭하고 설정 템플릿을 선택합니다.
3. 할당을 클릭합니다.
4. 제거 할당을 제거하려는 계정 또는 계정 그룹에서 할당 취소( 행동 ) 아이콘을 클릭합니다.

모든 설정 템플릿 할당을 제거하면 하위 계정 수준에서 정의된 설정이 적용됩니다.

설정 템플릿 삭제하기

설정 템플릿을 삭제하기 전에 템플릿의 모든 버전에 대한 모든 할당을 제거해야 합니다. 설정 템플릿을 삭제하면 모든 버전이 삭제됩니다.

설정 템플릿을 삭제하려면 다음 단계를 따르십시오

1. IBM Cloud® 콘솔에서 관리 > 접근(IAM) > 템플릿 > 설정을 클릭합니다.
2. 설정 을 클릭하십시오.
3. 삭제하려는 설정 템플릿의 ' 행동 ' 아이콘( )을 클릭합니다.
4. 템플릿 삭제를 클릭합니다.
5. 설정 템플릿을 삭제하시겠습니까? 확인하십시오.

CLI를 사용하여 설정 템플릿 만들기

동일한 IAM 설정이 필요한 하위 계정이 많은 경우 설정 템플릿을 사용하는 것을 고려해 보십시오. 예를 들어, 조직에 내부 표준이 있거나 업계 규정을 준수해야 할 수도 있습니다.

CLI를 사용하여 설정 템플릿을 생성하려면 다음 단계를 따르십시오

1. 설정 템플릿 정의를 구성하는 JSON 파일을 만듭니다. JSON 파일에서 사용할 수 있는 속성에 대한 자세한 정보는 IAM Identity API를 참조하십시오.

   다음 예제 JSON 파일은 기업 계정의 account_id, 템플릿의 name, account_settings 를 지정합니다. API 키 생성은 아이덴티티 서비스에서 API 키 생성자 역할을 가진 사용자로 제한됩니다. 서비스 ID 생성은 제한이 없으므로, 설정 템플릿이 할당된 계정에서 모든 회원이 서비스 ID를 생성할 수 있습니다. ID당 최대 세션 수는 5 로 설정되어 있으며, 다중 인증은 LEVEL3 로 설정되어 있어 모든 사용자가 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",
      }
   }
   

2. 다음 샘플 요청에 나와 있는 것처럼 ' account-settings-template-create ' 명령을 사용하여 설정 템플릿을 만듭니다

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

CLI를 사용하여 설정 템플릿 업데이트하기

설정 템플릿을 적용하기 전에 언제든지 업데이트할 수 있습니다. 특정 버전의 계정 설정 템플릿을 업데이트하려면 다음 단계를 완료하십시오

1. JSON 파일을 새로운 설정 템플릿 구성으로 업데이트하십시오. JSON 파일에서 사용할 수 있는 속성에 대한 자세한 정보는 IAM Identity API를 참조하십시오.

   다음 예제 JSON 파일은 기업 계정의 account_id, 템플릿의 name, account_settings 를 지정합니다. 새로운 구성은 MFA를 NONE 로 재설정하고 다른 설정을 제거합니다.

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

   템플릿 이름을 업데이트하면 모든 버전의 이름이 업데이트됩니다.

2. 계정 설정 템플릿의 특정 버전을 업데이트하려면 다음 샘플 요청에 나와 있는 것처럼 account-settings-template-version-update 명령을 사용하십시오

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

설정 템플릿 적용하기

설정 템플릿을 검토하고 커밋하여 버전에서 더 이상 변경할 수 없도록 합니다. 버전을 커밋하는 것은 하위 계정에 할당하기 전에 필요한 단계입니다. 이렇게 하면 템플릿 할당 관리자가 준비가 완료되었다는 확인을 받은 후에만 버전을 할당할 수 있습니다.

다음 샘플 요청은 AccountSettingsTemplateUpdated 라는 설정 템플릿의 버전 1 를 커밋합니다

ibmcloud iam account-settings-template-commit AccountSettingsTemplateUpdated 1

CLI를 사용하여 하위 계정에 설정 템플릿 할당

기업 내에서는 한 번에 하나의 설정 템플릿 버전에 대해서만 할당할 수 있습니다. 동일한 설정 템플릿의 다른 버전을 할당할 수 있지만, 기업에서 여러 설정 템플릿을 사용할 수는 없습니다. 생산 계정과 테스트 계정처럼 요구 사항이 다른 계정에 다른 버전을 할당할 수 있습니다.

기업 계정에는 IAM 템플릿을 할당할 수 없고, 하위 계정에만 할당할 수 있습니다.

계정 설정 템플릿에 대한 할당을 생성하려면 다음 단계를 완료하십시오

1. 기업 계정에 설정 템플릿을 나열하고 하위 계정에 할당할 설정 템플릿의 템플릿 이름과 버전 번호를 기록합니다

   ibmcloud iam account-settings-templates
   

2. account-settings-assignment-create 명령을 사용하여 템플릿을 프로젝트( Account ) 또는 작업( AccountGroup )에 할당하십시오.

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

과제가 실패하면, 재시도( account-settings-assigment-update ) 방법을 사용하십시오.

CLI를 사용하여 새 버전 생성하기

커밋된 버전을 업데이트해야 할 경우, 계정 설정 템플릿의 새 버전을 만듭니다. 새 버전을 생성하려면 다음 단계를 따르십시오.

1. JSON 파일을 새로운 설정 템플릿 구성으로 업데이트하십시오. JSON 파일에서 사용할 수 있는 속성에 대한 자세한 정보는 IAM Identity API를 참조하십시오.

2. account-settings-template-version-create 방법을 사용하여 새 버전을 만듭니다. 다음 샘플 요청은 템플릿 AccountSettingsUpdated 의 새로운 버전을 만듭니다.

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

CLI를 사용하여 과제를 업데이트하기

실패한 과제를 다시 시도하거나 새로운 버전으로 이전하기 위해 과제를 업데이트합니다.

새로 할당된 템플릿 버전이 이전 버전을 대체합니다. 새 버전 할당에 대해 자세히 알아보세요.

1. account-settings-assignments 방법을 사용하여 계정의 할당 목록을 작성하십시오. 업데이트하려는 과제에 대한 작업 노트( ASSIGNMENT_ID )를 작성하십시오.

2. 계정 설정 할당을 업데이트하십시오. 작업을 다시 시도하는 경우, 동일한 버전 번호를 사용하십시오. 다음 샘플 요청은 할당된 작업 AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b 을 버전 2로 이전합니다.

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

CLI를 사용하여 할당 사항 제거하기

템플릿이 할당된 계정이나 계정 그룹에서 템플릿 할당을 제거할 수 있습니다. 템플릿이 의도한 대로 작동하지 않는 경우 그렇게 할 수 있습니다. 계정에서 템플릿 할당을 제거하면 기본적으로 템플릿의 이전 버전이 복원됩니다. 제거하는 할당이 템플릿의 첫 번째 버전 또는 유일한 버전인 경우, 하위 계정의 기업 관리 설정 환경설정이 제거됩니다.

과제를 삭제하려면 다음 단계를 따르세요:

1. account-settings-assignments 방법을 사용하여 계정의 할당 목록을 작성하십시오. 제거하려는 과제에 대한 작업 노트( ASSIGNMENT_ID )를 기록해 두십시오.

2. account-settings-assigment-delete 방법을 사용하여 과제를 제거하십시오. 다음 샘플 요청은 할당 AccountSettingsAssignment-63d65ed159ff463b8ec09ea77d22a05b 을 제거합니다.

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

CLI를 사용하여 버전 삭제하기

설정 템플릿 버전을 삭제하기 전에, 그 버전의 템플릿에 대한 모든 할당을 제거해야 합니다. 다음 단계를 완료하여 특정 버전을 삭제하십시오

1. 기업 계정에서 설정 템플릿을 나열하고 삭제하려는 템플릿의 이름과 버전 번호를 기록합니다

   ibmcloud iam account-settings-templates
   

2. 버전 삭제:

   ibmcloud iam account-settings-template-delete AccountSettingsTemplateUpdated 2
   

3. 모든 버전을 삭제하려면 이 단계를 반복하십시오. 먼저 각 버전에 대한 할당을 제거해야 합니다.

API를 사용하여 설정 템플릿 만들기

동일한 IAM 설정이 필요한 하위 계정이 많은 경우 설정 템플릿을 사용하는 것을 고려해 보십시오. 예를 들어, 조직에 내부 표준이 있거나 업계 규정을 준수해야 할 수도 있습니다.

API를 사용하여 설정 템플릿을 생성하려면 다음 단계를 따르십시오:

1. 설정 템플릿 정의를 구성합니다. JSON 파일에서 사용할 수 있는 속성에 대한 자세한 정보는 IAM Identity API를 참조하십시오.

   다음 예제 JSON 파일은 기업 계정의 account_id, 템플릿의 name, account_settings 를 지정합니다. API 키 생성은 아이덴티티 서비스에서 API 키 생성자 역할을 가진 사용자로 제한됩니다. 서비스 ID 생성은 제한이 없으므로, 설정 템플릿이 할당된 계정에서 모든 회원이 서비스 ID를 생성할 수 있습니다. ID당 최대 세션 수는 5 로 설정되어 있으며, 다중 인증은 LEVEL3 로 설정되어 있어 모든 사용자가 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")
   

API를 사용하여 설정 템플릿 업데이트하기

설정 템플릿을 적용하기 전에 언제든지 업데이트할 수 있습니다. 특정 버전의 계정 설정 템플릿을 업데이트하려면 다음 단계를 완료하십시오

1. 기업 계정에 설정 템플릿을 나열하고 업데이트하려는 템플릿 버전에 대한 응답에서 AccountSettingsTemplate 의 ID와 ETag를 확인하십시오.

   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. 설정 템플릿 정의를 업데이트합니다.

   템플릿 이름을 업데이트하면 모든 버전의 이름이 업데이트됩니다.

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

API를 사용하여 설정 템플릿 커밋하기

설정 템플릿을 검토하고 커밋하여 버전에서 더 이상 변경할 수 없도록 합니다. 버전을 커밋하는 것은 하위 계정에 할당하기 전에 필요한 단계입니다. 이렇게 하면 템플릿 할당 관리자가 준비가 완료되었다는 확인을 받은 후에만 버전을 할당할 수 있습니다.

1. 검토하고 커밋하려는 신뢰할 수 있는 프로필 템플릿의 버전을 확인하십시오.

   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. 답변을 검토하여 커밋할 준비가 되었는지 확인하십시오.

3. 신뢰할 수 있는 프로필 템플릿의 버전을 커밋합니다.

   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)
   

API를 사용하여 하위 계정에 설정 템플릿 할당

기업 내에서는 한 번에 하나의 설정 템플릿 버전에 대해서만 할당할 수 있습니다. 동일한 설정 템플릿의 다른 버전을 할당할 수 있지만, 기업에서 여러 설정 템플릿을 사용할 수는 없습니다. 생산 계정과 테스트 계정처럼 요구 사항이 다른 계정에 다른 버전을 할당할 수 있습니다.

기업 계정에는 IAM 템플릿을 할당할 수 없고, 하위 계정에만 할당할 수 있습니다.

계정 설정 템플릿에 대한 할당을 생성하려면 다음 단계를 완료하십시오

1. 기업 계정에 설정 템플릿을 나열하고 하위 계정에 할당하려는 템플릿 버전에 대한 응답에서 하위 계정 ID( AccountSettingsTemplate )와 ETag를 기록합니다.

   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. 설정 템플릿을 [ Account ] 또는 [ 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
   

과제가 실패하면, 재시도( account-settings-assigment-update ) 방법을 사용하십시오.

API를 사용하여 새 버전 생성하기

커밋되었거나 할당된 설정 템플릿을 변경하려면 새 버전을 만드십시오.

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

이후에 호출할 때 사용할 새 버전의 AccountSettingsTemplate ID와 버전을 저장합니다.