a86ad1be90
fully-qualified function calls
210 lines
4.2 KiB
PHP
210 lines
4.2 KiB
PHP
<?php
|
|
|
|
namespace Appwrite\Auth;
|
|
|
|
use Appwrite\Database\Document;
|
|
|
|
class Auth
|
|
{
|
|
/**
|
|
* User Status.
|
|
*/
|
|
const USER_STATUS_UNACTIVATED = 0;
|
|
const USER_STATUS_ACTIVATED = 1;
|
|
const USER_STATUS_BLOCKED = 2;
|
|
|
|
/**
|
|
* User Roles.
|
|
*/
|
|
const USER_ROLE_GUEST = 0;
|
|
const USER_ROLE_MEMBER = 1;
|
|
const USER_ROLE_ADMIN = 2;
|
|
const USER_ROLE_DEVELOPER = 3;
|
|
const USER_ROLE_OWNER = 4;
|
|
const USER_ROLE_APP = 5;
|
|
const USER_ROLE_SYSTEM = 6;
|
|
const USER_ROLE_ALL = '*';
|
|
|
|
/**
|
|
* Token Types.
|
|
*/
|
|
const TOKEN_TYPE_LOGIN = 1;
|
|
const TOKEN_TYPE_VERIFICATION = 2;
|
|
const TOKEN_TYPE_RECOVERY = 3;
|
|
const TOKEN_TYPE_INVITE = 4;
|
|
|
|
/**
|
|
* Token Expiration times.
|
|
*/
|
|
const TOKEN_EXPIRATION_LOGIN_LONG = 31536000; /* 1 year */
|
|
const TOKEN_EXPIRATION_LOGIN_SHORT = 3600; /* 1 hour */
|
|
const TOKEN_EXPIRATION_RECOVERY = 3600; /* 1 hour */
|
|
const TOKEN_EXPIRATION_CONFIRM = 3600 * 24 * 7; /* 7 days */
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
public static $cookieName = 'a_session';
|
|
|
|
/**
|
|
* User Unique ID.
|
|
*
|
|
* @var int
|
|
*/
|
|
public static $unique = 0;
|
|
|
|
/**
|
|
* User Secret Key.
|
|
*
|
|
* @var string
|
|
*/
|
|
public static $secret = '';
|
|
|
|
/**
|
|
* Set Cookie Name.
|
|
*
|
|
* @param $string
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function setCookieName($string)
|
|
{
|
|
return self::$cookieName = $string;
|
|
}
|
|
|
|
/**
|
|
* Encode Session.
|
|
*
|
|
* @param int $id
|
|
* @param string $secret
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function encodeSession($id, $secret)
|
|
{
|
|
return \base64_encode(\json_encode([
|
|
'id' => $id,
|
|
'secret' => $secret,
|
|
]));
|
|
}
|
|
|
|
/**
|
|
* Decode Session.
|
|
*
|
|
* @param string $session
|
|
*
|
|
* @return array
|
|
*
|
|
* @throws \Exception
|
|
*/
|
|
public static function decodeSession($session)
|
|
{
|
|
$session = \json_decode(\base64_decode($session), true);
|
|
$default = ['id' => null, 'secret' => ''];
|
|
|
|
if (!\is_array($session)) {
|
|
return $default;
|
|
}
|
|
|
|
return \array_merge($default, $session);
|
|
}
|
|
|
|
/**
|
|
* Encode.
|
|
*
|
|
* One-way encryption
|
|
*
|
|
* @param $string
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function hash($string)
|
|
{
|
|
return \hash('sha256', $string);
|
|
}
|
|
|
|
/**
|
|
* Password Hash.
|
|
*
|
|
* One way string hashing for user passwords
|
|
*
|
|
* @param $string
|
|
*
|
|
* @return bool|string
|
|
*/
|
|
public static function passwordHash($string)
|
|
{
|
|
return \password_hash($string, PASSWORD_BCRYPT, array('cost' => 8));
|
|
}
|
|
|
|
/**
|
|
* Password verify.
|
|
*
|
|
* @param $plain
|
|
* @param $hash
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function passwordVerify($plain, $hash)
|
|
{
|
|
return \password_verify($plain, $hash);
|
|
}
|
|
|
|
/**
|
|
* Password Generator.
|
|
*
|
|
* Generate random password string
|
|
*
|
|
* @param int $length
|
|
*
|
|
* @return string
|
|
*
|
|
* @throws \Exception
|
|
*/
|
|
public static function passwordGenerator(int $length = 20):string
|
|
{
|
|
return \bin2hex(\random_bytes($length));
|
|
}
|
|
|
|
/**
|
|
* Token Generator.
|
|
*
|
|
* Generate random password string
|
|
*
|
|
* @param int $length
|
|
*
|
|
* @return string
|
|
*
|
|
* @throws \Exception
|
|
*/
|
|
public static function tokenGenerator(int $length = 128):string
|
|
{
|
|
return \bin2hex(\random_bytes($length));
|
|
}
|
|
|
|
/**
|
|
* Verify token and check that its not expired.
|
|
*
|
|
* @param array $tokens
|
|
* @param int $type
|
|
* @param string $secret
|
|
*
|
|
* @return bool|string
|
|
*/
|
|
public static function tokenVerify(array $tokens, int $type, string $secret)
|
|
{
|
|
foreach ($tokens as $token) { /* @var $token Document */
|
|
if (isset($token['type']) &&
|
|
isset($token['secret']) &&
|
|
isset($token['expire']) &&
|
|
$token['type'] == $type &&
|
|
$token['secret'] === self::hash($secret) &&
|
|
$token['expire'] >= \time()) {
|
|
return $token->getId();
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|