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

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:

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:

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.


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 jdbcDriverOOo avec l’aide d’Apache Ant, vous devez:


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:

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