aboutsummaryrefslogtreecommitdiff
path: root/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html')
-rw-r--r--files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html136
1 files changed, 136 insertions, 0 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html b/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html
new file mode 100644
index 0000000000..367206b319
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.html
@@ -0,0 +1,136 @@
+---
+title: storage.managed
+slug: Mozilla/Add-ons/WebExtensions/API/storage/managed
+tags:
+ - API
+ - Add-ons
+ - Extensions
+ - Non-standard
+ - Property
+ - Reference
+ - Storage
+ - WebExtensions
+ - managed
+translation_of: Mozilla/Add-ons/WebExtensions/API/storage/managed
+---
+<div>{{AddonSidebar()}}</div>
+
+<p>Un objet {{WebExtAPIRef("storage.StorageArea")}} qui représente la zone de stockage gérée. Les éléments de stockage <code>géré</code> sont définis par l'administrateur du domaine ou d'autres applications natives installées sur l'ordinateur de l'utilisateur et sont en lecture seule pour l'extension. Essayer de modifier cette zone de stockage entraîne une erreur.</p>
+
+<h2 id="Provisionnement_du_stockage_géré">Provisionnement du stockage géré</h2>
+
+<p>La procédure de provisionnement du stockage géré est différente selon les navigateurs. Firefox a sa propre méthode mais (à partir de Firefox 67) peut aussi utiliser la fonction Storage.managed de Chrome qui supporte un fichier <code>.json</code>. ((Voir Stockage Chrome géré ci-dessous.)</p>
+
+<h3 id="manifestes_natives">manifestes natives</h3>
+
+<p>Pour Firefox, vous devez créer un fichier manifest JSON dans un format spécifique, dans un emplacement spécifique. Pour plus de détails sur la syntaxe et l'emplacement du manifeste, voir <a href="/fr/Add-ons/WebExtensions/Native_manifests">manifests natifs</a>.</p>
+
+<p>Voici un exemple de manifest :</p>
+
+<pre class="brush: json">{
+ "name": "favourite-color-examples@mozilla.org",
+ "description": "ignored",
+ "type": "storage",
+ "data":
+ {
+ "color": "management thinks it should be blue!"
+ }
+}</pre>
+
+<p>Compte tenu de ce manifeste, l'extension "favourite-color-examples@mozilla.org" pourrait accéder aux données en utilisant un code comme celui-ci :</p>
+
+<pre class="brush: js">var storageItem = browser.storage.managed.get('color');
+storageItem.then((res) =&gt; {
+ console.log(`Managed colur is: ${res.color}`);
+});</pre>
+
+<h3 id="Gestion_de_stockage_dans_Chrome">Gestion de stockage dans Chrome</h3>
+
+<p>Firefox et Chrome supportent tous deux l'utilisation d'un manifeste pour les zones de stockage.</p>
+
+<p>La zone de stockage gérée est configurée à l'aide d'un schéma JSON, qui est strictement validé par Chrome et Firefox 67 ou supérieur. Stockez le schéma dans un fichier.json et pointez-le depuis la propriété "managed_schema" de la clé de manifeste "storage" de l'extension web. Le fichier json déclare les stratégies d'entreprise supportées par l'extension.</p>
+
+<p>Les stratégies définissent les options qui ont été configurées par un administrateur système au lieu de l'utilisateur. La gestion du stockage permet de préconfigurer une extension pour tous les utilisateurs d'une organisation.</p>
+
+<p>C'est à l'extension d'appliquer les stratégies configurées par l'administrateur. L'extension peut lire les stratégies à l'aide de l'API storage.managed.</p>
+
+<h4 id="manifest.json">manifest.json</h4>
+
+<pre class="brush: js">{
+ "name": "chrome-storage-managed-examples@mozilla.org",
+<span class="str"> "storage"</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln">
+ </span><span class="str">"managed_schema"</span><span class="pun">:</span><span class="pln"> </span><span class="str">"schema.json"</span><span class="pln">
+ </span><span class="pun">},</span>
+}
+</pre>
+
+<p>Le fichier json ressemblerait à ceci :</p>
+
+<pre class="brush: json">{
+ "type": "object",
+ // "properties" maps an optional key of this object to its schema. At the
+ // top-level object, these keys are the policy names supported.
+ "properties": {
+ // "title" and "description" are optional and are used to show a
+ // user-friendly name and documentation to the administrator.
+ "bookmarks": {
+ "id": "DevTeamBookmarks",
+ "title": "Dev Team bookmarks.",
+ "description": "A set of bookmarks particularly useful to the dev team.",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "title": { "type": "string" },
+ "url": { "type": "string" },
+ "children": { "$ref": "ListOfBookmarks" }
+ }
+ }
+ }
+}</pre>
+
+<p>Pour plus d'informations, voir l'article de Chrome pour les zones de stockage <a href="https://developer.chrome.com/extensions/manifest/storage">Manifeste pour les zones de stockage</a>.</p>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+
+<p>{{Compat("webextensions.api.storage.managed")}}</p>
+
+<p>{{WebExtExamples}}</p>
+
+<div class="note"><strong>Remerciements :</strong>
+
+<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</p>
+</div>
+
+<div class="hidden">
+<pre>// Copyright 2015 The Chromium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+// * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+// * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+// * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+</pre>
+</div>