Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Sicherheit
Der Parameter allowNetworking wird vor allem dann verwendet, wenn die SWF-Datei und die zugehörige HTML-
Seite von unterschiedlichen Domänen stammen. Die Werte „internal" und „none" sollten nicht verwendet werden,
wenn die geladene SWF-Datei aus der gleichen Domäne wie die zugehörigen HTML-Seiten stammen, da Sie nicht
sicherstellen können, dass eine SWF-Datei immer mit der gewünschten HTML-Seite geladen wird. Nicht
vertrauenswürdige Parteien könnten in diesem Fall eine SWF-Datei ohne die zugehörige HTML-Seite laden, sodass
die allowNetworking-Einschränkung nicht mehr wie gewünscht greift.
Der Aufruf einer gesperrten API löst eine SecurityError-Ausnahme aus.
Fügen Sie den Parameter allowNetworking hinzu und legen Sie dessen Wert in den Tags und auf
der HTML-Seite fest, die einen Verweis auf die SWF-Datei enthält. Dies wird im folgenden Beispiel gezeigt:
Eine HTML-Seite kann auch ein Skript verwenden, um SWF-eingebettete Tags zu erzeugen. Sie müssen das Skript
ändern, damit die richtigen allowNetworking-Einstellungen eingefügt werden. Von Adobe Flash Professional und
Adobe Flash Builder generierte HTML-Seiten verwenden die AC_FL_RunContent()-Funktion, um Verweise auf
SWF-Dateien einzubetten. Fügen Sie dem Skript die Einstellungen für den allowNetworking-Parameter hinzu wie
im Folgenden:
AC_FL_RunContent( ... "allowNetworking", "none", ...)
Die folgenden APIs werden gesperrt, wenn allowNetworking auf internal festgelegt ist:
navigateToURL(), fscommand(), ExternalInterface.call()
Zusätzlich zu den oben aufgeführten APIs werden die folgenden APIs gesperrt, wenn allowNetworking auf none
gesetzt ist:
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()
Auch wenn die ausgewählte allowNetworking-Einstellung einer SWF-Datei die Verwendung einer Netzwerk-API
gestattet, können andere Beschränkungen basierend auf den Einschränkungen der Sicherheits-Sandbox gelten (siehe
„Sicherheits-Sandboxen“ auf Seite 1103).
Ist allowNetworking auf none eingestellt, können Sie in einem -Tag in der Eigenschaft htmlText eines
TextField-Objekts nicht auf externe Medien verweisen (es wird eine SecurityError-Ausnahme ausgelöst).
Wenn allowNetworking auf none festgelegt ist, wird ein Symbol, das aus einer importierten freigegebenen Bibliothek
in Flash Professional (nicht ActionScript) hinzugefügt wurde, zur Laufzeit gesperrt.
Letzte Aktualisierung 27.6.2012
1118