FM / fr

/var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/authentication/docs/fr/

/var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/authentication/docs/fr

Name	Size	Mode	Actions
authentication-component.rst	4497	0644	edit dl rm
authenticators.rst	23110	0644	edit dl rm
conf.py	261	0644	edit dl rm
contents.rst	312	0644	edit dl rm
identifiers.rst	7097	0644	edit dl rm
identity-object.rst	3771	0644	edit dl rm
index.rst	9663	0644	edit dl rm
middleware.rst	3109	0644	edit dl rm
migration-from-the-authcomponent.rst	12736	0644	edit dl rm
password-hashers.rst	3100	0644	edit dl rm
testing.rst	2026	0644	edit dl rm
url-checkers.rst	1291	0644	edit dl rm
view-helper.rst	924	0644	edit dl rm

Edit: /var/www/vhosts/ihelp.ro/httpdocs/vendor/cakephp/authentication/docs/fr/password-hashers.rst (3100B)

Hacheurs de mots de passe
#########################

Default
=======

Ce hacheur utilise la constante PHP ``PASSWORD_DEFAULT`` comme méthode de
cryptage. Le type de hachage par défaut est ``bcrypt``.

Cf. `la documentation PHP <https://www.php.net/manual/fr/function.password-hash.php>`__
pour plus d'informations sur bcrypt et le hachage de mots de passe de PHP.

Les options de configuration pour cet adaptateur sont:

-  **hashType**: L'algorithme de hachage à utiliser. Les valeurs valides sont
   celles qui sont supportées par l'argument ``$algo`` de ``password_hash()``.
   Par défaut ``PASSWORD_DEFAULT``.
-  **hashOptions**: Tableau associatif d'options. Consultez le manuel PHP pour
   les options supportées pour chaque type de hachage. Par défaut un tableau
   vide.

Legacy
======

C'est un hacheur de mots de passe pour les applications migrées de CakePHP2.

Fallback
========

Le hacheur de mots de passe de repli (*fallback*) vous permet de
configurer plusieurs hacheurs qu'il vérifiera séquentiellement. Cela permet aux
utilisateurs de se connecter avec un ancien type de hachage jusqu'à ce que leur
mot de passe soit redéfini et mis à niveau vers le nouveau hachage.

Mettre à Niveau les Algorithmes de Hachage
==========================================

CakePHP propose un moyen propre de migrer les mots de passe de vos utilisateurs
d'un algorithme à un autre ; cela s'accomplit avec la classe
``FallbackPasswordHasher``. En supposant que vous veuillez migrer un mot de
passe Legacy vers le hacheur par défaut bcrypt, vous pouvez configurer le
hacheur fallback comme suit::

$service->loadIdentifier('Authentication.Password', [
       // Autres options de configuration
       'passwordHasher' => [
           'className' => 'Authentication.Fallback',
           'hashers' => [
               'Authentication.Default',
               [
                   'className' => 'Authentication.Legacy',
                   'hashType' => 'md5',
                   'salt' => false // coupe l'utilisation par défaut du sel
               ],
           ]
       ]
   ]);

Ensuite, dans votre action login, vous pouvez utiliser le service
d'authentification pour accéder à l'identificateur ``Password`` et vérifier si
le mot de passe de l'utilisateur actuel a besoin d'être mis à niveau::

public function login()
   {
       $authentication = $this->request->getAttribute('authentication');
       $result = $authentication->getResult();

// Que l'on soit en POST ou GET, rediriger l'utilisateur s'il est connecté
       if ($result->isValid()) {
           // En supposant que vous utilisez l'identificateur `Password`.
           if ($authentication->identifiers()->get('Password')->needsPasswordRehash()) {
               // Le re-hachage se produit lors de la sauvegarde.
               $user = $this->Users->get($authentication->getIdentity()->getIdentifier());
               $user->password = $this->request->getData('password');
               $this->Users->save($user);
           }

// Rediriger ou afficher un template.
       }
   }

Hacheurs de mots de passe ######################### Default ======= Ce hacheur utilise la constante PHP ``PASSWORD_DEFAULT`` comme méthode de cryptage. Le type de hachage par défaut est ``bcrypt``. Cf. `la documentation PHP `__ pour plus d'informations sur bcrypt et le hachage de mots de passe de PHP. Les options de configuration pour cet adaptateur sont: - **hashType**: L'algorithme de hachage à utiliser. Les valeurs valides sont celles qui sont supportées par l'argument ``$algo`` de ``password_hash()``. Par défaut ``PASSWORD_DEFAULT``. - **hashOptions**: Tableau associatif d'options. Consultez le manuel PHP pour les options supportées pour chaque type de hachage. Par défaut un tableau vide. Legacy ====== C'est un hacheur de mots de passe pour les applications migrées de CakePHP2. Fallback ======== Le hacheur de mots de passe de repli (*fallback*) vous permet de configurer plusieurs hacheurs qu'il vérifiera séquentiellement. Cela permet aux utilisateurs de se connecter avec un ancien type de hachage jusqu'à ce que leur mot de passe soit redéfini et mis à niveau vers le nouveau hachage. Mettre à Niveau les Algorithmes de Hachage ========================================== CakePHP propose un moyen propre de migrer les mots de passe de vos utilisateurs d'un algorithme à un autre ; cela s'accomplit avec la classe ``FallbackPasswordHasher``. En supposant que vous veuillez migrer un mot de passe Legacy vers le hacheur par défaut bcrypt, vous pouvez configurer le hacheur fallback comme suit:: $service->loadIdentifier('Authentication.Password', [ // Autres options de configuration 'passwordHasher' => [ 'className' => 'Authentication.Fallback', 'hashers' => [ 'Authentication.Default', [ 'className' => 'Authentication.Legacy', 'hashType' => 'md5', 'salt' => false // coupe l'utilisation par défaut du sel ], ] ] ]); Ensuite, dans votre action login, vous pouvez utiliser le service d'authentification pour accéder à l'identificateur ``Password`` et vérifier si le mot de passe de l'utilisateur actuel a besoin d'être mis à niveau:: public function login() { $authentication = $this->request->getAttribute('authentication'); $result = $authentication->getResult(); // Que l'on soit en POST ou GET, rediriger l'utilisateur s'il est connecté if ($result->isValid()) { // En supposant que vous utilisez l'identificateur `Password`. if ($authentication->identifiers()->get('Password')->needsPasswordRehash()) { // Le re-hachage se produit lors de la sauvegarde. $user = $this->Users->get($authentication->getIdentity()->getIdentifier()); $user->password = $this->request->getData('password'); $this->Users->save($user); } // Rediriger ou afficher un template. } }