StreamHTTPSParms-Schnittstelle

Stellt die HTTPS-Datenstromparameter dar, die festlegen, wie unter Verwendung sicherer HTTPS-Verbindungen mit einem MobiLink-Server kommuniziert werden soll.

Syntax

public interface StreamHTTPSParms

Mitglieder

Alle Mitglieder der StreamHTTPSParms-Schnittstelle, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
addCustomHTTPHeader-Methode [BlackBerry]	Fügt einen Nachrichtenheader in jede HTTP-Anforderung ein.
getCertificateCompany-Methode	Gibt den Namen der Zertifizierungsgesellschaft für die Verifizierung von sicheren Verbindungen zurück.
getCertificateName-Methode	Gibt den Zertifikatsnamen für die Verifizierung von sicheren Verbindungen zurück.
getCertificateUnit-Methode	Gibt den Namen der Zertifizierungseinheit für die Verifizierung von sicheren Verbindungen zurück.
getCustomHTTPHeaders-Methode [BlackBerry]	Gibt ein Hash-Tabellenobjekt zurück, das die HTTP-Header enthält, die mit der addCustomHTTPHeader-Methode angegeben wurden.
getE2eePublicKey-Methode [Blackberry]	Gibt den Namen der Datei zurück, die den öffentlichen Schlüssel für die Ende-zu-Ende-Verschlüsselung enthält.
getE2eeType-Methode [BlackBerry]	Gibt die Ende-zu-Ende-Verschlüsselung zurück, die gerade benutzt wird.
getExtraParameters-Methode [Android]	Ruft die zusätzlichen Netzwerkprotokolloptionen für den MobiLink-Client ab.
getHost-Methode	Gibt den Hostnamen des MobiLink-Servers zurück.
getHTTPPassword-Methode [BlackBerry]	Gibt das HTTP-Kennwort zurück.
getHTTPUserId-Methode [BlackBerry]	Gibt die HTTP Benutzer-ID zurück.
getOutputBufferSize-Methode	Gibt die Größe (in Byte) des Ausgabepuffers zurück, in dem Daten gespeichert werden, bevor sie an den MobiLink-Server gesendet werden.
getPort-Methode	Gibt die Portnummer zurück, die zum Verbinden mit dem MobiLink-Server verwendet wird.
getTrustedCertificates-Methode	Gibt den Namen der Datei zurück, die eine Liste von vertrauenswürdigen Stammzertifikaten enthält, die bei der sicheren Synchronisation verwendet werden.
getURLSuffix-Methode	Gibt das URL-Suffix des MobiLink-Servers zurück.
isRestartable-Methode	Ermittelt, ob die neu startbare HTTP-Verbindung verwendet wird.
setCertificateCompany-Methode	Setzt den Namen der Zertifizierungsgesellschaft für die Verifizierung von sicheren Verbindungen.
setCertificateName-Methode	Setzt den Zertifikatsnamen für die Verifizierung von sicheren Verbindungen.
setCertificateUnit-Methode	Setzt den Namen der Zertifizierungseinheit für die Verifizierung von sicheren Verbindungen.
setE2eePublicKey-Methode [Android]	Legt den Namen der Datei fest, die den öffentlichen Schlüssel für die Ende-zu-Ende-Verschlüsselung enthält.
setE2eeType-Methode [BlackBerry]	Legt den Typ der Ende-zu-Ende-Verschlüsselung fest, die verwendet werden soll.
setExtraParameters-Methode [Android]	Legt zusätzliche Netzwerkprotokolloptionen für den MobiLink-Client fest.
setHost-Methode	Setzt den Hostnamen des MobiLink-Servers.
setHTTPUserIdAndPassword-Methode [BlackBerry]	Legt die Benutzer-ID und das Kennwort fest, die für Basic HTTP-Authentifizierung verwendet werden sollen, wie in RFC 2617 beschrieben.
setOutputBufferSize-Methode	Setzt die Größe (in Byte) des Ausgabepuffers, in dem Daten gespeichert werden, bevor sie an den MobiLink-Server gesendet werden.
setPort-Methode	Setzt die Portnummer, die zum Verbinden mit dem MobiLink-Server verwendet wird.
setRestartable-Methode	Aktiviert bzw. deaktiviert die neu startbare HTTP-Verbindung.
setTrustedCertificates-Methode	Setzt eine Datei, die eine Liste von vertrauenswürdigen Stammzertifikaten für die sichere Synchronisation enthält.
setURLSuffix-Methode	Legt das URL-Suffix zum Verbinden mit dem MobiLink-Server fest.
setZlibCompression-Methode	Aktiviert bzw. deaktiviert die ZLIB-Komprimierung.
setZlibDownloadWindowSize-Methode	Legt die Größe des Download-Fensters für die ZLIB-Komprimierung fest.
setZlibUploadWindowSize-Methode	Legt die Größe des Upload-Fensters für die ZLIB-Komprimierung fest.
zlibCompressionEnabled-Methode	Ermittelt, ob die ZLIB-Komprimierung aktiviert ist.
E2EE_RSA-Variable [BlackBerry]	Legt die Ende-zu-Ende-Verschlüsselung auf RSA-Basis bei der Übergabe an die setE2eeType-Methode fest.

Das folgende Beispiel setzt die Datenstromparameter zur Kommunikation mit einem MobiLink -Server auf einem Host namens "MyMLHost". Der Server wurde mit den folgenden Parametern gestartet: "-x https(port=1234;certificate=RSAServer.crt;certificate_password=x)"

SyncParms syncParms = myConnection.createSyncParms(
        SyncParms.HTTPS_STREAM,
        "MyUniqueMLUserID",
        "MyMLScriptVersion"
    );
StreamHTTPSParms httpsParms =
    (StreamHTTPSParms) syncParms.getStreamParms();
httpsParms.setHost("MyMLHost");
httpsParms.setPort(1234);

Das obenstehende Beispiel nimmt an, dass das Zertifikat in RSAServer.crt mit einem vertrauenswürdigen Stammzertifikat verkettet ist, das bereits auf dem Client-Host oder Gerät installiert ist.

Für J2SE können Sie das erforderliche vertrauenswürdige Stammzertifikat bereitstellen, indem Sie eine der folgenden Methoden verwenden:

Installieren Sie das vertrauenswürdige Stammzertifikat im lib/security/cacerts-Schlüsselspeicher des JRE.
Erstellen Sie einen eigenen Schlüsselspeicher, indem Sie das Java-Dienstprogramm keytool verwenden und die Java-Systemeigenschaft javax.net.ssl.trustStore auf den gewünschten Speicherort einstellen. (Setzen Sie die javax.net.ssl.trustStorePassword-Methode auf einen entsprechenden Wert.)
Verwenden Sie den setTrustedCertificates(String)-Parameter, um auf die bereitgestellte Zertifikatdatei zu zeigen.

Um die Sicherheit zu erhöhen, sollten Sie mithilfe der Methode setCertificateName, setCertificateCompany bzw. setCertificateUnit die Validierung des MobiLink-Serverzertifikats aktivieren.

Instanzen, die diese Schnittstelle implementieren, werden von der Methode SyncParms.getStreamParms zurückgegeben, wenn das SyncParms-Objekt für die HTTPS-Synchronisation erstellt wird.

Siehe auch

getCertificateCompany-Methode
getCertificateName-Methode
getCertificateUnit-Methode
getTrustedCertificates-Methode
setCertificateCompany-Methode
setCertificateName-Methode
setCertificateUnit-Methode
setTrustedCertificates-Methode

Kommentieren Sie diese Seite in DocCommentXchange.