Documentación de Flash CS3

Programación con ActionScript 3.0 > Seguridad de Flash Player > Restricción de las API de red

Restricción de las API de red

Se puede controlar el acceso de un archivo SWF a la funcionalidad de red estableciendo el parámetro allowNetworking en las etiquetas <object> y <embed> de la página HTML que contiene el SWF.

Los valores posibles de allowNetworking son:

• "all" (valor predeterminado): se admiten todas las API de red en el archivo SWF.
• "internal": el archivo SWF no puede llamar a las API de navegación o de interacción con el navegador que se muestran a continuación, pero puede llamar a las otras API de red.
• "none": el archivo SWF no puede llamar a ninguna de las API de navegación o de interacción con el navegador que se muestran a continuación, y no puede usar ninguna de las API de comunicación entre archivos SWF, incluidas también en la lista siguiente.

Al llamar a una API no permitida, se emite una excepción SecurityError.

Para configurar el parámetro allowNetworking, añada el parámetro allowNetworking a las etiquetas <object> y <embed> de la página HTML que contiene una referencia al archivo SWF y establezca su valor, como se indica en el siguiente ejemplo:

<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>

Una página HTML también puede utilizar un script para generar etiquetas de incorporación de SWF. Es necesario modificar el script para insertar la configuración adecuada de allowNetworking. Las páginas HTML generadas por Flash y Adobe Flex Builder utilizan la función AC_FL_RunContent() para incorporar referencias a archivos SWF y es necesario añadir la configuración del parámetro allowNetworking al script, como en el siguiente ejemplo:

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

Las siguientes API no se admiten cuando el valor de allowNetworking es "internal":

• navigateToURL()
• fscommand()
• ExternalInterface.call()

Además de las API anteriores, no se admiten las siguientes API cuando el valor de allowNetworking es "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()

Aunque la configuración de allowNetworking seleccionada permita a un archivo SWF usar una API de red, puede haber otras restricciones basadas en las limitaciones de un entorno limitado de seguridad, como se explica en este capítulo.

Cuando allowNetworking se establece en "none", no se puede hacer referencia a medios externos en una etiqueta <img> en la propiedad htmlText de un objeto TextField (se emite una excepción SecurityError).

Si se establece allowNetworking en "none", un símbolo de una biblioteca compartida importada añadido en la herramienta de edición Flash (no mediante ActionScript) se bloqueará en tiempo de ejecución.

Flash CS3

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/main/00000351.html

Añadir comentario