SecureSocket

Paket	flash.net
Klasse	public class SecureSocket
Vererbung	SecureSocket Socket EventDispatcher Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Die SecureSocket-Klasse ermöglicht es dem Code, Socketverbindungen unter Verwendung der Protokolle Secure Sockets Layer (SSL) und Transport Layer Security herzustellen.

Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf allen Geräten mit AIR für TV. Auf mobilen Geräten wird es unter Android und iOS, angefangen bei AIR 20 unterstützt. Mit der SecureSocket.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum API-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.

Die SSL/TLS-Protokolle stellen einen Mechanismus bereit, um beide Aspekte einer sicheren Socketverbindung zu verarbeiten:

Verschlüsselung der Datenkommunikation, die über das Socket läuft
Authentifizierung der Hostidentität anhand dessen Zertifikats

Die unterstützten Verschlüsselungsprotokolle sind SSL 3.1 und höher sowie TLS 1.0 und höher. (TLS ist das Nachfolgerprotokoll von SSL. TLS 1.0 entspricht SSL 3.1, TLS 1.1 entspricht SSL 3.2 usw.) SSL-Versionen 3.0 oder niedriger werden nicht unterstützt.

Die Validierung des Serverzertifikats wird mithilfe des Vertrauensspeichers und der Zertifikatvalidierungsunterstützung der Clientplattform ausgeführt. Darüber hinaus können Sie Ihre eigenen Zertifikate programmatisch mit der addBinaryChainBuildingCertificate()-Methode hinzufügen. Diese API wird derzeit nicht auf iOS unterstützt. Bei der Verwendung dieser API auf iOS wurde eine Ausnahme auftreten: ArgumentError: Error #2004

Die SecureSocket-Klasse stellt nur zu Servern mit gültigen, vertrauenswürdigen Zertifikaten eine Verbindung her. Wenn es ein Problem mit dem Zertifikat eines Servers gibt, können Sie keine Verbindung zu diesem Server herstellen. Es ist zum Beispiel nicht möglich, eine Verbindung zu einem Server herzustellen, dessen Zertifikat abgelaufen ist. Dasselbe gilt für ein Zertifikat, das nicht mit einem vertrauenswürdigen Ankerzertifikat verkettet ist. Die Verbindung wird nicht hergestellt, selbst wenn das Zertifikat ansonsten gültig ist.

Die SecureSocket-Klasse ist für die verschlüsselte Kommunikation mit einem vertrauenswürdigen Server hilfreich. Ansonsten verhält sich ein SecureSocket-Objekt wie ein normales Socket-Objekt.

Um die SecureSocket-Klasse zu verwenden, erstellen Sie ein SecureSocket-Objekt (new SecureSocket()). Als Nächstes richten Sie Ihre Listener ein und führen dann SecureSocket.connect(host, port) aus. Nachdem Sie die Verbindung zum Server erfolgreich hergestellt haben, setzt das Socket ein connect-Ereignis ab. Eine Verbindung ist dann erfolgreich, wenn die Sicherheitsprotokolle des Servers unterstützt werden und seine Zertifikate gültig und vertrauenswürdig sind. Wenn das Zertifikat nicht validiert werden kann, setzt der Socket ein IOError-Ereignis ab.

Wichtig: Das Online Certificate Status Protocol (OCSP) wird nicht von allen Betriebssystemen unterstützt. Benutzer können die OCSP-Überprüfung auf einzelnen Computern deaktivieren. Wenn OCSP nicht unterstützt wird oder deaktiviert ist und ein Zertifikat nicht die erforderlichen Informationen zur Überprüfung der Zertifikatsperrung anhand einer Zertifikatsperrliste (Certificate Revocation List, CRL) enthält, wird die Zertifikatsperrung nicht überprüft. Wenn das Zertifikat ansonsten gültig ist, wird es akzeptiert. Dieses Szenario lässt es zu, dass ein Server ein gesperrtes Zertifikat verwendet.

Beispiele anzeigen

Verwandte API-Elemente

Socket-Klasse

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bytesAvailable : uint [schreibgeschützt] Die Byteanzahl der zum Lesen verfügbaren Daten im Eingabepuffer.	Socket
		bytesPending : uint [schreibgeschützt] Gibt die Anzahl der im Schreibpuffer verbleibenden Bytes an.	Socket
		connected : Boolean [schreibgeschützt] Gibt an, ob dieses Socket-Objekt zurzeit verbunden ist.	Socket
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		endian : String Gibt die Byte-Reihenfolge der Daten an.	Socket
		isSupported : Boolean [statisch] [schreibgeschützt] Gibt an, ob sichere Sockets vom aktuellen System unterstützt werden.	SecureSocket
		localAddress : String [schreibgeschützt] Die IP-Adresse, an die dieser Socket auf dem lokalen Computer gebunden ist.	Socket
		localPort : int [schreibgeschützt] Der Port, an den dieser Socket auf dem lokalen Computer gebunden ist.	Socket
		objectEncoding : uint Steuert die beim Schreiben oder Lesen eines Objekts verwendete AMF-Version.	Socket
		remoteAddress : String [schreibgeschützt] Die IP-Adresse des Remotecomputers, mit der dieser Socket verbunden ist.	Socket
		remotePort : int [schreibgeschützt] Der Port des Remotecomputers, mit dem dieser Socket verbunden ist.	Socket
		serverCertificate : X509Certificate [schreibgeschützt] Enthält das X.509-Zertifikat, das vom Server bezogen wurde, nachdem eine sichere SSL/TLS-Verbindung hergestellt wurde.	SecureSocket
		serverCertificateStatus : String [schreibgeschützt] Gibt den Status des Serverzertifikats zurück.	SecureSocket
		timeout : uint Gibt die Anzahl der Millisekunden an, die auf eine Verbindung gewartet werden soll.	Socket

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		SecureSocket() Erstellt ein neues SecureSocket-Objekt.	SecureSocket
		addBinaryChainBuildingCertificate(certificate:ByteArray, trusted:Boolean):void Fügt der lokalen Zertifikatkette, die Ihr System zum Überprüfen des Serverzertifikats verwendet, ein X.509-Zertifikat hinzu.	SecureSocket
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		close():void Schließt den Socket.	Socket
		connect(host:String, port:int):void [override] Verbindet den Socket über SSL oder TLS mit dem angegebenen Host und Port.	SecureSocket
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		flush():void Gibt alle Daten im Ausgabepuffer des Sockets aus.	Socket
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		readBoolean():Boolean Liest einen booleschen Wert aus dem Socket.	Socket
		readByte():int Liest ein Byte mit Vorzeichen aus dem Socket.	Socket
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Liest die Anzahl der im Parameter „length“ angegebenen Datenbyte aus dem Socket.	Socket
		readDouble():Number Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Socket.	Socket
		readFloat():Number Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Socket.	Socket
		readInt():int Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Socket.	Socket
		readMultiByte(length:uint, charSet:String):String Liest einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Bytestream.	Socket
		readObject():* Liest ein Objekt aus dem Socket, das im serialisierten AMF-Format kodiert ist.	Socket
		readShort():int Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Socket.	Socket
		readUnsignedByte():uint Liest ein Byte ohne Vorzeichen aus dem Socket.	Socket
		readUnsignedInt():uint Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.	Socket
		readUnsignedShort():uint Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.	Socket
		readUTF():String Liest einen UTF-8-String aus dem Socket.	Socket
		readUTFBytes(length:uint):String Liest die mit dem Parameter „length“ angegebene Anzahl UTF-8-Byte aus dem Socket und gibt einen String zurück.	Socket
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher
		writeBoolean(value:Boolean):void Schreibt einen booleschen Wert in den Socket.	Socket
		writeByte(value:int):void Schreibt ein Byte in den Socket.	Socket
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Schreibt eine Anzahl an Byte aus dem angegebenen Bytearray.	Socket
		writeDouble(value:Number):void Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit in den Socket.	Socket
		writeFloat(value:Number):void Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit in den Socket.	Socket
		writeInt(value:int):void Schreibt eine 32-Bit-Ganzzahl mit Vorzeichen in den Socket.	Socket
		writeMultiByte(value:String, charSet:String):void Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Bytestream.	Socket
		writeObject(object:*):void Schreibt ein Objekt im serialisierten AMF-Format in den Socket.	Socket
		writeShort(value:int):void Schreibt eine 16-Bit-Ganzzahl in den Socket.	Socket
		writeUnsignedInt(value:uint):void Schreibt eine 32-Bit-Ganzzahl ohne Vorzeichen in den Socket.	Socket
		writeUTF(value:String):void Schreibt die folgenden Daten in den Socket: Eine 16-Bit-Ganzzahl ohne Vorzeichen, die die Länge des angegebenen UTF-8-Strings in Byte angibt, gefolgt von dem eigentlichen String.	Socket
		writeUTFBytes(value:String):void Schreibt einen UTF-8-String in den Socket.	Socket

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
close	Wird ausgelöst, wenn der Server die Socketverbindung schließt.	SecureSocket
connect	Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.	SecureSocket
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
ioError	Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den ein Sende- oder Empfangsvorgang fehlschlägt.	SecureSocket
outputProgress	Wird abgesetzt, wenn ein Socket Daten aus seinem Schreibpuffer auf die Netzwerktransportebene verschiebt	Socket
securityError	Wird abgesetzt, wenn ein Aufruf von SecureSocket.connect() aufgrund einer Sicherheitsbeschränkung fehlschlägt.	SecureSocket
socketData	Wird ausgelöst, wenn ein Socket Daten empfangen hat.	SecureSocket

Eigenschaftendetails

isSupported

Eigenschaft

isSupported:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Gibt an, ob sichere Sockets vom aktuellen System unterstützt werden.

Sichere Sockets werden nicht auf allen Plattformen unterstützt. Überprüfen Sie diese Eigenschaft, bevor Sie versuchen, eine SecureSocket-Instanz zu erstellen.

Implementierung
public static function get isSupported():Boolean

serverCertificate

Eigenschaft

serverCertificate:X509Certificate [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 3

Enthält das X.509-Zertifikat, das vom Server bezogen wurde, nachdem eine sichere SSL/TLS-Verbindung hergestellt wurde. Wenn keine sichere Verbindung hergestellt wird, wird diese Eigenschaft auf null gesetzt. Derzeit wird sie jedoch nicht unter iOS unterstützt. Daher ist sie auf null für iOS festgelegt.

Weitere Informationen zu X.509-Zertifikaten finden Sie unter RFC2459.

Implementierung
public function get serverCertificate():X509Certificate

serverCertificateStatus

Eigenschaft

serverCertificateStatus:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Gibt den Status des Serverzertifikats zurück.

Der Status ist CertificateStatus.UNKNOWN, bis der Socket versucht, eine Verbindung zu einem Server herzustellen. Nach der Validierung wird als Status einer der von der CertificateStatus-Klasse aufgezählten Strings angegeben. Die Verbindung wird nur dann erfolgreich hergestellt, wenn das Zertifikat gültig und vertrauenswürdig ist. Deshalb ist nach einem connect-Ereignis der Wert von serverCertificateStatus immer trusted.

Hinweis: Nachdem das Zertifikat erfolgreich validiert oder abgelehnt wurde, wird der Status bis zum nächsten Aufruf der connect()-Methode nicht mehr aktualisiert. Durch den Aufruf von close() wird der Status nicht auf „unknown“ (unbekannt) zurückgesetzt.

Implementierung
public function get serverCertificateStatus():String

Verwandte API-Elemente

CertificateStatus-Klasse

Konstruktordetails

()

Konstruktor

public function SecureSocket()

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Erstellt ein neues SecureSocket-Objekt.

Überprüfen Sie SecureSocket.isSupported, bevor Sie versuchen, eine SecureSocket-Instanz zu erstellen. Wenn SSL 3.0- oder TLS 1.0-Sockets nicht unterstützt werden, gibt die Laufzeitumgebung einen IllegalOperationError aus.

Auslöser

	`IllegalOperationError` — Wenn SSL Version 3.0 (und höher) oder TLS Version 1.0 (und höher) nicht unterstützt wird.

	`SecurityError` — Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können dies umgehen, indem Sie die entsprechende SWF-Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.

Methodendetails

addBinaryChainBuildingCertificate

()

Methode

public function addBinaryChainBuildingCertificate(certificate:ByteArray, trusted:Boolean):void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 3

Fügt der lokalen Zertifikatkette, die Ihr System zum Überprüfen des Serverzertifikats verwendet, ein X.509-Zertifikat hinzu. Das Zertifikat ist zeitlich befristet und gilt für die Dauer der Sitzung.

Die Überprüfung des Serverzertifikats beruht auf dem Vertrauensspeicher Ihres Systems zur Zertifikatverkettung und -überprüfung. Verwenden Sie diese Methode, um Zertifikatketten und vertrauenswürdige Anker programmgesteuert hinzuzufügen.

Unter Mac OS ist das Schlüsselbund des Systems das standardmäßige Schlüsselbund, das beim SSL/TLS-Handshakeprozess verwendet wird. Alle Zwischenzertifikate in diesem Schlüsselbund werden beim Erstellen der Zertifikatkette einbezogen.

Das Zertifikat, das Sie mit dieser API hinzufügen, muss ein DER-kodiertes X.509-Zertifikat sein. Wenn der trusted-Parameter den Wert „true“ hat, gilt das Zertifikat, das Sie mit dieser API hinzufügen, als vertrauenswürdiger Anker.

Weitere Informationen zu X.509-Zertifikaten finden Sie unter RFC2459.

Parameter

	`certificate:ByteArray` — Ein ByteArray-Objekt, das ein digitales DER-kodiertes X.509-Zertifikat enthält.

	`trusted:Boolean` — Setzen Sie es auf true, um dieses Zertifikat als Vertrauensanker festzulegen.

Auslöser

ArgumentError — Wenn das Zertifikat nicht hinzugefügt werden kann.

connect

()

Methode

override public function connect(host:String, port:int):void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Verbindet den Socket über SSL oder TLS mit dem angegebenen Host und Port.

Wenn Sie die SecureSocket.connect()-Methode aufrufen, probiert das Socket, den SSL/TLS-Handshake mit dem Server auszuführen. Wenn der Handshake erfolgreich ist, versucht das Socket, das Serverzertifikat zu überprüfen. Wenn das Zertifikat gültig und vertrauenswürdig ist, wird die sichere Socketverbindung eingerichtet und das Socket setzt ein connect-Ereignis ab. Wenn der Handshake fehlschlägt oder das Zertifikat nicht validiert werden kann, setzt der Socket ein IOError-Ereignis ab. Sie können das Ergebnis der Zertifikatvalidierung überprüfen, indem Sie die serverCertificateStatus-Eigenschaft lesen, nachdem das IOError-Ereignis abgesetzt wurde. (Wenn ein connect-Ereignis abgesetzt wird, ist der Zertifikatstatus immer trusted.)

Wenn bereits eine Socketverbindung besteht, wird die vorhandene Verbindung zunächst geschlossen.

Parameter

	`host:String` — Der Name oder die IP-Adresse des Hosts, zu dem eine Verbindung hergestellt werden soll.

	`port:int` — Die Portnummer für die herzustellende Verbindung.

Ereignisse

	`connect:Event` — Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.

	`ioError:IOErrorEvent` — Wird ausgelöst, wenn ein Host angegeben wurde und ein I/O-Fehler auftritt, durch den die Verbindung fehlschlägt. Dies schließt SSL/TLS-Handshake-Fehler sowie das Fehlschlagen der Validierung des Hostserverzertifikats ein.

	`securityError:SecurityErrorEvent` — Wird ausgelöst, wenn beim Aufrufen von `Socket.connect()` versucht wird, eine Verbindung zu einem Server herzustellen, der keine Socket-Richtliniendatei bereitstellt, bzw. zu einem Server, dessen Richtliniendatei dem aufrufenden Host keinen Zugriff auf den angegebenen Port gewährt. Weitere Informationen zu Richtliniendateien finden Sie unter „Websitesteuerungen (Richtliniendateien)“ im ActionScript 3.0 Entwicklerhandbuch und im Flash Player Developer Center im Artikel: Sicherheit.

Auslöser

	`IOError` — Wenn Sie keinen Host angeben und die Verbindung fehlschlägt.

	`SecurityError` — Wenn Sie einen Socketport unter 0 oder über 65535 angeben.

Ereignisdetails

close

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CLOSE

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Wird ausgelöst, wenn der Server die Socketverbindung schließt.

Das Ereignis close wird nur ausgelöst, wenn der Server die Verbindung schließt. Es wird nicht ausgelöst, wenn Sie die Methode Socket.close() aufrufen.

Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, dessen Verbindung geschlossen wurde.

connect

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CONNECT

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.

Die Event.CONNECT-Konstante definiert den Wert der type-Eigenschaft eines connect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Socket- oder XMLSocket-Objekt, das eine Netzwerkverbindung hergestellt hat.

ioError

Ereignis

Ereignisobjekttyp: flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den ein Sende- oder Empfangsvorgang fehlschlägt.

Wenn ein Serverzertifikat nicht validiert werden kann, ist das abgesetzte Fehlerereignis ein IOError. In diesem Fall können Sie die serverCertificateStatus-Eigenschaft überprüfen, um die Ursache des Problems zu ermitteln.

Definiert den Wert der Eigenschaft type eines ioError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`errorID`	Die Referenznummer des spezifischen Fehlers (nur AIR).
`target`	Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt.
`text`	Der als Fehlermeldung anzuzeigende Text.

securityError

Ereignis

Ereignisobjekttyp: flash.events.SecurityErrorEvent
Eigenschaft SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Wird abgesetzt, wenn ein Aufruf von SecureSocket.connect() aufgrund einer Sicherheitsbeschränkung fehlschlägt.

Ein Sicherheitsfehler-Ereignis wird abgesetzt, wenn Code, der in Flash Player oder in AIR außerhalb der Sicherheitssandbox der Anwendung ausgeführt wird, versucht, eine Verbindung zu einem Server in einer anderen Domäne oder zu einem Port unter 1024 herzustellen und der Server keine Richtliniendatei bereitstellt, die diese Verbindung zulässt. Beachten Sie, dass Code, der innerhalb der AIR-Sicherheitssandbox ausgeführt wird, eine Verbindung zu einem Server in jeder beliebigen Domäne und zu Ports unter 1024 herstellen kann, ohne dass eine Richtliniendatei erforderlich ist.

Die Konstante SecurityErrorEvent.SECURITY_ERROR definiert den Wert der type-Eigenschaft eines securityError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Netzwerkobjekt, das den Sicherheitsfehler ausgibt.
`text`	Der als Fehlermeldung anzuzeigende Text.

Verwandte API-Elemente

SecureSocket.connect()

socketData

Ereignis

Ereignisobjekttyp: flash.events.ProgressEvent
Eigenschaft ProgressEvent.type = flash.events.ProgressEvent.SOCKET_DATA

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 11, AIR 2

Wird ausgelöst, wenn ein Socket Daten empfangen hat. Für Ereignisse vom Typ socketData wird die Eigenschaft ProgressEvent.bytesTotal nicht verwendet.

Definiert den Wert der Eigenschaft type eines socketData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, das das Ereignis aktiv verarbeitet.
`bytesLoaded`	Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
`bytesTotal`	0. Diese Eigenschaft wird von `socketData`-Ereignisobjekten nicht verwendet.
`target`	Der Socket, dessen Fortschritt protokolliert wird.

Beispiele Verwendung dieses Beispiels

SecureSocketExample.as

Das folgende Beispiel zeigt das Erstellen und Verbinden eines SecureSocket-Objekts.

package
{
    import flash.display.Sprite;
    import flash.errors.IOError;
    import flash.events.Event;
    import flash.events.IOErrorEvent;
    import flash.net.SecureSocket;
    
    public class SecureSocketExample extends Sprite
    {
        private var secureSocket:SecureSocket = new SecureSocket();
        
        public function SecureSocketExample()
        {
            secureSocket.addEventListener( Event.CONNECT, onConnect )
            secureSocket.addEventListener( IOErrorEvent.IO_ERROR, onError );
            
            try
            {
                secureSocket.connect( "208.77.188.166", 443 );
            }
            catch ( error:Error )
            {
                trace ( error.toString() );
            }
        }
        
        private function onConnect( event:Event ):void
        {
            trace("Connected.");
        }
        
        private function onError( error:IOErrorEvent ):void
        {
            trace( error.text + ", " + secureSocket.serverCertificateStatus );
        }
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

SecureSocket - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.net

isSupported

serverCertificate

serverCertificateStatus

SecureSocket

addBinaryChainBuildingCertificate

connect

close

connect

ioError

securityError

socketData