Proxy IP

Con la función de proxy IP, los clientes desvían todo el tráfico de Internet (excepto las transmisiones multimedia) a través de tu servidor proxy.

El tráfico no multimedia incluye la comunicación con los servidores de la Video API y la infraestructura de registro.

La función de proxy IP está disponible como una función adicional.

También hay un servidor TURN configurable una función adicional que te permite enrutar flujos multimedia a través de tus propios servidores TURN personalizados.

Configuración del servidor proxy IP

La URL o el servidor proxy se configuran al iniciar una sesión en los SDK de cliente.

Vonage concatena la URL de destino de todo el tráfico de Internet (excepto los flujos de medios) con la URL del proxy que proporciones. Este tráfico incluye llamadas a Video API, conexiones WebSocket y tráfico de registro realizado por OpenTok.js.

Por ejemplo, el Client SDK registra datos periódicamente en https://hlg.tokbox.com/prod/logging/ClientEvent. Si establece la URL del proxy en "https://123.123.123.123:8080"el cliente enviará estos datos a https://123.123.123.123:8080/hlg.tokbox.com/prod/logging/ClientEvent.

Debes proteger el servidor proxy para que sólo lo utilicen los clientes de Vonage y no clientes no autorizados. Por ejemplo, puedes colocar el servidor proxy dentro de un firewall o autenticar las solicitudes de alguna otra manera.

A continuación se muestra un código de ejemplo que configura un servidor proxy básico para esta función: https://github.com/robjperez/simple_reverse_proxy.

Nota: Si los clientes se conectarán a las sesiones de Vonage en una región geográfica diferente a la de tu servidor proxy y no estás utilizando la función [configurable TURN server feature]/video/guides/configurable-turn-servers/), asegúrate de configurar la pista de ubicación cuando crear sesiones de Vonage.

En OpenTok.js

Llame al OT.setProxyUrl() para establecer la URL del servidor proxy:

OT.setProxyUrl('https://123.123.123.123:8080');

Debes llamar a este método antes de llamar a cualquier otro método de Vonage. Esto garantiza que se utilice el servidor proxy para el tráfico de Vonage.

Nota: Este método se añadió como método no documentado en la versión 2.17.4. En versiones anteriores, la URL del servidor proxy se configuraba mediante una opción no documentada al llamar a la función OT.initSession() método. Sin embargo, esta opción ya no se utiliza y ha sido sustituida por el OT.setProxyUrl() método.

En el SDK de Android

Configura la URL del servidor proxy llamando a la función setProxyUrl() método del Session.Builder objeto que se utiliza para instanciar un objeto Session:

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

En el SDK de iOS

Establezca la URL del servidor proxy mediante el parámetro proxyURL propiedad del OTSessionSettings que se pasa al objeto [OTSession initWithApiKey:sessionId:delegate:settings:] método:

OTSessionSettings *settings = [[OTSessionSettings alloc] init];
settings.proxyURL = @"https://123.123.123.123:8080";

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

En el SDK de Windows

Establezca la URL del servidor proxy mediante el parámetro proxyUrl del Session() constructor:

Session = new Session.Builder(Context.Instance, API_KEY, SESSION_ID)
{
  ProxyUrl = "https://123.123.123.123:8080"
}.Build();

En el SDK de Linux

Configura la URL del servidor proxy llamando a la función otc_session_settings_set_proxy_url() función:

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);

El primer parámetro es el otc_session_settings que pasará a la instancia otc_session_new_with_settings() para inicializar un otc_session instancia. El segundo parámetro es la URL del servidor proxy. Para obtener más información sobre otc_session_settings estructura la otc_session\_new\_with\_settings()\ y conectarse a la sesión, véase Creación de una instancia de `otc_session` y funciones de devolución de llamada relacionadas con la sesión.

En el SDK de macOS

Configura la URL del servidor proxy llamando a la función otc_session_settings_set_proxy_url() función:

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);

El primer parámetro es el otc_session_settings que pasará a la página otc_session_new_with_settings() para inicializar un otc_session instancia. El segundo parámetro es la URL del servidor proxy. Para obtener más información sobre el otc_session_settings struct, el otc_session_new_with_settings() y conectarse a la sesión, véase Creación de una instancia de `otc_session` y funciones de devolución de llamada relacionadas con la sesión.

En la API React Native SDK

Fije el proxyUrl propiedad del options el parámetro que pasas al OTSession componente:

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