Registre du réseau

Pour utiliser le Caractéristiques du réseau 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, l'enregistrement est géré en coulisses par de nombreux opérateurs partenaires pour toutes les fonctionnalités du réseau prises en charge, dans tous les domaines suivants pays mis à disposition. Ce processus dépend de l'approbation de chaque opérateur, qui peut être transmise au registre du réseau à des moments différents.

Le processus

Pour lancer le processus du Registre du réseau, vous devez disposer d'un Account client; si vous n'en avez pas encore, vous pouvez faire part de votre intérêt ici.

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

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: Lier votre profil à une Application 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.

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 :

Informations commerciales:

• 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.

Informations sur la protection de la vie privée:

• 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.

Entreprise Adresse du siège social:

Saisissez 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.

Créer un profil d'application réseau

Les profils d'application sont utilisés pour activer une ou plusieurs fonctionnalités du réseau, décrire un cas d'utilisation et les soumettre aux opérateurs pour approbation. À 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.

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.

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.

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 connaître l'état de l'enregistrement de votre fonctionnalité réseau, accédez à 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.

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 :

• EN ATTENTE: reçu, en attente d'approbation
• NON SOUMIS: pas encore soumis à l'Opérateur
• PROVISIONNEMENT: soumis à l'Opérateur
• ACCEPTÉ: acceptée par l'opérateur
• 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 l'opérateur
• ÉCHEC*: la soumission à l'opérateur n'a pas abouti

* Les soumissions qui échouent seront réessayées par Vonage. Il n'est pas nécessaire de nous en informer, sauf si le problème persiste.

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 :

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.

Notifications

Lorsqu'un enregistrement de fonctionnalité réseau est soumis pour la première fois, vous serez abonné aux notifications de changement d'état. 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.

Prochaines étapes

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