Parameter Store 참조

파라미터는 텍스트 블록, 이름 목록, AMI ID, 판매자 ID 또는 다른 구성 값과 같이 Parameter Store에 저장되는 모든 데이터 조각입니다. 스크립트, 명령 및 SSM 문서에 있는 이 데이터를 중앙에서 참조할 수 있습니다.

파라미터를 참조할 때 다음 규칙을 사용하여 파라미터 이름을 지정합니다.

{{ssm:parameter-name}}

Parameter Store는 String, StringList, SecureString 등 세 가지 유형의 파라미터를 지원합니다.

단, 파라미터를 생성하거나 업데이트할 때 파라미터 값을 일반 텍스트로 입력해야 하며 Parameter Store는 입력한 텍스트에 대해 검증을 수행하지 않습니다. 그러나 String 파라미터의 경우 데이터 형식을 aws:ec2:image로 지정할 수 있으며 Parameter Store는 입력한 값이 Amazon EC2 AMI에 적합한 형식인지 검증합니다(예: ami-12345abcdeEXAMPLE).

파라미터 유형: String

기본적으로 String 파라미터의 값은 입력한 텍스트 블록으로 구성됩니다. 예제:

파라미터 유형: StringList

StringList 파라미터의 값에는 다음 예제와 같이 쉼표로 구분된 값 목록이 포함되어 있습니다.

Monday,Wednesday,Friday

CSV,TSV,CLF,ELF,JSON

파라미터 유형: SecureString

서비스 엔드포인트 및 계정 식별자와 같이 암호화가 필요한 구성 값에 대해 SecureString을 사용하세요. 데이터베이스 자격 증명, API 키 또는 토큰과 같은 시크릿의 경우 자동 교체 및 교차 리전 복제를 포함하여 목적별 보안 제어를 제공하는 AWS Secrets Manager를 사용하는 것이 좋습니다.

파라미터 값만 암호화됩니다. 파라미터 이름, 설명 및 기타 메타데이터는 암호화되지 않습니다.

Parameter Store는 AWS KMS 키를 사용하여 SecureString 파라미터 값을 암호화 및 복호화합니다. Parameter Store의 기본 AWS 관리형 키 또는 고객 관리형 키를 사용할 수 있습니다. 특정 파라미터를 복호화할 수 있는 위탁자를 제한해야 하는 경우 고객 관리형 키를 사용합니다. 자세한 내용은 AWS KMS 키를 사용하는 파라미터 암호화 및 복호화 섹션을 참조하세요.

다른 AWS 서비스에서 SecureString 파라미터를 사용할 수 있습니다. 다음 Lambda 함수는 /myapp/dev/vendor/merchant-id 파라미터에서 암호화된 판매자 ID를 검색합니다. 이 함수는 값을 함수 로그에 쓰거나 응답에서 반환하지 않고 사용합니다.

import json
import boto3

ssm = boto3.client("ssm", region_name="us-east-1")

def lambda_handler(event, context):
    response = ssm.get_parameter(
        Name="/myapp/dev/vendor/merchant-id",
        WithDecryption=True
    )

    merchant_id = response["Parameter"]["Value"]

    # Use merchant_id when communicating with the vendor system.
    # Don't write the value to logs or include it in the response.

    return {
        "statusCode": 200,
        "body": json.dumps("Vendor configuration retrieved.")
    }

AWS KMS 암호화 및 요금

SecureString 파라미터를 생성할 때 Systems Manager가 AWS KMS를 사용하여 파라미터 값을 암호화합니다.

SecureString 파라미터 생성 시 Parameter Store에서 비용이 부과되지 않지만 AWS KMS 사용에 대한 요금이 적용될 수 있습니다. 자세한 내용은 AWS Key Management Service 요금을 참조하십시오.

AWS 관리형 키 및 고객 관리형 키에 대한 자세한 내용은 AWS Key Management Service 개발자 가이드의 AWS Key Management Service 개념을 참조하세요. Parameter Store에서 AWS KMS를 사용하는 방법에 대한 자세한 내용은 AWS Systems ManagerParameter Store에서 AWS KMS를 사용하는 방법을 참조하세요.

aws kms describe-key \
    --region us-east-1 \
    --key-id alias/aws/ssm

파라미터 이름 제약 조건

이 주제의 정보를 사용하면 파라미터를 생성할 때 파라미터 이름에 유효한 값을 지정하는 데 도움이 됩니다.

이 정보는 AllowedPattern, Description, KeyId, Overwrite, Type 및 Value 값에 대한 정보도 제공하는 AWS Systems Manager API Reference의 PutParameter 주제의 세부 정보를 보완합니다.

파라미터 이름에 대한 요구 사항 및 제약 조건은 다음과 같습니다.