XPCNativeWrapper: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
{{extdev}}
XPCNativeWrapper is a Javascript object that should be used whenever privileged code is used to access unprivileged code. It is used to create a security wrapper that is analogous to a sandbox.
XPCNativeWrapper is a Javascript object that should be used whenever privileged code is used to access unprivileged code. It is used to create a security wrapper that is analogous to a sandbox.



Revision as of 09:27, 22 March 2005

This page is part of the extension development documentation project.

Ask your questions in MozillaZine Forums. Also try browsing example code.

Note: development documentation is in process of being moved to Mozilla Development Center (MDC).

XPCNativeWrapper is a Javascript object that should be used whenever privileged code is used to access unprivileged code. It is used to create a security wrapper that is analogous to a sandbox.

Basic Usage

Using XPCNativeWrapper is very simple. You create an instance of an XPCNativeWrapper with the untrusted object as the first parameter and the desired properties and methods of the untrusted object as the additional parameters.

Example

This example creates a wrapper around the document object so that it can safely read the title of the document and call one of its methods:

doc = window._content;
doc2 = new XPCNativeWrapper(doc, 'title', 'getElementsByTagName()');

Notice how the desired properties are specified by their name and the desired methods are specified by their name followed a pair of empty brackets.

The returned object can be used just like the untrusted object. Methods and properties can be called from it directly.

var tt = doc2.title;
var bd = doc2.getElementsByTagName('body')[0];

Attack Scenarios

To illustrate the importance of using XPCNativeWrapper, consider the following scenario:

An extension is written to modify the title property of the document.

document._content.document.title = 'Hello World';

On the surface it looks harmless enough. However, an attacker could execute malicious code if they added a getter to the title property:

document.title getter = function() {
  alert('code executed');  //malicious code...
};

The same analogy applies to calling methods on an untrusted object. Consider the following scenario:

An extension tries to get access to the body element of a document.

var bd = document._content.document.getElementsByTagName('body')[0];

It may also look harmless, but an attacker could execute malicious code if they overwrote the getElementsByTagName method with another:

document.getElementsByTagName = function() {
  alert('code executed');  //malicious code...
};

References

  1. XPCNativeWrapper.js