• Zend Framework中的身份认证
  • 胡萝卜 发表于 2014/12/8 13:29:00 | 分类标签: Zend 身份认证 适配器
  • Zend_Auth 为认证(authentication)和一些通用用例情景的具体认证适配器提供了一个API。

    Zend_Auth 只涉及 认证而不是授权。认证被宽松地定义为基于一些证书(credential)来确定一个实体(例如,身份)是否确实是它所声称的。授权是一个过程,它决定是否允许一个实体对其他实体进行访问、执行操作,它超出了Zend_Auth的范围。更多关于Zend Framework 授权和访问控制的信息,参见Zend_Acl.

    注意
    Zend_Auth 类通过它的getInstance()方法实现 Singleton 模式 - 只有一个实例可用。这意味着使用 new操作符和 clone 关键字将不能在Zend_Auth 类中工作,而要使用 Zend_Auth::getInstance()来代替。

    适配器
    Zend_Auth适配器被用来依靠特定的认证服务(例如LDAP、RDBMS或基于文件的存储)来认证。不同的适配器可能有不同的选项和行为,但有些基本的事情在认证适配器中是通用的。例如,接受认证证书(包括声称身份)、依靠认证服务执行查询、返回结果在Zend_Auth适配器中是通用的。

    每个Zend_Auth适配器类都实现Zend_Auth_Adapter_Interface。这个接口定义了一个方法authenticate(),适配器必须为执行认证查询而实现它。在调用authenticate()之前,每个适配器必需准备就绪。这样适配器准备包括设置证书(例如,用户名和密码)并为适配器专用的配置选项定义一些值,例如为数据库表适配器做的连接设置。

    下面是一个认证适配器的例子,它要求为认证设置用户名和密码。为简明扼要,其它的细节(如查询认证服务)被省略了。

    1. class MyAuthAdapter implements Zend_Auth_Adapter_Interface  
    2. {  
    3.     /** 
    4.      * Sets username and password for authentication 
    5.      * 
    6.      * @return void 
    7.      */  
    8.     public function __construct($username, $password)  
    9.     {  
    10.         // ...  
    11.     }  
    12.   
    13.     /** 
    14.      * Performs an authentication attempt 
    15.      * 
    16.      * @throws Zend_Auth_Adapter_Exception If authentication cannot  
    17.      *                                     be performed 
    18.      * @return Zend_Auth_Result 
    19.      */  
    20.     public function authenticate()  
    21.     {  
    22.         // ...  
    23.     }  
    24. }  

               
    如上面所示,authenticate()必需返回一个Zend_Auth_Result的实例(或从Zend_Auth_Result派生的一个类的实例)。如果因为某些原因认证查询不能执行,authenticate()应该抛出一个由Zend_Auth_Adapter_Exception产生的异常。

    结果
    为了表示一个认证尝试的结果,Zend_Auth适配器返回一个带有authenticate()的Zend_Auth_Result的实例。适配器基于结构组成Zend_Auth_Result对象,下面四个方法提供了一组基本的用户面临的通用Zend_Auth适配器结果的操作:

    isValid() - 返回 true 当且仅当结果表示一个成功的认证尝试

    getCode() - 返回一个 Zend_Auth_Result 常量标识符用来决定认证失败的类型或者是否认证成功。这个可以用于开发者希望区别若干认证结果类型的情形,例如,这允许开发者维护详细的认证结果统计。尽管开发这被鼓励去考虑提供这样详细的原因给用户的风险,替而代之使用一般的认证失败信息,这个功能的其它用法是由于可用性的原因提供专用的,定制的信息给用户。更多的信息,参见下面的注释。

    getIdentity() - 返回认证尝试的身份

    getMessages() - 返回关于认证尝试失败的数组
    为了执行更多的操作,开发者可能希望基于认证结果的类型来分支化。一些开发者可能发信有用的操作是:在太多的不成功的密码尝试之后锁住帐号,在太多不存在的身份尝试后标记IP地址,并提供专用的,定制的认证结果信息给用户。下面的结果代码是可用的:

    Zend_Auth_Result::SUCCESS
    Zend_Auth_Result::FAILURE
    Zend_Auth_Result::FAILURE_IDENTITY_NOT_FOUND
    Zend_Auth_Result::FAILURE_IDENTITY_AMBIGUOUS
    Zend_Auth_Result::FAILURE_CREDENTIAL_INVALID
    Zend_Auth_Result::FAILURE_UNCATEGORIZED   

    下面的例子举例说明开发者如何分支化结果代码:

    1. // inside of AuthController / loginAction  
    2. $result = $this->_auth->authenticate($adapter);  
    3.   
    4. switch ($result->getCode()) {  
    5.     case Zend_Auth_Result::FAILURE_IDENTITY_NOT_FOUND:  
    6.         /** do stuff for nonexistent identity **/  
    7.         break;  
    8.     case Zend_Auth_Result::FAILURE_CREDENTIAL_INVALID:  
    9.         /** do stuff for invalid credential **/  
    10.         break;  
    11.     case Zend_Auth_Result::SUCCESS:  
    12.         /** do stuff for successful authentication **/  
    13.         break;  
    14.     default:  
    15.         /** do stuff for other failure **/  
    16.         break;  
    17. }      

        

    身份的持久(Persistence)
    实质上,认证一个包含认证证书的请求很有用,但是维护已认证的身份并在每次请求时不需要出示认证证书也同样很重要。

    HTTP是一个无连接的协议,然而,象cookie和session这样的技术已经被开发出来使在服务器端的web应用维护多请求状态变得容易。

    在PHP Session 中的缺省持久(Persistence)
    缺省地,Zend_Auth从使用PHP session成功的认证尝试中提供身份的持久存储。基于一个成功的认证尝试,Zend_Auth::authenticate()通过把认证结果放入持久存储中来保存身份。除非另有配置,Zend_Auth 使用名称为Zend_Auth_Storage_Session 的存储类,这个类使用Zend_Session。通过实现Zend_Auth_Storage_Interface给Zend_Auth::setStorage()提供一个对象,一个定制的类可以被替代使用。

    注意
    对于特定的用例,如果身份的持久存储不合适,开发者可以放弃使用Zend_Auth类,替代地,而直接使用适配器类。

    修改 Session 名字空间

    Zend_Auth_Storage_Session使用'Zend_Auth'的seesion名字空间。通过给Zend_Auth_Storage_Session的构造器传递不同的值,这个名字空间可以被替换,并且这个值被从内部传递给Zend_Session_Namespace的构造器。这应该发生在认证尝试之前,因为Zend_Auth::authenticate()执行身份的自动存储。

    1. // Save a reference to the Singleton instance of Zend_Auth  
    2. $auth = Zend_Auth::getInstance();  
    3. // Use 'someNamespace' instead of 'Zend_Auth'  
    4. $auth->setStorage(new Zend_Auth_Storage_Session('someNamespace'));  
    5.   
    6. /** 
    7.  * @todo Set up the auth adapter, $authAdapter 
    8.  */  
    9. // Authenticate, saving the result, and persisting the identity on  
    10. // success  
    11. $result = $auth->authenticate($authAdapter);  

    实现订制存储
    有时候开发者需要使用不同的身份持久行为,而不是Zend_Auth_Storage_Session提供的。对于这样的案例开发者可以简单地实现Zend_Auth_Storage_Interface并给Zend_Auth::setStorage()提供一个类的实例。

    使用定制存储类

    为了使用不同于Zend_Auth_Storage_Session的身份之久存储类,开发者可实现Zend_Auth_Storage_Interface:

    1. class MyStorage implements Zend_Auth_Storage_Interface  
    2. {  
    3.     /** 
    4.      * Returns true if and only if storage is empty 
    5.      * 
    6.      * @throws Zend_Auth_Storage_Exception If it is impossible to  
    7.      *                                     determine whether storage  
    8.      *                                     is empty 
    9.      * @return boolean 
    10.      */  
    11.     public function isEmpty()  
    12.     {  
    13.         /** 
    14.          * @todo implementation 
    15.          */  
    16.     }  
    17.   
    18.     /** 
    19.      * Returns the contents of storage 
    20.      * 
    21.      * Behavior is undefined when storage is empty. 
    22.      * 
    23.      * @throws Zend_Auth_Storage_Exception If reading contents from  
    24.      *                                     storage is impossible 
    25.      * @return mixed 
    26.      */  
    27.     public function read()  
    28.     {  
    29.         /** 
    30.          * @todo implementation 
    31.          */  
    32.     }  
    33.   
    34.     /** 
    35.      * Writes $contents to storage 
    36.      * 
    37.      * @param  mixed $contents 
    38.      * @throws Zend_Auth_Storage_Exception If writing $contents to  
    39.      *                                     storage is impossible 
    40.      * @return void 
    41.      */  
    42.     public function write($contents)  
    43.     {  
    44.         /** 
    45.          * @todo implementation 
    46.          */  
    47.     }  
    48.   
    49.     /** 
    50.      * Clears contents from storage 
    51.      * 
    52.      * @throws Zend_Auth_Storage_Exception If clearing contents from  
    53.      *                                     storage is impossible 
    54.      * @return void 
    55.      */  
    56.     public function clear()  
    57.     {  
    58.         /** 
    59.          * @todo implementation 
    60.          */  
    61.     }  
    62. }   

    为了使用这个定制的存储类,在认证查询被尝试前,Zend_Auth::setStorage()被调用:

    1. // Instruct Zend_Auth to use the custom storage class  
    2. Zend_Auth::getInstance()->setStorage(new MyStorage());  
    3.   
    4. /** 
    5.  * @todo Set up the auth adapter, $authAdapter 
    6.  */  
    7.   
    8. // Authenticate, saving the result, and persisting the identity on   
    9. // success  
    10. $result = Zend_Auth::getInstance()->authenticate($authAdapter);  

    使用Zend_Auth
    这里提供了两种方法使用Zend_Auth适配器:

    非直接地,通过Zend_Auth::authenticate()

    直接地,通过适配器的 authenticate() 方法


    下面的例子通过Zend_Auth类来示例如何非直接地使用Zend_Auth适配器:

    1. // Get a reference to the singleton instance of Zend_Auth  
    2. require_once 'Zend/Auth.php';  
    3. $auth = Zend_Auth::getInstance();  
    4.   
    5. // Set up the authentication adapter  
    6. $authAdapter = new MyAuthAdapter($username, $password);  
    7.   
    8. // Attempt authentication, saving the result  
    9. $result = $auth->authenticate($authAdapter);  
    10.   
    11. if (!$result->isValid()) {  
    12.     // Authentication failed; print the reasons why  
    13.     foreach ($result->getMessages() as $message) {  
    14.         echo "$message\n";  
    15.     }  
    16. else {  
    17.     // Authentication succeeded; the identity ($username) is stored   
    18.     // in the session  
    19.     // $result->getIdentity() === $auth->getIdentity()  
    20.     // $result->getIdentity() === $username  
    21. }  
        

    一旦在一个请求里的认证被尝试,如上面的例子,检查一个成功的被认证的身份是否存在就是一个简单的匹配:

    1. $auth = Zend_Auth::getInstance();  
    2. if ($auth->hasIdentity()) {  
    3.     // Identity exists; get it  
    4.     $identity = $auth->getIdentity();  
    5. }

    从持久存储空间出去一个身份,可简单地使用clearIdentity()方法。这将被典型地用作“logout”操作。

    Zend_Auth::getInstance()->clearIdentity();

    当自动使用持久存储空间对特定的用例不合适,开发者可简单地忽略Zend_Auth类,直接使用适配器类。直接使用适配器类需要配置和准备适配器对象和调用它的authenticate()方法。适配器规范细节将在每个适配器的文档中讨论。下面的例子直接使用 MyAuthAdapter:

    1. // Set up the authentication adapter  
    2. $authAdapter = new MyAuthAdapter($username, $password);  
    3.   
    4. // Attempt authentication, saving the result  
    5. $result = $authAdapter->authenticate();  
    6.   
    7. if (!$result->isValid()) {  
    8.     // Authentication failed; print the reasons why  
    9.     foreach ($result->getMessages() as $message) {  
    10.         echo "$message\n";  
    11.     }  
    12. else {  
    13.     // Authentication succeeded  
    14.     // $result->getIdentity() === $username  
    15. }  


     

  • 请您注意

    ·自觉遵守:爱国、守法、自律、真实、文明的原则

    ·尊重网上道德,遵守《全国人大常委会关于维护互联网安全的决定》及中华人民共和国其他各项有关法律法规

    ·严禁发表危害国家安全,破坏民族团结、国家宗教政策和社会稳定,含侮辱、诽谤、教唆、淫秽等内容的作品

    ·承担一切因您的行为而直接或间接导致的民事或刑事法律责任

    ·您在编程中国社区新闻评论发表的作品,本网站有权在网站内保留、转载、引用或者删除

    ·参与本评论即表明您已经阅读并接受上述条款

  • 感谢本文作者
  • 作者头像
  • 昵称:胡萝卜
  • 加入时间:2013/5/23 0:00:00
  • TA的签名
  • 这家伙很懒,虾米都没写
  • +进入TA的空间
  • 以下内容也很赞哦
分享按钮