Code source wiki de Single sign-on NTLM

Modifié par jhurst le 2024/04/02 14:26
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 Ce document décrit comment connecter la valve Waffle dans DigDash Enterprise pour activer la Sécurité Intégrée Windows (NTLM...).
6
7 Cet add-on est situé dans le dossier **<DDE install>/add-ons/singlesignon/Waffle**.
8
9 La version actuelle de Waffle est 1.8.1.
10
11 Ce document décrit chaque dossiers et fichiers à modifier pour activer cette valve.
12
13 (((
14 = apache-tomcat / lib =
15 )))
16
17 __Désinstallation de la version précédente de Waffle :__
18
19 Dans le cas ou vous mettez à jour DigDash, il est possible qu’une ancienne version de Waffle ait été déployée sur votre Tomcat. Vous devez d’abord supprimer cette version de **<DDE install>/apache-tomcat/lib **avant d’installer la nouvelle.
20
21 Veuillez vous référer au guide de déploiement Waffle de votre version précédente de DigDash Enterprise pour connaître la liste des fichiers de la librairie Waffle à supprimer..
22
23 __Tomcat 8__
24
25 Ajouter les librairies JAR Waffle du dossier **<DDE install>/add-ons/singlesignon/Waffle/Tomcat8** dans le dossier **<DDE install>/apache-tomcat/lib **:
26
27 * guava-19.0.jar
28 * jna-4.2.1.jar
29 * jna-platform-4.2.1.jar
30 * slf4j-api-1.7.21.jar
31 * slf4j-log4j12-1.7.21.jar
32 * log4j-1.2.15.jar
33 * waffle-jna-1.8.1.jar
34 * waffle-tomcat8-1.8.1.jar
35 * waffle_digdash_extension_tomcat8.jar
36 * log4j.properties
37
38 __Tomcat 7__
39
40 Ajouter les librairies JAR Waffle du dossier **<DDE install>/add-ons/singlesignon/Waffle/Tomcat7** dans le dossier **<DDE install>/apache-tomcat/lib **:
41
42 * guava-19.0.jar
43 * jna-4.2.1.jar
44 * jna-platform-4.2.1.jar
45 * slf4j-api-1.7.21.jar
46 * slf4j-log4j12-1.7.21.jar
47 * log4j-1.2.15.jar
48 * waffle-jna-1.8.1.jar
49 * waffle-tomcat7-1.8.1.jar
50 * waffle_digdash_extension_tomcat7.jar
51 * log4j.properties
52
53 = apache-tomcat / conf / context.xml =
54
55 Ajouter le XML suivant pour la valve de sécurité :
56
57 {{code language="XML"}}
58 <Valve className="waffle.apache.SharedNegotiateAuthenticator" principalFormat="fqn" roleFormat="both"
59 sharedPasswd="SecretPwdToChange" allowAddr="localhost,127.0.0.*"></Valve>
60 <Realm className="waffle.apache.WindowsRealm"></Realm>
61 {{/code}}
62
63 Il est nécessaire de changer le mot de passe partagé (**sharedPasswd**). Ce mot de passe doit être identique à celui spécifié dans le fichier **<DDE install>/apache-tomcat/digdash_dashboard/WEB-INF/web.xml** (voir chapitre IV).
64
65 Vous pouvez aussi ajouter les adresses des hôtes distants autorisés (**allowAddr**) pour permettre à d'autres applications (digdash_dashboard) de se connecter au serveur DigDash Enterprise. Dans l'attribut **allowAddr**, vous devriez ajouter au minimum l'adresse IP de votre serveur.
66
67 (% id="Hapache-tomcat2Fconf2Fweb.xml" %)
68 = apache-tomcat / conf / web.xml =
69
70 Ajouter le XML suivant pour la contrainte de sécurité :
71
72 {{code language="XML"}}
73 <security-role>
74 <role-name>Tout le monde</role-name>
75 </security-role>
76 <security-constraint>
77 <display-name>Waffle Security Constraint</display-name>
78 <web-resource-collection>
79 <web-resource-name>Protected Area</web-resource-name>
80 <url-pattern>/*</url-pattern>
81 </web-resource-collection>
82 <auth-constraint>
83 <role-name>Tout le monde</role-name>
84 </auth-constraint>
85 </security-constraint>
86 <security-constraint>
87 <display-name>vjdbc Security Constraint</display-name>
88 <web-resource-collection>
89 <web-resource-name>UnProtected Area</web-resource-name>
90 <url-pattern>/vjdbc/*</url-pattern>
91 </web-resource-collection>
92 </security-constraint>
93
94 {{/code}}
95
96
97 (% class="box warningmessage" %)
98 (((
99 Le nom du "security role" (role-name) DOIT correspondre au rôle réel que vous avez dans votre AD (localisé). Exemple : BUILTIN\Utilisateurs
100 )))
101
102 Si vous n’êtes pas sûr du nom du rôle vous pouvez activer les informations de debug pour Waffle en utilisant le fichier log4j.properties fournit avec les jar.
103
104 Il suffit de le placer dans le répertoire **<DDE install>/apache-tomcat/lib**.
105
106 (% id="Hapache-tomcat2Fwebapps2Fdigdash_dashboard2FWEB-INF2Fweb.xml" %)
107 = apache-tomcat / webapps / digdash_dashboard / WEB-INF / web.xml =
108
109 Chercher la définition du paramètre **sharedPasswd** dans ce fichier, décommenter le bloc XML correspondant et changer la valeur du mot de passe  :
110
111 {{code language="XML"}}
112 <init-param>
113 <param-name>sharedPasswd</param-name>
114 <param-value>SecretPwdToChange</param-value>
115 </init-param>
116 {{/code}}
117
118
119 (% class="box warningmessage" %)
120 (((
121 Le mot de passe spécifié doit être identique à celui que vous avez mis dans le fichier **<DDE install>/apache-tomcat/conf/context.xml**.
122 )))
123
124
125
126 (% class="wikigeneratedid" id="HParamE8tresrecommandE9spourleloginautomatiquedutableaudebord" %)
127 __Paramètres recommandés pour le login automatique du tableau de bord__ :
128
129 Il est recommandé de configurer les paramètres suivants dans le fichier **<DDE install>/apache-tomcat/webapps/digdash_dashboard/WEB-INF/web.xml** lors du déploiement en mode Sécurité Windows Intégrée (Waffle).
130
131 Spécifier (et forcer) le domaine DigDash Enterprise :
132
133 {{code language="XML"}}
134 <init-param>
135 <param-name>DOMAIN</param-name>
136 <param-value>ddenterpriseapi</param-value>
137 </init-param>
138 <init-param>
139 <param-name>FORCEDOMAIN</param-name>
140 <param-value>true</param-value>
141 </init-param>
142 {{/code}}
143
144 Spécifier (et forcer) l’URL du serveur du domain DigDash Enterprise. Utiliser l’adresse //localhost// si l’application web ddenterpriseapi est installée sur le même Tomcat que l’application web digdash_dashboard. Adapter le port si nécessaire :
145
146 {{code language="XML"}}
147 <init-param>
148 <param-name>SERVERURL</param-name>
149 <param-value>http://localhost:8080</param-value>
150 </init-param>
151 <init-param>
152 <param-name>FORCESERVERURL</param-name>
153 <param-value>true</param-value>
154 </init-param>
155 {{/code}}
156
157 Spécifier une URL de déconnexion afin que l’utilisateur puisse se déconnecter de DigDash Enterprise et, par exemple, revenir à une page d’Intranet :
158
159 {{code language="XML"}}
160 <init-param>
161 <param-name>urlLogout</param-name>
162 <param-value>/adminconsole</param-value>
163 </init-param>
164
165 {{/code}}
166
167
168 (% class="box warningmessage" %)
169 (((
170 Par défaut la déconnexion du tableau de bord retourne à la page de login de ce dernier. Cette page n’existe pas dans le contexte du SSO. Il est important de spécifier une URL de retour en cas de déconnexion.
171 )))
172
173 Voir la documentation [[Réglages avancés des paramètres système>>doc:Digdash.deployment.configuration.advanced_system_guide.WebHome]] pour plus de détails sur ces paramètres.
174
175 = apache-tomcat / webapps / studio / WEB-INF / web.xml =
176
177 Chercher la définition du paramètre **sharedPasswd** dans ce fichier, décommenter le bloc XML correspondant et changer la valeur du mot de passe  :
178
179 {{code language="XML"}}
180 <context-param>
181 <param-name>sharedPasswd</param-name>
182 <param-value>SecretPwdToChange</param-value>
183 </context-param>
184 {{/code}}
185
186
187 (% class="box warningmessage" %)
188 (((
189 Le mot de passe spécifié doit être identique à celui que vous avez mis dans le fichier **<DDE install>/apache-tomcat/conf/context.xml**.
190 )))
191
192
193 __Paramètres recommandés pour le login automatique du Web Studio__ :
194
195 Il est recommandé de configurer les paramètres suivants dans le fichier **<DDE install>/apache-tomcat/webapps/studio/WEB-INF/web.xml** lors du déploiement en mode Sécurité Windows Intégrée (Waffle).
196
197 Spécifier (et forcer) le domaine DigDash Enterprise :
198
199 {{code language="xml"}}
200 <context-param>
201    <param-name>FORCEDOMAIN</param-name>
202    <param-value>false</param-value>
203 </context-param>
204 <context-param>
205    <param-name>DOMAIN</param-name>
206    <param-value>ddenterpriseapi</param-value>
207 </context-param>
208 {{/code}}
209
210 Spécifier (et forcer) l’URL du serveur du domain DigDash Enterprise. Utiliser l’adresse //localhost// si l’application web ddenterpriseapi est installée sur le même Tomcat que l’application web digdash_dashboard. Adapter le port si nécessaire :
211
212 {{code language="xml"}}
213 <context-param>
214    <param-name>FORCESERVERURL</param-name>
215    <param-value>false</param-value>
216 </context-param>
217 <context-param>
218    <param-name>SERVERURL</param-name>
219    <param-value>http://localhost:8080</param-value>
220 </context-param>
221 {{/code}}
222
223 Spécifier une URL de déconnexion afin que l’utilisateur puisse se déconnecter de DigDash Enterprise et, par exemple, revenir à une page d’Intranet :
224
225 {{code language="xml"}}
226 <context-param>
227   <param-name>urlLogout</param-name>
228   <param-value>/adminconsole</param-value>
229 </context-param>
230 {{/code}}
231
232 Par défaut la déconnexion du Web Studio retourne à la page de login de ce dernier. Cette page n’existe pas dans le contexte du SSO. Il est important de spécifier une URL de retour en cas de déconnexion.
233
234 = apache-tomcat / webapps / ddenterpriseapi / WEB-INF / web.xml =
235
236 Chercher la définition du paramètre **authMethod** dans ce fichier et changer sa valeur en **NTUser** :
237
238 {{code language="XML"}}
239 <init-param>
240 <param-name>authMethod</param-name>
241 <!-- possible values: LDAP, PassThru, NTUser, NTUserOrLDAP -->
242 <param-value>NTUser</param-value>
243 </init-param>
244 {{/code}}
245
246 //Note ~://
247
248 Le mode «** NTUserOrLDAP **» permet une authentification sur le serveur DigDash via la sécurité Windows Intégrée, avec une option pour s’authentifier via le LDAP DigDash en cas d’échec.
249
250 Par exemple, un utilisateur du domaine NT pourra automatiquement passer la valve Waffle avec son authentifiant Windows, mais, s’il n’existe pas dans le LDAP DigDash, il se verra proposer un écran de login pour s’authentifier avec un login DigDash.
251
252 Dans ce mode, un paramètre supplémentaire «** loginForm **» de certaines URLs permet d’afficher de toujours afficher l’écran de login DigDash. Ainsi, l’authentifiant Windows ne sert qu’à passer la valve Waffle. Un cas typique d’usage est de permettre à un utilisateur Windows de se connecter en tant qu’ « admin » dans des pages de configuration DigDash.
253
254 (% id="Hapache-tomcat2Fwebapps2Fadminconsole2Fdigdash.jnlp" %)
255 = apache-tomcat / webapps / adminconsole / digdash.jnlp =
256
257 Par défaut, si le serveur DigDash est configuré pour utiliser la sécurité Windows Intégrée, la connexion du Studio au domaine DigDash Enterprise se fait en spécifiant le login Windows (domaine NT\user) et son mot de passe. Par exemple :
258
259 Utilisateur : NT_DOMAIN\user1
260
261 Mot de passe : ~*~*~*~*~*~*
262
263 Il existe un moyen de permettre au Studio de se connecter automatiquement avec l’authentifiant de la session Windows courante. Les prérequis suivants sont nécessaires :
264
265 * Lancement du Studio à partir d’une session Windows authentifiée dans le domaine de sécurité Windows concerné
266 * L’URL du serveur DigDash, le nom du domaine DigDash Enterprise et le mode d’authentification du Studio (NTUser, NTUserOrLDAP…) sont paramétrés et forcés dans le fichier JNLP
267
268 Effectuer les réglages suivants dans le fichier **<DDE install>/apache-tomcat/webapps/adminconsole/digdash.jnlp **si vous souhaitez activer le login automatique avec la sécurité Windows Intégrée dans le Studio Digdash Enterprise.
269
270 A la fin de ce fichier se trouve le bloc XML d’exécution du Studio. Remplacer la valeur de certains paramètres de ce bloc comme illustré ci-dessous :
271
272 {{code language="JSP"}}
273 <application-desc main-class="commandline.CommandLineMain">
274 <argument>http://serverur_digdash:8080</argument>
275 <argument>ddenterpriseapi</argument>
276 <argument><%= XMLEncode(lang) %></argument>
277 <argument><%= XMLEncode(dashboard) %></argument>
278 <argument>-AuthMode=NTUserOrLDAP %></argument><!-- "default", "NTUser" or "NTUserOrLDAP" or "NTUserOrLDAP,loginForm" or "External" -->
279 <argument>-ForceServerDomain</argument>
280 <% if (sslNoPathCheck) { %><argument>-SSLNoPathCheck</argument><% } %>
281 <% if (sslNoHostNameCheck) { %><argument>-SSLNoHostNameCheck</argument><% } %>
282 <% if (cryptPass) { %><argument>-CryptPass</argument><% } %>
283 </application-desc>
284 {{/code}}
285
286 Description des paramètres modifiés :
287
288 * **1^^er^^ argument** : URL du serveur DigDash accessible par le Studio.
289 * **2^^ème^^ argument** : Nom du domaine DigDash Enterprise.
290 * **5^^ème^^ argument** : Mode d’authentification forcé du Studio. Seuls les modes «** NTUser **», «** NTUserOrLDAP **» ou « **NTUserOrLDAP,loginForm** » permettent le login automatique via la Sécurité Windows Intégrée.
291 * **6^^ème^^ argument** : Forcer l’URL et le nom de domaine : ils sont en lecture seule dans la boite de login du Studio