Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV |
||
|---|---|---|
| scripts | ||
| web | ||
| .env.example | ||
| .gitignore | ||
| README.md | ||
portail.alpinux.org
Portail membres de l'association Alpinux.
Statut
Site PHP sans dépendance, dans web/, servi par PHP-FPM sur le vhost
ISPConfig portail.alpinux.org (web16) et déployé par scripts/deploy.sh.
La configuration réelle est dans private/.env sur le serveur, hors dépôt
(.env.example sert de modèle).
Accès
- URL : https://portail.alpinux.org
- Authentification : AlpID (SSO Keycloak — https://alpid.alpinux.org)
Administration
Une console, sous /admin/, pour vérifier et corriger un compte AlpID sans
ouvrir la console Keycloak. Elle est réservée aux membres d'un groupe de
ADMIN_GROUPS (par défaut admins), lu à la connexion dans la claim
groups du userinfo — il faut donc un mappeur « Group Membership » (claim
groups, sans le chemin complet) sur le client portail-alpinux. Un
changement de groupe ne compte qu'à la connexion suivante.
Les écrans
| Écran | Rôle |
|---|---|
members.php |
Recherche (?q=, identifiant, nom ou adresse), pagination par 50, validation et révocation d'adhésion. Chaque ligne mène à la fiche. |
compte.php?id=<uuid> |
Fiche d'un compte : activé, adresse vérifiée, actions requises, OTP, groupes, rôles realm et client (directs et effectifs), sessions ouvertes, 20 derniers événements de connexion, gestes de la console sur ce compte. L'encadré « En bref » pointe les rôles de ROLES_SURVEILLES (par défaut messagerie-admin et messagerie-mailperso du client messagerie). |
Gestes, tous en POST avec jeton CSRF : activer / désactiver, courriel « nouveau mot de passe » (UPDATE_PASSWORD), courriel de vérification d'adresse, retrait de l'OTP, fermeture de toutes les sessions, ajout à un groupe, retrait d'un groupe. Un administrateur ne peut ni se désactiver, ni se retirer d'un groupe administrateur ; fermer ses propres sessions demande une confirmation explicite. |
|
groups.php |
Groupes Keycloak : création, suppression, services associés. |
services.php |
Tuiles de services et groupes requis (SERVICES_FILE). |
journal.php |
Les 200 derniers gestes de la console (?compte=<uuid> pour un seul compte). |
Pour le cas « reconnu, mais sans aucun droit » dans une application : la
fiche dit si le compte est activé, s'il lui reste une action requise, et
quels rôles il a effectivement sur le client de l'application, y compris
ceux hérités d'un groupe. Pour la messagerie, seul messagerie-admin vient de
Keycloak : les autres droits sont attribués dans la messagerie elle-même
(/droits), que la fiche ne voit pas.
Rôles du compte de service portail-service
La console appelle l'API d'administration avec le compte de service du client
portail-service (client_credentials sur le realm master). Ce compte vit
dans le realm master : ses droits sur un realm se donnent par les rôles du
client <realm>-realm du realm master — master-realm pour administrer
master lui-même, ce qui est le cas en production. C'est l'équivalent, pour un
compte de master, des rôles realm-management d'un autre realm ; il n'y a pas
de client realm-management dans master.
Dans la console Keycloak, realm master : Clients → portail-service →
onglet Service accounts roles → Assign role → filtrer par clients →
master-realm, et cocher :
| Rôle | Pour |
|---|---|
view-users |
lister, chercher et lire les comptes, leurs groupes, rôles, sessions et moyens d'authentification ; lister les groupes |
manage-users |
tous les gestes de la fiche, valider / révoquer une adhésion, créer / supprimer un groupe ; aussi l'inscription et le profil des membres |
view-events |
les derniers événements de connexion d'un compte et les réglages d'enregistrement |
view-clients |
retrouver un client par son nom pour en lire les rôles effectifs (la messagerie, quand le compte n'y a aucun rôle direct) |
query-groups n'est pas nécessaire : view-users suffit à lister les
groupes. Il ne faut le donner que si l'on retire view-users, ce qui
priverait de toute façon la console de l'essentiel.
Un rôle manquant ne donne ni page blanche ni liste vide : l'écran affiche le refus (403) et nomme le rôle à ajouter.
Événements de connexion
Keycloak n'enregistre les connexions que si on le lui demande. Dans le realm administré (master) : Realm settings → onglet Events → User events settings → activer Save events, choisir une Expiration (par exemple 30 jours — ces événements portent l'adresse IP des membres, ne pas les garder plus que nécessaire), puis Save. Sans cela, la fiche l'indique au lieu d'afficher une liste vide.
Les courriels (mot de passe, vérification) partent du serveur d'envoi du realm : Realm settings → onglet Email. S'il n'est pas configuré, le geste échoue avec un message qui le dit.
Journal de la console
Chaque geste ajoute une ligne JSON (date, administrateur, action, compte visé,
détail, résultat, IP) dans JOURNAL_FILE, par défaut
private/journal-console.jsonl, à côté du .env, hors racine web. Le dossier
private/ doit être accessible en écriture à l'utilisateur PHP du site. Si
l'écriture échoue, le geste a lieu quand même et le message de retour le
signale. Le fichier n'est pas tourné automatiquement.
Mise en ligne
Aujourd'hui, /admin/ ne mène pas au PHP : la réponse vient de gunicorn
(l'ancienne application Flask de static.alpinux.org), et
/admin/members.php y répond 404 alors que / est servi par Apache. Les
directives Apache d'ISPConfig portent encore le ProxyPass /admin/ dont
scripts/portail.alpinux.org.vhost.conf demande le retrait. Déployer ne
suffit donc pas. Dans l'ordre :
- Keycloak : donner à
portail-serviceles rôles ci-dessus, et activer l'enregistrement des événements. - ISPConfig : Sites →
portail.alpinux.org→ onglet Options → Apache Directives : retirer les lignesProxyPass/ProxyPassReversede/admin/, enregistrer, attendre qu'ISPConfig ait réécrit le vhost (ne jamais modifier/etc/apache2/sites-available/à la main). Vérifier :curl -sI https://portail.alpinux.org/admin/members.phpdoit répondreserver: Apacheet une redirection vers/auth/login.php, et non plusserver: gunicorn. - Configuration :
private/.envn'a besoin d'aucune variable nouvelle si les valeurs par défaut conviennent (JOURNAL_FILE,ROLES_SURVEILLES). Vérifier queprivate/est accessible en écriture à PHP. - Code :
./scripts/deploy.sh -npour voir ce qui partira (le dossierweb/admin/,web/inc/journal.php,web/views/admin_nav.phpsont nouveaux), puis./scripts/deploy.sh. - Contrôle : se connecter avec un compte du groupe
admins(se reconnecter si on vient d'y entrer), ouvrir Admin, chercher un compte, ouvrir sa fiche : aucun bloc ne doit afficher de refus 403. Faire un geste sans conséquence (courriel de vérification à son propre compte) et vérifier qu'il apparaît dans Journal.
Voir aussi
Vue d'ensemble des projets, procédures de déploiement globales et accès :
~/Projects/org.alpinux.owni/README.md