lemonldap-ng/po-doc/fr/pages/documentation/current/authgoogle.html
Clément Oudot ea00b9d6c3 New FR doc
2016-10-15 17:57:54 +00:00

125 lines
6.3 KiB
HTML

<!DOCTYPE html>
<html lang="fr" dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta charset="utf-8" />
<title>documentation:2.0:authgoogle</title>
<meta name="generator" content="DokuWiki"/>
<meta name="robots" content="index,follow"/>
<meta name="keywords" content="documentation,2.0,authgoogle"/>
<link rel="search" type="application/opensearchdescription+xml" href="lib/exe/opensearch.html" title="LemonLDAP::NG"/>
<link rel="start" href="authgoogle.html"/>
<link rel="contents" href="authgoogle.html" title="Sitemap"/>
<link rel="stylesheet" type="text/css" href="lib/exe/css.php.t.bootstrap3.css"/>
<link rel="stylesheet" type="text/css" href="/static/bwr/bootstrap/dist/css/bootstrap.min.css"/>
<script type="text/javascript">/*<![CDATA[*/var NS='documentation:2.0';var JSINFO = {"id":"documentation:2.0:authgoogle","namespace":"documentation:2.0"};
/*!]]>*/</script>
<script type="text/javascript" charset="utf-8" src="lib/exe/js.php.t.bootstrap3.js"></script>
</head>
<body>
<div class="dokuwiki export container"><!-- TOC START -->
<div id="dw__toc">
<h3 class="toggle">Table of Contents</h3>
<div>
<ul class="toc">
<li class="level1"><div class="li"><a href="#presentation">Présentation</a></div></li>
<li class="level1"><div class="li"><a href="#configuration">Configuration</a></div></li>
<li class="level1"><div class="li"><a href="#google_migration">Migration Google</a></div></li>
</ul>
</div>
</div><!-- TOC END -->
<h1 class="sectionedit1" id="google">Google</h1>
<div class="level1">
<div class="table sectionedit2"><table class="inline table table-bordered table-striped">
<thead>
<tr class="row0 roweven">
<th class="col0 centeralign"> Authentification </th><th class="col1 centeralign"> Utilisateurs </th><th class="col2 centeralign"> Mot-de-passe </th>
</tr>
</thead>
<tr class="row1 rowodd">
<td class="col0 centeralign"></td><td class="col1 centeralign"></td><td class="col2"> </td>
</tr>
</table></div><!-- EDIT2 TABLE [23-86] -->
</div><!-- EDIT1 SECTION "Google" [1-87] -->
<h2 class="sectionedit3" id="presentation">Présentation</h2>
<div class="level2">
<p>
Google propose d'autoriser les applications à réutiliser son propre processus d'authentification en utilisant le protocole <a href="http://fr.wikipedia.org/wiki/OpenID" class="urlextern" title="http://fr.wikipedia.org/wiki/OpenID" rel="nofollow">OpenID</a> (ce qui signifie que si on est connecté à Google, d'autres applications peuvent agréer Google et accepter l'utilisateur).
</p>
<div class="notewarning">Le support OpenID-2.0 esl clos depuis le 20 avril 2015. S'il est nécessaire d'utiliser la connexion Google après cette date, utiliser le <a href="authopenidconnect.html" class="wikilink1" title="documentation:2.0:authopenidconnect">module d'authentification OpenID-Connect</a>.
</div>
</div><!-- EDIT3 SECTION "Presentation" [88-544] -->
<h2 class="sectionedit4" id="configuration">Configuration</h2>
<div class="level2">
<p>
Dans le manager, allez dans <code>Paramètres generaux</code> &gt; <code>Modules d'authentification</code> et choisissez Google comme module d'authentication. L'adresse email est utilisée comme nom de compte (pour la traçabilité, l'explorateur de session,…). Pour accéder aux autres données, utiliser Google in <code>Paramètres generaux</code> &gt; <code>Modules d'authentification &gt; Modules d'utilisateurs</code>. Ensuite dans les «&nbsp;variables exportées&nbsp;», on ne peut demander que :
</p>
<ul>
<li class="level1"><div class="li"> country</div>
</li>
<li class="level1"><div class="li"> email</div>
</li>
<li class="level1"><div class="li"> firstname</div>
</li>
<li class="level1"><div class="li"> language</div>
</li>
<li class="level1"><div class="li"> lastname</div>
</li>
</ul>
<p>
Utiliser n'importe quel nom de clef mais ces valeurs dans le champ «&nbsp;valeur&nbsp;». Pour imposer qu'une valeur soit renseignée, ajouter un ”!” devant le nom de clef :
</p>
<ul>
<li class="level1"><div class="li"> “myfield ⇒ prénom”, peut être “”</div>
</li>
<li class="level1"><div class="li"> “!myfield ⇒ nom” doit être renseigné</div>
</li>
</ul>
<p>
Voir aussi la <a href="exportedvars.html" class="wikilink1" title="documentation:2.0:exportedvars">configuration des variables exportées</a>.
</p>
<div class="noteimportant">Une session persistente est créée avec ce module pour stocker les valeurs d'attribut renvoyées par Google. Si cette session est perdue, Google redemandera confirmation pour chaque attribut demandé.
</div>
</div><!-- EDIT4 SECTION "Configuration" [545-1491] -->
<h2 class="sectionedit5" id="google_migration">Migration Google</h2>
<div class="level2">
<p>
Un contournement à la migration Google est disponible depuis la version 1.4.4 de LemonLDAP::NG. Il fournit un module OpenID-Connect spécifique et facile qui remplace l'actuel module Google.
</p>
<div class="noteimportant">Ce module n'est plus disponible dans les versions 1.9 et supérieures, il faut utiliser le <a href="authopenidconnect.html" class="wikilink1" title="documentation:2.0:authopenidconnect">module d'authentification OpenID-Connect</a>.
</div>
<p>
Pour l'utiliser, éditer lemonldap-ng.ini (ce n'est pas disponible dans le Manager) et configurer :
</p>
<pre class="code file ini"><span class="re0"><span class="br0">[</span>portal<span class="br0">]</span></span>
<span class="re1">authentication</span> <span class="sy0">=</span><span class="re2"> GoogleMigration</span>
<span class="re1">googleClientId</span> <span class="sy0">=</span><span class="re2"> XXXX</span>
<span class="re1">googleClientSecret</span> <span class="sy0">=</span><span class="re2"> XXXX</span></pre>
<p>
Il faut enregistrer l'application LemonLDAP::NG chez Google pour obtenir le couple identifiant mot-de-passe, voir <a href="https://developers.google.com/" class="urlextern" title="https://developers.google.com/" rel="nofollow">https://developers.google.com/</a>
</p>
<p>
Il faut également enregistrer chez Google l'<abbr title="Uniform Resource Identifier">URI</abbr> de redirection. Il faut indiquer l'<abbr title="Uniform Resource Locator">URL</abbr> du portail avec le paramètre GET « googlecb=1 », par exemple :
</p>
<pre class="code">http://auth.example.com/?googlecb=1</pre>
</div><!-- EDIT5 SECTION "Google Migration" [1492-] -->
</div>
</body>
</html>