El campo permissions en el app manifest controla el acceso a varias APIs sensibles dentro del dispositivo (a veces llamadas WebAPIs). Los permisos están descritos en las tablas siguientes.
Las aplicaciones privilegiadas (privileged) tienen todos los permisos de las aplicaciones alojadas (hosted) más algunos más. Las aplicaciones certificadas (certified) tienen todos los permisos de las privilegiadas y alojadas y algunos más aún. Para más información de los tipos de aplicación puedes consultar los tipos de aplicaciones empaquetadas.
Permisos de las aplicaciones alojadas y privilegiadas
| Permiso en manifest | Nombre de la API | Descripción | Tipo de aplicación requerido | propiedad access |
Por defecto | Plataforma |
|---|---|---|---|---|---|---|
alarms |
Alarm | Programar una notificacion o programar que una aplicacion se inicie. | hosted | ninguna | Allow |
FxOS |
audio-channel-normal |
Audio Policy | Sonidos de la interfaz, contenido web, musica, radio. | hosted | ninguna | Allow |
FxOS |
audio-channel-content |
Audio Policy | Musica, video. | hosted | ninguna | Allow |
FxOS |
audio-channel-alarm |
Audio Policy | Reloj-alarma, alarmas de calendario. | privileged | ninguna | Allow |
FxOS |
audio-channel-notification |
Audio Policy | Nuevo email, SMS. | privileged | ninguna | Allow |
FxOS |
browser |
Browser | Permite a la app implementar un navegador en un iframe iframe. |
privileged | ninguna | Allow |
FxOS |
contacts |
Contacts | Añadir, leer o modificar contactos de la lista de contactos del telefono y leer los contactos desde la SIM. | privileged | readonly, readwrite, readcreate, o createonly |
Allow |
FxOS |
desktop-notification |
Desktop Notification | Muestra una notificacion en el escritorio del usuario. | hosted | ninguna | Prompt for Web content. Allow for all installed App types. |
FxOS, Android |
device-storage:music |
Device Storage | Añade, lee o modifica archivos de musica guardados en el dispositivo. | privileged | readonly, readwrite, readcreate o createonly |
Prompt |
FxOS |
device-storage:pictures |
Device Storage | Añade, lee o modifica archivos guardados en el dispositivo. | privileged | readonly, readwrite, readcreate o createonly |
Prompt |
FxOS |
device-storage:videos |
Device Storage | Añade, lee o modifica archivos de video guardados en el dispositivo. | privileged | readonly, readwrite, readcreate o createonly |
Prompt |
FxOS |
device-storage:sdcard |
Device Storage | Añade, lee o modifica archivos guardados en la tarjeta de memoria del dispositivo. | privileged | readonly, readwrite, readcreate, o createonly |
Prompt |
FxOS |
fmradio |
FM Radio | Controla la radio FM. | hosted | ninguna | Allow |
FxOS |
geolocation |
Geolocation | Obtiene la localizacion del usuario. | hosted | ninguna | Prompt (even for certified Apps) |
FxOS, Desktop, Android |
storage |
Storage | Utilizar almacenamiento (appcache, pinned apps, IndexedDB) sin limites. Ver appcache, IndexedDB. | hosted | ninguna | Allow |
FxOS |
systemXHR |
SystemXHR | Permite cross-origin XHR anonimossin que el sitio de destino tenga activado CORS. Similar a el TCP Socket API pero restringido a XHR, no solo raw sockets, por lo que conlleva menos riesgo. Ver XMLHttpRequest. | privileged | ninguna | Allow |
FxOS |
tcp-socket |
TCP Socket | Crea TCP sockets y se comunica a traves de ellos. | privileged | ninguna | Allow |
FxOS |
Permisos de las aplicaciones certificadas
Los siguientes permisos reuieren una aplicación certificada y están incluidos en lla sin alertar al usuario desde la propia aplicación. La mayoría de desarrolladores no tendrán permitido crear este tipo de aplicaciones, ya que están pensadas para aplicaciones propias del sistema.
| Permiso en manifest | Nombre de la API | Descripción | Tipo de aplicación requerido | propiedad access |
Plataforma |
|---|---|---|---|---|---|
attention |
Attention Screen | Permite abrir una ventana delante de cualquier otro contenido. Usado para el telefono y SMS. | certified | ninguna | FxOS |
audio-channel-ringer |
Audio Policy | Llamadas de telefono entrantes. | certified | ninguna | FxOS |
audio-channel-telephony |
Audio Policy | Llamadas de telefono, llamadas VoIP. | certified | ninguna | FxOS |
audio-channel-publicnotification |
Audio Policy | Fuerza el sonido de la camera. | certified | ninguna | FxOS |
background-sensors |
Background Sensor | Abilidad para escuchar sensores de proximidad en el background. (Todas las aplicaciones reciven estos eventos en el foreground.) | certified | ninguna | FxOS |
backgroundservice |
Background Services | Permite a la app ejecutarse en el background y realizar tareas como la sincronizacion o responder mensajes entrantes. | certified | ninguna | FxOS |
bluetooth |
Acceso de bajo nivel al Bluetooth. | certified | ninguna | FxOS | |
camera |
Camera |
TOmar fotos, video y controlar la camara. Note: La razon por la que la camara tiene el acceso limitado a las aplicaciones certificadas es para prevenir el acceso al hardware de la camara. El objetivo es ponerlo a disposicion de las aplicaciones de tercerlos lo antes posible, pero no ha habido tiempo para poder hacerlo para el lanzamiento inicial. |
certified | ninguna | FxOS |
cellbroadcast |
Lanza un evento cuando un tipo especifico de mensaje de la red telefonica es recibido (mensajes de emergencia de la red). | certified | ninguna | FxOS | |
device-storage:apps |
Device Storage | Añadir, leer o modificar archivos guardados en la carpeta de aplicaciones del dispositivo. | certified | read |
FxOS |
embed-apps |
Embed Apps | Abilidad de incluir apps en frames mozApp. |
certified | ninguna | FxOS |
idle |
Idle | Notifica a la aplicacion si el usuario esta ausente. | certified | ninguna | FxOS |
keyboard |
Keyboard | Permite a la aplicacion actuar como un teclado virtual escuchando los eventos "focus" en otras aplicaciones. | certified | ninguna | FxOS |
mobileconnection |
Mobile Connection | obtener informacion sobre el telefono movil y la red de datos. | certified | ninguna | FxOS |
network-events |
Network Events | Monitorea las subidas y descargas de la red. | certified | ninguna | FxOS |
networkstats-manage |
Network Stats Manage | Obtiene estadisticas del uso de datos por interfaz. | certified | ninguna | FxOS |
open-remote-window |
Open out-of-process windows | Permite llamadas window.open, pero la ventana es abierta en un nuevo proceso. |
certified | ninguna | FxOS |
permissions |
Permissions | Permite a una app cambiar los permisos de otras apps. | certified | ninguna | FxOS |
power |
Power Management | Apaga y enciende la pantalla, controla la CPU, enciennde y apaga el dispositivo. Escucha e inspeciona los eventos que consumen energia. | certified | ninguna | FxOS |
settings |
Settings | Configura o lee las preferencias del dispositivo. | certified | readonly o readwrite |
FxOS |
sms |
WebSMS | Envia y recibe mensajes SMS. | certified | ninguna | FxOS |
telephony |
WebTelephony | Accede a todas las funciones relacionadas con el telefono para hacer y recibir llamadas. | certified | ninguna | FxOS |
time |
TimeManager | Aplica el tiempo actual. La informacion de la zona es controlada por la API de preferencias. Llamada formalmente systemclock. |
certified | ninguna | FxOS |
voicemail |
Voicemail | Accede al buzon de voz. | certified | ninguna | FxOS |
webapps-manage |
Open Webapps | Obtiene acceso a la API navigator.mozApps.mgmt para gestionar las apps instaladas. |
certified | ninguna | FxOS, Desktop, Android |
wifi-manage |
WiFi Management | Enumera las redes Wifi disponibles, obtiene la fuerza de la señal y se conecta a la red. | certified | ninguna | FxOS |
See also
La tabla de permisos es donde los permisos están definidos en el código de Firefox.
Muchas de esas APIs están en proceso y otras serán implementadas en el futuro. Para más nformación en el trabajo en proceso puedes visitar WebAPI page on MozillaWiki.