====== Association sympa et dokuwiki ======


===== Sites ===== 

  * Dokuwiki 
    * http://wiki-dokuwiki.grenoble-inp.fr
    * https://www.dokuwiki.org

  * Sympa and Dokuwiki farm integration for Virtual Organizations
    * http://www.sympa.org/faq/sympa_and_wiki_farm

  * Couplage Sympa - Dokuwiki
    * http://www.sympa.org/doc/formation/sympa_avance#couplage_sympa_-_dokuwiki

  * Autre façon de shibboletiser sans passer par sympa
    * https://github.com/ivan-novakov/dokuwiki-shibboleth-auth
    * http://www-public.it-sudparis.eu/~procacci/dok/doku.php?id=docpublic:systemes:wiki:installconfdokuwiki#shibboleth

===== Pré-requis pour SYMPA =====

SOAP doit être installé 
  * https://sympa-community.github.io/manual/customize/soap-api.html
  * https://www.sympa.org/dev/soap_extensions

Vérifier la présence du package php-soap 

==== Génération du mot de passe pour SOAP ====

  # ~sympa/bin/sympa.pl -md5_digest=[passwd]   ---> abc256vv28

==== trusted_applications.conf ====

  # vi ~sympa/etc/trusted_applications.conf

  trusted_application
    name wiki
    md5password abc256vv28
    proxy_for_variables USER_EMAIL,remote_host
 
==== Test soap =====

  /home/sympa/bin/sympa_soap_client.pl --soap_url=https://listes.grenoble-inp.fr/sympasoap 
                                       --service=review  --service_parameters=dsi-test@listes.grenoble-inp.fr
                                       --trusted_application=XXXX --trusted_application_password=sXXXX
                                       --proxy_vars=USER_EMAIL=catherine.balleydier@grenoble-inp.fr

===== WIKI =====

Télécharger la dernière version de dokuwiki








== Script authentification ==

# mv lib/plugins/shibbolethauth-1.2 lib/plugins/shibbolethauth

Installation de **lib/plugins/shibbolethauth/files/shibboleth.class.php** dans **inc/auth** soit par l'interface soit manuellement

== Modification script authentification shibboleth ==

pour avoir l'adresse mail en minuscule

  public function trustExternal($user, $pass, $sticky=false) {
    ........


== Paramètres plugin Shibbolethauth == 

|shibbolethEmailAttribute | nom de la variable d'environnement\\ qui contient l'adresse email produite par shibboleth |	mail |
|shibbolethLoginURL | URL de login de shibboleth 	| |
|shibbolethLogoutURL | URL de logout de shibboleth 	| |
|useSympa | utiliser Sympa come backend d'autorisation ? | 1 |	
|sympaSoapService | Adresse du wsdl du service SOAP sympa | |	
|sympaApplicationPwd | mot de passe utilisé pour authentifier dokuwiki auprès de Sympa | |


===  ===

<color blue>** -- Soit la version de la formation de sympa**</color>

===  ===

  * dokuwiki : http://www.sympa.org/_media/doc/formation/formation_avance/dokuwiki.zip
 
  * Shibboleth + association groupe sympa : http://www.sympa.org/_media/doc/formation/formation_avance/sympagroups.zip

Modifier **inc/auth/shibboleth2.class.php** pour avoir l'adresse mail en minuscule

  public function trustExternal($user, $pass, $sticky=false) {
    ........
    /**    $user = $this->getShibEMail(); **/
    $user = strtolower($this->getShibEMail());

Attention en mode édition la toolbar n'apparait pas : supprimer le plugin txtconf




==== Téléchargement pour les dernières versions dokuwiki ====

  * dokuwiki : http://www.splitbrain.org/projects/dokuwiki

=== Shibboleth ===



==== Différentes installations ====


  * Wiki sur le même serveur que sympa
    * [[wiki_serveur_sympa|Wiki]] 
    * [[wiki-liste | Wiki associé à chaque liste sympa]] (ferme de wiki)
  * [[wiki_exterieur|Wiki sur un serveur différent que celui de sympa]]






===== Association droits d’accès aux listes sympa =====

==== Droit d'administration dans conf/local.php ====


<del>  * pour toute une liste :</del>

<del>  $conf['superuser'] = '@dsi-test@grenoble-inp.fr';</del>

<del>  * pour le propriétaire d'une liste :</del> 

<del>  $conf['superuser'] = '@dsi-test-request@grenoble-inp.fr';</del>

==== Configuration de la liste ====

Le paramètre Visibility ( visibilité de la liste) ne doit pas être à secret (liste cachée même aux abonnés)

==== Droits d’accès ====

=== Soit par l'interface administration ===

  [nom de listes]@[nom du serveur de listes]

=== Soit sur le serveur dans [wiki]/conf/acl.auth.php ===

  @dsi%2dtest%40grenoble%2dinp%2efr       16





===== A rediger !!!!! =====

<del>problème minsuscule majuscule
 
inc/auth/shibboleth2.class.php

 $mail = strtolower($mail);
</del>

[[test]]