Registre du réseau

Pour utiliser le Caractéristiques du réseau Vonage en production, vous devrez vous inscrire pour obtenir l'autorisation d'accéder aux réseaux des opérateurs à partir d'une ou plusieurs applications.

Pour simplifier ce processus, Vonage gère en coulisses l'enregistrement auprès de nombreux opérateurs partenaires pour toutes les fonctions réseau prises en charge, dans n'importe quel pays. pays mis à disposition par Vonage. Ce processus dépend de l'approbation de chaque opérateur, qui peut être transmise au registre du réseau Vonage à différents moments.

Le processus

Pour commencer le processus d'enregistrement du réseau Vonage, vous devez avoir un compte Vonage ; si vous n'en avez pas encore, vous pouvez vous inscrire pour obtenir un compte ici.

Une fois que vous êtes connecté, allez dans la section Construire et gérer et cliquez sur Registre du réseau pour commencer :

The Network Registry landing page

L'inscription aux fonctionnalités du réseau se fait en trois étapes principales :

  1. Ajouter un profil d'entreprise: Parlez-nous un peu de l'organisation qui détient l'application.
  2. Créer un profil d'application réseau: Sélectionnez les fonctionnalités du réseau que vous souhaitez utiliser, décrivez votre cas d'utilisation et soumettez le tout pour approbation.
  3. Connectez votre application Vonage: Liez votre profil à une application Vonage nouvelle ou existante pour l'authentification.

Ajouter un profil d'entreprise

Un profil d'entreprise aide Vonage et ses partenaires opérateurs à savoir quelle organisation possède chaque application utilisant les fonctions de réseau.

Sélection des pays

Pour que votre inscription soit acheminée vers les bons opérateurs, vous devez d'abord sélectionner le pays où le service est requis en choisissant dans la liste des pays disponibles. Votre inscription sera partagée avec les opérateurs disponibles dans chaque pays sélectionné. Les pays et les opérateurs disponibles peuvent être consultés ici.

Ensuite, complétez un profil d'entreprise en fournissant plus d'informations sur l'organisation propriétaire des Applications. Pour remplir cette section, vous aurez besoin des informations suivantes :

Profil de l'entreprise

  • Veuillez préciser votre rôle - le rôle fonctionnel que vous exercez au sein de l'organisation ou votre relation avec celle-ci.
  • Nom de l'entreprise - le nom de l'entité juridique propriétaire des applications qui utiliseront les fonctionnalités du réseau Vonage.
  • Pays d'immatriculation de l'entreprise - le pays où l'organisation est enregistrée.
  • Numéro d'enregistrement de l'entreprise - Si votre organisation dispose d'un enregistrement supplémentaire, vous pouvez l'inclure ici pour simplifier le processus de validation.
  • Type d'organisation - sélectionner le type le plus approprié dans la liste déroulante.
  • Nom commercial - S'il s'agit d'un nom différent, indiquez le nom sous lequel l'organisation exerce ses activités.
  • Numéro de taxe professionnelle - la référence fiscale de l'organisation dans le pays enregistré sera utilisée par Vonage et les opérateurs pour valider l'organisation.
  • Autorité de délivrance - Le cas échéant, sélectionnez dans la liste ou indiquez l'autorité qui a délivré votre numéro d'enregistrement d'entreprise.

Détails sur la confidentialité :

  • La loi vous oblige-t-elle à désigner un délégué à la protection des données ? - Sélectionner Yes/No si votre organisation est tenue par la loi d'avoir ou non un délégué à la protection des données.
  • Votre organisation est-elle certifiée ISO 27001 ? - Sélectionner Yes/No si votre organisation est certifiée ou non. Si ce n'est pas le cas, mais que vous détenez un certificat équivalent, un Indiquez la certification équivalente si vous en avez une apparaît. Saisissez le nom du certificat ou laissez-le vide.
  • URL de la politique de confidentialité - Vonage et ses partenaires opérateurs exigent que toute personne utilisant les fonctions du réseau dispose d'une politique de confidentialité, accessible au public sur Internet - fournir l'adresse de la politique de l'organisation.
  • Adresse électronique du responsable de la protection de la vie privée - inclure une adresse électronique qui peut être utilisée pour toute question relative à la politique de protection de la vie privée.
  • Adresse électronique du délégué à la protection des données - si la loi impose l'existence d'un DPD, indiquer un contact électronique si celui-ci diffère de celui du responsable de la politique de protection de la vie privée.

Emplacement de l'entreprise

Dans la section suivante, vous devez indiquer l'adresse du siège social de l'organisation.

Une fois l'inscription soumise, vous verrez un résumé de votre profil d'entreprise, grâce auquel vous pourrez voir et suivre l'état de votre inscription. Vous pouvez recevoir des notifications par courrier électronique lorsque l'état de votre inscription change ; les paramètres de notification peuvent être modifiés ici.

Prestataire de services en aval

Cette section est requise si vous avez l'intention de revendre les fonctions du réseau Vonage à d'autres entreprises. Si ce n'est pas le cas, vous pouvez sélectionner "Non" pour confirmer que tout accès fourni ne peut être utilisé pour la revente des fonctions du réseau Vonage.

Si vous sélectionnez "Oui", vous devrez fournir des informations sur la manière dont vous traiterez les données des utilisateurs, ainsi que des détails sur les sous-traitants tiers qui vous aident à traiter les données associées à l'utilisation des fonctionnalités du réseau.

Créer un profil d'application réseau

Un profil d'entreprise peut avoir un nombre quelconque de profils d'application, qui sont utilisés pour faire correspondre les Applications du réseau à votre cas d'utilisation et suivre l'approbation de l'opérateur.

À partir du profil commercial du propriétaire de l'application, cliquez sur le bouton "Ajouter un profil d'application".

Pour remplir cette section, vous aurez besoin des informations suivantes :

  • Nom du profil - donner un nom à l'application pour l'identifier facilement.
  • Catégorie - sélectionnez une catégorie d'application dans la liste déroulante.
  • Emplacement des infrastructures - sélectionner tous les pays dans lesquels vous pouvez traiter des données à caractère personnel liées à l'utilisation des fonctionnalités du réseau demandées.
  • Sélectionner les caractéristiques du réseau - sélectionner une ou plusieurs fonctionnalités réseau que vous pourriez vouloir utiliser.
  • Description du cas d'utilisation - Décrivez votre application du point de vue du consommateur. Expliquez comment les Applications réseau sélectionnées aideront l'application à atteindre l'objectif choisi.
  • Objectif - pour chaque fonctionnalité réseau sélectionnée, confirmer l'objectif dans la liste déroulante, par exemple "Prévention et détection de la fraude".
  • Objectif Raison - expliquer comment les caractéristiques du réseau sélectionnées aideront votre application à atteindre l'objectif choisi.
  • URL de la politique de confidentialité - fournir l'adresse de la politique de l'organisation.
  • Conditions générales URL - fournir l'URL des conditions générales en ligne pour votre application.

Une fois la demande soumise, vous verrez un résumé mis à jour, y compris les profils de la demande de réseau. Vous pouvez recevoir des notifications par courrier électronique lorsque l'état de votre candidature change ; les paramètres de notification peuvent être modifiés ici.

Veuillez noter que votre profil de candidature ne peut pas être modifié une fois qu'il a été créé. Si vous devez modifier l'une des informations fournies, veuillez renvoyer le formulaire pour créer un nouveau profil de candidature. Une fois que celui-ci aura été approuvé et que le trafic aura été transféré vers le nouveau profil, vous pourrez supprimer en toute sécurité le profil de candidature original.

Connectez votre application Vonage

Une fois que votre enregistrement est approuvé par au moins un opérateur, vous pouvez le lier à une ou plusieurs Applications Vonage pour commencer à utiliser les fonctionnalités du réseau. L'application Vonage contient les informations d'identification nécessaires pour effectuer des appels API.

Note : Vous pouvez utiliser la fonction Terrain de jeux d'accéder aux fonctionnalités du réseau à des fins de test, dans l'attente d'une approbation.

Naviguez jusqu'à la page Page Applications sur le tableau de bord et cliquez sur "Créer une nouvelle application", puis suivez les étapes suivantes :

  • Nom - Donnez un nom à votre application.
  • Authentification - Vous pouvez soit fournir vos propres clés, soit cliquer sur "Générer les clés publiques et privées" pour générer les clés nécessaires au processus d'authentification ; une nouvelle clé publique apparaîtra dans la zone de texte, tandis que votre navigateur téléchargera automatiquement la clé privée.
  • Clé API - est connectée à la clé API de votre Account.
  • Dans la section relative à la protection de la vie privée, activez l'option "Intelligence artificielle" pour autoriser l'utilisation des données à des fins d'entraînement à l'IA.
  • Dans la section "Capacités", activez "Registre du réseau" et sélectionnez le type d'accès requis : Terrain de jeu ou Production.
    • Pour plus d'informations sur les tests effectués à partir de l'aire de jeu du registre du réseau Vonage, voir ici.
    • Pour l'accès Production, sélectionnez le profil d'entreprise et le profil d'application que vous avez créés dans les étapes précédentes.
Enable Network Features capability in the Vonage application

Il se peut que vous soyez invité à configurer des options en fonction des fonctionnalités réseau incluses dans votre enregistrement.

Gestion des inscriptions

Statut d'enregistrement

Pour voir l'état de l'enregistrement de votre fonctionnalité réseau, naviguez vers Vonage API Dashboard→Network Registry.

Sélectionnez un profil commercial et développez le profil Applications pour afficher l'état de chacun des opérateurs partenaires de Vonage dans les pays que vous avez sélectionnés.

The Network Registry status page

Les composants d'enregistrement peuvent se trouver dans un certain nombre d'états, qui peuvent varier d'un composant à l'autre et d'un opérateur partenaire de Vonage à l'autre à un moment donné. Les vues élargies comprennent une description sommaire de chaque état :

  • TRANSFORMATION: Vonage travaille avec le(s) opérateur(s) pour permettre votre demande d'accès.
  • ACCEPTÉ: accepté par le(s) opérateur(s)
  • PARTIELLEMENT ACCEPTÉLa Commission européenne a adopté un projet de loi sur l'accès à l'information : accepté par certains opérateurs, rejeté par d'autres.
  • REJETÉ: rejetée par le(s) opérateur(s)

En mode production, les demandes de fonctionnalités réseau ne seront transmises à un opérateur que si elles sont envoyées à partir d'une Applications liée à un profil qui a été accepté par cet opérateur.

Utilisation de plusieurs clés API

Lorsqu'un profil d'application est créé, il appartient à la clé active que vous utilisiez dans le tableau de bord. Bien que cette clé ne puisse pas être modifiée, vous pouvez attribuer d'autres clés API à votre profil d'application pour activer les Applications réseau approuvées sur l'ensemble de votre Account.

Pour ce faire, naviguez jusqu'au profil d'application auquel vous souhaitez attribuer des clés et sélectionnez le bouton Attribuer des clés API. Une fois cliqué, vous verrez apparaître une liste de clés API provenant de votre Account :

The Assign API Keys drop down in the Vonage dashboard

La première clé de la liste déroulante est la clé propriétaire du profil d'application - elle ne peut pas être modifiée. Les autres clés de la liste sont toutes les autres clés API du même Account que la clé propriétaire. Pour attribuer ou désattribuer une autre clé API, sélectionnez-la dans la liste déroulante. Lors de la création d'une application utilisant les fonctionnalités réseau approuvées dans votre profil d'application, vous pourrez utiliser n'importe laquelle des clés API sélectionnées dans la liste.

Veuillez noter que vous ne pourrez pas désélectionner une clé API dans la liste si elle est associée à des applications dotées de fonctionnalités réseau. Si vous tentez de désélectionner la clé, un message d'erreur s'affichera, vous demandant de reconfigurer les applications associées avant de réessayer.

Vetting

Certains opérateurs exigent des vérifications supplémentaires des antécédents, effectuées par un agent indépendant, pour les organisations qui demandent l'accès à leurs fonctions de réseau. Si ces vérifications sont exigées par un ou plusieurs opérateurs dans les pays que vous avez sélectionnés dans votre profil d'entreprise, vous serez invité à consentir à cette vérification avant que votre demande puisse leur être soumise.

Outre les informations décrites ci-dessus, vous devrez indiquer un point de contact au cas où l'agent de contrôle aurait besoin de contacter votre organisation au sujet des informations fournies.

  • Nom: La personne qui doit être contactée par l'agent de contrôle, le cas échéant.
  • Numéro de téléphone: Le numéro de contact de la personne nommée
  • Adresse électronique: L'adresse électronique de la personne nommée

Si vous ne consentez pas à cette vérification, les opérateurs qui l'exigent seront exclus de votre enregistrement et vous n'aurez pas accès à leur réseau. Si vous changez d'avis, vous pouvez à tout moment demander une modification de votre profil commercial et ajouter votre consentement, ce qui déclenchera les processus de provisionnement et d'approbation avec ces opérateurs.

Notifications

Lorsqu'un enregistrement de fonctionnalité réseau est soumis, vous serez invité à vous abonner aux notifications, si ce n'est pas déjà fait. Vous pouvez à tout moment vous désabonner ou modifier les paramètres de notification en accédant à Tableau de bord API de Vonage→Paramètres API→Notifications.

Les notifications, ainsi que tout changement d'état connexe, sont également visibles dans votre tableau de bord Network Registry, où vous pouvez être invité à prendre d'autres mesures.

Network Registry notifications

Soutien

Pour obtenir de l'aide sur les fonctionnalités du réseau, y compris sur la procédure d'enregistrement, consultez le site Web de la Commission européenne. Support API Centre d'aide.

Prochaines étapes

Une fois que vous vous êtes inscrit et que vous avez été approuvé, vous êtes prêt à utiliser les API !