Riferimento Parameter Store

Un parametro è qualsiasi dato memorizzato inParameter Store, ad esempio un blocco di testo, un elenco di nomi, un AMI ID, un ID commerciante o un altro valore di configurazione. Puoi fare riferimento centralmente a questi dati nei tuoi script, comandi e documenti SSM.

Quando si fa riferimento a un parametro, si specifica il nome del parametro utilizzando la seguente convenzione.

{{ssm:parameter-name}}

Parameter Store fornisce il supporto per tre tipi di parametri. String, StringList e SecureString.

Con un'eccezione, quando si crea o si aggiorna un parametro, si immette il valore del parametro come testo normale e Parameter Store non esegue alcuna convalida sul testo immesso. Per i parametri String, tuttavia, è possibile specificare il tipo di dati come aws:ec2:image e Parameter Store convalida che il valore immesso sia nel formato corretto per un'AMI Amazon EC2, ad esempio: ami-12345abcdeEXAMPLE.

Tipo di parametro: String

Per impostazione predefinita, il valore di un parametro String consiste in qualsiasi blocco di testo immesso. Ad esempio:

Tipo di parametro: StringList

I valori dei parametri StringList contengono un elenco di valori separati da virgole, come illustrato nell'esempio seguente.

Monday,Wednesday,Friday

CSV,TSV,CLF,ELF,JSON

Tipo di parametro: SecureString

Da utilizzare SecureString per i valori di configurazione che richiedono la crittografia, ad esempio gli endpoint del servizio e gli identificatori degli account. Per informazioni segrete, come credenziali di database, chiavi API o token, consigliamo di utilizzare questa soluzione che fornisce controlli di sicurezza appositamente progettati AWS Secrets Manager, tra cui la rotazione automatica e la replica tra regioni.

Solo il valore del parametro è crittografato. Il nome, la descrizione e gli altri metadati del parametro non sono crittografati.

Parameter Storecrittografa e decrittografa i SecureString valori dei parametri utilizzando una chiave. AWS KMS È possibile utilizzare la chiave predefinita Parameter Store o una Chiave gestita da AWS chiave gestita dal cliente. Utilizza una chiave gestita dal cliente quando devi limitare i principali che possono decrittografare determinati parametri. Per ulteriori informazioni, consulta Crittografia e decrittografia dei parametri utilizzando AWS KMS keys.

È possibile utilizzare SecureString parametri con altri Servizi AWS. La seguente funzione Lambda recupera un ID venditore crittografato dal parametro. /myapp/dev/vendor/merchant-id La funzione utilizza il valore senza scriverlo nei log delle funzioni o restituirlo nella risposta.

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 crittografia e prezzi

Quando si crea un SecureString parametro, Systems Manager utilizza AWS KMS per crittografare il valore del parametro.

La creazione di Parameter Store un SecureString parametro è gratuita, ma AWS KMS possono essere applicati costi di utilizzo. Per ulteriori informazioni, consultare Prezzi di AWS Key Management Service.

Per ulteriori informazioni sulle chiavi gestite dal cliente Chiavi gestite da AWS e sulle chiavi gestite dal cliente, consulta AWS Key Management Service Concepts nella AWS Key Management Service Developer Guide. Per ulteriori informazioni sulle modalità di Parameter Store utilizzo AWS KMS, consulta Modalità di AWS Systems ManagerParameter Store utilizzo AWS KMS.

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

Vincoli relativi ai nomi dei parametri

Utilizza le informazioni riportate in questo argomento per specificare valori validi per i nomi di parametro durante il processo di creazione di un parametro.

Queste informazioni integrano i dettagli dell'argomento PutParameter dell'AWS Systems Manager API Reference, che fornisce anche informazioni sui valori AllowedPattern, sulla descrizione, sulla sovrascrittura KeyId , sul tipo e sul valore.

I requisiti e i vincoli relativi ai nomi di parametro sono descritti di seguito: