Documentation

This document in english.

L’utilisation de ce logiciel vous soumet à nos Conditions d’Utilisation et à notre Politique de Protection des Données.

version 1.5.0

Introduction:

OAuth2OOo fait partie d’une Suite d’extensions LibreOffice et/ou OpenOffice permettant de vous offrir des services inovants dans ces suites bureautique.

Cette extension est l’implémentation du protocole OAuth 2.0. Protocole permettant d’obtenir votre consentement pour qu’une application puisse accéder à vos données présentes chez les GAFA.

Elle permet d’exécuter des requêtes HTTP en BASIC et fournit les macros suivantes à titre d’exemple:

• HTTPGetRequest
• HTTPPostRequest
• ChatGPTRequest
• GoogleAPIRequest
• GraphAPIRequest

Si au préalable vous ouvrez un document, vous pouvez les lancer par:
Outils -> Macros -> Exécuter la macro… -> Mes macros -> OAuth2OOo -> nom-macro -> Main -> Exécuter

Elle permet également de récupérer des données Internet dans une feuille Calc. Voir les fichiers Calc suivants à titre d’exemple:

• LDLC MacBook Pro.ods
• LDLC Asus Zenbook.ods

Et enfin, elle permet de piloter Firefox par un fichier Calc (ou tout autre navigateur pris en charge par Selenium). Voir les fichiers suivant:

• Page Jaunes (Windows).ods
• Page Jaunes (Linux).ods

Etant un logiciel libre je vous encourage:

• A dupliquer son code source.
• A apporter des modifications, des corrections, des ameliorations.
• D’ouvrir un dysfonctionnement si nécessaire.

Bref, à participer au developpement de cette extension. Car c’est ensemble que nous pouvons rendre le Logiciel Libre plus intelligent.

---

Prérequis:

La version minimale de LibreOffice prise en charge par l’extension OAuth2OOo dépend de la façon dont vous avez installé LibreOffice sur votre ordinateur:

• Quelle que soit la plateforme, si vous avez installé LibreOffice depuis le site de téléchargement de LibreOffice, la version minimale de LibreOffice est 7.0.

• Sous Linux si vous avez utilisé le gestionnaire de paquets pour installer LibreOffice, la version minimale de LibreOffice est 6.0. Cependant, vous devez vous assurer que la version de Python fournie par le système n’est pas inférieure à 3.8.
  De plus, vos packages Python fournis par le système peuvent être obsolètes. La journalisation de l’extension vous permettera de vérifier si c’est le cas. Elle est accessible via le menu: Outils -> Options -> Internet -> Protocole OAuth2-> Voir journal -> Info système et nécessite le redemarrage de LibreOffice aprés son activation.
  Si des paquets obsolètes apparaissent, vous pouvez les mettre à jour avec cette procédure:

  • Télécharger le fichier requirements.txt.
  • Installer à l’aide de pip, les paquets Python nécessaires à l’extension avec la commande:
    pip install requirements.txt

Si vous voulez piloter Firefox dans Calc sous Ubuntu alors il vous faut reinstaller Firefox à partir du PPA de Mozilla.
Pour installer le PPA de Mozilla veuillez taper la commande:
sudo add-apt-repository ppa:mozillateam/ppa

---

Installation:

Il semble important que le fichier n’ait pas été renommé lors de son téléchargement.
Si nécessaire, renommez-le avant de l’installer.

• Installer l’extension OAuth2OOo.oxt

Redémarrez LibreOffice après l’installation.
Attention, redémarrer LibreOffice peut ne pas suffire.

• Sous Windows pour vous assurer que LibreOffice redémarre correctement, utilisez le Gestionnaire de tâche de Windows pour vérifier qu’aucun service LibreOffice n’est visible après l’arrêt de LibreOffice (et tuez-le si ç’est le cas).
• Sous Linux ou macOS vous pouvez également vous assurer que LibreOffice redémarre correctement, en le lançant depuis un terminal avec la commande soffice et en utilisant la combinaison de touches Ctrl + C si après l’arrêt de LibreOffice, le terminal n’est pas actif (pas d’invité de commande).

---

Utilisation:

Cette extension n’est pas faite pour être utilisée seule, mais fournit le service OAuth2 à d’autres extensions LibreOffice / OpenOffice.
Voici comment nous utilisons son API:

Créer le service OAuth2:

identifier = “io.github.prrvchr.OAuth2OOo.OAuth2Service”
service = ctx.ServiceManager.createInstanceWithContext(identifier, ctx)

Initialiser la Session ou au moins l’Url:

• Initialiser la Session:

initialized = service.initializeSession(registered_url, user_account)

La valeur renvoyée: initialized est True si user_account est déjà autorisé pour registered_url.

• Initialiser l’Url:

initialized = service.initializeUrl(registered_url)

La valeur renvoyée: initialized est True si registered_url a été trouvé avec succès dans la configuration du service OAuth2.

Obtenir le jeton d’accès:

format = ‘Bearer %s’
token = service.getToken(format)

---

Uno OAuth2.0 API pour LibreOffice.

Le protocole OAuth2 permet d’accéder aux ressources de serveurs, après acceptation de l’autorisation de connexion, en échangeant des jetons.

La révocation a lieu dans la gestion des applications associées à votre compte.

Plus aucun mot de passe n’est stocké dans LibreOffice.

---

Comment créer l’extension:

Normalement, l’extension est créée avec Eclipse pour Java et LOEclipse. Pour contourner Eclipse, j’ai modifié LOEclipse afin de permettre la création de l’extension avec Apache Ant.
Pour créer l’extension OAuth2OOo avec l’aide d’Apache Ant, vous devez:

• Installer le SDK Java version 8 ou supérieure.
• Installer Apache Ant version 1.10.0 ou supérieure.
• Installer LibreOffice et son SDK version 7.x ou supérieure.
• Cloner le dépôt OAuth2OOo sur GitHub dans un dossier.
• Depuis ce dossier, accédez au répertoire: source/OAuth2OOo/
• Dans ce répertoire, modifiez le fichier build.properties afin que les propriétés office.install.dir et sdk.dir pointent vers les dossiers d’installation de LibreOffice et de son SDK, respectivement.
• Lancez la création de l’archive avec la commande: ant
• Vous trouverez l’archive générée dans le sous-dossier: dist/

---

A été testé avec:

• LibreOffice 7.3.7.2 - Lubuntu 22.04 - Python version 3.10.12

• LibreOffice 7.5.4.2(x86) - Windows 10 - Python version 3.8.16 (sous Lubuntu 22.04 / VirtualBox 6.1.38)

• LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 (sous Lubuntu 22.04 / VirtualBox 6.1.38)

• LibreOffice 24.8.0.3 (X86_64) - Windows 10(x64) - Python version 3.9.19 (sous Lubuntu 22.04 / VirtualBox 6.1.38)

• Ne fonctionne pas avec OpenOffice voir dysfonctionnement 128569. N’ayant aucune solution, je vous encourrage d’installer LibreOffice.

Je vous encourage en cas de problème
de créer un dysfonctionnement
J’essaierai de le résoudre

---

Historique:

Toutes les changements sont consignées dans l’Historique des versions