Proxy IP

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

El tráfico no relacionado con los medios incluye las comunicaciones 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 redirigir flujos multimedia a través de tus propios servidores TURN personalizados.

Configuración del servidor proxy IP

Debes configurar la URL o tu servidor proxy al iniciar una sesión de OpenTok en los SDK de cliente de OpenTok.

OpenTok concatena la URL de destino de todo el tráfico de Internet (excepto las transmisiones multimedia) con la URL del proxy que facilites. Este tráfico incluye llamadas a la Video API, conexiones WebSocket y el tráfico de registro generado por OpenTok.js.

Por ejemplo, el Client SDK de OpenTok registra datos periódicamente en https://video-log-host.example.com/prod/logging/ClientEvent. Si configuras la URL del proxy como "https://123.123.123.123:8080", el cliente enviará estos datos a https://123.123.123.123:8080/video-log-host.example.com/prod/logging/ClientEvent.

Debes proteger el servidor proxy para que solo lo utilicen los clientes de OpenTok y no clientes no autorizados. Por ejemplo, puedes situar el servidor proxy dentro de un cortafuegos o autenticar las solicitudes de alguna otra forma.

A continuación se muestra un código de ejemplo que configura un servidor proxy básico para esta función: proxy_inverso_simple.

Nota: Si los clientes se van a conectar a sesiones de OpenTok en una región geográfica distinta de la de tu servidor proxy y no estás utilizando el Función configurable del servidor TURN, asegúrate de configurar la sugerencia de ubicación cuando crear sesiones de OpenTok.

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 OpenTok. Esto garantiza que se utilice el servidor proxy para el tráfico de OpenTok.

Nota: Este método se añadió como método no documentado en OpenTok 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 está obsoleta y ha sido sustituida por el OT.setProxyUrl() método.

En el SDK de OpenTok para 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 OpenTok para 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 OpenTok para 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 OpenTok para 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 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 el SDK de OpenTok para 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 el SDK de React Native de la API de OpenTok

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>