blob: 0cced90bc7a26e82b4b413a4ff0b7b4d4a874928 (
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
|
<com:TContent ID="Main">
<h1>Authentification et Autorisation</h1>
<p>
Avant que nous n'implémentions la gestion des utilisateurs, nous devons activer les modules <a href="http://www.pradosoft.com/demos/quickstart/index.php?page=Advanced.Auth">authentification et autorisation</a>.
</p>
<p>
Nous ajoutons deux nouveaux modules à notre fichier de configuration de l'application.
</p>
<com:TTextHighlighter CssClass="source" Language="xml">
<modules>
...modules TDataSourceConfig et TActiveRecordConfig ...
<module id="auth"
class="System.Security.TAuthManager"
UserManager="users"
LoginPage="users.LoginUser" />
<module id="users"
class="System.Security.TDbUserManager"
UserClass="Application.BlogUser" />
</modules>
</com:TTextHighlighter>
<p>
Le module <a href="http://www.pradosoft.com/docs/classdoc/TAuthManager">TAuthManager</a> gère le processus d'authentification et d'autorisation. Il utilise le module <tt>users</tt> comme gestionnaire d'utilisateur (voir ci-après). En spécifiant la propriété <tt>LoginPage</tt>, nous indiquons au module d'authentification de rediriger vers la page <tt>LoginUser</tt> quand il est nécessaire de s'authentifier. Nous décrirons comment créer la page <tt>LoginUser</tt> ci-après.
</p>
<p>
Le module <tt>user</tt> est une classe de type <a href="http://www.pradosoft.com/docs/classdoc/TDbUserManager">TDbUserManager</a> qui est responsable de la vérification et de la validation des utilisateurs et qui enregistre dans une session PHP les données utilisateurs. La propriété <tt>UserClass</tt> est initialisée comme étant de type <tt>Application.BlogUser</tt>, ceci indique au module <tt>user</tt> de chercher une classe <tt>BlogUser</tt> dans le dossier <tt>protected</tt> (rappellez-vous que l'alias <tt>Application</tt> fait référence au dossier <tt>protected</tt>) et d'utiliser cette classe pour conserver les données utilisateurs dans une session.
Le module <tt>user</tt> est une classe de type <a href="http://www.pradosoft.com/docs/classdoc/TDbUserManager">TDbUserManager</a> qui est responsable de la vérification et de la validation des utilisateurs et qui enregistre dans une session PHP les données utilisateurs. La propriété <tt>UserClass</tt> est initialisée comme étant de type <tt>Application.BlogUser</tt>, ceci indique au module <tt>user</tt> de chercher une classe <tt>BlogUser</tt> dans le dossier <tt>protected</tt> (rappellez-vous que l'alias <tt>Application</tt> fait référence au dossier <tt>protected</tt>) et d'utilisez cette classe pour conserver les données utilisateurs dans une session.
</p>
<p>
Comme vous pourrez le constater dans les sections suivantes, dans les différents contrôles et pages, nous pourrons utiliser <tt>$this->User</tt> pour accéder à l'objet qui contient les informations de l'utilisateur actuellement connecté.
</p>
<p>
Ci-dessous les détails de l'implémentation de la classe <tt>BlogUser</tt>. Remarquez que les <a href="http://www.pradosoft.com/demos/quickstart/index.php?page=Database.ActiveRecord">Active Record</a> sont utilisés pour exécuter une requête. Par exemple, nous utilisons <tt>UserRecord::finder()->findByPk($username)</tt> pour chercher la valeur de <tt>$username</tt> dans la table <tt>users</tt> et ceci par la clé primaire.
</p>
<com:TTextHighlighter CssClass="source" Language="php">
// Include TDbUserManager.php file which defines TDbUser
Prado::using('System.Security.TDbUserManager');
/**
* La classe BlogUser.
* BlogUser représente les données utilisateurs à conserver en session.
* L'implémentation par défaut conserve le nom et le rôle de l'utilisateur.
*/
class BlogUser extends TDbUser
{
/**
* Créer un objet de type BlogUser basé sur le nom de l'utilisateur.
* Cette méthode est requise par TDbUser. Cet objet vérifie si l'utilisateur
* est bien présent en base de données. Si oui, un objet BlogUser
* est créé et initialisé.
* @param string le nom de l'utilisateur
* @return l'objet BlogUser, null si le nom de l'utilisateur est invalide.
*/
public function createUser($username)
{
// utilise l'Active Record UserRecord pour chercher l'utilisateur username
$userRecord=UserRecord::finder()->findByPk($username);
if($userRecord instanceof UserRecord) // si trouvé
{
$user=new BlogUser($this->Manager);
$user->Name=$username; // enregistre le nom de l'utilisateur
$user->Roles=($userRecord->role==1?'admin':'user'); // et son rôle
$user->IsGuest=false; // l'utilisateur n'est pas un invité
return $user;
}
else
return null;
}
/**
* Vérifie que le nom d'utilisateur et son mot de passe sont correct.
* Cette méthode est requise par TDbUser.
* @param string le nom de l'utilisateur
* @param string le mot de passe
* @return boolean en fonction de la validité de la vérification.
*/
public function validateUser($username,$password)
{
// utilise l'Active Record UserRecord pour vérifier le nom d'utilisateur couplé au mot de passe.
return UserRecord::finder()->findBy_username_AND_password($username,$password)!==null;
}
/**
* @return boolean indiquant si l'utilisateur est un administrateur.
*/
public function getIsAdmin()
{
return $this->isInRole('admin');
}
}
</com:TTextHighlighter>
</com:TContent>
|