# 계정의 확장 프로그램에 대한 구성 데이터 편집
<a name="registry-set-configuration"></a>

이 주제에서는 특정 리전 내 계정의 확장 프로그램에 대한 구성 데이터 편집 지침을 제공합니다. 확장 프로그램에는 지정된 계정과 리전에 대한 확장 프로그램의 모든 인스턴스에 적용되는 구성 속성이 포함될 수 있습니다. 이러한 속성은 확장 프로그램 작성자가 확장 프로그램의 구성 정의에 정의합니다. 익스텐션의 구성 정의에 필수 속성이 있는 경우 해당 속성을 지정해야 계정과 리전에서 익스텐션을 사용할 수 있습니다.

확장 프로그램을 개발할 때 구성 정의가 정의되는 방법에 대한 자세한 내용은 다음 설명서를 참조하세요.
+ [후크 구성 스키마 구문 참조](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html)
+ [익스텐션의 계정 수준 구성 정의](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration)

**Topics**
+ [동적 참조를 사용하는 데 필요한 권한](#registry-set-configuration-considerations)
+ [확장 프로그램에 대한 구성 데이터 편집(콘솔)](#registry-set-configuration-procedure-console)
+ [확장 프로그램에 대한 구성 데이터 편집(AWS CLI)](#registry-set-configuration-procedure-cli)

## 동적 참조를 사용하는 데 필요한 권한
<a name="registry-set-configuration-considerations"></a>

구성 데이터에 AWS Systems Manager 또는 AWS Secrets Manager에 저장된 값에 대한 동적 참조가 있는 경우 유형을 프로비저닝하는 데 사용되는 모든 역할(예: 스택을 만들거나 업데이트할 때)에 해당 값을 검색할 수 있는 적절한 권한이 있어야 합니다. 구체적으로 설명하면 다음과 같습니다.
+ 구성 데이터에 AWS Systems Manager Parameter Store에 저장된 파라미터가 포함된 경우 유형을 프로비저닝하는 데 사용되는 사용자 또는 역할에 [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html)를 직접적으로 호출할 수 있는 권한이 있어야 합니다.
+ 구성 데이터에 AWS Secrets Manager에 저장된 보안 암호가 포함된 경우 유형을 프로비저닝하는 데 사용되는 사용자 또는 역할에 [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html)를 직접적으로 호출할 수 있는 권한이 있어야 합니다.

자세한 내용은 [동적 참조를 사용하여 다른 서비스에 저장된 값 가져오기](dynamic-references.md) 섹션을 참조하세요.

## 확장 프로그램에 대한 구성 데이터 편집(콘솔)
<a name="registry-set-configuration-procedure-console"></a>

이 섹션의 다음 단계를 따라 콘솔을 사용합니다.
+ 확장 프로그램에 대한 현재 구성 데이터 보기
+ 계정의 확장 프로그램 구성 데이터 업데이트

**확장 프로그램에 대한 현재 구성 데이터를 보려면 다음을 수행하세요.**

1. AWS Management Console에 로그인하여 [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)에서 CloudFormation 콘솔을 엽니다.

1. 화면 상단의 탐색 모음에서 AWS 리전을 선택합니다.

1. 탐색 창의 **레지스트리**에서 **활성화된 프로그램**을 선택하세요.

1. 보려는 확장 프로그램을 찾습니다. 자세한 내용은 [CloudFormation 레지스트리에서 사용 가능하고 활성화된 확장 프로그램 보기](registry-view.md) 섹션을 참조하세요.

1. 익스텐션을 선택하여 익스텐션 세부 정보를 봅니다.

1. 익스텐션 세부 정보 페이지에서 **Configuration**(구성) 탭을 선택합니다.

1. **Configuration schema**(구성 스키마) 탭을 확장하여 익스텐션에 대해 정의된 구성 스키마를 봅니다.

1. **Configuration**(구성) 탭을 클릭하여 이 익스텐션에 대해 설정한 현재 구성을 봅니다.

**확장 프로그램의 구성 데이터를 업데이트하려면 다음을 수행하세요.**

1. 확장 프로그램 세부 정보 페이지의 **구성** 탭에서 **구성 편집**을 선택합니다.

   또는 **작업**에서 **편집**을 선택한 다음 **구성 편집**을 선택합니다.

   **Configure extension**(익스텐션 구성) 페이지가 표시됩니다. 익스텐션의 현재 구성 정의 스키마를 보려면 **View configuration schema**(구성 스키마 보기)가 켜져 있는지 확인합니다.

1. **Configuration JSON**(구성 JSON) 텍스트 상자에 이 익스텐션에 대해 설정하려는 구성 스키마를 나타내는 JSON 문자열을 입력합니다. **Configuration schema**(구성 스키마)에 정의된 스키마에 대해 검증해야 합니다.

1. **익스텐션 구성**을 선택합니다.

## 확장 프로그램에 대한 구성 데이터 편집(AWS CLI)
<a name="registry-set-configuration-procedure-cli"></a>

이 섹션의 다음 단계를 따라 AWS CLI을 사용합니다.
+ 확장 프로그램에 대한 현재 구성 데이터 보기
+ 계정의 확장 프로그램 구성 데이터 업데이트

**확장 프로그램에 대한 현재 구성 데이터를 보려면 다음을 수행하세요.**
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html) 명령을 사용하여 확장 프로그램에 대한 세부 정보를 반환합니다. 출력의 `ConfigurationSchema` 요소는 지정된 리전에서 익스텐션의 현재 구성 정의를 포함합니다.

  또는 [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html) 명령을 사용하여 여러 익스텐션에 대한 구성 데이터를 반환합니다.

**확장 프로그램의 구성 데이터를 업데이트하려면 다음을 수행하세요.**
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html) 명령을 사용하여 구성 데이터를 지정합니다. `--configuration`에 대해 전달하는 JSON은 확장 프로그램의 구성 스키마에 대해 검증되어야 합니다.

  다음 예에서 **set-type-configuration** 명령은 `--configuration`옵션에 대한 구성 데이터 *`"{"CredentialKey": "testUserCredential"}"`*을 지정합니다.

  ```
  aws cloudformation set-type-configuration --type RESOURCE \
    --type-name My::Resource::Example \
    --configuration-alias default \
    --configuration "{"CredentialKey": "testUserCredential"}" \
    --region us-west-2
  ```