Proxy IP

Con la función de proxy IP, los clientes dirigen todo el tráfico de Internet (excepto los flujos multimedia) a través de su 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 que le permite enrutar flujos multimedia a través de sus propios servidores TURN personalizados.

Configuración del servidor proxy IP

Usted establece la URL o su servidor proxy cuando inicia una sesión en los SDK 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 ejemplo de código 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 2.17.4. En versiones anteriores, se establecía la URL del servidor proxy mediante una opción no documentada al llamar al método OT.initSession() . Sin embargo, esta opción ha quedado obsoleta y se ha sustituido por el método OT.setProxyUrl() método.

En el SDK de Android

Establezca la URL del servidor proxy llamando a la función setProxyUrl() método del Session.Builder 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

Establezca 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 Instanciación de una instancia otc_session y callbacks relacionados con la sesión.

En el SDK de macOS

Establezca 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 otc_session_settings struct, el otc_session_new_with_settings() y conectarse a la sesión, véase Instanciación de una instancia otc_session y callbacks relacionados con la sesión.

En la API React Native SDK

Fije el proxyUrl propiedad del options prop que pasa 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>