aboutsummaryrefslogtreecommitdiff
path: root/vendors/simpletest/docs/fr/authentication_documentation.html
blob: 782a46b1227c0357790cf05fac35d64e1ef4efbe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Documentation Simple Test : tester l'authentification</title>
<link rel="stylesheet" type="text/css" href="docs.css" title="Styles">
</head>
<body>
<div class="menu_back"><div class="menu">
<a href="index.html">SimpleTest</a>
                |
                <a href="overview.html">Overview</a>
                |
                <a href="unit_test_documentation.html">Unit tester</a>
                |
                <a href="group_test_documentation.html">Group tests</a>
                |
                <a href="mock_objects_documentation.html">Mock objects</a>
                |
                <a href="partial_mocks_documentation.html">Partial mocks</a>
                |
                <a href="reporter_documentation.html">Reporting</a>
                |
                <a href="expectation_documentation.html">Expectations</a>
                |
                <a href="web_tester_documentation.html">Web tester</a>
                |
                <a href="form_testing_documentation.html">Testing forms</a>
                |
                <a href="authentication_documentation.html">Authentication</a>
                |
                <a href="browser_documentation.html">Scriptable browser</a>
</div></div>
<h1>Documentation sur l'authentification</h1>
        This page...
        <ul>
<li>
            Passer au travers d'une <a href="#basique">authentification HTTP basique</a>
        </li>
<li>
            Tester l'<a href="#cookies">authentification basée sur des cookies</a>
        </li>
<li>
            Gérer les <a href="#session">sessions du navigateur</a> et les timeouts
        </li>
</ul>
<div class="content">
        
            <p>
                Un des secteurs à la fois délicat et important lors d'un test
                de site web reste la sécurité. Tester ces schémas est au coeur
                des objectifs du testeur web de SimpleTest.
            </p>
        
        <p><a class="target" name="basique"><h2>Authentification HTTP basique</h2></a></p>
            <p>
                Si vous allez chercher une page web protégée
                par une authentification basique, vous hériterez d'une entête 401.
                Nous pouvons représenter ceci par ce test...
<pre>
class AuthenticationTest extends WebTestCase {<strong>
    function test401Header() {
        $this-&gt;get('http://www.lastcraft.com/protected/');
        $this-&gt;showHeaders();
    }</strong>
}
</pre>
                Ce qui nous permet de voir les entêtes reçues...
                <div class="demo">
                    <h1>File test</h1>
<pre style="background-color: lightgray; color: black">
HTTP/1.1 401 Authorization Required
Date: Sat, 18 Sep 2004 19:25:18 GMT
Server: Apache/1.3.29 (Unix) PHP/4.3.4
WWW-Authenticate: Basic realm="SimpleTest basic authentication"
Connection: close
Content-Type: text/html; charset=iso-8859-1
</pre>
                    <div style="padding: 8px; margin-top: 1em; background-color: green; color: white;">1/1 test cases complete.
                    <strong>0</strong> passes, <strong>0</strong> fails and <strong>0</strong> exceptions.</div>
                </div>
                Sauf que nous voulons éviter l'inspection visuelle,
                on souhaite que SimpleTest puisse nous dire si oui ou non
                la page est protégée. Voici un test en profondeur sur nos entêtes...
<pre>
class AuthenticationTest extends WebTestCase {
    function test401Header() {
        $this-&gt;get('http://www.lastcraft.com/protected/');<strong>
        $this-&gt;assertAuthentication('Basic');
        $this-&gt;assertResponse(401);
        $this-&gt;assertRealm('SimpleTest basic authentication');</strong>
    }
}
</pre>
                N'importe laquelle de ces assertions suffirait,
                tout dépend de la masse de détails que vous souhaitez voir.
            </p>
            <p>
                La plupart du temps, nous ne souhaitons pas tester
                l'authentification en elle-même, mais plutôt
                les pages protégées par cette authentification.
                Dès que la tentative d'authentification est reçue,
                nous pouvons y répondre à l'aide d'une réponse d'authentification :
<pre>
class AuthenticationTest extends WebTestCase {
    function testAuthentication() {
        $this-&gt;get('http://www.lastcraft.com/protected/');<strong>
        $this-&gt;authenticate('Me', 'Secret');</strong>
        $this-&gt;assertTitle(...);
    }
}
</pre>
                Le nom d'utilisateur et le mot de passe seront désormais
                envoyés à chaque requête vers ce répertoire
                et ses sous-répertoires.
                En revanche vous devrez vous authentifier à nouveau
                si vous sortez de ce répertoire mais SimpleTest est assez
                intelligent pour fusionner les sous-répertoires dans un même domaine.
            </p>
            <p>
                Vous pouvez gagner une ligne en définissant
                l'authentification au niveau de l'URL...
<pre>
class AuthenticationTest extends WebTestCase {
    function testCanReadAuthenticatedPages() {
        $this-&gt;get('http://<strong>Me:Secret@</strong>www.lastcraft.com/protected/');
        $this-&gt;assertTitle(...);
    }
}
</pre>
                Si votre nom d'utilisateur ou mot de passe comporte
                des caractères spéciaux, alors n'oubliez pas de les encoder,
                sinon la requête ne sera pas analysée correctement.
                De plus cette entête ne sera pas envoyée aux
                sous requêtes si vous la définissez avec une URL absolue.
                Par contre si vous naviguez avec des URL relatives,
                l'information d'authentification sera préservée.
            </p>
            <p>
                 Pour l'instant, seule l'authentification de base est implémentée
                 et elle n'est réellement fiable qu'en tandem avec une connexion HTTPS.
                 C'est généralement suffisant pour protéger
                 le serveur testé des regards malveillants.
                 Les authentifications Digest et NTLM pourraient être ajoutées prochainement.
            </p>
        
        <p><a class="target" name="cookies"><h2>Cookies</h2></a></p>
            <p>
                L'authentification de base ne donne pas assez de contrôle
                au développeur Web sur l'interface utilisateur.
                Il y a de forte chance pour que cette fonctionnalité
                soit codée directement dans l'architecture web
                à grand renfort de cookies et de timeouts compliqués.
            </p>
            <p>
                Commençons par un simple formulaire de connexion...
<pre>
&lt;form&gt;
    Username:
    &lt;input type="text" name="u" value="" /&gt;&lt;br /&gt;
    Password:
    &lt;input type="password" name="p" value="" /&gt;&lt;br /&gt;
    &lt;input type="submit" value="Log in" /&gt;
&lt;/form&gt;
</pre>
                Lequel doit ressembler à...
            </p>
            <p>
                <form class="demo">
                    Username:
                    <input type="text" name="u" value=""><br>
                    Password:
                    <input type="password" name="p" value=""><br>
                    <input type="submit" value="Log in">
                </form>
            </p>
            <p>
                Supposons que, durant le chargement de la page,
                un cookie ait été inscrit avec un numéro d'identifiant de session.
                Nous n'allons pas encore remplir le formulaire,
                juste tester que nous pistons bien l'utilisateur.
                Voici le test...
<pre>
class LogInTest extends WebTestCase {
    function testSessionCookieSetBeforeForm() {
        $this-&gt;get('http://www.my-site.com/login.php');<strong>
        $this-&gt;assertCookie('SID');</strong>
    }
}
</pre>
                Nous nous contentons ici de vérifier que le cookie a bien été défini.
                Etant donné que sa valeur est plutôt énigmatique,
                elle ne vaut pas la peine d'être testée.
            </p>
            <p>
                Le reste du test est le même que dans n'importe quel autre formulaire,
                mais nous pourrions souhaiter nous assurer
                que le cookie n'a pas été modifié depuis la phase de connexion.
                Voici comment cela pourrait être testé :
<pre>
class LogInTest extends WebTestCase {
    ...
    function testSessionCookieSameAfterLogIn() {
        $this-&gt;get('http://www.my-site.com/login.php');<strong>
        $session = $this-&gt;getCookie('SID');
        $this-&gt;setField('u', 'Me');
        $this-&gt;setField('p', 'Secret');
        $this-&gt;clickSubmit('Log in');
        $this-&gt;assertWantedPattern('/Welcome Me/');
        $this-&gt;assertCookie('SID', $session);</strong>
    }
}
</pre>
                Ceci confirme que l'identifiant de session
                est identique avant et après la connexion.
            </p>
            <p>
                Nous pouvons même essayer de duper notre propre système
                en créant un cookie arbitraire pour se connecter...
<pre>
class LogInTest extends WebTestCase {
    ...
    function testSessionCookieSameAfterLogIn() {
        $this-&gt;get('http://www.my-site.com/login.php');<strong>
        $this-&gt;setCookie('SID', 'Some other session');
        $this-&gt;get('http://www.my-site.com/restricted.php');</strong>
        $this-&gt;assertWantedPattern('/Access denied/');
    }
}
</pre>
                Votre site est-il protégé contre ce type d'attaque ?
            </p>
        
        <p><a class="target" name="session"><h2>Sessions de navigateur</h2></a></p>
            <p>
                Si vous testez un système d'authentification,
                la reconnexion par un utilisateur est un point sensible.
                Essayons de simuler ce qui se passe dans ce cas :
<pre>
class LogInTest extends WebTestCase {
    ...
    function testLoseAuthenticationAfterBrowserClose() {
        $this-&gt;get('http://www.my-site.com/login.php');
        $this-&gt;setField('u', 'Me');
        $this-&gt;setField('p', 'Secret');
        $this-&gt;clickSubmit('Log in');
        $this-&gt;assertWantedPattern('/Welcome Me/');<strong>
        
        $this-&gt;restart();
        $this-&gt;get('http://www.my-site.com/restricted.php');
        $this-&gt;assertWantedPattern('/Access denied/');</strong>
    }
}
</pre>
                La méthode <span class="new_code">WebTestCase::restart()</span> préserve les cookies
                dont le timeout a expiré, mais conserve les cookies temporaires ou expirés.
                Vous pouvez spécifier l'heure et la date de leur réactivation.
            </p>
            <p>
                L'expiration des cookies peut être un problème.
                Si vous avez un cookie qui doit expirer au bout d'une heure,
                nous n'allons pas mettre le test en veille en attendant
                que le cookie expire...
            </p>
            <p>
                Afin de provoquer leur expiration,
                vous pouvez dater manuellement les cookies,
                avant le début de la session.
<pre>
class LogInTest extends WebTestCase {
    ...
    function testLoseAuthenticationAfterOneHour() {
        $this-&gt;get('http://www.my-site.com/login.php');
        $this-&gt;setField('u', 'Me');
        $this-&gt;setField('p', 'Secret');
        $this-&gt;clickSubmit('Log in');
        $this-&gt;assertWantedPattern('/Welcome Me/');
        <strong>
        $this-&gt;ageCookies(3600);</strong>
        $this-&gt;restart();
        $this-&gt;get('http://www.my-site.com/restricted.php');
        $this-&gt;assertWantedPattern('/Access denied/');
    }
}
</pre>
                Après le redémarrage, les cookies seront plus vieux
                d'une heure et que tous ceux dont la date d'expiration
                sera passée auront disparus.
            </p>
        
    </div>
        References and related information...
        <ul>
<li>
            La page du projet SimpleTest sur <a href="http://sourceforge.net/projects/simpletest/">SourceForge</a>.
        </li>
<li>
            La page de téléchargement de SimpleTest sur <a href="http://www.lastcraft.com/simple_test.php">LastCraft</a>.
        </li>
<li>
            <a href="http://simpletest.org/api/">L'API du développeur pour SimpleTest</a> donne tous les détails sur les classes et les assertions disponibles.
        </li>
</ul>
<div class="menu_back"><div class="menu">
<a href="index.html">SimpleTest</a>
                |
                <a href="overview.html">Overview</a>
                |
                <a href="unit_test_documentation.html">Unit tester</a>
                |
                <a href="group_test_documentation.html">Group tests</a>
                |
                <a href="mock_objects_documentation.html">Mock objects</a>
                |
                <a href="partial_mocks_documentation.html">Partial mocks</a>
                |
                <a href="reporter_documentation.html">Reporting</a>
                |
                <a href="expectation_documentation.html">Expectations</a>
                |
                <a href="web_tester_documentation.html">Web tester</a>
                |
                <a href="form_testing_documentation.html">Testing forms</a>
                |
                <a href="authentication_documentation.html">Authentication</a>
                |
                <a href="browser_documentation.html">Scriptable browser</a>
</div></div>
<div class="copyright">
            Copyright<br>Marcus Baker 2006
        </div>
</body>
</html>