# 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 : - API OpenFlyers, procedures de declaration d'un client et d'emission des certificats : 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 `curl` et `openssl` ; - 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* : . 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` (ajouter `refresh_token` pour 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 : 1. le code plateforme, le `client_id` et la passphrase ; 2. 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 ; 3. 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-` 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 : ```php if (function_exists('of_sso_is_member') && of_sso_is_member()) { // Contenu reserve. } echo 'Se connecter'; ``` ## 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. 1. Dans OpenFlyers, ouvrir la fiche du membre (administration des utilisateurs). Son identifiant apparait dans l'URL de la fiche, dans le parametre `menuParameter`. 2. 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` : ```php 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 `state` et 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.