Programmation croisée

Si deux fichiers SWF écrits en ActionScript 3.0 sont servis à partir d'un même domaine (par exemple l'URL de l'un est http://www.example.com/swfA.swf et celle de l'autre est http://www.example.com/swfB.swf), alors l'un des fichiers SWF peut examiner et modifier les variables, objets, propriétés, méthodes, etc. de l'autre fichier, et inversement. On parle de programmation croisée.

La programmation croisée n'est pas prise en charge entre les fichiers SWF AVM1 et AVM2. Un fichier SWF AVM1 est un fichier créé avec ActionScript 1.0 ou ActionScript 2.0. (AVM1 et AVM2 font référence à la machine virtuelle ActionScript.) Vous pouvez néanmoins utiliser la classe LocalConnection pour échanger des données entre AVM1 et AVM2.

Si deux fichiers SWF écrits en ActionScript 3.0 sont servis à partir de domaines différents (par exemple http://siteA.com/swfA.swf et http://siteB.com/swfB.swf), par défaut Flash Player ne permet pas la programmation entre swfA.swf et script swfB.swf, et inversement. Pour autoriser l'accès à des fichiers SWF issus d'autres domaines, un fichier SWF doit appeler Security.allowDomain(). Ainsi, en appelant Security.allowDomain("siteA.com"), swfB.swf accepte la programmation en provenance des fichiers SWF de siteA.com.

Dans toute situation interdomaine, il est important de définir clairement les deux parties impliquées. Dans le cadre de cette étude, le fichier effectuant la programmation croisée sera appelé partie procédant à l'accès (habituellement le fichier SWF procédant à l'accès), et l'autre côté sera appelé partie cible (généralement le fichier SWF cible). Lorsque siteA.swf programme siteB.swf, siteA.swf est la partie procédant à l'accès et site.B.swf la partie cible, comme le montre l'illustration suivante :

Schéma illustrant une hypothèse de scénario de chargement : siteA.com/swfA.swf charge siteB.com/swfB.swf. swfB autorise l'accès de siteA.com à l'aide de Security.allowDomain(), donc swfA.swf programme swfB.swf.

Les autorisations interdomaine établies avec Security.allowDomain() sont asymétriques. Dans l'exemple ci-avant, siteA.swf peut programmer siteB.swf mais l'inverse n'est pas possible car siteA.swf n'a pas appelé la méthode Security.allowDomain() pour autoriser les fichiers SWF de siteB.com à le programmer. Vous pouvez définir des autorisations symétriques si les deux fichiers SWF appellent la méthode Security.allowDomain().

Outre la protection des fichiers SWF contre les scripts interdomaine provenant d'autres fichiers SWF, Flash Player protège également les fichiers SWF contre ce type de script provenant des fichiers HTML. La programmation HTML vers SWF est possible au moyen de rappel effectué avec la méthode ExternalInterface.addCallback(). Lorsque la programmation HTML vers SWF franchit les limites du domaine, le SWF cible doit également appeler Security.allowDomain(), comme s'il avait été appelé par un fichier SWF, faute de quoi l'opération échoue. Pour plus d'informations, voir Contrôles de création (développeur).

Flash Player fournit en outre des contrôles de sécurité spécifiques à la programmation SWF vers HTML. Pour plus d'informations, voir Contrôle de l'accès aux scripts dans une page Web hôte.

Sous-rubriques

sécurité de la scène

Parcours de la liste d'affichage

Sécurité d'événements

sécurité de la scène

Certaines propriétés et méthodes de l'objet Stage sont disponibles pour tout sprite ou clip de la liste d'affichage.

On dit cependant de l'objet Stage qu'il a un propriétaire : le fichier SWF chargé. Par défaut, les propriétés et méthodes suivantes de l'objet Stage sont uniquement disponibles pour les fichiers SWF du même sandbox de sécurité que le propriétaire de l'objet Stage :

Propriétés		Méthodes
`align`	`showDefaultContextMenu`	`addChild()`
displayState	`stageFocusRect`	`addChildAt()`
frameRate	`stageHeight`	`addEventListener()`
`height`	`stageWidth`	`dispatchEvent()`
`mouseChildren`	`tabChildren`	`hasEventListener()`
`numChildren`	`textSnapshot`	`setChildIndex()`
`quality`	`width`	`willTrigger()`
`scaleMode`

Pour qu'un fichier SWF d'un sandbox différent de celui du propriétaire de l'objet Stage puisse accéder à ces propriétés et méthodes, le fichier SWF propriétaire de l'objet Stage doit appeler la méthode Security.allowDomain(). Pour plus d'informations, voir Contrôles de création (développeur).

La propriété frameRate est un cas à part : tout fichier SWF peut lire la propriété frameRate. Toutefois, seuls les fichiers situés dans le sandbox de sécurité du propriétaire de l'objet Stage (ou ceux qui ont été autorisés à l'aide de la méthode Security.allowDomain()) peuvent modifier cette propriété.

Il existe également des restrictions sur les méthodes removeChildAt() et swapChildrenAt(), mais ce sont des restrictions différentes des autres. Pour appeler ces méthodes, le code ne doit pas se trouver dans le même domaine que le propriétaire de l'objet Stage mais dans le même domaine que le ou les objets enfant concernés ; ou le ou les objets enfant doivent appeler la méthode Security.allowDomain().

Parcours de la liste d'affichage

La capacité d'un fichier SWF d'accéder aux objets d'affichage chargés à partir d'autres sandboxes fait l'objet de restrictions. Pour qu'un fichier SWF puisse accéder à un objet d'affichage créé par un autre fichier SWF dans un sandbox différent, le fichier SWF cible doit appeler la méthode Security.allowDomain() pour autoriser l'accès du domaine du fichier SWF procédant à l'appel. Pour plus d'informations, voir Contrôles de création (développeur).

Pour accéder à un objet Bitmap chargé par un objet Loader, il faut qu'un fichier de régulation inter-domaines existe sur le serveur d'origine du fichier image et que ce fichier accorde une autorisation au domaine du fichier SWF qui essaie d'accéder à l'objet Bitmap (voir Contrôles de site Web (fichiers de régulation interdomaine)).

L'objet LoaderInfo qui correspond au fichier chargé (et à l'objet Loader) inclut les trois propriétés suivantes, qui définissent la relation entre l'objet chargé et l'objet Loader : childAllowsParent, parentAllowsChild et sameDomain.

Sécurité d'événements

Les événements liés à la liste d'affichage sont soumis à des restrictions d'accès de sécurité en fonction du sandbox de l'objet d'affichage qui distribue l'événement. Un événement de la liste d'affichage traverse des phases de capture et de propagation vers le haut (décrites dans le Gestion d'événements). Au cours de ces deux phases un événement passe de l'objet d'affichage source aux objets d'affichage parent dans la liste d'affichage. Si un objet parent appartient à un sandbox de sécurité différent de celui de l'objet d'affichage source, la phase de capture ou de propagation vers le haut s'arrête en dessous de cet objet parent, sauf si une relation de confiance est établie entre le propriétaire de l'objet parent et celui de l'objet source. Cette confiance mutuelle s'établit des manières suivantes :

Le fichier SWF propriétaire de l'objet parent doit appeler la méthode Security.allowDomain() pour approuver le domaine du fichier SWF propriétaire de l'objet source.
Le fichier SWF propriétaire de l'objet source doit appeler la méthode Security.allowDomain() pour approuver le domaine du fichier SWF propriétaire de l'objet parent.

L'objet LoaderInfo qui correspond au fichier chargé (et à l'objet Loader) inclut les deux propriétés suivantes, qui définissent la relation entre l'objet chargé et l'objet Loader : childAllowsParent et parentAllowsChild.

Pour les événements distribués à partir d'objets autres que les objets d'affichage, il n'existe aucune vérification de sécurité ni aucune implication liée à la sécurité.

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/00000354.html