Grundlegendes zu Parametertypen

Ein Parameter ist ein beliebiges DatenelementParameter Store, das gespeichert ist, z. B. ein Textblock, eine Namensliste, eine AMI ID, ein Lizenzschlüssel usw. Sie können diese Daten zentral und sicher in Ihren Skripten, Befehlen und SSM-Dokumenten referenzieren.

Wenn Sie auf einen Parameter verweisen, geben Sie den Parameternamen gemäß der folgenden Konvention an.

{{ssm:parameter-name}}

Parameter Store bietet Unterstützung für drei Arten von Parametern: String, StringList und SecureString.

Mit einer Ausnahme geben Sie beim Erstellen oder Aktualisieren eines Parameters den Parameterwert als Klartext ein und Parameter Store führt keine Validierung für den eingegebenen Text aus. Bei String-Parametern können Sie jedoch den Datentyp als aws:ec2:image angeben und Parameter Store prüft , ob der eingegebene Wert das richtige Format für ein Amazon EC2 AMI aufweist. Beispiel: ami-12345abcdeEXAMPLE.

Parametertyp: String

Standardmäßig nimmt der String-Parameter jeden beliebigen Textblock auf, den Sie eingeben. Beispiel:

Parametertyp: StringList

Die Werte der StringList-Parameter enthalten eine kommagetrennte Liste von Werten wie in den folgenden Beispielen gezeigt.

Monday,Wednesday,Friday

CSV,TSV,CLF,ELF,JSON

Typ des Parameters: SecureString

Der Wert eines SecureString-Parameters kann aus beliebigen vertraulichen Daten bestehen, die auf sichere Weise gespeichert und referenziert werden müssen. Wenn Sie Daten haben, die Benutzer nicht ändern oder im Klartext referenzieren sollen, wie z. B. einfache geheime Schlüssel oder Lizenzschlüssel, erstellen Sie diese Parameter mithilfe des SecureString Datentyps.

Wir empfehlen die Verwendung von SecureString-Parametern in den folgenden Szenarien:

Sie können den SecureString Parametertyp für Textdaten verwenden, die Sie verschlüsseln möchten, wie z. B. einfache geheime Daten, für die keine Rotation erforderlich ist, vertrauliche Konfigurationsdaten oder andere Arten von Daten, die Sie schützen möchten. SecureStringDaten werden mit einem Schlüssel ver- und entschlüsselt. AWS KMS Sie können entweder einen Standard-KMS-Schlüssel verwenden, der von bereitgestellt wird, AWS oder Sie können Ihren eigenen AWS KMS key erstellen und verwenden. (Verwenden Sie Ihre eigenen AWS KMS key , wenn Sie den Benutzerzugriff auf SecureString-Parameter einschränken möchten. Weitere Informationen finden Sie unter IAM-Berechtigungen für die Verwendung von AWS Standardschlüsseln und vom Kunden verwalteten Schlüsseln.)

Sie können SecureString Parameter auch zusammen mit anderen verwenden AWS-Services. Im folgenden Beispiel ruft die Lambda-Funktion mithilfe der GetParametersAPI einen SecureString Parameter ab.

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 Verschlüsselung und Preisgestaltung

Wenn Sie bei der Erstellung Ihres SecureString Parameters den Parametertyp wählen, verschlüsselt Systems AWS KMS Manager den Parameterwert.

Für die Erstellung eines SecureString Parameters fallen keine Gebühren Parameter Store an, es fallen jedoch Gebühren für die Verwendung der AWS KMS Verschlüsselung an. Weitere Informationen finden Sie unter AWS Key Management Service -Preise.

Weitere Informationen zu Von AWS verwaltete Schlüssel und vom Kunden verwalteten Schlüsseln finden Sie unter AWS Key Management Service Konzepte im AWS Key Management Service Entwicklerhandbuch. Weitere Informationen zur AWS KMS Verschlüsselung Parameter Store und zur Verschlüsselung finden Sie unter AWS Systems ManagerParameter StoreAnwendungsmöglichkeiten AWS KMS.

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