Add OpenID config page

content/deploy/oidc.en.md

@@ -0,0 +1,35 @@
+---
+data: 2024-06-07T20:50:55+02:00
+title: OpenID Connect
+weight: 25
+---
+
+happyDomain supports user authentication via the OpenID Connect protocol. If you have an authentication provider (Auth0, Okta, ...) or Identity Provider (IdP) software such as Keycloak, Authentik, Authelia, ... you can use it with happyDomain, and possibly dispense with the embedded registration and authentication system.
+
+
+## Configuration
+
+To enable OpenID Connect, you'll need to set the following options:
+
+```
+HAPPYDOMAIN_OIDC_PROVIDER_URL=https://auth.example.com/
+HAPPYDOMAIN_OIDC_CLIENT_ID=youClientId
+HAPPYDOMAIN_OIDC_CLIENT_SECRET=0a1b2c3d4e6f7A8B9C0D
+```
+
+The `PROVIDER_URL` setting should be defined to the base URL of your authentication service.
+The service should expose a settings discovery endpoint (at `/.well-known/openid-configuration`).
+
+
+### OpenID Connect provider settings
+
+You'll need to setup a new application in your authentication provider, with the following settings:
+
+- Provider type: OIDC ou OAuth2
+- Grant type: `Authorization Code`
+- Application type: `Web` ou `PWA`
+- Client type: `private`
+- Scopes: `openid`, `profile`, `email`
+
+Also define the allowed callback URL to:
+- `https://yourHappyDomain.example.com/auth/callback`

content/deploy/oidc.fr.md

@@ -0,0 +1,34 @@
+---
+data: 2024-06-07T20:50:55+02:00
+title: OpenID Connect
+weight: 25
+---
+
+happyDomain supporte l'authentification d'utilisateurs via le protocole OpenID Connect. Si vous avez un prestataire pour l'authentification (Auth0, Okta, ...) ou que vous avez un logiciel dit "Identity Provider" (IdP) tel que Keycloak, Authentik, Authelia, ... vous pouvez l'utiliser avec happyDomain et vous passez, éventuellement, du système d'inscription et d'authentification embarqué.
+
+
+## Configuration
+
+Pour activer l'authentification OpenID Connect, vous aurez besoin de définir les options suivantes :
+
+```
+HAPPYDOMAIN_OIDC_PROVIDER_URL=https://auth.example.com/
+HAPPYDOMAIN_OIDC_CLIENT_ID=youClientId
+HAPPYDOMAIN_OIDC_CLIENT_SECRET=0a1b2c3d4e6f7A8B9C0D
+```
+
+L'option `PROVIDER_URL` correspond à l'URL de base du service d'authentification. Celui-ci doit mettre à disposition une page de découverte de ses paramètres (accessible à `/.well-known/openid-configuration`).
+
+
+### Paramétrage du fournisseur OpenID Connect
+
+Vous aurez besoin de créer une application dans votre fournisseur d'authentification, avec les paramètres suivants :
+
+- Provider type: OIDC ou OAuth2
+- Grant type: `Authorization Code`
+- Application type: `Web` ou `PWA`
+- Client type: `private`
+- Scopes: `openid`, `profile`, `email`
+
+Définissez également une adresse de retour autorisée :
+- `https://yourHappyDomain.example.com/auth/callback`