Utilisation de ressources partagées dans les SMS destinés aux utilisateurs AWS finaux

AWS La messagerie SMS destinée aux utilisateurs finaux s'intègre à AWS Resource Access Manager (AWS RAM) pour permettre le partage des ressources. AWS RAM est un service qui vous permet de partager certaines ressources de messagerie SMS destinées aux utilisateurs AWS finaux avec d'autres personnes Comptes AWS ou par le biais de celles-ci AWS Organizations. Avec AWS RAM, vous partagez les ressources que vous possédez en créant un partage de ressources. Un partage de ressources spécifie les ressources à partager, ainsi que les consommateurs avec qui elles seront partagées. Les consommateurs peuvent être :

• Spécifique Comptes AWS à l'intérieur ou à l'extérieur de son organisation dans AWS Organizations

• Une unité organisationnelle au sein de son organisation dans AWS Organizations

• Toute son organisation en AWS Organizations

• Autres AWS services tels qu'Amazon Pinpoint ou Amazon SNS

Pour plus d'informations AWS RAM, consultez le guide de AWS RAM l'utilisateur.

Cette rubrique explique comment partager les ressources que vous possédez et comment utiliser les ressources partagées avec vous.

Conditions préalables au partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un expéditeur IDs

• Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur, vous devez le posséder dans votre Compte AWS. Cela signifie que la ressource doit être allouée ou provisionnée dans votre compte. Vous ne pouvez pas partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur qui ont été partagés avec vous.

• Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur avec votre organisation ou une unité organisationnelle AWS Organizations, vous devez activer le partage avec AWS Organizations. Pour plus d’informations, consultez Activation du partage avec AWS Organizations dans le Guide de l’utilisateur AWS RAM .

Partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur

Lorsque vous partagez une ressource que vous possédez avec d'autres personnes Comptes AWS, vous leur permettez d'effectuer les opérations suivantes :

• Liste de désinscription — Les consommateurs ayant accès à cette ressource peuvent vérifier le statut d'un numéro de téléphone, supprimer un numéro de téléphone et ajouter des numéros de téléphone à la liste de désinscription.

• PhoneNumber— Les consommateurs ayant accès à cette ressource peuvent utiliser le numéro de téléphone pour envoyer des messages.

• Piscine — Les consommateurs ayant accès à cette ressource peuvent consulter la piscine. Toutes les ressources contenues dans le pool doivent également être partagées pour que d'autres Comptes AWS puissent y accéder. Vous pouvez avoir un mélange de ressources partagées et non partagées dans un pool.

• ID de l'expéditeur — Les consommateurs ayant accès à cette ressource peuvent utiliser l'identifiant de l'expéditeur pour envoyer des messages.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur, vous devez l'ajouter à un partage de ressources. Un partage de ressources est une ressource AWS RAM qui vous permet de partager vos ressources entre des Comptes AWS. Un partage de ressources spécifie les ressources à partager, ainsi que les consommateurs avec qui elles seront partagées. Lorsque vous partagez un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur à l'aide de la console SMS de messagerie utilisateur AWS final, vous l'ajoutez à un partage de ressources existant. Pour ajouter le numéro de téléphone, le pool, la liste de désinscription ou l'identifiant de l'expéditeur à un nouveau partage de ressources, vous devez d'abord créer le partage de ressources à l'aide de la AWS RAM console.

Si vous faites partie d'une organisation AWS Organizations et que le partage au sein de votre organisation est activé, les clients de votre organisation ont automatiquement accès au numéro de téléphone, au pool, à la liste de désinscription ou à l'identifiant d'expéditeur partagés. Dans le cas contraire, les consommateurs reçoivent une invitation à rejoindre le partage de ressources et ont accès au numéro de téléphone, au pool, à la liste de désinscription ou à l'identifiant d'expéditeur partagés après avoir accepté l'invitation.

Vous pouvez partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur que vous possédez à l'aide de la console SMS de messagerie utilisateur AWS final, de la AWS RAM console ou du AWS CLI.

Note

Les ressources partagées ne peuvent être utilisées que via l' AWS CLI API AWS Final User Messaging SMS and Voice v2. Pour utiliser une ressource partagée, vous devez utiliser le nom complet de la ressource Amazon (ARN).

Pour consulter les ressources partagées avec votre compte, vous devez utiliser la console AWS CLI ou la AWS RAM console.

Nous vous recommandons d'utiliser la AWS RAM console pour partager des ressources.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide de la console SMS de messagerie utilisateur AWS final

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

2. Dans le volet de navigation, sous Configurations, choisissez le type de ressource, puis la ressource.

3. Dans l’onglet Stratégie de ressources choisissez Modifier.

4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

5. Sélectionnez Enregistrer les modifications.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide de la AWS RAM console

Consultez Création d’un partage de ressources dans le Guide de l’utilisateur AWS RAM .

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS CLI

Utilisez la commande create-resource-share.

Annulation du partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés

Lorsqu'un propriétaire de ressource arrête de partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur avec un consommateur, la ressource n'apparaît plus dans la console du consommateur.

Pour annuler le partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur que vous possédez, vous devez le supprimer du partage de ressources. Vous pouvez le faire à l'aide de la console SMS de messagerie utilisateur AWS final, de la AWS RAM console ou du AWS CLI.

Pour annuler le partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés dont vous êtes propriétaire à l'aide de la console AWS RAM

Consultez Mise à jour d’un partage de ressources dans le Guide de l’utilisateur AWS RAM .

Pour annuler le partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés à l'aide du AWS CLI

Utilisez la commande disassociate-resource-share.

Identification d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés

Les propriétaires et les consommateurs peuvent identifier le numéro de téléphone partagé, le pool, la liste de désinscription ou l'expéditeur IDs à l'aide du AWS CLI.

Note

Les numéros de téléphone, les pools, la liste de désinscription et l'expéditeur ne IDs sont généralement pas identifiables en tant que ressource partagée dans la console SMS de messagerie utilisateur AWS final.

Pour identifier un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur partagés à l'aide du AWS CLI

Utilisez la describe-sender-idscommande describe-opt-out-lists, describe-phone-numbers, describe-pools, ou avec le Owner paramètre défini sur. SHARED La commande renvoie le numéro de téléphone, le pool, la liste de désinscription ou l'expéditeur IDs partagés avec vous.

Responsabilités et autorisations relatives au numéro de téléphone, au pool, à la liste de désinscription ou à l'expéditeur partagés IDs

Autorisations accordées aux propriétaires

Les propriétaires peuvent mettre à jour, consulter, partager, arrêter de partager et utiliser le numéro de téléphone, le pool, la liste de désinscription ou l'expéditeur IDs.

Autorisations accordées aux consommateurs

Les consommateurs peuvent utiliser et consulter le numéro de téléphone, le pool, la liste de désinscription ou l'expéditeur IDs.

Facturation et mesures

Le propriétaire de la ressource est facturé pour la ressource. Les consommateurs ne sont pas facturés pour les ressources partagées avec eux, mais pour l'utilisation de ressources pour envoyer des messages. Le partage d'une ressource n'entraîne aucun coût supplémentaire.

Les consommateurs sont facturés pour l'envoi d'un message avec send-media-messageou send-text-message, send-voice-messageet cela est pris en compte dans les limites de dépenses des consommateurs. Pour plus d'informations sur les prix ou les limites de dépenses, consultez les sections Tarification des messages destinés aux utilisateurs AWS finaux etDéfinissez une limite de dépenses pour les SMS, les MMS ou les appels vocaux dans AWS la messagerie SMS de l'utilisateur final.

Quotas d'instances

Le partage d'une ressource n'a aucune incidence sur les limites de la ressource sur le compte du propriétaire ou du consommateur. Seul le compte du propriétaire est utilisé pour calculer les limites de la ressource.

Exemples de politiques relatives au partage d'un identifiant d'expéditeur ou d'un numéro de téléphone avec Amazon Pinpoint

Nous vous recommandons d'utiliser la AWS RAM console pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint d'envoyer des SMS ou des messages vocaux avec le numéro de téléphone spécifié.

Pour partager un numéro de téléphone dont vous êtes propriétaire à l'aide de la console SMS de messagerie utilisateur AWS final

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

2. Dans le volet de navigation, sous Configurations, sélectionnez Numéros de téléphone, puis choisissez un numéro de téléphone.

3. Dans l’onglet Stratégie de ressources choisissez Modifier.

4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

   Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources :

   • Remplacez Partition par la AWS partition dans laquelle se trouve le numéro de téléphone.

   • Remplacez Region par Région AWS le numéro de téléphone indiqué.

   • Remplacez Account par le numéro de compte auquel appartient le numéro de téléphone.

   • Remplacez Phone-id par l'identifiant du numéro de téléphone.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "pinpoint.amazonaws.com"
               },
               "Action": [
                   "sms-voice:SendTextMessage",
                   "sms-voice:SendVoiceMessage"
               ]
               "Resource":"arn:Partition:sms-voice:Region:Account:phone-number/Phone-id",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "Account"
                   }
               }
           }
       ]
   }

5. Sélectionnez Enregistrer les modifications.

L'exemple suivant permet à Amazon Pinpoint d'envoyer des SMS avec l'identifiant d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur dont vous êtes propriétaire à l'aide de la console SMS de messagerie utilisateur AWS final

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

2. Dans le volet de navigation, sous Configurations, sélectionnez Expéditeur, IDs puis choisissez un ID d'expéditeur.

3. Dans l’onglet Stratégie de ressources choisissez Modifier.

4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

   Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources :

   • Remplacez Partition par la AWS partition dans laquelle se trouve l'identifiant de l'expéditeur.

   • Remplacez Region par Région AWS l'identifiant de l'expéditeur indiqué.

   • Remplacez Account par le numéro de compte associé à l'identifiant de l'expéditeur.

   • Remplacez Senderid par l'identifiant de l'expéditeur.

   • CountrycodeRemplacez-le par le code ISO-3166 alpha-2 à deux lettres correspondant au pays de l'identifiant de l'expéditeur.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "pinpoint.amazonaws.com"
               },
               "Action": [
                   "sms-voice:SendTextMessage"
               ]
               "Resource":"arn:Partition:sms-voice:Region:Account:sender-id/Senderid/Countrycode",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "Account"
                   }
               }
           }
       ]
   }

5. Sélectionnez Enregistrer les modifications.

Exemple de politique de partage d'un identifiant d'expéditeur avec Amazon Pinpoint et Amazon SNS

Nous vous recommandons d'utiliser la AWS RAM console pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint et Amazon SNS d'envoyer des SMS avec l'identifiant d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur dont vous êtes propriétaire à l'aide de la console SMS de messagerie utilisateur AWS final

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

2. Dans le volet de navigation, sous Configurations, sélectionnez Expéditeur, IDs puis choisissez un ID d'expéditeur.

3. Dans l’onglet Stratégie de ressources choisissez Modifier.

4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

   Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources :

   • Remplacez Partition par la AWS partition dans laquelle se trouve le numéro de téléphone.

   • Remplacez Region par Région AWS le numéro de téléphone indiqué.

   • Remplacez OwnersAccountID par le numéro de AWS compte associé à l'identifiant de l'expéditeur.

   • Remplacez SenderID par l'identifiant de l'expéditeur.

   • ISORemplacez-le par le code ISO-3166 alpha-2 à deux lettres correspondant au pays de l'identifiant de l'expéditeur.

   • Remplacez ConsumersAccountID par le numéro de AWS compte auquel vous souhaitez donner accès.

   
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "pinpoint.amazonaws.com"
         },
         "Action": [
           "sms-voice:SendTextMessage",
           "sms-voice:SendVoiceMessage"
         ],
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sns.amazonaws.com"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "arn:aws:iam::ConsumersAccountID:root"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO"
       }
     ]
   }
           

5. Sélectionnez Enregistrer les modifications.

Exemple de politique de partage d'un numéro de téléphone avec Amazon Pinpoint et Amazon SNS

Nous vous recommandons d'utiliser la AWS RAM console pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint et Amazon SNS d'envoyer des SMS avec le numéro de téléphone spécifié.

Pour partager un numéro de téléphone dont vous êtes propriétaire à l'aide de la console SMS de messagerie utilisateur AWS final

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

2. Dans le volet de navigation, sous Configurations, sélectionnez Numéros de téléphone, puis choisissez un numéro de téléphone.

3. Dans l’onglet Stratégie de ressources choisissez Modifier.

4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

   Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources :

   • Remplacez Partition par la AWS partition dans laquelle se trouve le numéro de téléphone.

   • Remplacez Region par Région AWS le numéro de téléphone indiqué.

   • Remplacez OwnersAccountID par le numéro de AWS compte auquel appartient le numéro de téléphone.

   • Remplacez PhoneNumberID par l'identifiant du numéro de téléphone.

   • Remplacez ConsumersAccountID par le numéro de AWS compte auquel vous souhaitez donner accès.

   
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "pinpoint.amazonaws.com"
         },
         "Action": [
           "sms-voice:SendTextMessage",
           "sms-voice:SendVoiceMessage"
         ],
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sns.amazonaws.com"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "arn:aws:iam::ConsumersAccountID:root"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID"
       }
     ]
   }
           

5. Sélectionnez Enregistrer les modifications.