Ce document en français.
The use of this software subjects you to our Terms Of Use and Data Protection Policy.
OAuth2OOo is part of a Suite of LibreOffice and/or OpenOffice extensions allowing to offer you innovative services in these office suites.
This extension is the implementation of the OAuth 2.0 protocol. Protocol allowing you to obtain your consent so that an application can access your data present at the GAFA.
It allows executing HTTP requests in BASIC and provides the following macros as an example:
If you open a document beforehand, you can launch them by:
Tools -> Macros -> Run Macro… -> My Macros -> OAuth2OOo -> macro-name
-> Main -> Run
It also allows grabbing internet data in a Calc sheet. See the following Calc files as an example:
And finally, it allows you to drive Firefox using a Calc file (or any other browser supported by Selenium). See the following files:
Being free software I encourage you:
In short, to participate in the development of this extension. Because it is together that we can make Free Software smarter.
The minimum version of LibreOffice supported by the OAuth2OOo extension depends on how you installed LibreOffice on your computer:
Regardless of platform, if you installed LibreOffice from the LibreOffice download site, the minimum version of LibreOffice is 7.0.
On Linux, if you used the package manager to install LibreOffice, the minimum version of LibreOffice is 6.0. However, you must ensure that the system-provided Python version is not lower than 3.8.
In addition, your system-provided Python packages can be out of date. The extension’s logging will allow you to check if this is the case. It is accessible via the menu: Tools -> Options -> Internet -> OAuth2 protocol -> View log -> System Info and requires restarting LibreOffice after activation.
If outdated packages appear, you can update them with this procedure:
pip install requirements.txt
If you want to drive Firefox in Calc on Ubuntu then you need to reinstall Firefox from the Mozilla PPA.
To install the Mozilla PPA please type the command:
sudo add-apt-repository ppa:mozillateam/ppa
It seems important that the file was not renamed when it was downloaded.
If necessary, rename it before installing it.
Restart LibreOffice after installation.
Be careful, restarting LibreOffice may not be enough.
soffice
and using the key combination Ctrl + C
if after stopping LibreOffice, the terminal is not active (no command prompt).This extension is not made to be used alone, but provide OAuth2 service to other LibreOffice / OpenOffice extensions.
Here’s how we use its API:
identifier = “io.github.prrvchr.OAuth2OOo.OAuth2Service”
service = ctx.ServiceManager.createInstanceWithContext(identifier, ctx)
initialized = service.initializeSession(registered_url, user_account)
The return value: initialized
is True if user_account
is already authorized for registered_url
.
initialized = service.initializeUrl(registered_url)
The return value: initialized
is True if registered_url
was successfully found in the OAuth2 service configuration.
format = ‘Bearer %s’
token = service.getToken(format)
The OAuth2 protocol allows access to server resources, after accepting the connection authorization, by exchanging tokens.
The revocation takes place in the management of the applications associated with your account.
No more password is stored in LibreOffice.
Normally, the extension is created with Eclipse for Java and LOEclipse. To work around Eclipse, I modified LOEclipse to allow the extension to be created with Apache Ant.
To create the jdbcDriverOOo extension with the help of Apache Ant, you need to:
source/OAuth2OOo/
build.properties
so that the office.install.dir
and sdk.dir
properties point to the folders where LibreOffice and its SDK were installed, respectively.ant
dist/
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 (under Lubuntu 22.04 / VirtualBox 6.1.38)
LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 (under Lubuntu 22.04 / VirtualBox 6.1.38)
LibreOffice 24.8.0.3 (x86_64) - Windows 10(x64) - Python version 3.9.19 (under Lubuntu 22.04 / VirtualBox 6.1.38)
Does not work with OpenOffice see bug 128569. Having no solution, I encourage you to install LibreOffice.
I encourage you in case of problem
to create an issue
I will try to solve it