Memahami jenis parameter

Parameter adalah setiap bagian dari data yang disimpanParameter Store, seperti blok teks, daftar nama, AMI ID, kunci lisensi, dan sebagainya. Anda dapat secara terpusat dan aman mereferensi data ini dalam skrip, perintah, dan dokumen SSM Anda.

Saat Anda mereferensikan parameter, Anda menentukan nama parameter menggunakan konvensi berikut.

{{ssm:parameter-name}}

Parameter Storememberikan dukungan untuk tiga jenis parameter:String,StringList, danSecureString.

Dengan satu pengecualian, saat Anda membuat atau memperbarui parameter, Anda memasukkan nilai parameter sebagai teks biasa, dan tidak Parameter Store melakukan validasi pada teks yang Anda masukkan. Untuk String parameter, bagaimanapun, Anda dapat menentukan tipe data sebagaiaws:ec2:image, dan Parameter Store memvalidasi bahwa nilai yang Anda masukkan adalah format yang tepat untuk Amazon AMI EC2; misalnya:. ami-12345abcdeEXAMPLE

Jenis parameter: String

Secara default, nilai String parameter terdiri dari blok teks apa pun yang Anda masukkan. Contoh:

Jenis parameter: StringList

Nilai StringList parameter berisi daftar nilai yang dipisahkan koma, seperti yang ditunjukkan pada contoh berikut.

Monday,Wednesday,Friday

CSV,TSV,CLF,ELF,JSON

Jenis parameter: SecureString

Nilai SecureString parameter adalah setiap data sensitif yang perlu disimpan dan direferensikan dengan cara yang aman. Jika Anda memiliki data yang tidak ingin pengguna ubah atau referensi dalam teks biasa, seperti rahasia ringan atau kunci lisensi, buat parameter tersebut SecureString menggunakan tipe data.

Kami merekomendasikan penggunaan parameter SecureString untuk skenario berikut:

Anda dapat menggunakan tipe SecureString parameter untuk data tekstual yang ingin Anda enkripsi, seperti rahasia ringan yang tidak memerlukan rotasi, data konfigurasi rahasia, atau jenis data lain yang ingin Anda lindungi. SecureStringdata dienkripsi dan didekripsi menggunakan kunci. AWS KMS Anda dapat menggunakan kunci KMS default yang disediakan oleh AWS atau membuat dan menggunakan kunci Anda sendiri AWS KMS key. (Gunakan AWS KMS key Anda sendiri jika Anda ingin membatasi akses pengguna ke parameter SecureString. Untuk informasi lebih lanjut, lihat Izin IAM untuk menggunakan kunci AWS default dan kunci yang dikelola pelanggan.)

Anda juga dapat menggunakan SecureString parameter dengan yang lain Layanan AWS. Dalam contoh berikut, fungsi Lambda mengambil SecureString parameter dengan menggunakan API. GetParameters

import json
import boto3
ssm = boto3.client('ssm', 'us-east-2')
def get_parameters():
    response = ssm.get_parameters(
        Names=['LambdaSecureString'],WithDecryption=True
    )
    for parameter in response['Parameters']:
        return parameter['Value']
        
def lambda_handler(event, context):
    value = get_parameters()
    print("value1 = " + value)
    return value  # Echo back the first key value

AWS KMS enkripsi dan harga

Jika Anda memilih jenis SecureString parameter saat membuat parameter, Systems Manager menggunakan AWS KMS untuk mengenkripsi nilai parameter.

Tidak ada biaya Parameter Store untuk membuat SecureString parameter, tetapi biaya untuk penggunaan AWS KMS enkripsi berlaku. Untuk informasi, lihat harga AWS Key Management Service.

Untuk informasi selengkapnya tentang Kunci yang dikelola AWS dan kunci yang dikelola pelanggan, lihat AWS Key Management Service Konsep di Panduan AWS Key Management Service Pengembang. Untuk informasi selengkapnya tentang Parameter Store dan AWS KMS enkripsi, lihat Cara AWS Systems ManagerParameter Store Penggunaan AWS KMS.

aws kms describe-key --key-id alias/aws/ssm