Proxy de l'UE

Avec la fonction proxy UE, les clients Video API de Vonage acheminent tout le trafic internet (à l'exception des flux média) via des serveurs proxy hébergés au sein de l'UE.

Le trafic non multimédia comprend les appels à l'API Video, les connexions WebSocket, et le trafic des journaux.

La fonctionnalité de proxy de l'UE est disponible lorsque vous achetez un Zone médiatique régionale européenne, ce qui vous permet de limiter l'ensemble du trafic de flux multimédia au sein de l'UE. Combinées, ces fonctionnalités vous permettent de limiter l'ensemble du trafic de la Video API (multimédia et non multimédia) au sein de l'UE.

Vonage vous fournit une URL pour le serveur proxy de l'UE, qui prend en charge le protocole TLS 1.3 et utilise des clés cryptographiques robustes d'au moins 3 072 bits (ou d'une force équivalente), que vous devrez configurer dans les applications clientes utilisant la Video API. Cette URL est susceptible de changer. Contactez votre représentant commercial Vonage pour obtenir l'URL du serveur proxy de l'UE.

Mise en place d'un service web pour fournir l'URL du serveur proxy de l'UE

Si vous comptez utiliser la fonctionnalité de proxy UE dans des applications qui exploitent les SDK clients de la Video API pour Android, iOS, Windows ou Linux, vous devrez créer un service web que l'application cliente pourra appeler pour obtenir l'URL du proxy UE. Vonage pouvant modifier cette URL, vous ne devez pas l'intégrer de manière fixe dans une application cliente compilée.

Configuration du serveur proxy de l'UE dans les applications clientes

Vous configurez l'URL du serveur proxy de l'UE lorsque vous lancez une session OpenTok dans les SDK clients de la Video API Vonage.

OpenTok.js

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

const euProxyUrl = ''; // Set this to the EU proxy URL provided by Vonage
OT.setProxyUrl(euProxyUrl);

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

SDK Android de l'API Video de Vonage

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 :

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

mSession = new Session.Builder(context, API_KEY, SESSION_ID)
  .setProxyUrl(mEuProxyUrl)
  .build();

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.

SDK iOS Video API de Vonage

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 :

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

OTSessionSettings *settings = [[OTSessionSettings alloc] init];
settings.proxyURL = euProxyUrl;

session = [[OTSession alloc] initWithApiKey:kApiKey
                                  sessionId:kSessionId
                                  delegate:self
                                  settings:settings];

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.

SDK Windows de l'API Video de Vonage

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

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

Session = new Session.Builder(Context.Instance, API_KEY, SESSION_ID)
{
  ProxyUrl = EU_PROXY_URL
}.Build();

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.

SDK Linux de l'API Video de Vonage

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

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

otc_session_settings_set_proxy_url(session_settings, euProxyUrl);
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 l'instance otc_session_new_with_settings() pour initialiser un otc_session par exemple. Le deuxième paramètre correspond à l'URL du serveur proxy de l'UE.

Pour plus d'informations sur le otc_session_settings la structure otc_session_new_with_settings() et la connexion à la session, voir Instanciation d'une instance otc_session et des rappels liés à la session liés à la session.

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.

SDK macOS de l'API Video de Vonage

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

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

otc_session_settings_set_proxy_url(session_settings, euProxyUrl);
otc_session *session = otc_session_new_with_settings(API_KEY,
                                                     SESSION_ID,
                                                     &session_callbacks,
                                                     session_settings);

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.

SDK React Native de l'API Video de Vonage

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

// Before executing this code, call a function that obtains
// the EU proxy server URL from the web service you set up.

<OTSession
  apiKey="your-api-key"
  sessionId="your-session-id"
  token="your-session-token"
  options={{
    proxyUrl: euProxyUrl,
    // ... other options
  }}
>
  <OTPublisher/>
  <OTSubscriber/>
</OTSession>

Voir Mise en place d'un service web pour fournir le serveur proxy de l'UE URL.