Extension:SimpleSAMLphp/fr

L’extension SimpleSAMLphp utilise l’extension PluggableAuth extension pour fournir une authentification en utilisant SimpleSAMLphp. Il est principalement conçu pour prendre en charge les flux d'authentification initiés par SP.

Configuration
Les valeurs doivent être renseignées obligatoirement pour les variables de configuration obligatoires :

Variables de configuration optionnelles :

Définir le fournisseur d’informations utilisateur personnalisé
Si vous souhaitez modifier l'un des champs,   ou   avant la connexion, par exemple, si votre source SAML ne fournit pas d'attribut de nom d'utilisateur explicite et que vous souhaitez utiliser l'adresse e-mail sans le domaine pour le nom d'utilisateur, vous pouvez configurer un rappel personnalisé pour. La méthode de fabrique a la signature suivante:

Pour des cas d'utilisation simples, on peut utiliser, en supposant que votre attribut email s'appelle   (s'il s'appelle autre chose, changez les deux instances de   en  ):

Mappage groupe
Use case: your SAML IdP reads groups from LDAP or Database and stores this information inside an attribute of the SAML response. You want to use this to map MediaWiki groups to users belonging to some known groups given by your IdP.

Exemple:


 * Votre IdP envoie un attribut nommé "groupes" avec une liste de noms tels que "administrateur", "étudiant", "enseignant", ... dans la réponse SAML après authentification.
 * Tous les utilisateurs qui ont la valeur "administrator" dans l'attribut "groups" doivent être mappés au groupe "sysop" de MediaWiki pour leur donner des droits d'administrateur au sein de votre instance de MediaWiki.
 * Créez une carte de groupe dans votre LocalSettings.php comme suit:

Vous pouvez proposer des mappages assez complexes qui correspondent à vos besoins. Si vous avez plusieurs attributs de SAML, ajoutez-les simplement au tableau avec le tableau de valeurs que vous souhaitez mapper.

Si un groupe MediaWiki n'existe pas, il sera créé "à la volée" lors du premier mappage réussi d'un utilisateur.

Mappage groupe 2
Depuis la version 4.3, on peut également configurer un mécanisme de synchronisation de groupe alternatif. Outre les "MapGroups" par défaut, on peut utiliser "SyncAllGroups", qui prend tous les groupes de la réponse SAML et leur attribue l'utilisateur.

Pour ce faire, ajoutez ce qui suit au :

Si l'IdP renvoie des noms de groupe qui ne conviennent pas au wiki, on peut mettre en place un callback pour modifier les noms de groupe. Par exemple. certaines configurations IdP peuvent renvoyer des LDAP-DN comme "CN = Admin, OU = Groups, DC = SomeDomain". On pourrait alors préciser en :

Traitement des données arbitraires de la réponse SAML
Les "processeurs d'attributs" peuvent également être utilisés pour traiter des données arbitraires de la réponse SAML. Dans ce cas, il faut d"abord créer une nouvelle classe PHP qui implémente l'interface Pour plus de commodité, la classe de base   peut être utilisée, qui a un rappel de personnalisation approprié et un constructeur implémenté. Un exemple

It then needs to be instantiated by using the.

Notes des versions

 * Version 4.5.2
 * bug corrigé: les groupes ne sont pas supprimés dans MW si l'attribut n'existe pas (T246351)
 * Version 4.5.1
 * correction d'avertissement: $wgSimpleSAMLphp_GroupMap n'est pas un tableau
 * amélioration du chargement des informations utilisateur et des groupes
 * tests améliorés
 * Version 4.5
 * Ajout de la prise en charge des fournisseurs d'informations utilisateur personnalisés
 * mis à jour vers la version 2 du manifeste
 * Version 4.4
 * Signature fixe de la fonction populateGroups pour correspondre au hook
 * Version 4.3
 * Ajout de la prise en charge des processeurs d'attributs
 * Correction d'un bug dans le traitement des attributs SAML
 * Ajout d'un espace de noms compatible PSR-4
 * Suppression du support pour MW <1,31
 * Version 4.2
 * Les fonctions de nom d'utilisateur, de vrai nom et de courrier électronique ont été supprimées afin qu'elles puissent être remplacées dans une sous-classe pour permettre des règles personnalisées
 * Style de codage et répertoires
 * Débogage amélioré
 * Version 4.1
 * Implémente l'accroche pour remplir les groupes MediaWiki à partir des attributs SAML. Merci à Poikilotherm d'avoir contribué à cette fonctionnalité.
 * Version 4.0
 * Ajout d'un message d'erreur facultatif à authenticate
 * Numéro de version bossé à synchroniser avec les extensions PluggableAuth et OpenID Connect

Débogage
L'authentification unique peut être difficile à configurer correctement, en particulier pour les nouveaux administrateurs système chargés de connecter leur nouvelle instance MediaWiki au fournisseur d'identité de la société. The PluggableAuth and SimpleSAMLphp extensions themselves are quite stable, so most issues are usually associated with configuration.

Pour commencer à déboguer, affectez à un chemin de fichier sur votre système local. Vous n'avez pas besoin de définir $wgShowExceptionDetails à true ; en fait, vous ne devriez probablement pas le faire, pour des raisons de sécurité.

Visitez votre wiki et essayez de vous connecter avec PluggableAuth. Une fois que vous avez rencontré votre erreur, consultez le fichier de débogage et cherchez des lignes qui commencent par  et.

En cas de problème d'authentification, le journal de débogage indique quelque part.

L'extension SimpleSAMLphp fonctionne ainsi :


 * 1) L'utilisateur clique sur le bouton de connexion SSO sur wiki.
 * 2) L'utilisateur est dirigé vers Special : PluggableAuthLogin. Il détecte que le wiki utilise Extension : SimpleSAMLphp. SimpleSAMLphp (le logiciel, pas l'extension) détecte qu'aucune session de connexion n'a encore été définie.
 * 3) Special:PluggableAuthLogin appelle la fonction   de SimpleSAMLphp, qui appelle l'API de SimpleSAMLphp pour commencer le processus d'authentification.
 * 4) SimpleSAMLphp redirige l'utilisateur vers la page de connexion du fournisseur d'identité.
 * 5) Une fois que l'utilisateur s'est authentifié avec IDP, il génère une assertion et redirige vers l'URL ACS (service client d'assertion) de votre instance SimpleSAMLphp locale, qui redirige ensuite vers le Special:PluggableAuthLogin du wiki.
 * 6) Special:PluggableAuthLogin reconnaît maintenant le cookie de session et gère la connexion de l'utilisateur.

Si vous rencontrez une boucle de redirection de connexion, le processus d'authentification n'aura jamais la chance de consigner un message d'erreur ou de réussite. Cela indique que l'appel à la méthode  de SimpleSAMLphp ne se termine jamais, ce qui signifie que SimpleSAMLphp essaie de recommencer le processus d'authentification. Ceci est généralement dû au fait qu'il ne détecte pas la session de connexion malgré sa définition. Assurez-vous que vous ne faites pas d'erreurs courantes, telles que ne pas définir votre magasin SimpleSAMLphp sur une méthode basée sur la base de données, ou mettre votre instance SimpleSAMLphp sur un domaine différent de votre wiki sans proxy approprié. (Par exemple, si votre instance de SimpleSAMLphp se trouve dans le domaine canonique  mais que votre wiki est situé à , la session ne sera jamais stockée sur   et Special:PluggableAuthLogin redirigera vers le fournisseur d'identité au lieu de connecter l'utilisateur, créant ainsi une boucle de connexion.)

Si vous rencontrez un message d'erreur sur Special:PluggableAuthLogin après une redirection réussie du fournisseur d'identité, il y a probablement une erreur de configuration PluggableAuth/SimpleSAMLphp dans votre LocalSettings.php. Vérifiez si vous avez correctement configuré vos attributs. The attributes may sometimes need to be URLs (such as if you are using Azure Active Directory).

Bogues connus
Si vous utilisez MediaWiki 1.27 ou version ultérieure avec PluggableAuth 2.0 ou version ultérieure, des problèmes ont été observés lorsque SimpleSAMLphp est configuré pour utiliser phpsession pour store.type. Cela peut être dû T147161. Pour résoudre ce problème, utilisez un type de magasin différent dans la configuration du [logiciel https://simplesamlphp.org/ SimpleSAMLphp] en ajustant simplesamlphp/config/config.php (voir https://simplesamlphp.org/docs/stable/simplesamlphp-maintenance#section_2_3). Par exemple, pour SQLite, utilisez:

'store.type' => 'sql', 'store.sql.dsn' => 'sqlite:/path/where/the/apache/user/can/write/sqlitedatabase.sq3',

Pour MySQL, utilisez:

'store.type' => 'sql', 'store.sql.dsn' => 'mysql:host=xxx;port=xxx;dbname=xxx', 'store.sql.username' => 'xxx', 'store.sql.password' => 'xxx',