Autorisations des applications

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Le champs permissions du manifest de l'application gère l'accès de l'application aux différentes API sensibles de l'appreil  (parfois apellées WebAPIs). Les permissions sont détaillées dans le tableau suivant.

En résumé, les trois niveaux de permission sont:

  • Application Web : elles ont seulement un niveau basique de permission, et ne peuvent accèder ni aux API privilegiées ni aux API internes.
  • Application privilegiée: elles ont un peu plus d'accès que le niveau des applications web classiques
  • Application interne (certifiée): elles ont encore plus que l'ensemble des permissions des applications web et privilegiées.

Pour plus d'information concernant les types d'application, consultez les types d'applications empaquetées.

Note: Si vous utilisez le App Manager/WebIDE pour tester votre application, il affichera un  tableau, facile à lire, des permissions autorisées, refusée ou nécessitant un prompt de l'appareil ou du simulateur sur lequel vous êtes connectés.

Autorisations pour les applications hébergées et privilegiées

Nom dans le manifeste Nom de l'API Description Type de l'application requis au minimum Propriété access Autorisé par défaut Plateforme/version supportée
alarms Alarm Plannifier une notification ou le démarrage de l'application. hébérgée aucune Allow FxOS 1.0.1
audio-capture GetUserMedia Obtenir le flux MediaStream des d'entrées audios, e.g. microphone. Nécessaire pour la capture audio dans Firefox OS 1.2+. hébérgée aucune Prompt pour tout les types d'app installés FxOS 1.2 pour Desktop Firefox 20+
audio-channel-alarm AudioChannels Alarme du réveil, alarme du calendrier. privilégiée aucune Allow FxOS 1.0.1
audio-channel-content AudioChannels Musique, vidéo. hébérgée aucune Allow FxOS 1.0.1
audio-channel-normal AudioChannels Son, contenu Web, musique, radio. hébérgée aucune Allow FxOS 1.0.1
audio-channel-notification AudioChannels Nouvel email, SMS entrant. privilégiée aucune Allow FxOS 1.0.1
browser Browser Autorise l'app à lancer un navigateur web dans une iframe. privilégiée aucune Allow FxOS 1.0.1
camera Camera

Prendre des photos, filmer, enregistrer de l'audio, et controler la caméra.

Note: la fonction camera était initialement limitée aux app certifiées à cause de la sécurité sandbox qui bloquait l'accès au matériel. Corrigé depuis Firefox OS 2.0.

privilégiée pour Firefox OS 2.0+ interne/certifiée pour Firefox OS 1.4 (et -)

aucune Prompt pour tout les types d'app installés. FxOS 1.0.1-1.4 certifiée
FxOS 2.0+ privilégiée
contacts Contacts Ajouter, lire et modifier les contacts du carnet d'adresse de l'appareil et lire les contacts de la SIM. privilégiée readonly, readwrite, readcreate, ou createonly Prompt pour tout les types d'app installés FxOS 1.1
Firefox Android 18
desktop-notification mozNotification for Gecko <22, Notification for Gecko 22+ Afficher une notification sur le bureau de l'utilisateur. Note that this has changed, so for Gecko <22 (Firefox OS <1.2) you need to use mozNotification, while for Gecko 22+ (Firefox 1.2+) you need to use Notification. hébérgée aucune Prompt pour le contenu web. Allow pour tout les types d'app installés FxOS 1.0.1, Android 4.0, Desktop 4.0 pour les versions préfixées
FxOS 1.2, Android 22, Desktop 22 pour les versions non-préfixées
device-storage:music Device Storage Ajouter, lire ou modifier les fichiers audios stockés sur l'appareil. privilégiée readonly, readwrite, readcreate, ou createonly Prompt FxOS 1.0.1
device-storage:pictures Device Storage Ajouter, lire ou modifier les fichiers images stockés sur l'appareil. privilégiée readonly, readwrite, readcreate, ou createonly Prompt FxOS 1.0.1
device-storage:sdcard Device Storage Ajouter, lire ou modifier les fichiers  stockés sur la care SD de l'appareil. privilégiée readonly, readwrite, readcreate, ou createonly Prompt FxOS 1.0.1
device-storage:videos Device Storage Ajouter, lire ou modifier les fichiers vidéos stockés sur l'appareil. privilégiée readonly, readwrite, readcreate, ou createonly Prompt FxOS 1.0.1
fmradio FM Radio Contrôler la radio FM. hébérgée aucune Allow FxOS 1.0.1
geolocation Geolocation Obtenir la localisation courante de l'utilisateur. hébérgée aucune Prompt (même pour les apps certifiées) FxOS 1.0.1, Desktop Firefox 3.5, Android 4.0
input Keyboard Autorise l'app à se comporter comme un clavier virtuel en écoutant les événements des autres applications. privilégiée aucune Allow FxOS 1.0.1
mobilenetwork Mobile Network Obtenir les informations du réseau mobile (MCC, MNC, etc.). privilégiée aucune Allow FxOS 1.0.1
push Simple Push Autorise l'app à se réveiller pour recevoir des notifications. hébérgée aucune Allow FxOS 1.1
storage Storage Utiliser le stockage (appcache, pinned apps, IndexedDB)sans restrictions sur la taille. Voir appcache, IndexedDB. hébérgée aucune Allow FxOS 1.0.1,
Desktop (versions early)
systemXHR SystemXHR Autorise l'utilisation anonyme (sans cookies) du cross-origin XHR sans que la cible ai la propriété CORS active. Similaire à l'API de Socket TCP mais limitée à XHR, pas juste aux raw sockets, donc légèrement moins risqué. Voir XMLHttpRequest. privilégiée aucune Allow FxOS 1.0.1
tcp-socket TCP Socket Créer des sockets TCP et communiquer au travers. privilégiée aucune Allow FxOS 1.0.1,
Desktop (versions early)
video-capture GetUserMedia Obtenir le flux MediaStream des entrées vidéo de l'appareil, e.g. camera. Nécessaire à la capture vidéo dans Firefox OS 1.4+. hébérgée aucune Prompt pour tout les types d'app installés FxOS 1.4

Note: Pour déclarer une application comme privilegiée, vous devez ajouter "type" : "privileged" dans votre manifest applicatif. Vous n'avez pas besoin d'inclure cet attribut type pour les applications web, web est la valeur par défaut.

Internal (Certified) app permissions

The following permissions require a internal app and are granted implicitly without prompting the user. Most app developers will not be able to use internal APIs, because they are intended for system-level apps and default apps created by Mozilla/operators/OEMs.

Manifest permission API name Description Minimum app type required access property Platform
attention Attention Screen

Allow content to open a window in front of all other content. Used by telephone and SMS.

Note: Attention screens use the Firefox OS-specific attention feature name when calling window.open().

internal (certified) none FxOS 1.0.1
audio-channel-ringer AudioChannels Incoming phone calls. internal (certified) none FxOS 1.0.1
audio-channel-telephony AudioChannels Phone calls, VoIP calls. internal (certified) none FxOS 1.0.1
audio-channel-publicnotification AudioChannels Forced camera shutter sounds. internal (certified) none FxOS 1.2
background-sensors Background Sensor Ability to listen to proximity sensor events in the background. (All apps recieve these events in the foreground.) internal (certified) none FxOS 1.0.1
backgroundservice Background Services Enable an app to run in the background and perform tasks like syncing or responding to incoming messages. internal (certified) none FxOS 1.0.1
bluetooth   Low level access to Bluetooth hardware. internal (certified) none FxOS 1.0.1
camera Camera

Take photos, shoot video, record audio, and control the camera.

Note: camera was limited to certified apps initially because the sandbox that apps run in was preventing access to the camera hardware. This has been fixed from Firefox OS 2.0 onwards.

internal (certified) up to Firefox OS 1.4, privileged in Firefox OS 2.0+ none FxOS 1.0.1-1.4 certified
FxOS 2.0+ privileged
cellbroadcast   Fires an event when a specific type of cell network message is received (an emergency network notification). internal (certified) none FxOS 1.0.1
device-storage:apps Device Storage Add, read, or modify files stored in the apps location on the device.

When this is used, the webapps-manage permission is also required alongside it (see below.)
internal (certified) read FxOS 1.0.1
embed-apps Embed Apps Ability to embed apps in mozApp frames. internal (certified) none FxOS 1.0.1
idle Idle Notify the app if the user is idle. internal (certified) none FxOS 1.0.1
mobileconnection Mobile Connection Obtain information about the current mobile voice and data connection. internal (certified) none FxOS 1.0.1
network-events Network Events Monitor network uploads and downloads. internal (certified) none FxOS 1.0.1
networkstats-manage Network Stats Manage Obtain statistics of data usage per interface. internal (certified) none FxOS 1.0.1
open-remote-window Open out-of-process windows Allows normal window.open calls, but the resulting window is opened in a new process. internal (certified) none FxOS 1.0.1
permissions Permissions Allow an app to manage other permissions of other apps. internal (certified) none FxOS 1.0.1
phonenumberservice ?? ?? internal (certified) none ??
power Power Management Turn the screen on or off, control CPU, device power, and so on. Listen for and inspect resource lock events. internal (certified) none FxOS 1.0.1
settings Settings Configure or read device settings. internal (certified) readonly or readwrite FxOS 1.0.1
sms WebSMS Send and receive SMS messages. internal (certified) none FxOS 1.0.1,
1.1 for MMS
telephony WebTelephony Access all telephony-related APIs to make and recieve phone calls. internal (certified) none FxOS 1.0.1
time TimeManager Set current time. Time zone information is controlled by the Settings API. Formerly called systemclock. internal (certified) none FxOS 1.0.1
voicemail Voicemail Access voicemail. internal (certified) none FxOS 1.0.1
webapps-manage Open Webapps Obtain access to the navigator.mozApps.mgmt API to manage installed Open Web Apps.

Required alongside the device-storage:apps permission (see above.)
internal (certified) none FxOS 1.0.1, Desktop, Android
wifi-manage WiFi Management Enumerate available WiFi networks, get signal strength, connect to a network. internal (certified) none FxOS 1.0.1
wappush WAP Push Receive WAP Push messages. internal (certified) none FxOS 1.0.1

Note: The internal codename for internal apps is certified apps. To declare an app as internal, you need to put "type" : "certified" into your app manifest.

See also

The permissions table is where the permissions are defined in the Firefox code.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : JeffD, Bene, sousmangoosta
 Dernière mise à jour par : JeffD,