cellar下载 - cellar源码下载

cellar

Python

1.0.0

下载

Cellar - 生成并验证签名令牌

Cellar 是一个轻量级库，用于生成和验证签名令牌，可用于密码重置链接、身份验证、CSRF 或您可能需要的任何其他内容。它的目标是安全并具有最小的外部依赖性。

安装

将 Cellar 添加到您的composer.json 并运行composer update来安装它。

{
  "require" : { "amxx-bg/cellar" : " 0.1.*@dev " }
}

基本用法

 $ secret = ' some-constant-secret-value ' ;
$ cellar = new  AMXXBG  Cellar ( $ secret , array ( ' lifetime ' => 3600 ));

// Generate with default lifetime from constructor options
$ token = $ cellar -> generate ();

// Overall check if token is valid
if ( $ cellar -> isValid ( $ token )) {
  // Do whatever
}

// Or for more control use :
$ cellar -> hasExpired ( $ token );
$ cellar -> hasTampered ( $ token );

Cellar 将令牌生成为 {random}-{expirytime}-{signature} 形式的单个字符串，采用 Base64 编码，因此适合包含在大多数地方。

验证附加值

您可能想要使用 Cellar 的签名算法来验证一些附加数据没有被篡改。例如，您可以使用它在 URL 中包含电子邮件地址或其他确认信息，而不必存储令牌和用户服务器端之间的映射记录。

 $ token = $ cellar -> generate ( 3600 , [ ' user_id ' => 9123 ]);

// Then , later :
if ( $ cellar -> isValid ( $ _GET [ ' token ' ], [ ' user_id ' => $ _GET [ ' user_id ' ]]) {
  // You can now trust user_id , even if it came through the URL , because it matches the value you originally signed
  // for this token .
}