Security¶

Chiffrer et Déchiffrer les Données¶

static Cake\Utility\Security::encrypt($text, $key, $hmacSalt = null)¶

static Cake\Utility\Security::decrypt($cipher, $key, $hmacSalt = null)¶

Chiffre $text en utilisant AES-256. La $key devrait être une valeur avec beaucoup de différence dans les données un peu comme un bon mot de passe. Le résultat retourné sera la valeur chiffrée avec un checksum HMAC.

Cette méthode va soit utiliser openssl soit mcrypt selon ce qui est disponible sur votre système. Les données cryptées dans une implémentation sont portables vers les autres implémentations.

Cette méthode ne devrait jamais être utilisée pour stocker des mots de passe. A la place, vous devriez utiliser la manière de hasher les mots de passe fournie par hash(). Un exemple d’utilisation serait:

// En supposant que la clé est stockée quelque part, elle peut être
// réutilisée pour le déchiffrement plus tard.
$key = 'wt1U5MACWJFTXGenFoZoiLwQGrLgdbHA';
$result = Security::encrypt($value, $key);

Si vous ne fournissez pas de sel HMAC, la valeur Security.salt sera utilisée. Les valeurs chiffrées peuvent être déchiffrées avec Cake\Utility\Security::decrypt().

Déchiffre une valeur chiffrée au préalable. Les paramètres $key et $hmacSalt doivent correspondre aux valeurs utilisées pour chiffrer ou alors le déchiffrement sera un échec. Un exemple d’utilisation serait:

// En supposant que la clé est stockée quelque part, elle peut être
// réutilisée pour le déchiffrement plus tard.
$key = 'wt1U5MACWJFTXGenFoZoiLwQGrLgdbHA';

$cipher = $user->secrets;
$result = Security::decrypt($cipher, $key);

Si la valeur ne peut pas être déchiffrée à cause de changements dans la clé ou le sel HMAC à false sera retournée.

// Dans config/bootstrap.php
use Cake\Utility\Crypto\Mcrypt;

Security::engine(new Mcrypt());

Hashage des Données¶

static Cake\Utility\Security::hash($string, $type = NULL, $salt = false)¶

Crée un hash à partir d’une chaîne en utilisant la méthode donnée. Le Fallback sur la prochaine méthode disponible. Si $salt est défini à true, la valeur de salt de l’application sera utilisée:

// Utilise la valeur du salt de l'application
$sha1 = Security::hash('CakePHP Framework', 'sha1', true);

// Utilise une valeur du salt personnalisée
$sha1 = Security::hash('CakePHP Framework', 'sha1', 'my-salt');

// Utilise l'algorithme de hashage par défaut
$hash = Security::hash('CakePHP Framework');

La méthode hash() a aussi les stratégies de hashage suivantes:

• md5

• sha1

• sha256

Et tout autre algorithme de hashage que la fonction hash() de PHP permet.

Getting Secure Random Data¶

static Cake\Utility\Security::randomBytes($length)¶

Get $length number of bytes from a secure random source. This function draws data from one of the following sources:

• PHP’s random_bytes function.

• openssl_random_pseudo_bytes from the SSL extension.

If neither source is available a warning will be emitted and an unsafe value will be used for backwards compatibility reasons.