Apprendre à protéger des documents dans ONLYOFFICE Desktop Editors grâce au chiffrement

ONLYOFFICE

Pour réagir au contenu de cet article, un espace de dialogue vous est proposé sur le forum. Commentez

- Titre : Apprendre à protéger des documents dans ONLYOFFICE Desktop Editors grâce au chiffrement

- Auteur : ONLYOFFICE

- Parution : 20 août 2021

- Licence : Copyright ® 2021 ONLYOFFICE . Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. Outils

- III. À propos des modules complémentaires

- IV. Deux modules pour chiffrer tous les documents

- IV-A. Module complémentaire de chiffrement pour les éditeurs

- IV-B. Module complémentaire de l’UI pour l’application

- V. Ajoutez des modules complémentaires à l'application de bureau

- VI. Travaillez avec des modules complémentaires de chiffrement

- VII. Remerciements Developpez.com

I - Introduction

Dans cet article, nous allons apprendre à chiffrer vos documents locaux, vos feuilles de calcul et vos présentations avec un simple module complémentaire de chiffrement symétrique.

II - Outils

Nous utiliserons ONLYOFFICE Desktop Editors, une suite bureautique open source pour Linux, Windows et macOS. Ce logiciel est distribué sous la licence AGPLv3 et dispose d'une API accessible au public.

L'application prend en charge les modules complémentaires que nous utiliserons pour ajouter une couche supplémentaire de sécurité. Les modules complémentaires apportent de nouvelles fonctionnalités, ce qui est utile en matière de sécurité. Vous ne devez pas vous fier aux outils prêts à l'emploi fournis par les développeurs. Vous pouvez travailler par vous-même.

III - À propos des modules complémentaires

Chaque module complémentaire présente un dossier avec trois fichiers :

- HTML – pour l'interface du module complémentaire ;

- JS – pour le code du module complémentaire ;

- JSON – pour la configuration du module complémentaire.

La structure des modules est décrite ici. Des exemples de plugins sont disponibles sur ONLYOFFICE GitHub. Il suffit de taper Plugin dans le champ « Find a repository ».

IV - Deux modules pour chiffrer tous les documents

Pour automatiser et faciliter le chiffrement des documents, nous allons créer deux modules complémentaires :

- module de chiffrement pour les éditeurs ;

- module de l’UI pour l’application.

Pourquoi avons-nous besoin des deux ? Habituellement, un module complémentaire ONLYOFFICE ne fonctionne qu'avec un document là où il est exécuté (dans un onglet de l'application). Dans notre cas, nous voulons travailler avec tous les documents ouverts ou créés dans différents onglets sur l’application de bureau ONLYOFFICE. C'est pourquoi nous avons besoin d'un deuxième module pour l'application.

Veuillez noter que les modules complémentaires décrits ci-dessous sont des exemples que vous pouvez utiliser pour créer les vôtres.

IV-A - Module complémentaire de chiffrement pour les éditeurs

Nous allons créer un module complémentaire de chiffrement simple.

Voyons la configuration du module :

1. {

2. "name" : "crypto",

3. "guid" : "asc.{22222222-2222-2222-2222-222222222222}",

5. "variations" : [

6. {

7. "url"         : "index.html",

9. "icons"           : [],

10. "isViewer"        : true,

11. "EditorsSupport"  : ["word", "cell", "slide"],

13. "isVisual"        : false,

14. "isModal"         : false,

15. "isInsideMode"    : false,

17. "initDataType"    : "desktop",    // this should be the value for this type of plugin

18. "initData"        : "encryption",    // this should be the value for this type of plugin

19. "cryptoMode"      : "2",             // plugin ID as it’s possible to create several encryption plugins

21. "cryptoDisabledForInternalCloud" : "true",  // disables encryption for ONLYOFFICE clouds

22. "cryptoDisabledForExternalCloud" : "true"  // disables encryption for 3rd party clouds

23. }

24. ]

25. }

Vous pouvez facilement trouver les premières lignes dans la documentation. Les cinq dernières valeurs sont nouvelles, donc la documentation sera bientôt disponible.

Le code du module est assez simple.

1. (function(window, undefined){

2. const global_password = "{ my-super-long-password }";

3. window.Asc.plugin.init = function(obj)

4. {

5. if (!obj)

6. return;

8. switch (obj.type)

9. {

10. case "generatePassword":

11. {

12. // password generation request

13. this.executeMethod("OnEncryption", [{ type : "generatePassword", password : global_password }]);

14. break;

15. }

16. case "getPasswordByFile":

17. {

18. // file password request

19. this.executeMethod("OnEncryption", [{ type : "getPasswordByFile", password : global_password }]);

20. break;

21. }

22. case "setPasswordByFile":

23. {

24. this.executeMethod("StartAction", ["Info", "Save"]);

25. // saving password and file information

26. this.executeMethod("EndAction", ["Info", "Save"]);

28. break;

29. }

30. case "encryptData":

31. {

32. // changes encryption - not relevant for local files

33. this.executeMethod("OnEncryption", [{ type : "encryptData", data : obj.data, check: true }]);

34. break;

35. }

36. case "decryptData":

37. {

38. // changes decryption - not relevant for local files

39. this.executeMethod("OnEncryption", [{ type : "decryptData", data : obj.data, check: true }]);

40. break;

41. }

42. default:

43. break;

44. }

45. };

47. })(window, undefined);

Nous voyons que dans le code ci-dessus, tous les fichiers seront cryptés avec un seul mot de passe - {my-super-long-password}. Pour plus d'informations sur la méthode de chiffrement, lisez la documentation officielle de l'API.

Ce module de chiffrement n'a pas d'interface et n'est pas exécuté par défaut. Mais l'éditeur saura quand l'utiliser à l’aide du module de l’interface utilisateur pour l'ensemble de l'application.

IV-B - Module complémentaire de l’UI pour l’application

Ce module n'a pas accès aux fonctions d'édition, mais possède presque la même configuration :

1. {

2. "name" : "Encryption",

3. "nameLocale" : { "ru" : "Шифрование",

4. "it" : "Crittografia",

5. "fr" : "Chiffrement",

6. "es" : "Encriptación",

7. "de" : "Verschlüsselung"

8. },

9. "guid" : "asc.{11111111-1111-1111-1111-111111111111}",

11. "variations" : [

12. {

13. "url"           : "index.html",

15. "initDataType"  : "desktop-external",  // plugins for the whole app type

16. "initData"    : "encryption",              // indicates that the plugin is meant for encryption.

18. "cryptoDisabledOnStart" : "true"         // reset the mode on restart              }

19. ]

20. }

Maintenant, nous pouvons créer l'interface du module complémentaire avec index.html :

1. <!DOCTYPE html>

2. <html lang="en">

3. <head>

4. <meta charset="UTF-8" />

5. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">

6. <title>Encrypt files</title>

7. <script type="text/javascript" src="code.js"></script>

8. </head>

9. <body>

10. <p>Encryption enabled: <input id="check" type="checkbox"/></p>

11. </body>

12. </html>

Le nouvel onglet appelé « Chiffrement » apparaîtra sur la page principale de l'application :

Ajoutons maintenant l'activation du chiffrement en cochant la case :

1. window.onload = function() {

3. const ASC_DESKTOP_EDITOR_DEFAULT_MODE = 0;

4. const ASC_DESKTOP_EDITOR_CRYPTO_MODE = 2; // cryptoMode in the plugin for the editor config

6. document.getElementById("check").onchange = function() {

8. let mode = this.checked ? ASC_DESKTOP_EDITOR_CRYPTO_MODE : ASC_DESKTOP_EDITOR_DEFAULT_MODE;

9. AscDesktopEditor.SetCryptoMode("", mode, function(retCode) {

10. switch (retCode) {

11. case 0: // OK

12. console.log("OK");

13. break;

14. case 1:

15. console.log("Please, close all openfiles!");

16. break;

17. default:

18. break;

19. }

20. });

22. };

24. };

V - Ajoutez des modules complémentaires à l'application de bureau

Pour la dernière version stable (6.3), vous devez copier les dossiers contenant les plugins dans le répertoire sdkjs-plugins. Voici comment le trouver :

- pour Linux : /opt/onlyoffice/desktopeditors/editors/sdkjs-plugins/

- pour Windows : %ProgramFiles%\ONLYOFFICE\DesktopEditors\sdkjs-plugins\

Il est important que vous utilisiez le GUID des modules complémentaires comme nom de dossier.

Les instructions détaillées sont dans la documentation officielle de l'API.

VI - Travaillez avec des modules complémentaires de chiffrement

Après avoir ajouté les deux modules à l'application, nous verrons un nouvel onglet « Chiffrement ». Si vous cochez la case à cet endroit, tous les fichiers que vous créez et modifiez seront cryptés avec le mot de passe :

- si le chiffrement est activé, aucun mot de passe ne vous sera demandé à l'ouverture de vos fichiers protégés (appelé getPasswordByFile) ;

- si le chiffrement est désactivé ou si vous ouvrez vos fichiers dans une autre application, un mot de passe vous sera demandé.

VII - Remerciements Developpez.com

Nous tenons à remercier Malick pour la mise au gabarit et escartefigue pour la relecture orthographique.