From aaee15bb1b58661d1a538cc6ad0485b641f1ee0f Mon Sep 17 00:00:00 2001 From: Adrien P Date: Thu, 17 Jul 2025 18:40:36 +0200 Subject: [PATCH] Added oauth 2 generation explaination for radicale --- doc/installation.rst | 1 + doc/manual_installation/radicale.rst | 38 ++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 doc/manual_installation/radicale.rst diff --git a/doc/installation.rst b/doc/installation.rst index 15b07506e..aa8a3c877 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -72,6 +72,7 @@ specific part, here are the steps you must follow: manual_installation/dovecot manual_installation/postfix manual_installation/opendkim + manual_installation/radicale Extensions ---------- diff --git a/doc/manual_installation/radicale.rst b/doc/manual_installation/radicale.rst new file mode 100644 index 000000000..abe6191fc --- /dev/null +++ b/doc/manual_installation/radicale.rst @@ -0,0 +1,38 @@ +.. _radicale: + +####### +Radicale +####### + +This page is currently being written. + +.. _radicale_oauth2: + +OAuth 2 authentication +====================== + +You first need to register Radicale as an authorized consumer of the +OAuth2 authentication service provided by Modoboa. To do so, create an +application with the following commands: + +.. sourcecode:: bash + + > cd + > python manage.py createapplication --name=Radicale --skip-authorization --client-id=radicale confidential client-credentials + +On success, you should see an output similar to:: + + New application Radicale created successfully. + client_secret: XXXX + +To enable OAuth2 authentication in Radicale, edit the :file:`/etc/radicale/config` +file and update the `type` in `[auth]` to:: + + type = radicale_modoboa_auth_oauth2 + +Then, add the following line in `[auth]`:: + + oauth2_introspection_endpoint = https://radical:@/api/o/introspect/ + + +Replace ```` with the value you obtained earlier.