Restriction des API de réseau

Vous pouvez contrôler l'accès d'un fichier SWF aux fonctionnalités réseau en définissant le paramètre allowNetworking dans les balises <object> et <embed> de la page HTML qui accueille le contenu SWF.

allowNetworking peut prendre les valeurs suivantes :

"all" (par défaut) : toutes les API de réseau sont autorisées dans le fichier SWF.
"internal" : le fichier SWF ne peut pas appeler les API de navigation et d'interaction avec le navigateur (présentées plus loin dans cette section). Il peut cependant appeler toutes les autres API de réseau.
"none" : le fichier SWF file ne peut pas appeler les API de navigation et d'interaction avec le navigateur (présentées plus loin dans cette section) ni utiliser les API de communication entre fichiers SWF (également décrites plus loin).

L'appel d'une API interdite renvoie une exception SecurityError.

La définition du paramètre allowNetworking s'effectue dans les balises <object> et <embed> de la page HTML qui contient la référence au fichier SWF. Pour ce faire, ajoutez le paramètre allowNetworking aux balises et définissez sa valeur, comme illustré ci-après :

<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
 codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,18,0" 
 width="600" height="400" id="test" align="middle">
<param name="allowNetworking" value="none" />
<param name="movie" value="test.swf" />
<param name="bgcolor" value="#333333" />
<embed src="test.swf" allowNetworking="none" bgcolor="#333333" 
    width="600" height="400"  
    name="test" align="middle" type="application/x-shockwave-flash"   
    pluginspage="http://www.macromedia.com/go/getflashplayer" />
</object>

Une page HTML peut également générer des balises d'incorporation SWF à l'aide d'un script. Vous devez modifier le script de manière qu'il insère les paramètres allowNetworking appropriés. Les pages HTML générées par Flash et Adobe Flex Builder utilisent la fonction AC_FL_RunContent() pour incorporer des références aux fichiers SWF. Vous devez ajouter les paramètres allowNetworking au script, comme illustré ci-après :

AC_FL_RunContent( ... "allowNetworking", "none", ...)

Les API suivantes sont interdites lorsque allowNetworking est défini sur "internal" :

navigateToURL()
fscommand()
ExternalInterface.call()

Outre les API listées ci-dessus, les API ci-après sont également interdites lorsque allowNetworking a la valeur "none" :

sendToURL()
FileReference.download()
FileReference.upload()
Loader.load()
LocalConnection.connect()
LocalConnection.send()
NetConnection.connect()
NetStream.play()
Security.loadPolicyFile()
SharedObject.getLocal()
SharedObject.getRemote()
Socket.connect()
Sound.load()
URLLoader.load()
URLStream.load()
XMLSocket.connect()

Même si le paramètre allowNetworking sélectionné permet au fichier SWF d'utiliser une API de réseau, d'autres restrictions peuvent survenir en fonction des limites fixées par le sandbox de sécurité, comme décrit dans ce chapitre.

Si allowNetworking est défini sur "none", vous ne pouvez pas référencer un média externe dans une balise <img> de la propriété htmlText d'un objet TextField (si vous le faites, une exception SecurityError est renvoyée).

Si allowNetworking est défini sur "none", un symbole issu d'une bibliothèque partagée importée dans l'outil de programmation Flash (pas ActionScript) est bloqué lors de l'exécution.

Flash CS3

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/main/00000351.html