http://xataface.com/wiki/index.php?-action=single_record_search&-table=wiki&page_id=%3D102&-cursor=0&-skip=0&-limit=30&-mode=list&--subsearch= Fri, 24 May 2013 09:17:20 +0100 FeedCreator 1.7.2 http://www.xataface.com/wiki/before_authenticate <table><thead><tr><th>Field</th><th>Value</th></tr></thead><tbody><tr><td valign="top">Page name</td><td valign="top">before_authenticate</td></tr><tr><td valign="top">Page id</td><td valign="top">102</td></tr><tr><td valign="top">Page title</td><td valign="top">before_authenticate hook</td></tr><tr><td valign="top">Content</td><td valign="top"><p>Return to <a href="/wiki/Application_Delegate_Class">Application Delegate Class</a></p> <p>The <strong>before_authenticate</strong> hook is a method that can be defined in the <a href="/wiki/Application_Delegate_Class">Application Delegate Class</a> which is called before the authentication step occurs on <strong>every</strong> request (not just on login). It is meant to be used to perform custom code that may affect the authentication settings.</p> <h3 id="toc0">Since</h3> <p>This hook has been available since Xataface Version 1.2.5.</p> <h3 id="toc1">Example</h3> <pre><code>/** * Implemented trigger to be called before authentication to set the authentication * type to basic. */ function before_authenticate(){ $auth = Dataface_AuthenticationTool::getInstance(); if ( @$_SESSION['-login-type'] == 'basic' ) $auth-&gt;setAuthType('basic'); }</code></pre> <p>In the above example we used a separate action to store the user's preferred login type in a session variable. This preference is then applied in the before_authenticate method to override the authentication type.</p> <h3 id="toc2">Chain Authentication Support</h3> <p>The most common use of this hook is likely to implement some sort of chain authentication, where authentication methods are attempted until one succeeds.</p> <h3 id="toc3">See Also</h3> <ul> <li> <a href="/wiki/Application_Delegate_Class">Application Delegate Class</a></li> <li> <a href="/wiki/authentication">authentication</a> - Overview of Xataface authentication</li> <li> <a href="/wiki/Writing_Custom_Authentication_Plugins">Writing Custom Authentication Plugins</a></li> <li> Authenticating Against the PHPBB Users Table<a href="/wiki/index.php?-action=new&-table=wiki&page_name=Authenticating_Against_the_PHPBB_Users_Table">?</a></li> <li> <a href="/wiki/LDAP_or_Active_Directory">LDAP or Active Directory</a> - Using LDAP or Active Directory for authentication.</li> <li> <a href="http://xataface.com/documentation/tutorial/getting_started/permissions" onclick="window.open(this.href, '_blank'); return false;">Permissions Section of the Getting Started tutorial</a></li> <li> <a href="/wiki/_auth">_auth</a> - Directives available in the <a href="/wiki/_auth">_auth</a> section of the <a href="/wiki/conf.ini_file">conf.ini file</a>.</li> </ul> </td></tr><tr><td valign="top">Keywords</td><td valign="top">authentication</td></tr><tr><td valign="top">Language</td><td valign="top">en</td></tr></tbody></table> before_authenticate