Firefox OS includes new APIs which provide Open Web Apps access to a range of native device capabilities, such as access to cameras, bluetooth, network connections and other APIs not previously exposed to the Web. A variety of security mechanisms have also been introduced to increase the trustworthiness of apps to the point where they can be trusted with these new APIs. The key Open Web App security controls are:
- Apps are explicitly installed and launched, rather than being casually navigated to in a browser. Apps must be installed prior to use, and security controls govern the update and removal of apps to protect the user.
- Access to new Web APIs is controlled by a permissions system, where an app must declare the permissions it intends to use prior to installation. In order to gain access to more powerful APIs, apps must meet certain requirements and be reviewed, approved, and signed by a marketplace such as the Firefox Marketplace.
- Apps are sandboxed so they can only see their own resources (cookies, offline storage, IndexedDB databases, and so on). Even if two apps happen to load a page with the same URL, these two pages are not considered same-origin because they are running inside separate apps.
Application Types & Lifecycle
The table below summarizes the different types of Open Web Apps and describes the format, installation, and update process.
|Web||Hosted or Packaged||Less-sensitive permissions that are not dangerous to expose to unvalidated Web content||Installed from anywhere||Can be updated transparently to the user or explicitly through a marketplace, depending on where the app was installed from, and the delivery mechanism.|
|Privileged||Packaged||Privileged APIs which require validation and authentication of the app||Installed from a trusted marketplace||Updated via a trusted marketplace, user prompted to approve download and installation of updates.|
|Certified||Packaged||Powerful and dangerous APIs which are not available to third-party apps.||Pre-installed on the device||Updated only as part of system level updates.|
Firefox OS supports three types of apps: web, privileged, and certified. An app's type is declared in its manifest, and determines the list of permissions it may request.
- Web Apps: Most third-party apps will be "Web" Apps, which is the default type, and doesn't grant the App any additional permissions besides those already exposed to the web. Web Apps can be installed from any website, without any further verification, but as a
- Privileged Apps: These Apps are allowed to request increased permissions, and as such Privileged Apps must be verified and signed by a Marketplace
- Certified Apps: Certified Apps can currently only be pre-installed on the device.
Apps can be delivered by two different mechanisms: hosted or packaged.
A hosted app consists solely of an application manifest file on the developer's Web server. Often the manifest will also point to an appcache manifest which allows an app to be cached for faster startup and to enable offline usage, but otherwise doesn't affect the app at all. From a security point of view, hosted apps work very much like normal websites. When a hosted app is loaded, the URL of the loaded pages are the normal URLs that those pages have on their web server. So to link to a specific page or resource in the app, the same URL is used as when linking to that page or URL on the website.
- Hosted apps: Hosted apps are installed by calling
manifestURLis a URL that specifies the location of the app. For further details, see Installing Apps.
- Packaged apps: For packaged apps, the main application manifest is stored inside the package itself, so that it can be signed. There is a second "mini-manifest" that is used to start the installation and update process on the marketplace. See Installing Packaged Apps and Packaged apps for more information.
In order to secure an app wants to be installed, we have to ensure that it's not possible to trick a website into hosting an application manifest. This is done by requiring that the manifest is served with a specific mime-type,
application/x-web-app-manifest+json. This restriction is relaxed when the manifest file, and thus the app manifest, is same-origin with the page that requested the app to be installed.
The update process for apps is described in Updating apps.
Apps may be granted additional privileges on top of the ones granted to normal websites. By default an application has no permissions on top of the ones normal webpages have. An app can request additional permissions by enumerating the permissions in its manifest. Enumerating a permission does not guarantee that an app will be granted the permission. The Web runtime may decide to not grant access.
For each additional permission that an app wants, the manifest has to explicitly enumerate that permission along with a human-readable description of why the app wants that permission. This description will be used at various points in the device UI, and is also used when the app is reviewed. For further detail on manifests, see App manifest.
Web app sandbox
Data stored per app
Each appl runs in a separate sandbox, meaning that all data stored by an app is separate from all data stored by another app. This includes things like cookie data, localStorage data, indexedDB data, and site permissions.
This means that if the user has two apps installed, app A and app B, these apps will have completely different sets of cookies, different local data, and different permissions. This even applies if both of these apps open an
<iframe> that points to the same origin. For example, if both app A and app B open an
<iframe> pointing to "http://www.mozilla.org", they will both render the website, however the website will be fetched and rendered with different cookies in the two apps.
A result of this is that if the user logs in to Facebook, for example, while using app A, this in no way affects app B's ability to interact with the user's account on Facebook. The login cookie that Facebook sets when the user logs in using app A is only available in app A. If app B open an
<iframe> to Facebook, the cookie wouldn't be there and so when app B opens Facebook, it receives the Facebook login page rather than the user's account.
Apps can't open each other
This means that apps can't open other apps by using
<iframe>s. If app A creates an <iframe> with
src set to the URL of app B, this won't actually open app B in the
<iframe>. It will simply open the website located at that URL. It will not use any of app B's cookies and so it will behave no differently than if app B wasn't installed on the user's device.
This applies even for packaged apps (more about them below). App A may not open packaged app B using an
<iframe> pointing to the
app:// URL of app B under normal circumstances. Web content also may not access
app:// URLs. Attempting to access an
app:// URL from Web content or without the proper permssion will fail and return an error. And App A can access contents of app B if app A has the
webapps-manage permission which is only available to certified apps.
The same thing happens if the top-level frame of app A is navigated to a URL for app B. We always know for a given frame which app is opened in it, and so when attempting to load the app B URL in the app A frame, this will behave exactly like the two situations described above. That is, in no way will app B's resources, like cookies or other local data, be used.
There are both benefits and downsides to this approach. The downside is that if the user interacts with the same website through several apps, he or she will have to log in in every app. Likewise, if a website wants to store data locally, and the user interacts with this website in several apps, the data will end up getting duplicated in each app, which could be a problem if it's a large amount of data.
The main benefit of this approach is that it's a more stable model. There is no way that several apps could interact with each other through a third-party website in unexpected ways such that installing an app causes another app to stop working. When an app is uninstalled there is no way that data for another app could be lost, or that another app will stop working due to functional dependence of the uninstalled app.
There are also large security benefits. A user can safely use his AwesomeSocial app to log in to Facebook without having to worry that the SketchGame app can mount any types of attack for getting at the user's Facebook data by exploiting bugs or other shortcomings in the Facebook website.
There are also good privacy benefits. The user can safely install the PoliticalPartyPlus app without having to worry that MegaCorpEmployee app will be able to detect that the app was installed or what data it has created.
And just like website data is sandboxed per app, so are permission grants. If app A loads a page from http://maps.google.com and that page requests to use geolocation and the user says "yes and remember this decision for all times," this only means that http://maps.google.com has access to geolocation within app A. If app B then opens http://maps.google.com, that page won't have access to geolocation unless the user grants that permission again for app B.
And just like in the normal browser, permissions are separated by origin. This means that if app A is granted permission to use geolocation, this does not mean that all origins running in app A have the permission to use geolocation. If app A opens an
<iframe> to http://maps.google.com, then http://maps.google.com still has to ask the user for permission before geolocation access is granted.
Browser API sandbox
To additionally secure applications that open a large set of URLs, such as browsers, we have added a browserContent flag. The browserContent flag allows each app to have not one, but two sandboxes, one for the app itself, and one for any Web content that it opens. For example, say that the MyBrowser app is loaded from the https://mybrowser.com domain. This is the domain where the scripts and resources are loaded within. The scripts and resources belong to this domain.
Now, if a page in this app creates an
<iframe mozbrowser>, a different sandbox is created and used for this
<iframe>, which is different from the sandbox used by the app. That is, if this iframe is navigated to https://mybrowser.com, it will result in different cookies being used inside the
<iframe mozbrowser>. Likewise, the contents inside the
<iframe mozbrowser> will see different IndexedDB and localStorage databases from the ones opened by the app.
This also applies if the MyBrowser app wants to create integration with, for example, Google maps, to implement location-based browsing. If the app opens an
<iframe> to http://maps.google.com, that will open an iframe which will receive a set of cookies for the http://maps.google.com website. If the user then navigates inside Web content area, that is, inside the
<iframe mozbrowser>, to http://maps.google.com, this will use different cookies and different permissions than the top level app.
Another example where this is useful is in a Yelp-like app. Yelp has the ability to visit a restaurant's website directly in the app. By using
<iframe mozbrowser> to open the restaurant website, the Yelp app ensures that the restaurant website can't contain an
<iframe> pointing back to Yelp's app (which points to http://yelp.com). If it does, the website will only receive the Yelp website, rather than the Yelp app. So there is no way that the restaurant website can mount an attack against the app since the contained Yelp website won't share any permissions or data with the Yelp app.
App malware threat model
|App type||Signing||Privilege level||defaultCSP||Install path||Queries||Risk||Mitigation|
|Certified||signed||full API||yes||firmware image||none||low||reviews, firmware updates|
|signed or unsigned||sideloading||high||sideload restriction, gonk-level cleanup|
|Packaged||signed||whitelisted API||yes||Marketplace||Marketplace||none||Marketplace||medium||reviews, updates, gonk-level cleanup|
|signed or unsigned||sideloading||none||none?||high||sideload restriction, gonk-level cleanup|
|signed||Web API||no||Marketplace||Marketplace||Marketplace||low||reviews, Marketplace updates, gonk-level cleanup|
|signed or unsigned||sideloading||none||none?||medium||sideload restriction, gonk-level cleanup|
|unsigned||Web API||no||download URI||download URI||none||none?||low||Safe Browsing for URI|
|Hosted/Web||unsigned||Web API||no||Marketplace||Marketplace||Web app URI||Marketplace||low||reviews, Marketplace updates, Safe-browsing for app URI|
|download URI||download URI||none?||medium||Safe Browsing for download and app URI|
|sideloading||none||none?||low||sideload restriction, Safe Browsing for app URI|