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 d'une destination d'événement Amazon SNS dans les SMS de messagerie destinés aux utilisateurs AWS finaux
Amazon Simple Notification Service (Amazon SNS) est un service web qui permet aux applications, utilisateurs finaux et appareils d’envoyer et de recevoir instantanément des notifications. Pour en savoir plus sur Amazon SNS, consultez le [Guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
Certains des exemples présentés dans cette section supposent que vous avez déjà installé et configuré le AWS Command Line Interface. Pour plus d'informations sur la configuration du AWS CLI, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).
**Topics**
+ [Politique d'accès Amazon SNS](configuration-sets-sns-creating-role.md)
+ [Création d'une destination d'événement Amazon SNS](configuration-sets-sns-add.md)
+ [Modifier la destination d'un événement Amazon SNS](configuration-sets-sns-edit.md)
+ [Supprimer la destination d'un événement Amazon SNS](configuration-sets-sns-delete.md)
# Politique d'accès Amazon SNS
*L'accès à une rubrique Amazon SNS est contrôlé par une *politique de ressources* attachée à la rubrique Amazon SNS, également appelée politique d'accès.* Pour plus d'informations sur les *politiques d'accès* Amazon SNS, consultez la section [Gestion des identités et des accès](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) dans le manuel *Amazon SNS Developer Guide*.
**Note**
Si le chiffrement côté serveur est activé dans votre rubrique Amazon SNS, AWS Key Management Service ajoutez également la politique à la clé de chiffrement [symétrique](#configuration-sets-sns-creating-role-encrypted) gérée par le client associée.
Mettez à jour la *politique d'accès* avec la déclaration suivante pour autoriser AWS la publication de SMS destinés aux utilisateurs finaux sur la rubrique Amazon SNS.
+ *111122223333*Remplacez-le par l'identifiant unique de votre AWS compte.
+ Remplacez *TopicName* par le nom de la rubrique Amazon SNS.
+ *Region*Remplacez-le par le Région AWS qui contient le sujet Amazon SNS et le jeu de configuration.
+ Remplacez *ConfigSetName* par le nom du jeu de configuration.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## Politique d'accès aux rubriques Amazon SNS chiffrées
Si le chiffrement côté serveur est activé dans votre rubrique Amazon SNS AWS Key Management Service, ajoutez la politique suivante à la clé de chiffrement symétrique gérée par le client associée. Vous devez ajouter la politique à une clé gérée par le client car vous ne pouvez pas modifier la clé AWS gérée pour Amazon SNS.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# Création d'une destination d'événement Amazon SNS dans les SMS de messagerie destinés aux utilisateurs AWS finaux
Avant de créer une destination d'événement Amazon SNS, vous devez d'abord créer une rubrique Amazon SNS. Pour plus d'informations sur la création de rubriques Amazon SNS, consultez la section [Création d'une rubrique](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) dans le manuel *Amazon Simple Notification Service Developer Guide*.
Vous devez également avoir déjà configuré un ensemble de configuration auquel associer les destinations des événements, voir[Ensembles de configuration dans les SMS de messagerie destinés aux utilisateurs AWS finaux](configuration-sets.md).
------
#### [ Create an Amazon SNS event destination (Console) ]
Pour créer une destination d'événement Amazon SNS à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :
1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.
1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement.
1. Sur la page des **détails du jeu de configuration**, choisissez **Ajouter un événement de destination**.
1. Dans la section **Détails de l'événement**, entrez un nom.
1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon SNS.
1. **Nouvelle rubrique Amazon SNS** — Choisissez cette option pour que l'utilisateur AWS final envoie des SMS afin de créer un sujet dans votre compte. La rubrique est automatiquement créée avec toutes les autorisations requises. Pour plus d'informations sur les sujets relatifs à Amazon SNS, consultez la [section Configuration d'Amazon SNS dans le manuel Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple Notification](https://docs.aws.amazon.com/sns/latest/dg/) Service Developer Guide.
1. **Rubrique Amazon SNS existante** : choisissez cette option si vous avez déjà une rubrique Amazon SNS dans **le** menu déroulant Rubrique.
1. Sous **Types d'événements**, sélectionnez :
+ **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
+ **Événements SMS personnalisés** : choisissez des événements SMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
+ **Tous les événements vocaux (recommandé)** : choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon SNS.
+ **Événements vocaux personnalisés** : choisissez parmi les événements vocaux spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
+ **Tous les événements MMS (recommandé)** : choisissez cette option pour envoyer tous les événements MMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
+ Événements **MMS personnalisés : choisissez des événements** MMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
1. Choisissez **Create event (Créer un événement)**.
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
Vous pouvez utiliser la [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)commande pour créer une destination d'événement.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par un nom descriptif pour la destination de l'événement.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement.
+ *eventTypes*Remplacez-le par l'un des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `TopicArn` par l'Amazon Resource Name (ARN) de la rubrique Amazon SNS à laquelle vous souhaitez envoyer des événements.
------
# Modifier la destination d'un événement Amazon SNS dans un SMS de messagerie à l'utilisateur AWS final
Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour modifier la destination d'un événement Amazon SNS.
------
#### [ Update an Amazon SNS event destination (Console) ]
Pour mettre à jour AWS la destination d'un événement de messagerie SMS à l'utilisateur AWS final à l'aide de la console SMS de messagerie utilisateur final, procédez comme suit :
1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.
1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement.
1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration à modifier.
1. **Sur la page des **détails de l'ensemble de configuration**, choisissez une destination d'événement Amazon SNS, puis Modifier.**
1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon SNS.
1. **Nouvelle rubrique Amazon SNS** — Choisissez cette option, les SMS destinés aux utilisateurs AWS finaux créent un sujet dans votre compte. La rubrique est automatiquement créée avec toutes les autorisations requises. Pour plus d'informations sur les sujets relatifs à Amazon SNS, consultez la [section Configuration d'Amazon SNS dans le manuel Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple Notification](https://docs.aws.amazon.com/sns/latest/dg/) Service Developer Guide.
1. **Rubrique Amazon SNS existante** : choisissez cette option si vous avez déjà une rubrique Amazon SNS dans **le** menu déroulant Rubrique.
1. Sous **Types d'événements**, sélectionnez :
+ **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
+ **Événements SMS personnalisés** : choisissez cette option pour sélectionner des événements SMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
+ **Tous les événements vocaux (recommandé)** : choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon SNS.
+ **Événements vocaux personnalisés** : choisissez cette option pour sélectionner des événements vocaux spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
+ **Tous les événements MMS (recommandé)** : choisissez cette option pour envoyer tous les événements MMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
+ **Événements MMS personnalisés** : choisissez cette option pour sélectionner des événements MMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
1. Choisissez **Modifier l'événement**.
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
Vous pouvez utiliser la [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)commande pour mettre à jour la destination d'un événement.
La procédure de mise à jour d'une destination d'événement Amazon SNS est similaire au processus de création d'une destination d'événement.
**Pour mettre à jour la destination d'un événement Amazon SNS dans le AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par le nom de la destination de l'événement que vous souhaitez modifier.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement. Vous pouvez associer la destination de l'événement à un autre jeu de configuration.
+ Remplacez *eventTypes* par un ou plusieurs des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `TopicArn` par l'Amazon Resource Name (ARN) de la rubrique Amazon SNS à laquelle vous souhaitez envoyer des événements.
------
# Supprimer la destination d'un événement Amazon SNS dans un SMS de messagerie à l'utilisateur AWS final
Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour supprimer une rubrique Amazon SNS.
------
#### [ Delete an Amazon SNS event destination (Console) ]
Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.
**Pour supprimer la destination d'un événement Amazon SNS dans la console**
1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.
1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration dont vous souhaitez supprimer une destination d'événement.
1. Dans la section **Toutes les destinations**, choisissez une destination d'événement, puis cliquez **sur Supprimer**.
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
Vous pouvez utiliser la [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)commande pour supprimer la destination d'un événement.
Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.
**Pour supprimer la destination d'un événement Amazon SNS dans AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par le nom ou le Amazon Resource Name (ARN) de la destination de l'événement que vous souhaitez supprimer.
+ Remplacez *configurationSetName* par le nom ou l'ARN du jeu de configuration auquel la destination de l'événement est associée.
------