SecureSocket

Pakiet	flash.net
Klasa	public class SecureSocket
Dziedziczenie	SecureSocket Socket EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Klasa SecureSocket umożliwia nawiązywanie z poziomu kodu połączeń z gniazdami przy użyciu protokołów Secure Sockets Layer (SSL) i Transport Layer Security (TLS).

Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na niektórych urządzeniach telewizyjnych ze środowiskiem AIR. Na urządzeniach przenośnych jest ona obsługiwana w systemie Android oraz — od środowiska AIR 20 — w systemie iOS. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość SecureSocket.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Protokoły SSL/TLS oferują mechanizm obsługujący oba aspekty połączenia z zabezpieczonym gniazdem:

Szyfrowanie komunikacji danych przechodzącej przez gniazdo
Uwierzytelnianie tożsamości komputera za pośrednictwem jego certyfikatu

Obsługiwane są protokoły SSL 3.1 (i nowsze wersje) oraz TLS 1.0 (i nowsze wersje). (Protokół TLS zastąpił protokół SSL. Protokół TLS 1.0 odpowiada protokołowi SSL 3.1, protokół TLS 1.1 odpowiada protokołowi SSL 3.2 itd.). Protokoły SSL w wersji 3.0 lub starsze nie są obsługiwane.

Sprawdzanie ważności certyfikatu serwera realizowane jest przy użyciu magazynu certyfikatów zaufanych i mechanizmu sprawdzania certyfikatu udostępnianego przez platformę kliencką. Ponadto można programowo dodać własne certyfikaty za pomocą metody addBinaryChainBuildingCertificate(). Ten interfejs API obecnie nie jest obsługiwany w systemie iOS. Użycie tego interfejsu API w systemie iOS powoduje wygenerowanie wyjątku „Błąd argumentu: błąd 2004”.

Klasa SecureSocket nawiązuje połączenia tylko z serwerami, które mają ważne i zaufane certyfikaty. Nie można wymusić połączenia z serwerem, gdy występuje problem z jego certyfikatem. Nie ma na przykład możliwości nawiązania połączenia z serwerem mającym certyfikat, który utracił ważność. To samo dotyczy certyfikatu, który w łańcuchu nie ma zaufanego certyfikatu kontrolnego. Połączenie nie zostanie nawiązane nawet w sytuacji, w której poza tym certyfikat byłby poprawny.

Klasa SecureSocket jest przydatna do realizacji szyfrowanej komunikacji z serwerem zaufanym. Pod innymi względami obiekt SecureSocket zachowuje się tak samo jak zwykły obiekt Socket.

Aby użyć klasy SecureSocket, należy utworzyć obiekt SecureSocket (new SecureSocket()). Potem należy skonfigurować detektory zdarzeń, a następnie uruchomić metodę SecureSocket.connect(host, port). Po pomyślnym połączeniu z serwerem gniazdo wyzwoli zdarzenie connect. Pomyślne połączenie to takie, w którym są obsługiwane protokoły zabezpieczeń serwera, a jego certyfikat jest ważny i zaufany. Jeśli nie można sprawdzić ważności certyfikatu, obiekt Socket wywołuje zdarzenie IOError.

Ważne: Protokół OCSP (Online Certificate Status Protocol) nie jest obsługiwany przez wszystkie systemy operacyjne. Użytkownicy mogą również wyłączyć sprawdzanie dostępności protokołu OCSP na poszczególnych komputerach. Jeśli protokół OCSP nie jest obsługiwany lub został wyłączony oraz certyfikat nie zawiera informacji wymaganych do sprawdzenia, czy znajduje się na liście unieważnionych certyfikatów CRL, wówczas unieważnienie certyfikatu nie jest sprawdzane. Certyfikat zostanie zaakceptowany, jeśli pod innymi względami jest ważny. W tym scenariuszu może dojść do sytuacji, w której serwer użyje unieważnionego certyfikatu.

Wyświetl przykłady

Powiązane elementy interfejsu API

Klasa Socket

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		bytesAvailable : uint [tylko do odczytu] Liczba bajtów, które można odczytać z bufora wejściowego.	Socket
		bytesPending : uint [tylko do odczytu] Wskazuje liczbę bajtów, które pozostały w buforze zapisu.	Socket
		connected : Boolean [tylko do odczytu] Wskazuje, czy obiekt Socket jest aktualnie podłączony.	Socket
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		endian : String Przedstawia porządek bajtów danych.	Socket
		isSupported : Boolean [statyczny] [tylko do odczytu] Wskazuje, czy gniazda zabezpieczone są obsługiwane w bieżącym systemie.	SecureSocket
		localAddress : String [tylko do odczytu] Adres IP, z którym to gniazdo jest powiązane na komputerze lokalnym.	Socket
		localPort : int [tylko do odczytu] Port, z którym to gniazdo jest powiązane na komputerze lokalnym.	Socket
		objectEncoding : uint Zapewnia kontrolę nad wersją formatu AMF stosowaną przy zapisywaniu i odczycie obiektu.	Socket
		remoteAddress : String [tylko do odczytu] Adres IP komputera zdalnego, z którym jest połączone to gniazdo.	Socket
		remotePort : int [tylko do odczytu] Port komputera zdalnego, z którym jest połączone to gniazdo.	Socket
		serverCertificate : X509Certificate [tylko do odczytu] Przechowuje certyfikat X.509 uzyskany z serwera po nawiązaniu bezpiecznego połączenia SSL/TLS.	SecureSocket
		serverCertificateStatus : String [tylko do odczytu] Zwraca stan certyfikatu serwera.	SecureSocket
		timeout : uint Wskazuje czas oczekiwania na połączenie w milisekundach.	Socket

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		SecureSocket() Tworzy nowy obiekt SecureSocket.	SecureSocket
		addBinaryChainBuildingCertificate(certificate:ByteArray, trusted:Boolean):void Dodaje certyfikat X.509 do lokalnego łańcucha certyfikatów używanego przez system do sprawdzania poprawności certyfikatu serwera.	SecureSocket
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		close():void Zamyka gniazdo.	Socket
		connect(host:String, port:int):void [przesłanianie] Łączy gniazdo z określonym komputerem i portem przy użyciu protokołu SSL lub TLS.	SecureSocket
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		flush():void Usuwa wszystkie dane zgromadzone w buforze wyjściowym gniazda.	Socket
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		readBoolean():Boolean Czyta z gniazda wartość typu Boolean.	Socket
		readByte():int Czyta z gniazda bajt ze znakiem.	Socket
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Pozwala odczytać z gniazda liczbę bajtów określonych przez parametr długość.	Socket
		readDouble():Number Czyta z gniazda liczbę zmiennoprzecinkową o podwójnej precyzji (IEEE 754).	Socket
		readFloat():Number Czyta z gniazda liczbę zmiennoprzecinkową o pojedynczej precyzji (wg normy IEEE 754).	Socket
		readInt():int Czyta z gniazda 32-bitową liczbę całkowitą ze znakiem.	Socket
		readMultiByte(length:uint, charSet:String):String Czyta wielobajtowy ciąg znaków ze strumienia bajtów, przy użyciu określonego zestawu znaków.	Socket
		readObject():* Czyta z gniazda obiekt zakodowany w formacie AMF.	Socket
		readShort():int Czyta z gniazda 16-bitową liczbę całkowitą ze znakiem.	Socket
		readUnsignedByte():uint Czyta z gniazda bajt bez znaku.	Socket
		readUnsignedInt():uint Czyta z gniazda 32-bitową liczbę całkowitą bez znaku.	Socket
		readUnsignedShort():uint Czyta z gniazda 16-bitową liczbę całkowitą bez znaku.	Socket
		readUTF():String Czyta z gniazda ciąg znaków UTF-8.	Socket
		readUTFBytes(length:uint):String Czyta z gniazda liczbę bajtów UTF-8 określonych przez parametr długość, a zwraca ciąg znaków.	Socket
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher
		writeBoolean(value:Boolean):void Zapisuje wartość typu Boolean w gnieździe.	Socket
		writeByte(value:int):void Zapisuje bajt w gnieździe.	Socket
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Zapisuje sekwencję bajtów z określonej tablicy bajtów.	Socket
		writeDouble(value:Number):void Zapisuje w gnieździe liczbę zmiennoprzecinkową o podwójnej precyzji (IEEE 754).	Socket
		writeFloat(value:Number):void Zapisuje w gnieździe liczbę zmiennoprzecinkową o pojedynczej precyzji (wg normy IEEE 754).	Socket
		writeInt(value:int):void Zapisuje w gnieździe 32-bitową liczbę całkowitą ze znakiem.	Socket
		writeMultiByte(value:String, charSet:String):void Zapisuje wielobajtowy ciąg znaków ze strumienia bajtów, przy użyciu określonego zestawu znaków.	Socket
		writeObject(object:*):void Zapisuje w gnieździe obiekt w formacie serializowanym AMF.	Socket
		writeShort(value:int):void Zapisuje w gnieździe 16-bitową liczbę całkowitą.	Socket
		writeUnsignedInt(value:uint):void Zapisuje w gnieździe 32-bitową liczbę całkowitą bez znaku.	Socket
		writeUTF(value:String):void Zapisuje w gnieździe następujące dane: 16-bitowa liczba całkowita bez znaku, która określa długość podanego ciągu UTF-8 (w bajtach), a po niej sam ciąg.	Socket
		writeUTFBytes(value:String):void Zapisuje w gnieździe ciąg znaków UTF.	Socket

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
close	Wywoływana, gdy serwer zamyka połączenie z gniazdem.	SecureSocket
connect	Wywoływane po nawiązaniu połączenia sieciowego.	SecureSocket
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
ioError	Wywoływane, gdy wystąpi błąd wejścia lub wyjścia będący przyczyną niepowodzenia operacji wysyłania lub odbierania.	SecureSocket
outputProgress	Wywoływane, gdy gniazdo przenosi dane z bufora zapisu do warstwy transportu sieci.	Socket
securityError	Wywoływane w przypadku niepowodzenia wywołania metody SecureSocket.connect() z powodu ograniczenia dotyczącego zabezpieczeń.	SecureSocket
socketData	Wywoływana, gdy gniazdo odbierze dane.	SecureSocket

Szczegół właściwości

isSupported

właściwość

isSupported:Boolean [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wskazuje, czy gniazda zabezpieczone są obsługiwane w bieżącym systemie.

Gniazda zabezpieczone nie są obsługiwane na niektórych platformach. Wartość tej właściwości należy sprawdzić przed próbą utworzenia wystąpienia klasy SecureSocket.

Implementacja
public static function get isSupported():Boolean

serverCertificate

właściwość

serverCertificate:X509Certificate [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 3

Przechowuje certyfikat X.509 uzyskany z serwera po nawiązaniu bezpiecznego połączenia SSL/TLS. Jeśli bezpieczne połączenie nie zostanie nawiązane, dla tej właściwości zostanie ustawiona wartość null. Obecnie ta właściwość nie jest obsługiwana w systemie iOS, dlatego przyjmuje w nim wartość null.

Więcej informacji na temat certyfikatów X.509 zawiera dokument RFC2459.

Implementacja
public function get serverCertificate():X509Certificate

serverCertificateStatus

właściwość

serverCertificateStatus:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Zwraca stan certyfikatu serwera.

Stan ma wartość CertificateStatus.UNKNOWN, dopóki nie nastąpi próba połączenia gniazda z serwerem. Po sprawdzeniu poprawności wartość stanu jest równa jednemu z ciągów znaków wyliczonych w klasie CertificateStatus. Połączenie zostaje pomyślnie nawiązane tylko wtedy, gdy certyfikat jest ważny i zaufany. Dlatego po wywołaniu zdarzenia connectwartość właściwości serverCertificateStatus zawsze wynosi trusted.

Uwaga: Po potwierdzeniu ważności lub odrzuceniu certyfikatu wartość statusu jest aktualizowana dopiero przy następnym wywołaniu metody connect(). Wywołanie metody close() nie powoduje powrotu do statusu "unknown".

Implementacja
public function get serverCertificateStatus():String

Powiązane elementy interfejsu API

Klasa CertificateStatus

Konstruktor Szczegół

()

Konstruktor

public function SecureSocket()

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Tworzy nowy obiekt SecureSocket.

Przed próbą utworzenia instancji klasy SecureSocket należy sprawdzić wartość właściwości SecureSocket.isSupported. Jeśli nie są obsługiwane gniazda SSL 3.0 lub TLS 1.0, środowisko wykonawcze generuje wyjątek IllegalOperationError.

Zgłasza

	`IllegalOperationError` — Gdy nie jest obsługiwany protokół SSL 3.0 lub nowszy ani protokół TLS 1.0 lub nowszy.

	`SecurityError` — Niezaufane pliki SWF nie mogą komunikować się z Internetem. Można obejść ten problem przez zaklasyfikowanie pliku SWF jako lokalnego z dostępem do sieci lub zaufanego.

Szczegół metody

addBinaryChainBuildingCertificate

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 3

Dodaje certyfikat X.509 do lokalnego łańcucha certyfikatów używanego przez system do sprawdzania poprawności certyfikatu serwera. Certyfikat jest tymczasowy i obowiązuje przez czas trwania sesji.

W zakresie tworzenia łańcucha certyfikatów i sprawdzania poprawności proces sprawdzania poprawności certyfikatu serwera opiera się na systemowym magazynie certyfikatów zaufanych. Ta metoda pozwala programowo dodawać kolejne łańcuchy certyfikatów i zaufane punkty kontrolne.

W systemie Mac OS domyślnym łańcuchem kluczy podczas procesu uzgadniania protokołów SSL/TLS jest systemowy łańcuch kluczy. Wszelkie certyfikaty pośrednie w tym łańcuchu kluczy są uwzględniane podczas budowania łańcucha certyfikatów.

Certyfikat dodawany za pomocą tego interfejsu API musi być certyfikatem X.509 zakodowanym w standardzie DER. Jeśli parametr trusted ma wartość true, certyfikat dodawany za pomocą tego interfejsu API jest uznawany za początek łańcucha zaufania.

Więcej informacji na temat certyfikatów X.509 zawiera dokument RFC2459.

Parametry

	`certificate:ByteArray` — Obiekt ByteArray zawierający certyfikat cyfrowy X.509 zakodowany w standardzie DER.

	`trusted:Boolean` — Ustawienie wartości true pozwala wskazać ten certyfikat jako początek łańcucha zaufania.

Zgłasza

ArgumentError — Gdy nie można dodać certyfikatu.

connect

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Łączy gniazdo z określonym hostem i portem przy użyciu protokołu SSL lub TLS.

Po wywołaniu metody SecureSocket.connect() gniazdo próbuje przeprowadzić uzgodnienie z serwerem za pomocą protokołu SSL/TLS. Jeśli uzgadnianie zakończy się powodzeniem, gniazdo próbuje sprawdzić poprawność certyfikatu serwera. Jeśli certyfikat jest ważny i zaufany, połączenie z zabezpieczonym gniazdem jest nawiązywane, a gniazdo wywołuje zdarzenie connect. Jeśli uzgodnienie nie powiedzie się lub nie można sprawdzić ważności certyfikatu, obiekt Socket wywołuje zdarzenie IOError. Wynik kontroli poprawności certyfikatu można sprawdzić, odczytując właściwość serverCertificateStatus po wywołaniu zdarzenia IOError. (Po wywołaniu zdarzenia connect, certyfikat zawsze ma stan zaufanego — trusted).

Jeśli gniazdo było już połączone, wtedy najpierw zostanie zamknięte istniejące połączenie.

Parametry

	`host:String` — Nazwa lub adres IP hosta, do którego będzie realizowane połączenie.

	`port:int` — Numer portu, do którego będzie realizowane połączenie.

Zdarzenia

	`connect:Event` — Wywoływane po nawiązaniu połączenia sieciowego.

	`ioError:IOErrorEvent` — Wywoływane, jeśli host został określony i wystąpił błąd wejścia/wyjścia, który spowodował zerwanie połączenia. W szczególności dotyczy to błędów uzgadniania protokołu SSL/TLS i braku możliwości poprawnego sprawdzenia ważności certyfikatu serwera działającego na hoście.

	`securityError:SecurityErrorEvent` — Wywoływane, gdy metoda `Socket.connect()` usiłuje połączyć się z serwerem, który nie obsługuje pliku reguł gniazd lub z serwerem, którego plik reguł nie udziela wywołującemu hostowi dostępu do określonego portu. Więcej informacji na temat plików reguł zawiera sekcja „Kontrola witryn internetowych (pliki reguł)” w publikacji ActionScript 3.0 — Podręcznik dla programistów oraz odpowiedni temat w Centrum programistów programu Flash Player w kategorii Zabezpieczenia.

Zgłasza

	`IOError` — Gdy użytkownik nie określi komputerem i próba nawiązania połączenia zakończy się niepowodzeniem.

	`SecurityError` — W przypadku określenia portu gniazda o numerze mniejszym od zera lub większym niż 65535.

Szczegół zdarzenia

close

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CLOSE

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wywoływana, gdy serwer zamyka połączenie z gniazdem.

Zdarzenie close wywoływane jest jedynie wtedy, gdy serwer zamyka połączenie; nie jest wywoływane w wyniku wywołania metodySocket.close().

Stała Event.CLOSE definiuje wartość właściwości type obiektu zdarzenia close.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, którego połączenie zostało zamknięte.

connect

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CONNECT

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wywoływane po nawiązaniu połączenia sieciowego.

Stała Event.CONNECT definiuje wartość właściwości type obiektu zdarzenia connect.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt Socket lub XMLSocket, który nawiązał połączenie sieciowe.

ioError

Zdarzenie

Typ obiektu zdarzenia: flash.events.IOErrorEvent
właściwość IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wywoływane, gdy wystąpi błąd wejścia lub wyjścia będący przyczyną niepowodzenia operacji wysyłania lub odbierania.

Jeśli nie można sprawdzić ważności certyfikatu, zostanie wywołane zdarzenie błędu IOError. W takim przypadku, aby określić przyczynę problemu, można sprawdzić właściwość serverCertificateStatus.

Definiuje wartość właściwości type obiektu zdarzenia ioError.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`errorID`	Numer referencyjny skojarzony z konkretnym błędem (tylko w środowisku AIR).
`target`	Obiekt sieciowy, w którym wystąpił błąd wejścia/wyjścia.
`text`	Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie.

securityError

Zdarzenie

Typ obiektu zdarzenia: flash.events.SecurityErrorEvent
właściwość SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wywoływane w przypadku niepowodzenia wywołania metody SecureSocket.connect() z powodu ograniczenia dotyczącego zabezpieczeń.

Zdarzenie dotyczące błędu zabezpieczeń jest wywoływane, gdy kod uruchomiony w programie Flash Player lub środowisku AIR poza obszarem izolowanym aplikacji próbuje połączyć się z serwerem w innej domenie lub z portem o numerze niższym niż 1024, a serwer nie udostępnia pliku zasad zezwalającego na takie połączenie. Kod uruchomiony w obszarze izolowanym aplikacji AIR może łączyć się z serwerem w dowolnej domenie i z portami o numerze niższym niż 1024 bez pliku zasad.

Stała SecurityErrorEvent.SECURITY_ERROR definiuje wartość właściwości type obiektu zdarzenia securityError.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt sieciowy zgłaszający błąd zabezpieczeń.
`text`	Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie.

Powiązane elementy interfejsu API

SecureSocket.connect()

socketData

Zdarzenie

Typ obiektu zdarzenia: flash.events.ProgressEvent
właściwość ProgressEvent.type = flash.events.ProgressEvent.SOCKET_DATA

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 2

Wywoływana, gdy gniazdo odbierze dane. Zdarzenia typu socketData nie używają właściwości ProgressEvent.bytesTotal.

Definiuje wartość właściwości type obiektu zdarzenia socketData.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt, który aktywnie przetwarza zdarzenie Event.
`bytesLoaded`	Liczba elementów lub bajtów załadowanych w momencie, w którym detektor przetwarza zdarzenie.
`bytesTotal`	0; ta właściwość nie jest używana w obiektach zdarzeń `socketData`.
`target`	Gniazdo informujące o postępie.

Przykłady Sposób korzystania z tego przykładu

SecureSocketExample.as

W poniższym przykładzie zilustrowano sposób tworzenia i łączenia z obiektem SecureSocket.

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

Informacje prawne | Zasady prywatności online

SecureSocket - AS3

Klasy x

isSupported

serverCertificate

serverCertificateStatus

SecureSocket

addBinaryChainBuildingCertificate

connect

close

connect

ioError

securityError

socketData