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

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:

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


Prérequis:

Afin de profiter des dernières versions des bibliothèques Python utilisées dans OAuth2OOo, la version 2 de Python a été abandonnée au profit de Python 3.8 minimum.
Cela signifie que OAuth2OOo ne supporte plus OpenOffice et LibreOffice 6.x sous Windows depuis sa version 1.1.0. Je ne peux que vous conseiller de migrer vers LibreOffice 7.x.

Les prérequis dépendent de la plateforme (architecture) sur laquelle l’extension est installée:

Sous Linux et macOS les paquets utilisés par l’extension, peuvent s’il sont déja installé provenir du système et donc, peuvent ne pas être à jour.
Afin de s’assurer que vos paquets Python sont à jour il est recommandé d’utiliser l’option Info système dans les Options de l’extension accessible par:
Outils -> Options -> Internet -> Protocole OAuth2 -> Voir journal -> Info système
Si des paquets obsolètes apparaissent, vous pouvez les mettre à jour avec la commande:
pip install --upgrade <package-name>

Pour plus d’information voir: Ce qui a été fait pour la version 1.3.0.

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.

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


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:

initialized = service.initializeSession(registered_url, user_account)

La valeur renvoyée: initialized est True si user_account est déjà autorisé pour registered_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.

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.


A été testé avec:

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


Historique:

Ce qui a été fait pour la version 0.0.5:

Ce qui a été fait pour la version 0.0.6:

Ce qui a été fait pour la version 1.0.0:

Cela rend les requêtes HTTP utilisant JSON facilement utilisable dans le langage BASIC de LibreOffice.

Ce qui a été fait pour la version 1.0.1:

Ce qui a été fait pour la version 1.1.0:

Ce qui a été fait pour la version 1.1.1:

Ce qui a été fait pour la version 1.1.2:

Ce qui a été fait pour la version 1.2.0:

Ce qui a été fait pour la version 1.2.1:

Ce qui a été fait pour la version 1.2.2:

Ce qui a été fait pour la version 1.2.3:

Ce qui a été fait pour la version 1.2.4:

Ce qui a été fait pour la version 1.3.0:

Ce qui a été fait pour la version 1.3.1:

Ce qui a été fait pour la version 1.3.2:

Ce qui a été fait pour la version 1.3.3:

Ce qui a été fait pour la version 1.3.4:

Ce qui a été fait pour la version 1.3.5:

Ce qui a été fait pour la version 1.3.6:

La mise à jour de tous ces paquets Python devrait permettre d’utiliser Python 3.8, 3.9, 3.10, 3.11 et 3.12 sous l’architecture ManyLinux x86_64.
Pour les architectures win32 et win_amd64, seule la version 3.8 de Python est prise en charge. Cela signifie, puisque Python est intégré à LibreOffice pour ces architectures, que seules les versions 7.x et 24.x de LibreOffice sont prises en charge.
Si votre architecture n’est pas encore supportée par OAuth2OOo (Mac OSX, arm…), je vous conseille d’ouvrir un dysfonctionnement pour que je puisse ajouter les fichiers binaires manquants.

Ce qui a été fait pour la version 1.3.7:

Ce qui a été fait pour la version 1.3.8:

Que reste-t-il à faire pour la version 1.3.8: