Proxy IP

Avec la fonction proxy IP, les clients acheminent tout le trafic internet (à l'exception des flux multimédias) via votre serveur proxy.

Le trafic non multimédia comprend les communications avec les serveurs Video API et l'infrastructure de journalisation.

La fonction de proxy IP est disponible en tant que une fonction supplémentaire.

Il existe également un serveur TURN configurable qui vous permet d'acheminer des flux de médias via vos propres serveurs TURN personnalisés.

Configuration du serveur proxy IP

Vous définissez l'URL de votre serveur proxy lorsque vous lancez une session dans les SDK clients.

Vonage concatène l'URL de destination de tout le trafic Internet (à l'exception des flux multimédias) à l'URL du proxy que vous fournissez. Ce trafic comprend les appels Video API, les connexions WebSocket et le trafic de journal effectué par OpenTok.js.

Par exemple, le Client SDK enregistre périodiquement des données vers https://hlg.tokbox.com/prod/logging/ClientEvent. Si vous définissez l'URL du proxy sur "https://123.123.123.123:8080"le client enverra ces données à https://123.123.123.123:8080/hlg.tokbox.com/prod/logging/ClientEvent.

Vous devez sécuriser le serveur proxy afin qu'il ne soit utilisé que par les clients de Vonage et non par des clients non autorisés. Par exemple, vous pouvez placer le serveur proxy dans un pare-feu ou authentifier les demandes d'une autre manière.

Voici un exemple de code qui met en place un serveur proxy de base pour cette fonctionnalité : https://github.com/robjperez/simple_reverse_proxy.

Remarque : Si les clients se connectent à des sessions Vonage dans une région géographique autre que celle de votre serveur proxy et que vous n'utilisez pas la [fonction de serveur TURN configurable]/video/guides/configurable-turn-servers/), assurez-vous de définir l'indice d'emplacement lorsque vous utilisez la [fonction de serveur TURN configurable]/video/guides/configurable-turn-servers/). créer des sessions Vonage.

Dans OpenTok.js

Appeler le OT.setProxyUrl() pour définir l'URL du serveur proxy :

Vous devez appeler cette méthode avant d'appeler toute autre méthode Vonage. Cela garantit que le serveur proxy est utilisé pour le trafic Vonage.

Remarque : Cette méthode a été ajoutée en tant que méthode non documentée dans la version 2.17.4. Dans les versions précédentes, vous définissiez l'URL du serveur proxy à l'aide d'une option non documentée lors de l'appel de la méthode OT.initSession() . Cependant, cette option est désormais obsolète et remplacée par la méthode OT.setProxyUrl() méthode.

Dans le SDK Android

Définir l'URL du serveur proxy en appelant la fonction setProxyUrl() de la méthode Session.Builder que vous utilisez pour instancier un objet Session :

mSession = new Session.Builder(context, API_KEY, SESSION_ID)
  .setProxyUrl("https://123.123.123.123:8080")
  .build();

Dans le SDK iOS

Définissez l'URL du serveur proxy en définissant le paramètre proxyURL de la propriété OTSessionSettings que vous passez dans l'objet [OTSession initWithApiKey:sessionId:delegate:settings:] méthode :

Dans le SDK Windows

Définissez l'URL du serveur proxy en définissant le paramètre proxyUrl du paramètre Session() constructeur :

Dans le SDK Linux

Définir l'URL du serveur proxy en appelant la fonction otc_session_settings_set_proxy_url() fonction :

otc_session_settings_set_proxy_url(session_settings, "https://123.123.123.123:8080");
otc_session *session = otc_session_new_with_settings(API_KEY,
                                                     SESSION_ID,
                                                     &session_callbacks,
                                                     session_settings);

Le premier paramètre est le otc_session_settings que vous passerez dans l'instance otc_session_new_with_settings() pour initialiser un otc_session instance. Le deuxième paramètre est l'URL du serveur proxy. Pour plus d'informations sur l'URL du otc_session_settings struct le otc_session\_new\_with\_settings()\ et la connexion à la session, voir Instanciation d'une instance otc_session et rappels liés à la session.

Dans le SDK macOS

Définir l'URL du serveur proxy en appelant la fonction otc_session_settings_set_proxy_url() fonction :

Le premier paramètre est le otc_session_settings que vous passerez dans l'instance l'instance otc_session_new_with_settings() pour initialiser un otc_session instance. Le deuxième paramètre est l'URL du serveur proxy. Pour plus d'informations sur l'URL du otc_session_settings la structure otc_session_new_with_settings() et la connexion à la session, voir Instanciation d'une instance otc_session et rappels liés à la session.

Dans l'API React Native SDK

Régler le proxyUrl de la propriété options vous passez dans le OTSession de la composante :