Comprensione dei tipi di parametri

Un parametro è qualsiasi dato memorizzatoParameter Store, ad esempio un blocco di testo, un elenco di nomi, un AMI ID, una chiave di licenza e così via. È possibile fare riferimento a questi dati in modo centralizzato e sicuro negli script, nei comandi e nei documenti di 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. 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

Il valore di un parametro SecureString è costituito da qualsiasi dato sensibile che deve essere archiviato e a cui è necessario fare riferimento in modo sicuro. Se hai dati che non vuoi che gli utenti modifichino o facciano riferimento in testo semplice, ad esempio segreti leggeri o chiavi di licenza, crea questi parametri utilizzando il tipo di SecureString dati.

Ti consigliamo di utilizzare i parametri SecureString per gli scenari seguenti:

È possibile utilizzare il tipo di SecureString parametro per i dati testuali che si desidera crittografare, ad esempio segreti leggeri che non richiedono rotazione, dati di configurazione riservati o qualsiasi altro tipo di dati che si desidera proteggere. SecureStringi dati vengono crittografati e decrittografati utilizzando una chiave. AWS KMS È possibile utilizzare una chiave KMS predefinita fornita da AWS o crearne e utilizzarne una propria. AWS KMS key(Utilizza AWS KMS key se desideri limitare l'accesso degli utenti ai parametri SecureString. Per ulteriori informazioni, consulta Autorizzazioni IAM per l'utilizzo di chiavi AWS predefinite e chiavi gestite dal cliente.)

È inoltre possibile utilizzare SecureString i parametri con altri Servizi AWS. Nell'esempio seguente, la funzione Lambda recupera un SecureString parametro utilizzando l'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 crittografia e prezzi

Se si sceglie il tipo di SecureString parametro quando si crea il parametro, Systems Manager lo utilizza AWS KMS per crittografare il valore del parametro.

Non è previsto alcun addebito Parameter Store per la creazione di un SecureString parametro, ma si applicano i costi per l'uso della AWS KMS crittografia. Per informazioni, consulta Prezzi di AWS Key Management Service.

Per ulteriori informazioni sulle chiavi Chiavi gestite da AWS gestite dai clienti, consulta AWS Key Management Service Concepts nella AWS Key Management Service Developer Guide. Per ulteriori informazioni sulla Parameter Store AWS KMS crittografia, vedere Modalità di AWS Systems ManagerParameter Store utilizzo AWS KMS.

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