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

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:

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

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.
De participer au frais de la certification CASA.

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

Certification CASA:

Afin de garantir l’interopérabilité avec Google, l’extension OAuth2OOo nécessite la certification CASA.
Jusqu’à présent, cette certification était gratuite et réalisée par un partenaire de Google.
L’application OAuth2OOo a obtenu sa certification CASA le 28/11/2023.

Maintenant cette certification est devenue désormais payante et coûte 600$.

Je n’avais jamais anticipé de tels frais et je compte sur votre contribution pour financer cette certification.

Merci pour votre aide.

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 a été initialement conçue pour fournir la prise en charge du protocole OAuth2 à d’autres extensions LibreOffice.
Elle fournit également une API utilisable en BASIC pour exécuter des requêtes HTTP:

Créer le service UNO OAuth2Service avec le support du protocole OAuth2:

sUser = "account@gmail.com"
sUrl = "people.googleapis.com"
oRequest = createUnoServiceWithArguments("io.github.prrvchr.OAuth2OOo.OAuth2Service", Array(sUrl, sUser))

Créer le service UNO OAuth2Service sans le support du protocole OAuth2:

oRequest = createUnoServiceWithArguments("io.github.prrvchr.OAuth2OOo.OAuth2Service")

Utiliser le service UNO OAuth2Service pour executer des requêtes HTTP:

Vous disposez désormais d’un objet oRequest qui répond à l’interface définie dans le fichier XOAuth2Service.idl.
Avec cette interface, deux méthodes sont nécessaires pour exécuter une requête HTTP:

getRequestParameter([in] string Name), qui vous permet d’obtenir un objet répondant à l’interface XRequestParameter.idl. Cette interface vous permet de configurer la requête HTTP avant son exécution.
execute([in] com::sun::star::rest::XRequestParameter Parameter), qui vous permet d’obtenir un objet répondant à l’interface XRequestResponse.idl. Cela vous permet d’obtenir presque tout ce qui est possible avec une réponse HTTP.

Pour aller plus loin, je vous conseille de prendre connaissance des macros qui sont livrées avec l’extension et qui implémentent tous types de requêtes HTTP.

Uno OAuth2.0 API pour LibreOffice.

OAuth2OOo Wizard Page1 screenshot

OAuth2OOo Wizard Page2 screenshot

OAuth2OOo Wizard Page3 screenshot

OAuth2OOo Browser Page1 screenshot

OAuth2OOo Browser Page2 screenshot

OAuth2OOo Browser Page3 screenshot

OAuth2OOo Browser Page4 screenshot

OAuth2OOo Wizard Page4 screenshot

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

OAuth2OOo