

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration Parameter Store

Avant de configurer les paramètres dansParameter Store, configurez des politiques Gestion des identités et des accès AWS (IAM) qui autorisent les administrateurs de votre compte à effectuer les actions que vous spécifiez. 

Dans cette section, vous apprendrez à configurer manuellement ces politiques à l'aide de la console IAM et à les attribuer à des utilisateurs et à des groupes d'utilisateurs. Vous pouvez également créer et attribuer des politiques pour contrôler les actions de paramètres qui peuvent être exécutées sur un nœud géré. 

Cette section explique également comment créer des EventBridge règles Amazon qui vous permettent de recevoir des notifications concernant les modifications apportées aux paramètres de Systems Manager. Vous pouvez utiliser des EventBridge règles pour invoquer d'autres actions en AWS fonction des modifications apportées àParameter Store.

**Topics**
+ [Gestion de l'accès à Parameter Store paramètres utilisant des politiques IAM](#sysman-paramstore-access)
+ [Choix des niveaux de paramètres dans Parameter Store](parameter-store-advanced-parameters.md)
+ [Gestion Parameter Store débit](parameter-store-throughput.md)
+ [Configuration des notifications ou déclenchement d'actions en fonction de Parameter Store events](sysman-paramstore-cwe.md)

## Gestion de l'accès à Parameter Store paramètres utilisant des politiques IAM
<a name="sysman-paramstore-access"></a>

 Le principal IAM qui accède aux AWS Systems Manager paramètres doit être autorisé à effectuer les actions SSM requises. Le principal peut être un utilisateur IAM, un rôle IAM, un profil d'instance Amazon EC2, un rôle d'exécution Lambda, un rôle de tâche Amazon ECS, un rôle de CodeBuild service ou un autre rôle de service. AWS 

 Le tableau suivant décrit les autorisations IAM requises pour différentes Parameter Store actions. 



| Action | Privilège IAM requis | Informations de référence | 
| --- | --- | --- | 
| Création ou mise à jour d'un paramètre | ssm:PutParameter | [PutParameter](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_PutParameter.html) | 
| Récupérez un paramètre | ssm:GetParameter | [GetParameter](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html) | 
| Récupérez plusieurs paramètres nommés | ssm:GetParameters | [GetParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameters.html) | 
| Récupérer des paramètres sous un chemin | ssm:GetParametersByPath | [GetParametersByPath](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html) | 
| Afficher les métadonnées des paramètres | ssm:DescribeParameters | [DescribeParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeParameters.html) | 
| Afficher l'historique des versions des paramètres | ssm:GetParameterHistory | [GetParameterHistory](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameterHistory.html) | 
| Supprimer un paramètre | ssm:DeleteParameter | [DeleteParameter](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DeleteParameter.html) | 
| Supprimer plusieurs paramètres | ssm:DeleteParameters | [DeleteParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DeleteParameters.html) | 

Lorsque vous utilisez des politiques IAM pour accorder l'accès aux paramètres de Systems Manager, nous vous recommandons de créer et d'utiliser des politiques * IAM * restrictives. Par exemple, la politique suivante permet à un responsable d'appeler les opérations d'`GetParameters`API `DescribeParameters` et pour un ensemble limité de ressources. Le directeur peut obtenir des informations et utiliser tous les paramètres commençant par`prod-*`.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:DescribeParameters"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParameters"
            ],
            "Resource": "arn:aws:ssm:{{us-east-1}}:{{111122223333}}:parameter/prod-*"
        }
    ]
}
```

------

**Note**  
La politique précédente autorise les actions de récupération, `ssm:GetParameters` mais pas les autres. Parameter Storeautorise chaque opération de récupération en fonction de sa propre action IAM, de sorte que le fait d'autoriser ou de refuser une action n'affecte pas les autres. Avant de vous fier à une politique visant à restreindre les paramètres qu'un directeur peut lire, consultez [Comment ? Parameter Store autorise la récupération des paramètres](ps-retrieval-authorization.md) et[Restreindre l'accès à des paramètres et à des chemins spécifiques](ps-restrict-parameter-access.md).

**Important**  
Parameter Storeautorise l'`GetParametersByPath`opération par rapport au chemin que vous spécifiez dans la demande, et non par rapport à chaque paramètre renvoyé par l'opération. Un principal autorisé à appeler `GetParametersByPath` le chemin `/a` reçoit tous les paramètres de ce chemin, y compris`/a/b`. Cela est vrai même si la même politique refuse explicitement l'accès à `/a/b` pour d'autres actions.  
Pour empêcher le renvoi d'un paramètre par`GetParametersByPath`, refusez l'`ssm:GetParametersByPath`action sur chaque chemin ancêtre susceptible d'inclure le paramètre dans ses résultats. Par exemple, pour `/a/b` empêcher le renvoi, refusez `ssm:GetParametersByPath` à la fois `/a` et`/`.

Pour les administrateurs de confiance, vous pouvez fournir un accès complet à toutes les opérations d'API des paramètres Systems Manager en utilisant une politique similaire à l'exemple suivant. Cette politique accorde à l'utilisateur un accès complet à tous les paramètres de production qui commencent par `dbserver-prod-*`.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:PutParameter",
                "ssm:DeleteParameter",
                "ssm:GetParameterHistory",
                "ssm:GetParametersByPath",
                "ssm:GetParameters",
                "ssm:GetParameter",
                "ssm:DeleteParameters"
            ],
            "Resource": "arn:aws:ssm:{{us-east-1}}:111122223333:parameter/dbserver-prod-*"
        },
        {
            "Effect": "Allow",
            "Action": "ssm:DescribeParameters",
            "Resource": "*"
        }
    ]
}
```

------

### Refuser des autorisations
<a name="sysman-paramstore-deny-permissions"></a>

Chaque API est unique et dispose d'opérations et d'autorisations distinctes que vous pouvez autoriser ou refuser individuellement. Un refus explicite dans n'importe quelle politique remplace l'autorisation.

**Important**  
Chaque opération étant autorisée pour sa propre action IAM, le refus d'une seule action n'empêche pas un principal de récupérer le même paramètre par le biais d'une autre opération. Par exemple, le fait de nier à `ssm:GetParameter` lui seul n'a aucun effet sur `ssm:GetParameters``ssm:GetParameterHistory`, ou`ssm:GetParametersByPath`. Refusez toujours toute action susceptible de renvoyer la valeur. Pour une description complète de ce comportement, consultez[Comment ? Parameter Store autorise la récupération des paramètres](ps-retrieval-authorization.md).

**Note**  
La clé par défaut AWS Key Management Service (AWS KMS) `Decrypt` autorise tous les principaux IAM du. Compte AWS Si vous souhaitez différents niveaux d'accès aux `SecureString` paramètres de votre compte, nous vous déconseillons d'utiliser la clé par défaut. La `kms:Decrypt` restriction d'une clé gérée par le client empêche le déchiffrement d'une `SecureString` valeur lors de toute opération de récupération. Pour plus d’informations, consultez [Restreindre le déchiffrement des valeurs des `SecureString` paramètres](ps-restrict-decryption.md).

Les noms des quatre actions de récupération commencent par`GetParameter`, de sorte que l'entrée unique `ssm:GetParameter*` couvre `ssm:GetParameter` `ssm:GetParameters``ssm:GetParameterHistory`, et`ssm:GetParametersByPath`. L'exemple suivant utilise ce modèle pour refuser les quatre actions pour tous les paramètres commençant par`prod-*`.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "ssm:GetParameter*"
            ],
            "Resource": "arn:aws:ssm:{{us-east-1}}:{{111122223333}}:parameter/prod-*"
        }
    ]
}
```

------

**Note**  
Dans l'exemple précédent, le refus `ssm:GetParametersByPath` s'applique uniquement aux appels qui * demandent * une correspondance de chemin`prod-*`. Cela n'empêche pas le renvoi d'un `prod-*` paramètre par un appel qui demande un chemin ancêtre. Pour combler cet écart, `ssm:GetParametersByPath` niez également les chemins des ancêtres. Pour plus d’informations, consultez [Restreindre l'accès à des paramètres et à des chemins spécifiques](ps-restrict-parameter-access.md).

L'exemple suivant montre comment refuser certaines commandes, tout en permettant à l'utilisateur d'en exécuter d'autres sur tous les paramètres commençant par `prod-*`.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "ssm:PutParameter",
                "ssm:DeleteParameter",
                "ssm:DeleteParameters",
                "ssm:DescribeParameters"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParametersByPath",
                "ssm:GetParameters",
                "ssm:GetParameter",
                "ssm:GetParameterHistory"
            ],
            "Resource": "arn:aws:ssm:{{us-east-1}}:111122223333:parameter/prod-*"
        }
    ]
}
```

------

**Note**  
L'historique des paramètres inclut toutes les versions de paramètres, y compris la version actuelle. Par conséquent, si un utilisateur se voit refuser l'autorisation pour `GetParameter`, `GetParameters` et `GetParametersByPath`, mais qu'il obtient l'autorisation pour `GetParameterHistory`, il peut voir le paramètre actuel, y compris les paramètres `SecureString`, en utilisant `GetParameterHistory`.

Le même comportement s'applique à la suppression. `ssm:DeleteParameters`est autorisé indépendamment de`ssm:DeleteParameter`, donc le fait de refuser uniquement `ssm:DeleteParameter` n'empêche pas un principal de supprimer le paramètre avec l'`DeleteParameters`opération. Refusez les deux actions ou utilisez le schéma`ssm:DeleteParameter*`.

### Chiffrement et déchiffrement des paramètres à l'aide de AWS KMS clés
<a name="ps-kms-permissions"></a>

Parameter Store`SecureString`les paramètres utilisent AWS KMS des clés pour le chiffrement. AWS KMS chiffre la valeur à l'aide d'une clé gérée par le client Clé gérée par AWS ou d'une clé gérée par le client. Pour plus d'informations sur AWS KMS et AWS KMS key, consultez le Guide du * [AWS Key Management Service développeur ](https://docs.aws.amazon.com/kms/latest/developerguide/)*.

Tous les utilisateurs du compte client ont accès à la clé AWS gérée par défaut. Vous pouvez trouver l'Amazon Resource Name (ARN) de la clé par défaut dans la AWS KMS console, sur la [ page des clés ](https://console.aws.amazon.com/kms/home#/kms/defaultKeys)AWS gérées. La clé par défaut est identifiée par `aws/ssm` dans la colonne **Alias**. Vous souhaiterez peut-être utiliser la clé par défaut pour chiffrer `SecureString` les paramètres tout en empêchant les utilisateurs de travailler avec les `SecureString` paramètres. Dans ce cas, les politiques IAM doivent explicitement refuser l'accès à la clé par défaut, comme le montre l'exemple de politique suivant.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
            ],
            "Resource": [
                "arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/abcd1234-ab12-cd34-ef56-abcdeEXAMPLE"
            ]
        }
    ]
}
```

------

Lorsque vous utilisez une clé gérée par le client, la politique IAM qui accorde à un accès principal à un paramètre ou à un chemin de paramètre doit fournir des `kms:Encrypt` autorisations explicites pour la clé. Par exemple, la politique suivante permet à un principal de créer, de mettre à jour et d'afficher des `SecureString` paramètres commençant par `prod-` les valeurs spécifiées Région AWS et Compte AWS.

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:PutParameter",
                "ssm:GetParameter",
                "ssm:GetParameters"
            ],
            "Resource": [
                "arn:aws:ssm:{{us-east-1}}:{{111122223333}}:parameter/prod-*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey"
            ],
            "Resource": [
                "arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/1234abcd-12ab-34cd-56ef-12345EXAMPLE"
            ]
        }
    ]
}
```

------

**Note**  
L’autorisation `kms:GenerateDataKey` est requise pour créer des paramètres avancés chiffrés à l’aide de la clé gérée par le client spécifiée. 

Si vous avez besoin d'un contrôle d'accès précis aux `SecureString` paramètres de votre compte, utilisez une clé gérée par le client pour protéger et restreindre l'accès à ces paramètres. Nous vous recommandons également de l'utiliser AWS CloudTrail pour surveiller l'activité des `SecureString` paramètres.

Pour plus d’informations, consultez les rubriques suivantes :
+ [Logique d'évaluation des politiques](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) dans le *Guide de l'utilisateur IAM*
+ [Utilisation de politiques de clé dans AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) dans le *Guide du développeur AWS Key Management Service *
+ [Afficher les événements avec l'historique des CloudTrail événements ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) dans le guide de *AWS CloudTrail l'utilisateur *

### Autoriser les nœuds gérés à accéder à des paramètres spécifiques
<a name="sysman-paramstore-access-inst"></a>

Pour contrôler Parameter Store les paramètres qu'un nœud géré peut récupérer, vous pouvez associer une politique IAM au rôle d'instance. Si vous choisissez le type de `SecureString` paramètre lorsque vous créez votre paramètre, Systems Manager l'utilise AWS KMS pour chiffrer la valeur du paramètre. Vous pouvez le consulter Clé gérée par AWS en exécutant la commande suivante à partir du AWS CLI.

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

L'exemple suivant permet aux nœuds d'obtenir une valeur de paramètre seulement pour les paramètres commençant par `prod-`. Si le paramètre est un paramètre `SecureString`, le nœud déchiffre alors la chaîne en utilisant la AWS KMS.

**Note**  
Les politiques d'instances, comme dans l'exemple précédent, sont attribuées au rôle de l'instance dans IAM. Pour plus d'informations sur la configuration de l'accès aux fonctions Systems Manager, y compris la façon d'attribuer des politiques aux utilisateurs et aux instances, consultez [Gestion des instances EC2 avec Systems Manager](systems-manager-setting-up-ec2.md).

------
#### [ JSON ]

****  

```json
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParameters"
            ],
            "Resource": [
                "arn:aws:ssm:{{us-east-1}}:111122223333:parameter/prod-*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:{{us-east-1}}:111122223333:key/4914ec06-e888-4ea5-a371-5b88eEXAMPLE"
            ]
        }
    ]
}
```

------