Échange d'appareils

La fonction "Device Swap" est conçue pour permettre de savoir en temps réel si une carte SIM associée au numéro de téléphone d'un utilisateur a été transférée vers un autre appareil physique. Elle améliore la sécurité, la détection des fraudes et la conformité réglementaire en offrant des informations claires et structurées sur l'échange d'appareils.

La fraude par échange d'appareils permet à un pirate de prendre le contrôle de la carte SIM d'une victime et donc de son numéro de téléphone mobile, ce qui peut permettre à cette dernière de l'utiliser :

• L'usurpation d'identité : Les attaquants peuvent utiliser la permutation d'appareils pour usurper l'identité de la victime alors qu'ils prennent le contrôle de son numéro de téléphone.
• Reprise de compte : De nombreux comptes en ligne, notamment les comptes de messagerie, de médias sociaux et financiers, utilisent les numéros de téléphone pour l'authentification à deux facteurs (2FA) ou la récupération des comptes. En prenant le contrôle de la carte SIM de la victime dans son propre appareil, les attaquants peuvent intercepter les codes d'authentification envoyés par SMS et obtenir un accès non autorisé aux comptes de la victime.
• Fraude financière : Une fois que les attaquants ont accédé aux comptes de la victime, ils peuvent mener diverses formes de fraude financière, comme transférer des fonds, effectuer des achats non autorisés ou contracter des prêts au nom de la victime.
• Violation de la vie privée : Les attaquants peuvent accéder aux communications personnelles, aux contacts et à d'autres informations sensibles stockées sur les appareils ou les comptes de la victime.

L'un des principaux objectifs de l'aperçu de l'échange de dispositifs est de fournir une évaluation du risque de fraude en identifiant les événements liés à l'échange de dispositifs. L'intégration de l'échange d'appareils peut compléter divers scénarios, notamment :

• Ajouter un facteur de risque à un individu
• Renforcement des méthodes 2FA traditionnelles sur la base d'événements récents rapportés par Device Swap
• Surveillance des activités frauduleuses sur les numéros de téléphone des clients
• La conformité réglementaire peut exiger des contrôles sur l'échange de dispositifs

Conditions préalables

Pour utiliser Identity Insights, vous devez vous assurer que votre Account est correctement configuré. Pour commencer pour plus d'informations :

• Création de votre Account,
• Création d'une application Vonage à utiliser avec l'API Identity Insights,
• Les différents environnements disponibles et comment configurer votre Account pour les utiliser,
• Et comment utiliser l'interface utilisateur du tableau de bord pour utiliser l'API sans écrire de code.

Ce guide explique comment utiliser Device Swap Insight de manière programmatique à l'aide de cURL.

Faire un appel à l'API

L'authentification pour l'API Identity Insights se fait par le biais de JWT, un jeton JSON compact et autonome. Pour générer un JWT, vous pouvez utiliser notre outil générateur en ligneou bien utiliser la fonction CLI Vonage. Vous aurez besoin de votre identifiant d'application et de votre clé privée pour générer le JWT. Une fois que vous avez votre JWT, vous pouvez envoyer une demande à l'API.

Cet exemple montre une requête cURL pour l'aperçu des échanges de périphériques afin de vérifier si un échange de périphériques a eu lieu au cours des 240 dernières heures ; cette période est définie par l'attribut period qui peut être réglé entre 1 et 2400 heures :

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        "device_swap": {
         "period": 240
          }
        }
    }'

L'API compare alors l'appareil associé à l'utilisateur du téléphone portable avec celui qui figure dans les dossiers de l'opérateur de l'utilisateur du téléphone portable, et renvoie des informations indiquant si et quand un échange d'appareil a eu lieu au cours de la période spécifiée :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "device_swap": {
        "latest_device_swap_at": "2024-07-08T09:30:27.504Z",
        "is_swapped": true,
        "status": {
          "code": "OK",
          "message": "Success"
        }
    }
  }
}

Vous verrez les champs suivants dans la fenêtre device_swap objet :

Pour en savoir plus

• Pour en savoir plus sur l'API Identity Insights, consultez la page Référence API.
• Si vous avez des questions, vous pouvez nous contacter à l'adresse suivante Communauté Vonage Slack.