Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
flash.net 

SecureSocket  - AS3

Packagesx

Niveau supérieur
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques
Packageflash.net
Classepublic class SecureSocket
HéritageSecureSocket Inheritance Socket Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

La classe SecureSocket permet au code d’établir des connexions socket à l’aide des protocoles SSL (Secure Sockets Layer) et TLS (Transport Layer Security).

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur tous les périphériques AIR pour TV. Sur les périphériques mobiles, ceci est pris en charge sur Android, ainsi que sur iOS à partir de la version 20 d'AIR. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété SecureSocket.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

Les protocoles SSL/TLS fournissent un mécanisme permettant de gérer les deux aspects d’une connexion de socket sécurisée :

  1. Chiffrement de la communication de données sur le socket
  2. Authentification de l’identité de l’hôte par le biais de son certificat

Les protocoles de chiffrement pris en charge sont les suivants : SSL 3.1 et versions ultérieures, et TLS 1.0 et versions ultérieures. (TLS n’est le protocole successeur pour SSL. TLS 1.0 SSL correspond à SSL 3.1, TLS 1.1 SSL correspond à SSL 3.2, et ainsi de suite.) Les versions SSL 3.0 ou inférieures ne sont pas prises en charge.

Le certificat de serveur est validé à l’aide du magasin d’approbations et de la fonction de validation de certificat de la plate-forme client. En outre, vous pouvez ajouter vos propres certificats par programmation avec la méthode addBinaryChainBuildingCertificate(). Cette API n'est actuellement pas prise en charge sous iOS. Utiliser cette API sous iOS retournerait une exception - « ArgumentError : Erreur #2004 »

La classe SecureSocket se connecte aux serveurs uniquement avec des certificats valides et approuvés. Vous ne pouvez pas vous connecter à un serveur si son certificat pose problème. Par exemple, il n’existe aucun moyen de se connecter à un serveur avec un certificat périmé. Il en va de même pour un certificat qui n’est pas lié à un certificat d’ancrage approuvé. La connexion n’est pas établie même si le certificat est valide.

La classe SecureSocket est utile pour établir la communication chiffrée à un serveur approuvé. A d’autres égards, un objet SecureSocket se comporte comme un objet Socket standard

Pour utiliser la classe SecureSocket, créez un objet SecureSocket (new SecureSocket()). Configurez ensuite vos écouteurs, puis exécutez SecureSocket.connect(host, port). Lorsque la connexion au serveur est établie, le socket distribue un événement connect. Une connexion correctement établie est une connexion dans laquelle les protocoles de sécurité du serveur sont pris en charge, et dans laquelle le certificat du serveur est valide et approuvé. S’il est impossible de valider le certificat, le socket distribue un événement IOError.

Important : le protocole OCSP (Online Certificate Status Protocol) n’est pas pris en charge sur tous les systèmes d’exploitation. Les utilisateurs peuvent également désactiver la vérification OCSP sur des ordinateurs individuels. Si le protocole OCSP n’est pas pris en charge ou s’il est désactivé et si un certificat ne contient pas les informations nécessaires permettant de vérifier la révocation à l’aide d’une liste de révocation de certificats, la révocation des certificats n’est pas vérifiée. Le certificat est accepté s’il est valide. Ce scénario pourrait autoriser un serveur à utiliser un certificat révoqué.

Consulter les exemples

Plus d’exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 InheritedbytesAvailable : uint
[lecture seule] Nombre d’octets de données disponibles en lecture dans la mémoire tampon d’entrée.
Socket
 InheritedbytesPending : uint
[lecture seule] Indique le nombre d’octets restants dans la mémoire tampon d’écriture.
Socket
 Inheritedconnected : Boolean
[lecture seule] Indique si l’objet Socket est actuellement connecté.
Socket
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 Inheritedendian : String
Indique l’ordre d’octet des données.
Socket
  isSupported : Boolean
[statique] [lecture seule] Indique si les sockets sécurisés sont pris en charge sur le système actuel.
SecureSocket
 Inherited    localAddress : String
[lecture seule] Adresse IP à laquelle ce socket est lié sur la machine locale.
Socket
 Inherited    localPort : int
[lecture seule] Port auquel ce socket est lié sur la machine locale.
Socket
 InheritedobjectEncoding : uint
Contrôle la version du format AMF utilisée lors de l’écriture ou de la lecture d’un objet.
Socket
 Inherited    remoteAddress : String
[lecture seule] Adresse IP de la machine distante à laquelle ce socket est connecté.
Socket
 Inherited    remotePort : int
[lecture seule] Port de la machine distante auquel ce socket est connecté.
Socket
  serverCertificate : X509Certificate
[lecture seule] Conserve le certificat X.509 obtenu à partir du serveur après l’établissement d’une connexion SSL/TLS sécurisée.
SecureSocket
  serverCertificateStatus : String
[lecture seule] Renvoie l’état du certificat du serveur.
SecureSocket
 Inheritedtimeout : uint
Indique le délai d’attente d’une connexion, en millisecondes.
Socket
Méthodes publiques
 MéthodeDéfini par
  
Crée un nouvel objet SecureSocket.
SecureSocket
  
Ajoute un certificat X.509 à la chaîne de certificat local que votre système utilise pour la validation du certificat de serveur.
SecureSocket
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Ferme le socket.
Socket
  
connect(host:String, port:int):void
[override] Connecte le socket à l’hôte et au port spécifiés à l’aide du protocole SSL ou TLS.
SecureSocket
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Efface les données accumulées dans la mémoire tampon de sortie du socket.
Socket
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Lit une valeur booléenne dans le socket.
Socket
 Inherited
Lit un octet signé dans le socket.
Socket
 Inherited
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Lit dans le socket le nombre d’octets de données spécifié par le paramètre length.
Socket
 Inherited
Lit dans le socket un nombre à virgule flottante à deux décimales et conforme à IEEE 754.
Socket
 Inherited
Lit dans le socket un nombre à virgule flottante à une décimale et conforme à IEEE 754.
Socket
 Inherited
Lit un entier de 32 bits signé dans le socket.
Socket
 Inherited
readMultiByte(length:uint, charSet:String):String
Lit une chaîne multi-octets dans le flux d’octets, en utilisant le jeu de caractères spécifié.
Socket
 Inherited
Lit dans le socket un objet codé au format AMF (Action Message Format) sérialisé.
Socket
 Inherited
Lit un entier de 16 bits signé dans le socket.
Socket
 Inherited
Lit un octet non signé dans le socket.
Socket
 Inherited
Lit un entier de 32 bits non signé dans le socket.
Socket
 Inherited
Lit un entier de 16 bits non signé dans le socket.
Socket
 Inherited
Lit une chaîne UTF-8 dans le socket.
Socket
 Inherited
Lit dans le socket le nombre d’octets de données UTF-8 spécifié par le paramètre length et renvoie une chaîne.
Socket
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
 Inherited
Ecrit une valeur booléenne dans le socket.
Socket
 Inherited
Ecrit un octet dans le socket.
Socket
 Inherited
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Ecrit une séquence d’octets extraits du tableau d’octets spécifié.
Socket
 Inherited
Ecrit dans le socket un nombre à virgule flottante à deux décimales et conforme à IEEE 754.
Socket
 Inherited
Ecrit dans le socket un nombre à virgule flottante à une décimale conforme à IEEE 754.
Socket
 Inherited
Ecrit un entier signé de 32 bits dans le socket.
Socket
 Inherited
Ecrit une chaîne multi-octets extraite du flux d’octets, en utilisant le jeu de caractères spécifié.
Socket
 Inherited
Ecrit un objet dans le socket au format AMF sérialisé.
Socket
 Inherited
Ecrit un entier 16 bits dans le socket.
Socket
 Inherited
Ecrit un entier non signé de 32 bits dans le socket.
Socket
 Inherited
Ecrit les données suivantes dans le socket : un entier non signé de 16 bits, qui indique, en octets, la longueur de la chaîne UTF-8 spécifiée, suivie de la chaîne elle-même.
Socket
 Inherited
Ecrit une chaîne UTF-8 dans le socket.
Socket
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
  Distribué lorsque le serveur ferme la connexion socket.SecureSocket
  Distribué lorsqu’une connexion réseau est établie.SecureSocket
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
  Distribué lorsqu’il se produit une erreur d’entrée ou de sortie entraînant l’échec d’une opération d’envoi ou de réception.SecureSocket
 InheritedDistribué lorsqu’un socket déplace des données de son tampon d’écriture vers la couche de transport de la mise en réseauSocket
  Distribué lorsqu’un appel à SecureSocket.connect() échoue en raison d’une restriction de sécurité.SecureSocket
  Distribué lorsqu’un socket a reçu des données.SecureSocket
Détails de la propriété

isSupported

propriété
isSupported:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Indique si les sockets sécurisés sont pris en charge sur le système actuel.

Les sockets sécurisés ne sont pas pris en charge sur toutes les plates-formes. Vérifiez cette propriété avant toute tentative de création d’une occurrence de SecureSocket.



Implémentation
    public static function get isSupported():Boolean

serverCertificate

propriété 
serverCertificate:X509Certificate  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 3

Conserve le certificat X.509 obtenu à partir du serveur après l’établissement d’une connexion SSL/TLS sécurisée. Si une connexion sécurisée n’est pas établie, cette propriété est définie sur null. Ceci n'est actuellement pas pris en charge sous iOS, et donc défini sur null dans le cas d'iOS.

Pour plus d’informations sur les certificats X.509, voir RFC2459.



Implémentation
    public function get serverCertificate():X509Certificate

serverCertificateStatus

propriété 
serverCertificateStatus:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Renvoie l’état du certificat du serveur.

L’état est CertificateStatus.UNKNOWN jusqu’à ce que le socket tente d’établir une connexion à un serveur. Après validation, l’état est l’une des chaînes énumérées par la classe CertificateStatus. La connexion aboutit uniquement lorsque le certificat est validé et approuvé. Ainsi, après un événement connect, la valeur de serverCertificateStatus est toujours trusted.

Remarque : une fois le certificat validé ou rejeté, la valeur d’état n’est pas mise à jour jusqu’au prochain appel de la méthode connect(). L’appel de la méthode close() ne rétablit pas l’état sur la valeur « unknown ».



Implémentation
    public function get serverCertificateStatus():String

Eléments de l’API associés

Détails du constructeur

SecureSocket

()Constructeur
public function SecureSocket()

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Crée un nouvel objet SecureSocket.

Vérifiez SecureSocket.isSupported avant toute tentative de création d’une occurrence de SecureSocket. Si les sockets SSL 3.0 ou TLS 1.0 ne sont pas pris en charge, le moteur d’exécution renvoie une erreur IllegalOperationError.


Valeur émise
IllegalOperationError — Lorsque SSL version 3.0 (et versions ultérieures) ou TLS version 1.0 (et versions ultérieures) n’est pas pris en charge.
 
SecurityError — Les fichiers SWF locaux et non approuvés ne peuvent pas communiquer avec Internet. Pour contourner ce problème, reclassifiez le fichier SWF en tant que fichier local avec accès au réseau ou en tant que fichier approuvé.
Détails de la méthode

addBinaryChainBuildingCertificate

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 3

Ajoute un certificat X.509 à la chaîne de certificat local que votre système utilise pour la validation du certificat de serveur. Le certificat est temporaire et dure pendant toute la durée de la session.

La validation du certificat de serveur dépend du magasin d’approbation de votre système pour créer et valider la chaîne de certificat. Utilisez cette méthode pour ajouter par programmation d’autres chaînes de certification et ancrages approuvés.

Sous Mac OS, le trousseau du système est le trousseau par défaut utilisé au cours du processus de connexion SSL/TLS. Tous les certificats intermédiaires dans ce trousseau sont inclus lors de la construction de la chaîne de certification.

Le certificat que vous ajoutez avec cette API doit être un certificat X.509 codé en DER. Si le paramètre trusted est défini sur true, le certificat que vous ajoutez avec cette API est considéré comme un ancrage approuvé.

Pour plus d’informations sur les certificats X.509, voir RFC2459.

Paramètres

certificate:ByteArray — Objet ByteArray contenant un certificat numérique X.509 codé en DER.
 
trusted:Boolean — Défini sur true pour désigner ce certificat comme ancre de confiance.


Valeur émise
ArgumentError — Lorsque le certificat ne peut pas être ajouté.

connect

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Connecte le socket à l’hôte et au port spécifiés à l’aide du protocole SSL ou TLS.

Lorsque vous appelez la méthode SecureSocket.connect(), le socket tente une connexion SSL/TLS avec le serveur. Si la connexion est établie, le socket tente de valider le certificat du serveur. Si le certificat est validé et approuvé, la connexion socket sécurisée est établie et le socket distribue un événement connect. Si la connexion échoue ou s’il est impossible de valider le certificat, le socket distribue un événement IOError. Vous pouvez vérifier les résultats de validation du certificat en lisant la propriété serverCertificateStatus après la distribution de l’événement IOError. (Lorsqu’un événement connect est distribué, l’état du certificat est toujours approuvé.)

Si le socket était déjà connecté, la connexion existante est d’abord fermée.

Paramètres

host:String — Nom ou adresse IP de l’hôte auquel la connexion doit être établie.
 
port:int — Numéro du port auquel établir la connexion.


Evénements
connect:Event — Distribué lorsqu’une connexion réseau est établie.
 
ioError:IOErrorEvent — Distribué lorsqu’un hôte est spécifié et qu’il se produit une erreur d’entrée/sortie entraînant l’échec de la connexion. Il peut s’agir d’erreurs de communication SSL/TLS et de tout échec de validation du certificat de serveur de l’hôte.
 
securityError:SecurityErrorEvent — Distribué si un appel à Socket.connect() tente de se connecter à un serveur qui ne fournit pas de fichier de régulation de socket ou à un serveur dont le fichier de régulation n’accorde pas à l’hôte appelant l’accès au port spécifié. Pour plus d’informations sur les fichiers de régulation, voir la rubrique « Contrôles de site Web (fichiers de régulation) » dans le Guide du développeur d’ActionScript 3.0 , ainsi que la rubrique Sécurité du Pôle de développement Flash Player (disponible en anglais uniquement).

Valeur émise
IOError — Lorsque vous ne spécifiez pas d’hôte et que la connexion échoue.
 
SecurityError — Lorsque vous spécifiez un port de socket inférieur à zéro ou supérieur à 65535.
Détails de l’événement

close

Evénement
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CLOSE

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Distribué lorsque le serveur ferme la connexion socket.

L’événement close se produit uniquement lorsque le serveur ferme la connexion. Il n’est pas distribué lorsque vous appelez la méthode Socket.close().

La constante Event.CLOSE définit la valeur de la propriété type d’un objet événement close.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet dont la connexion a été fermée.

connect

Evénement  
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CONNECT

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Distribué lorsqu’une connexion réseau est établie.

La constante Event.CONNECT définit la valeur de la propriété type d’un objet événement connect.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet Socket ou XMLSocket qui a établi une connexion réseau.

ioError

Evénement  
Type d’objet d’événement: flash.events.IOErrorEvent
propriété IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Distribué lorsqu’il se produit une erreur d’entrée ou de sortie entraînant l’échec d’une opération d’envoi ou de réception.

Lorsqu’il s’avère impossible de valider un certificat de serveur, l’événement d’erreur distribué est de type IOError. Dans ce cas, vous pouvez vérifier la propriété serverCertificateStatus pour déterminer la cause du problème.

Définit la valeur de la propriété type d’un objet d’événement ioError.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
errorIDUn numéro de référence associé à l’erreur spécifique (AIR uniquement).
targetObjet réseau sur lequel l’erreur d’entrée/sortie s’est produite.
textTexte à afficher en tant que message d’erreur.

securityError

Evénement  
Type d’objet d’événement: flash.events.SecurityErrorEvent
propriété SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Distribué lorsqu’un appel à SecureSocket.connect() échoue en raison d’une restriction de sécurité.

Un événement d’erreur de sécurité est distribué lorsque le code qui s’exécute dans Flash Player ou dans AIR à l’extérieur du sandbox de sécurité de l’application tente d’établir une connexion à un serveur dans un domaine différent ou sur un port inférieur à 1024, et que le serveur ne fournit pas de fichier de régulation autorisant la connexion. Notez que le code qui s’exécute dans le sandbox de l’application AIR peut se connecter à un serveur à n’importe quel domaine et sur les ports inférieurs à 1024 sans un fichier de régulation.

La constante SecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau signalant l’erreur de sécurité
textTexte à afficher en tant que message d’erreur.

Eléments de l’API associés

socketData

Evénement  
Type d’objet d’événement: flash.events.ProgressEvent
propriété ProgressEvent.type = flash.events.ProgressEvent.SOCKET_DATA

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 2

Distribué lorsqu’un socket a reçu des données. Les événements de type socketData n’utilisent pas la propriété ProgressEvent.bytesTotal.

Définit la valeur de la propriété type d’un objet événement socketData.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetObjet qui traite activement l’événement.
bytesLoadedNombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur.
bytesTotal0 ; cette propriété n’est pas utilisée par les objets événement socketData.
targetSocket indiquant la progression.
SecureSocketExample.as

L’exemple suivant explique comment créer et connecter un objet 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 );
        }
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.