CMS-CSE/core/class/googleAuthenticator.class.php

<?php
/**
 * Classe googleAuthenticator
 * 
 * Cette classe fournit des méthodes pour générer et vérifier des codes de validation
 * basés sur l'algorithme TOTP (Time-based One-Time Password).
 */
class googleAuthenticator
{
    /**
     * Longueur par défaut des codes générés.
     *
     * @var int
     */
    static protected $_codeLength = 6;

    /**
     * Génère un secret pour l'authentification.
     *
     * @param int $secretLength Longueur du secret (entre 16 et 128).
     * @return string Retourne le secret généré.
     * @throws Exception Si la longueur du secret est invalide ou si une source aléatoire sécurisée est indisponible.
     */
    static public function createSecret($secretLength = 16)
    {
        $validChars = self::_getBase32LookupTable();

        // Valid secret lengths are 80 to 640 bits
        if ($secretLength < 16 || $secretLength > 128) {
            throw new Exception('Bad secret length');
        }
        $secret = '';
        $rnd = false;
        if (function_exists('random_bytes')) {
            $rnd = random_bytes($secretLength);
        } elseif (function_exists('openssl_random_pseudo_bytes')) {
            $rnd = openssl_random_pseudo_bytes($secretLength, $cryptoStrong);
            if (!$cryptoStrong) {
                $rnd = false;
            }
        }
        if ($rnd !== false) {
            for ($i = 0; $i < $secretLength; ++$i) {
                $secret .= $validChars[ord($rnd[$i]) & 31];
            }
        } else {
            throw new Exception('No source of secure random');
        }

        return $secret;
    }

    /**
     * Génère un code TOTP basé sur un secret et une tranche de temps.
     *
     * @param string $secret Secret utilisé pour générer le code.
     * @param int|null $timeSlice Tranche de temps (par défaut, tranche actuelle).
     * @return string Retourne le code généré.
     */
    static public function getCode($secret, $timeSlice = null)
    {
        if ($timeSlice === null) {
            $timeSlice = floor(time() / 30);
        }

        $secretkey = self::_base32Decode($secret);

        // Pack time into binary string
        $time = chr(0).chr(0).chr(0).chr(0).pack('N*', $timeSlice);
        // Hash it with users secret key
        $hm = hash_hmac('SHA1', $time, $secretkey, true);
        // Use last nipple of result as index/offset
        $offset = ord(substr($hm, -1)) & 0x0F;
        // grab 4 bytes of the result
        $hashpart = substr($hm, $offset, 4);

        // Unpak binary value
        $value = unpack('N', $hashpart);
        $value = $value[1];
        // Only 32 bits
        $value = $value & 0x7FFFFFFF;

        $modulo = pow(10, self::$_codeLength);

        return str_pad($value % $modulo, self::$_codeLength, '0', STR_PAD_LEFT);
    }

    /**
     * Génère une URL pour configurer Google Authenticator.
     *
     * @param string $name Nom du compte ou de l'utilisateur.
     * @param string $secret Secret associé au compte.
     * @return string Retourne l'URL générée.
     */
    static public function getGoogleUrl($name, $secret)
    {
        $urlencoded = 'otpauth://totp/'.$name.'?secret='.$secret;
        return $urlencoded;
    }

    /**
     * Vérifie si un code TOTP est valide pour un secret donné.
     *
     * @param string $secret Secret utilisé pour générer le code.
     * @param string $code Code à vérifier.
     * @param int $discrepancy Tolérance en tranches de temps (par défaut 1).
     * @param int|null $currentTimeSlice Tranche de temps actuelle (facultatif).
     * @return bool Retourne TRUE si le code est valide, FALSE sinon.
     */
    static public function verifyCode($secret, $code, $discrepancy = 1, $currentTimeSlice = null)
    {
        if ($currentTimeSlice === null) {
            $currentTimeSlice = floor(time() / 30);
        }

        if (strlen($code) != 6) {
            return false;
        }

        for ($i = -$discrepancy; $i <= $discrepancy; ++$i) {
            $calculatedCode = self::getCode($secret, $currentTimeSlice + $i);
            if (self::timingSafeEquals($calculatedCode, $code)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Définit la longueur des codes générés.
     *
     * @param int $length Longueur des codes.
     * @return int Retourne la nouvelle longueur définie.
     */
    static public function setCodeLength($length)
    {
        return self::$_codeLength = $length;
    }

    /**
     * Décode une chaîne encodée en Base32.
     *
     * @param string $secret Chaîne encodée en Base32.
     * @return string Retourne la chaîne décodée.
     */
    static protected function _base32Decode($secret)
    {
        if (empty($secret)) {
            return '';
        }

        $base32chars = self::_getBase32LookupTable();
        $base32charsFlipped = array_flip($base32chars);

        $paddingCharCount = substr_count($secret, $base32chars[32]);
        $allowedValues = array(6, 4, 3, 1, 0);
        if (!in_array($paddingCharCount, $allowedValues)) {
            return false;
        }
        for ($i = 0; $i < 4; ++$i) {
            if ($paddingCharCount == $allowedValues[$i] &&
                substr($secret, -($allowedValues[$i])) != str_repeat($base32chars[32], $allowedValues[$i])) {
                return false;
            }
        }
        $secret = str_replace('=', '', $secret);
        $secret = str_split($secret);
        $binaryString = '';
        for ($i = 0; $i < count($secret); $i = $i + 8) {
            $x = '';
            if (!in_array($secret[$i], $base32chars)) {
                return false;
            }
            for ($j = 0; $j < 8; ++$j) {
                $x .= str_pad(base_convert(@$base32charsFlipped[@$secret[$i + $j]], 10, 2), 5, '0', STR_PAD_LEFT);
            }
            $eightBits = str_split($x, 8);
            for ($z = 0; $z < count($eightBits); ++$z) {
                $binaryString .= (($y = chr(base_convert($eightBits[$z], 2, 10))) || ord($y) == 48) ? $y : '';
            }
        }

        return $binaryString;
    }

    /**
     * Retourne la table de correspondance pour l'encodage Base32.
     *
     * @return array Retourne un tableau des caractères Base32.
     */
    static protected function _getBase32LookupTable()
    {
        return array(
            'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', //  7
            'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', // 15
            'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', // 23
            'Y', 'Z', '2', '3', '4', '5', '6', '7', // 31
            '=',  // padding char
        );
    }

    /**
     * Compare deux chaînes de manière sécurisée contre les attaques temporelles.
     *
     * @param string $safeString Chaîne sécurisée.
     * @param string $userString Chaîne utilisateur.
     * @return bool Retourne TRUE si les chaînes sont identiques, FALSE sinon.
     */
    static private function timingSafeEquals($safeString, $userString)
    {
        if (function_exists('hash_equals')) {
            return hash_equals($safeString, $userString);
        }
        $safeLen = strlen($safeString);
        $userLen = strlen($userString);

        if ($userLen != $safeLen) {
            return false;
        }

        $result = 0;

        for ($i = 0; $i < $userLen; ++$i) {
            $result |= (ord($safeString[$i]) ^ ord($userString[$i]));
        }

        // They are only identical strings if $result is exactly 0...
        return $result === 0;
    }
}