Configuration¶
Ce guide couvre uniquement les réglages spécifiques à sites_conformes. Pour
la configuration générale Wagtail/Django, référez-vous à leurs documentations
officielles.
La plupart des réglages se lisent depuis l’environnement, ce qui permet de
les modifier sans toucher au code. Les valeurs par défaut indiquées ci-dessous
sont celles utilisées dans le config/settings.py fourni en exemple par le
package.
Voir aussi
Pour la liste exhaustive de toutes les variables d’environnement lues par l’application (au-delà de celles spécifiques à l’intégration), voir la référence des variables d’environnement.
HOST_URL¶
Hôte de votre site (sans protocole). Sert à construire les URL absolues.
HOST_URL = os.getenv("HOST_URL", "localhost")
HOST_PROTO¶
Protocole utilisé (http ou https). Par défaut https.
HOST_PROTO = os.getenv("HOST_PROTO", "https")
HOST_PORT¶
Port HTTP utilisé pour les URL générées (laissez vide en production).
HOST_PORT = os.getenv("HOST_PORT", "")
FORCE_SCRIPT_NAME¶
Préfixe d’URL si le site est servi depuis un sous-chemin (/site-conformes/,
par exemple). Voir la doc Django.
FORCE_SCRIPT_NAME = os.getenv("FORCE_SCRIPT_NAME", "").rstrip("/")
WAGTAILADMIN_PATH¶
Chemin d’accès à l’administration Wagtail. Par défaut cms-admin/, pour
éviter la collision avec /admin/ (souvent réservé à Django admin).
WAGTAILADMIN_PATH = os.getenv("WAGTAILADMIN_PATH", "cms-admin/")
WAGTAIL_I18N_ENABLED¶
Active l’internationalisation de Wagtail :
WAGTAIL_I18N_ENABLED = True
PROCONNECT_ACTIVATED¶
Active l’authentification ProConnect (réservée aux agents de l’État). Lue depuis l’environnement, désactivée par défaut.
PROCONNECT_ACTIVATED = os.getenv("PROCONNECT_ACTIVATED", "") in ("1", "True")
Quand True, le package ajoute automatiquement sites_conformes.proconnect
à INSTALLED_APPS et configure le backend OIDC (voir
Installation).
SF_USE_DB_STORAGE¶
Stocke les fichiers médias en base de données plutôt que sur le filesystem. Utile pour les PaaS avec filesystem éphémère (Scalingo, Heroku). Non recommandé au-delà de ~1 Go de médias : privilégiez S3.
SF_USE_DB_STORAGE = getenv_bool("SF_USE_DB_STORAGE", False)
Quand True, sites_conformes.db_storage doit être ajouté à
INSTALLED_APPS (voir Installation).
SF_USE_WHITENOISE¶
Active WhiteNoise pour servir les fichiers statiques sans serveur de fichiers dédié. Désactivé par défaut.
SF_USE_WHITENOISE = getenv_bool("SF_USE_WHITENOISE", False)
SF_CONTENTPAGE_MODEL¶
Modèle Django utilisé pour les pages de contenu, au format app_label.ModelName.
Permet de remplacer le modèle initial ContentPage par un modèle de votre choix.
Celui-ci doit hériter de
AbstractContentPage, sur le principe des modèles de Page personnalisé de Wagtail
ou User de Django.
Voir Modèle de page de contenu personnalisé.
Ce réglage doit être défini avant la première migration du projet : les sites existants ne peuvent pas changer de modèle sans une migration de contenu.
Valeur par défaut :
SF_CONTENTPAGE_MODEL = "sites_conformes_core.ContentPage"
SF_DISABLE_LOCAL_LOGIN¶
Désactive la connexion par identifiant et mot de passe : seul ProConnect permet alors de se connecter. Désactivé par défaut.
SF_DISABLE_LOCAL_LOGIN = getenv_bool("SF_DISABLE_LOCAL_LOGIN", False)
Le réglage n’a d’effet que si PROCONNECT_ACTIVATED vaut aussi True : la
connexion par mot de passe ne peut pas être désactivée sans autre moyen de se
connecter. Sans ProConnect, le formulaire de connexion reste affiché.
Avertissement
Côté package, ce réglage ne fait que masquer le formulaire de connexion.
La vue de connexion accepte toujours un identifiant et un mot de passe tant
que django.contrib.auth.backends.ModelBackend figure dans
AUTHENTICATION_BACKENDS. Il faut donc le retirer dans les réglages du projet
hôte :
if PROCONNECT_ACTIVATED:
if SF_DISABLE_LOCAL_LOGIN:
AUTHENTICATION_BACKENDS = []
WAGTAIL_PASSWORD_RESET_ENABLED = False
WAGTAIL_PASSWORD_MANAGEMENT_ENABLED = False
WAGTAILUSERS_PASSWORD_ENABLED = False
else:
AUTHENTICATION_BACKENDS = [
"django.contrib.auth.backends.ModelBackend",
]
AUTHENTICATION_BACKENDS.append("sites_conformes.proconnect.backends.OIDCAuthenticationBackend")
Le backend ProConnect hérite de ModelBackend : les droits des utilisateurs
continuent de fonctionner. La réinitialisation et le changement de mot de
passe sont désactivés, et les formulaires de création et de modification
d’utilisateur n’ont plus de champ mot de passe : un compte créé dans l’admin
ne sert qu’à autoriser à l’avance une connexion via ProConnect (le compte est
retrouvé par son adresse e-mail). Les sessions déjà ouvertes par mot de passe
sont fermées au prochain chargement de page.
Pour ajouter un appareil de double authentification (2FA), un code envoyé par
e-mail remplace alors la saisie du mot de passe : l’envoi d’e-mails doit être
configuré (DEFAULT_FROM_EMAIL), sinon l’ajout d’un appareil est bloqué. Voir
Authentification à deux facteurs (2FA).
Accès de secours¶
Si ProConnect est indisponible, ou si plus aucun compte n’a les droits nécessaires, une personne ayant accès au serveur peut rétablir temporairement la connexion par mot de passe :
Passer
SF_DISABLE_LOCAL_LOGINàFalseet redémarrer l’application : le formulaire de connexion réapparaît à côté du bouton ProConnect.Définir un mot de passe pour un compte superadmin avec
python manage.py changepassword <identifiant>, ou créer un compte avecpython manage.py createsuperuser. Les comptes créés dans l’admin ont un mot de passe vide, et ceux créés via ProConnect un mot de passe inconnu. Pour lancer ces commandes selon l’hébergement, voir Sur Scalingo (ou PaaS) — 🟢 Débutant, Avec Docker — 🔵 Confirmé ou Sur un serveur Linux (VPS, dédié ou interne) — 🔵 Confirmé.Se connecter et faire l’opération nécessaire, par exemple donner des droits à un compte ProConnect.
Remettre
SF_DISABLE_LOCAL_LOGINàTrueet redémarrer : les sessions ouvertes par mot de passe sont fermées.
Si la 2FA est activée, le code de l’appareil est demandé après la connexion. Si le compte n’a pas encore d’appareil, l’ajout est à confirme avec le mot de passe défini ci-dessus.
Avertissement
Pendant cette opération, la connexion par mot de passe est rétablie pour tous les comptes qui en ont un.
Voir aussi
Pour les réglages Django et Wagtail, référez-vous à leurs documentations officielles : https://docs.djangoproject.com/ et https://docs.wagtail.org/.