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 |
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 |
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: |
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.