1.1.1 was a mistake: this is the 1.1.0 release.
OpenFlyers SSO pour WordPress
Plugin d'authentification permettant aux membres d'un club de se connecter a un espace prive WordPress avec leurs identifiants OpenFlyers. Le mot de passe est saisi sur OpenFlyers et n'est jamais transmis ni stocke sur le site WordPress.
Le plugin implemente le flux authorization_code avec PKCE, l'authentification TLS mutuelle et la
signature HTTP exigees par le serveur d'autorisation OpenFlyers, ainsi que la verification de la
signature des reponses du serveur.
Documentation
- Documentation publique, cote plateforme OpenFlyers : https://doc4-fr.openflyers.com/Plugin-WordPress
- API OpenFlyers, procedures de declaration d'un client et d'emission des certificats : https://doc4-fr.openflyers.com/API-OpenFlyers
Le present fichier decrit l'installation et l'exploitation du plugin cote WordPress. La documentation publique decrit ce qui se passe cote OpenFlyers. Les deux se completent et se referencent mutuellement.
En bref
| Qui | Fait quoi |
|---|---|
| Le prestataire du site | Genere deux bi-cles et deux demandes de certificat sur le serveur (section 2), installe et configure le plugin (sections 4 et 5) |
| Le club (ou OpenFlyers) | Declare le client depuis l'administration de la plateforme, ce qui signe les deux demandes et delivre les certificats, le client_id et la passphrase (section 3) |
| Le club | Coche Connexion depuis l'exterieur (OAuth2) pour les profils concernes, puis associe chaque membre a son compte WordPress ou active la creation automatique (section 7) |
| Le membre | Clique sur "Se connecter avec OpenFlyers", saisit ses identifiants sur OpenFlyers, revient connecte sur le site |
Comptez une demi-journee pour une premiere mise en place, l'essentiel du temps etant l'echange des certificats.
1. Prerequis
Sur l'hebergement WordPress :
- PHP 7.4 ou superieur, avec les extensions
curletopenssl; - la possibilite d'utiliser un certificat client sortant (
CURLOPT_SSLCERT). Certains hebergements mutualises le bloquent : c'est le point a verifier en premier ; - un emplacement de stockage hors de la racine web pour les cles privees ;
- le site accessible en HTTPS, avec une URL stable.
Cote OpenFlyers :
- un compte disposant des droits d'administration sur la plateforme du club ;
- le code plateforme (par exemple
acat-lfcl) ; - la case Connexion depuis l'exterieur (OAuth2) cochee pour les profils des membres concernes. Sans elle, OpenFlyers refuse l'autorisation apres la saisie des identifiants, avec le message Connected user is not allowed to login. Voir la section 7.
La procedure officielle de declaration d'un client est documentee sur le wiki OpenFlyers, chapitre Enregistrer un client : https://doc4-fr.openflyers.com/API-OpenFlyers. Les sections 2 et 3 ci-dessous en donnent la version courte, limitee a ce dont ce plugin a besoin.
2. Generer les cles et les demandes de certificat
Deux bi-cles distinctes sont necessaires : une pour le TLS mutuel, une pour la signature HTTP.
Sur le serveur, dans un dossier hors de la racine web (ici /home/site/of-certs) :
openssl req -new -newkey rsa:2048 -nodes \
-keyout auth.key -out auth.csr \
-subj "/C=FR/O=Nom du club/CN=www.exemple.fr"
openssl req -new -newkey rsa:2048 -nodes \
-keyout sign.key -out sign.csr \
-subj "/C=FR/O=Nom du club/CN=www.exemple.fr"
chmod 600 auth.key sign.key
Conserver les deux fichiers .key a l'abri : ils ne doivent jamais quitter le serveur ni etre
accessibles depuis le web.
La procedure officielle (chapitre Generer des certificats du wiki) passe par des fichiers de
configuration .conf et produit des cles chiffrees, sans -nodes. Les deux approches conviennent :
si vous suivez celle du wiki, renseignez la passphrase des cles dans les reglages du plugin.
3. Declarer le client dans OpenFlyers
Dans OpenFlyers, Admin > Transferts > Exports > API OAuth2, bouton Ajouter un client :
- Nom du client : le nom du site WordPress ;
- Type d'autorisation :
authorization_code(ajouterrefresh_tokenpour des sessions longues) ; - URL de redirection : l'URL affichee en haut de la page de reglages du plugin, typiquement
https://www.exemple.fr/?of_sso=callback. Elle doit correspondre au caractere pres ; - CSR TLS mutuel : contenu de
auth.csr; - CSR signature HTTP : contenu de
sign.csr.
Apres validation, OpenFlyers renvoie les deux certificats signes (valables 3 ans), a enregistrer
sous auth_cert.crt et sign_cert.crt dans le meme dossier. Relever egalement le client_id et la
passphrase : ils ne sont affiches qu'une seule fois, et les regenerer invalide les precedents.
Cette declaration se fait entierement depuis l'administration de la plateforme : le club, ou son prestataire s'il en a les droits, peut la realiser sans intervention d'OpenFlyers.
Deux fichiers supplementaires sont a demander a OpenFlyers et a deposer dans ce dossier :
ca.crt: autorite de certification OpenFlyers ;sign_cert_server.crt: certificat avec lequel le serveur signe ses reponses.
Le dossier contient alors :
/home/site/of-certs/
├── auth.key
├── auth_cert.crt
├── sign.key
├── sign_cert.crt
├── ca.crt
└── sign_cert_server.crt
4. Installer le plugin
Copier le dossier openflyers-sso dans wp-content/plugins/, ou televerser l'archive
openflyers-sso-1.1.0.zip depuis Extensions > Ajouter > Televerser une extension. Activer ensuite
le plugin depuis l'administration WordPress.
5. Configurer
Reglages > OpenFlyers SSO. Trois choses a renseigner, pas davantage :
- le code plateforme, le
client_idet la passphrase ; - le dossier des certificats, un seul chemin absolu. Les six fichiers y sont retrouves par leurs noms standard, ceux de la section 3. Si l'un d'eux porte un autre nom ou se trouve ailleurs, depliez Chemins personnalises (avance) et indiquez-le individuellement ;
- le mode de gestion des comptes.
Verifier que tout fonctionne
Le bouton Tester la connexion a OpenFlyers, en haut de la page, envoie une vraie requete au serveur avec un code d'autorisation volontairement invalide. Tout ce qui protege le point de terminaison est donc traverse : certificat TLS, signature HTTP et identifiants du client. Seul le code ne peut pas etre valide. Si la reponse ne reproche que le code, c'est que toute la chaine d'authentification est acceptee, et le plugin l'annonce en clair.
C'est la verification decisive, et elle ne demande ni membre, ni navigateur, ni rendez-vous : elle peut se faire des que les certificats sont en place. En cas d'echec, le message designe le maillon en cause (certificat, signature, identifiants, ou type d'autorisation du client) plutot qu'un code d'erreur brut.
Le bloc Diagnostic en bas de page complete cela hors ligne : extensions PHP, lisibilite des fichiers, dates d'expiration, correspondance entre chaque certificat et sa cle, et permissions des cles privees sur les serveurs qui les gerent.
Gestion des comptes
Deux modes, selon ce que souhaite le club :
- Comptes existants uniquement (par defaut) : le membre doit deja avoir un compte WordPress portant son identifiant OpenFlyers. Cet identifiant se saisit dans la fiche de l'utilisateur WordPress, section OpenFlyers. Mode recommande quand l'espace membres compte peu d'utilisateurs ou quand les comptes existent deja.
- Creation automatique : tout membre qui se connecte via OpenFlyers obtient un compte WordPress
avec le role choisi. Le compte cree porte l'identifiant
of-<identifiant OpenFlyers>et n'a pas d'adresse e-mail tant que celle-ci n'est pas fournie (voir section 8).
6. Utiliser dans les pages
Bouton de connexion :
[openflyers_login]
[openflyers_login label="Acceder a l'espace membres" redirect="https://www.exemple.fr/espace-membres/"]
Contenu reserve aux membres :
[openflyers_membre]
Contenu visible uniquement par les membres connectes via OpenFlyers.
[/openflyers_membre]
Dans un theme :
if (function_exists('of_sso_is_member') && of_sso_is_member()) {
// Contenu reserve.
}
echo '<a href="' . esc_url(of_sso_login_url()) . '">Se connecter</a>';
7. Au quotidien : gerer les acces
Autoriser les membres cote OpenFlyers
Prealable indispensable, a faire une fois. Dans OpenFlyers, Admin > Utilisateurs > Profils, onglet Generalites : cocher la case Connexion depuis l'exterieur (OAuth2) pour les profils dont les membres doivent pouvoir se connecter au site (pilotes, eleves, instructeurs, selon le club).
OpenFlyers verifie cette autorisation apres la saisie des identifiants. Un membre dont aucun profil ne la porte voit sa connexion refusee avec Connected user is not allowed to login, meme si tout le reste est correctement configure. C'est aussi le levier qui permet de restreindre l'espace membres a une categorie d'adherents : seuls les profils coches ici accedent au site.
Ce que vit le membre
Il clique sur le bouton de connexion, arrive sur la page de connexion OpenFlyers de la plateforme du club, saisit ses identifiants habituels, et revient sur le site deja connecte. Il ne cree pas de compte, ne choisit pas de mot de passe, et n'a rien a retenir de plus. La deconnexion se fait normalement depuis WordPress ; elle ne le deconnecte pas d'OpenFlyers.
Associer un membre a un compte WordPress
Necessaire uniquement si la creation automatique est desactivee.
- Dans OpenFlyers, ouvrir la fiche du membre (administration des utilisateurs). Son identifiant
apparait dans l'URL de la fiche, dans le parametre
menuParameter. - Dans WordPress, Utilisateurs > modifier l'utilisateur concerne, section OpenFlyers, saisir cet identifiant et enregistrer.
Un identifiant ne peut etre associe qu'a un seul compte WordPress.
Retirer un acces
Videz le champ Identifiant du membre dans la fiche WordPress de la personne : elle ne pourra plus se connecter via OpenFlyers, sans que son compte WordPress soit supprime. Un membre radie du club perd de toute facon l'acces des que son compte OpenFlyers est desactive, puisque l'authentification se fait chez nous.
Un membre n'arrive pas a se connecter
- "Connected user is not allowed to login", affiche par OpenFlyers juste apres la saisie des identifiants : le membre n'appartient a aucun profil ou la case Connexion depuis l'exterieur (OAuth2) est cochee. Voir le debut de cette section. C'est de loin la cause la plus frequente lors d'une premiere mise en service.
- "Aucun compte de ce site n'est associe a votre compte OpenFlyers" : la liaison decrite ci-dessus n'a pas ete faite, ou l'identifiant saisi n'est pas le bon.
- "Session de connexion expiree ou invalide" : le membre a mis plus de dix minutes a se connecter, ou a utilise un vieil onglet. Il suffit de recommencer.
- La page de connexion OpenFlyers refuse ses identifiants : le probleme est cote OpenFlyers, pas cote site. Verifier son compte dans la plateforme.
Pour tout le reste, activer la journalisation dans les reglages et consulter la section 9.
8. Recuperer le nom et l'e-mail du membre
Le scope default.login retourne uniquement l'identifiant interne OpenFlyers du membre. Pour
alimenter le nom ou l'e-mail du compte WordPress, il faut creer un rapport dans OpenFlyers exposant
ces donnees, autoriser le scope de lecture correspondant sur le client, puis brancher le filtre
of_sso_user_profile :
add_filter('of_sso_scope', function () {
return 'default.login reports.readonly';
});
add_filter('of_sso_user_profile', function ($profile, $ofUserId, $token, $client) {
// 42 : identifiant du rapport OpenFlyers renvoyant les coordonnees des membres.
$report = $client->getReport($token, 42, 'report', array('userId' => $ofUserId));
// Adapter l'extraction aux colonnes du rapport.
// $profile['user_email'] = ...;
// $profile['first_name'] = ...;
// $profile['last_name'] = ...;
// $profile['display_name'] = ...;
return $profile;
}, 10, 4);
Autres points d'extension :
of_sso_client_config: modifier la configuration du client avant chaque appel ;of_sso_after_login: action declenchee apres la connexion, avec l'utilisateur WordPress, l'identifiant OpenFlyers et le jeton.
9. Depannage
Commencez par le bouton Tester la connexion a OpenFlyers (section 5) : il nomme le maillon en cause. Pour aller plus loin, activez la journalisation dans les reglages et consultez le journal PHP du site, ou vous retrouverez le message exact renvoye par le serveur.
| Message renvoye par OpenFlyers | Cause probable |
|---|---|
invalid_client |
client_id errone, ou client non declare sur cette plateforme. |
invalid_certificate |
Le certificat TLS envoye ne correspond pas a celui enregistre. Si les certificats sont corrects, l'hebergeur termine probablement le TLS sur un proxy : activer l'option X-SSL-CERT. |
invalid_request / Invalid signature |
Signature HTTP invalide : mauvaise cle de signature, ou horloge du serveur desynchronisee. Verifier la synchronisation NTP. |
invalid_grant |
Code d'autorisation expire (10 minutes) ou redirect_uri different de celui declare dans OpenFlyers. |
| Erreur cURL 58 / 35 | Cle privee illisible par PHP, ou certificat client refuse lors de la negociation TLS. |
10. Securite
- Les cles privees restent hors de la racine web, en permissions
600. - La passphrase du client est stockee dans les options WordPress : la base de donnees du site doit etre protegee au meme titre qu'un secret applicatif.
- Le parametre
stateet le PKCE sont verifies a chaque connexion ; une demande non aboutie expire au bout de 10 minutes. - La signature et l'empreinte des reponses du serveur sont verifiees avant exploitation du jeton.
- En cas de compromission, revoquer le client dans l'administration OpenFlyers : les certificats emis pour ce client cessent immediatement d'etre acceptes.
11. Tests
Deux tests sont fournis, aucun ne contacte de serveur.
Le premier verifie le protocole : generation PKCE, URL d'autorisation, signature HTTP, et rejet des reponses alterees (empreinte ou signature invalide, statut HTTP en erreur). Il genere son propre certificat et fonctionne sans WordPress, ce qui permet de valider l'installation PHP de l'hebergement avant meme de configurer le client :
php tests/smoke-test.php
Le second verifie l'integration WordPress : activation du plugin, enregistrement des reglages, resolution du dossier de certificats, demarrage de la connexion, rejet d'un retour invalide, association des comptes, shortcodes, page de reglages et champ de liaison dans la fiche utilisateur. Il se lance depuis la racine du site :
php wp-content/plugins/openflyers-sso/tests/wordpress-test.php
Si le dossier du plugin est un lien symbolique vers une copie de travail situee ailleurs, indiquez le site explicitement :
php wordpress-test.php /chemin/vers/le/site
Il cree ses propres comptes de test (pilote.test, of-7777, of-8888) et les supprime a chaque
execution. A ne pas lancer sur le site de production.
Ces deux tests portent sur le plugin lui-meme. Pour verifier la configuration reelle d'un site, c'est le bouton Tester la connexion a OpenFlyers de la page de reglages qu'il faut utiliser.