IP-Proxy

Mit der IP-Proxy-Funktion leiten die Clients den gesamten Internetverkehr (mit Ausnahme von Medienstreams) über Ihren Proxy-Server.

Der nicht-mediale Verkehr umfasst die Kommunikation mit den Video API-Servern und der Protokollierungsinfrastruktur.

Die IP-Proxy-Funktion ist verfügbar als ein zusätzliches Merkmal.

Außerdem gibt es eine konfigurierbarer TURN-Server Add-on-Funktion, mit der Sie Medienströme über Ihre eigenen benutzerdefinierten TURN-Server leiten können.

Konfigurieren des IP-Proxy-Servers

Sie legen die URL oder Ihren Proxy-Server fest, wenn Sie eine Sitzung in den Client-SDKs initiieren.

Vonage verkettet die Ziel-URL für den gesamten Internetverkehr (außer Medienstreams) mit der von Ihnen angegebenen Proxy-URL. Dieser Datenverkehr umfasst Video API-Aufrufe, WebSocket-Verbindungen und von OpenTok.js erzeugten Protokollverkehr.

Zum Beispiel protokolliert das Client SDK regelmäßig Daten an https://hlg.tokbox.com/prod/logging/ClientEvent. Wenn Sie die Proxy-URL auf "https://123.123.123.123:8080"sendet der Client diese Daten an https://123.123.123.123:8080/hlg.tokbox.com/prod/logging/ClientEvent.

Sie sollten den Proxy-Server so absichern, dass er nur von Vonage-Clients und nicht von unbefugten Clients verwendet werden kann. Sie können den Proxyserver zum Beispiel in eine Firewall einbinden oder Anfragen auf andere Weise authentifizieren.

Hier ist ein Beispielcode, der einen einfachen Proxyserver für diese Funktion einrichtet: https://github.com/robjperez/simple_reverse_proxy.

Anmerkung: Wenn sich Clients mit Vonage-Sitzungen in einer anderen geografischen Region als der Ihres Proxy-Servers verbinden und Sie nicht die Funktion [konfigurierbarer TURN-Server]/video/guides/configurable-turn-servers/) verwenden, stellen Sie sicher, dass Sie den Standort-Hinweis setzen, wenn Sie Vonage-Sitzungen erstellen.

In OpenTok.js

Rufen Sie die OT.setProxyUrl() Methode, um die URL des Proxy-Servers festzulegen:

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

Sie müssen diese Methode vor allen anderen Vonage-Methoden aufrufen. Dadurch wird sichergestellt, dass der Proxy-Server für den Vonage-Verkehr verwendet wird.

Anmerkung: Diese Methode wurde in Version 2.17.4 als undokumentierte Methode hinzugefügt. In früheren Versionen wurde die URL des Proxy-Servers mit einer undokumentierten Option beim Aufruf der Methode OT.initSession() Methode. Diese Option ist jedoch inzwischen veraltet und wurde durch die Methode OT.setProxyUrl() Methode.

Im Android SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion setProxyUrl() Methode der Session.Builder Objekt, das Sie zur Instanziierung eines Session-Objekts verwenden:

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

Im iOS SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Option proxyURL Eigenschaft der OTSessionSettings Objekt, das Sie an die [OTSession initWithApiKey:sessionId:delegate:settings:] Methode:

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

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

Im Windows-SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Option proxyUrl Parameter des Session() Konstrukteur:

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

Im Linux-SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion otc_session_settings_set_proxy_url() Funktion:

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

Der erste Parameter ist die otc_session_settings Instanz, die Sie an die otc_session_new_with_settings() Funktion zur Initialisierung einer otc_session Instanz. Der zweite Parameter ist die URL des Proxyservers. Für weitere Informationen über die otc_session_settings Struktur der otc_session\_new\_with\_settings()\ und die Verbindung zur Sitzung, siehe Instanziierung einer otc_session-Instanz und sitzungsbezogene Rückrufe.

Im macOS SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion otc_session_settings_set_proxy_url() Funktion:

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

Der erste Parameter ist die otc_session_settings Instanz, die Sie in die otc_session_new_with_settings() Funktion zur Initialisierung einer otc_session Instanz. Der zweite Parameter ist die URL des Proxyservers. Für weitere Informationen über die otc_session_settings Struktur, die otc_session_new_with_settings() und die Verbindung zur Sitzung, siehe Instanziierung einer otc_session-Instanz und sitzungsbezogene Rückrufe.

In der API React Native SDK

Setzen Sie die proxyUrl Eigenschaft der options Stütze, die Sie in die OTSession Komponente:

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