mirror of
https://gitlab.com/davical-project/davical.git
synced 2026-06-20 06:50:20 +00:00
365 lines
14 KiB
HTML
365 lines
14 KiB
HTML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<!-- template designed by Marco Von Ballmoos -->
|
|
<title>Docs for page auth-functions.php</title>
|
|
<link rel="stylesheet" href="../../media/stylesheet.css" />
|
|
<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
|
|
</head>
|
|
<body>
|
|
<div class="page-body">
|
|
<h2 class="file-name"><img src="../../media/images/Page_logo.png" alt="File" style="vertical-align: middle">/inc/auth-functions.php</h2>
|
|
|
|
<a name="sec-description"></a>
|
|
<div class="info-box">
|
|
<div class="info-box-title">Description</div>
|
|
<div class="nav-bar">
|
|
<span class="disabled">Description</span> |
|
|
<a href="#sec-includes">Includes</a>
|
|
| <a href="#sec-functions">Functions</a>
|
|
</div>
|
|
<div class="info-box-body">
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">The authentication handling plugins can be used by the Session class to provide authentication.</p>
|
|
<p class="description"><p>Each authenticate hook needs to: <ul><li>Accept a username / password</li><li>Confirm the username / password are correct</li><li>Create (or update) a 'usr' record in our database</li><li>Return the 'usr' record as an object</li><li>Return === false when authentication fails</li></ul> It can expect that: <ul><li>Configuration data will be in $c->authenticate_hook['config'], which might be an array, or whatever is needed.</li></ul> In order to be called: <ul><li>This file should be included</li><li>$c->authenticate_hook['call'] should be set to the name of the plugin</li><li>$c->authenticate_hook['config'] should be set up with any configuration data for the plugin</li></ul></p></p>
|
|
<ul class="tags">
|
|
<li><span class="field">author:</span> Andrew McMillan <<a href="mailto:andrew@mcmillan.net.nz">andrew@mcmillan.net.nz</a>></li>
|
|
<li><span class="field">copyright:</span> Catalyst IT Ltd, Morphoss Ltd</li>
|
|
<li><span class="field">license:</span> <a href="http://gnu.org/copyleft/gpl.html">GNU GPL v2 or later</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<a name="sec-includes"></a>
|
|
<div class="info-box">
|
|
<div class="info-box-title">Includes</div>
|
|
<div class="nav-bar">
|
|
<a href="#sec-description">Description</a> |
|
|
<span class="disabled">Includes</span>
|
|
| <a href="#sec-functions">Functions</a>
|
|
</div>
|
|
<div class="info-box-body">
|
|
<a name="_DataUpdate_php"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Page.png" alt=" " />
|
|
<span class="include-title">
|
|
<span class="include-type">require_once</span>
|
|
(<span class="include-name">"DataUpdate.php"</span>)
|
|
(line <span class="line-number">28</span>)
|
|
</span>
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">The authentication handling plugins can be used by the Session class to provide authentication.</p>
|
|
<p class="description"><p>Each authenticate hook needs to: <ul><li>Accept a username / password</li><li>Confirm the username / password are correct</li><li>Create (or update) a 'usr' record in our database</li><li>Return the 'usr' record as an object</li><li>Return === false when authentication fails</li></ul> It can expect that: <ul><li>Configuration data will be in $c->authenticate_hook['config'], which might be an array, or whatever is needed.</li></ul> In order to be called: <ul><li>This file should be included</li><li>$c->authenticate_hook['call'] should be set to the name of the plugin</li><li>$c->authenticate_hook['config'] should be set up with any configuration data for the plugin</li></ul></p></p>
|
|
<ul class="tags">
|
|
<li><span class="field">author:</span> Andrew McMillan <<a href="mailto:andrew@mcmillan.net.nz">andrew@mcmillan.net.nz</a>></li>
|
|
<li><span class="field">copyright:</span> Catalyst IT Ltd, Morphoss Ltd</li>
|
|
<li><span class="field">license:</span> <a href="http://gnu.org/copyleft/gpl.html">GNU GPL v2 or later</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<a name="sec-functions"></a>
|
|
<div class="info-box">
|
|
<div class="info-box-title">Functions</div>
|
|
<div class="nav-bar">
|
|
<a href="#sec-description">Description</a> |
|
|
<a href="#sec-includes">Includes</a>
|
|
| <span class="disabled">Functions</span>
|
|
</div>
|
|
<div class="info-box-body">
|
|
<a name="functionAuthExternalAWL" id="functionAuthExternalAWL"><!-- --></a>
|
|
<div class="evenrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">AuthExternalAWL</span> (line <span class="line-number">271</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">Authenticate against a different PostgreSQL database which contains a usr table in the AWL format.</p>
|
|
<p class="description"><p>Use this as in the following example config snippet:</p><p>require_once('auth-functions.php'); $c->authenticate_hook = array( 'call' => 'AuthExternalAwl', 'config' => array( // A PgSQL database connection string for the database containing user records 'connection[]' => 'dbname=wrms host=otherhost port=5433 user=general', // Which columns should be fetched from the database 'columns' => "user_no, active, email_ok, joined, last_update AS updated, last_used, username, password, fullname, email", // a WHERE clause to limit the records returned. 'where' => "active AND org_code=7" ) );</p></p>
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
AuthExternalAWL
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$username</span>, <span class="var-type"></span> <span class="var-name">$password</span>)
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$username</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$password</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functionauth_functions_deprecated" id="functionauth_functions_deprecated"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">auth_functions_deprecated</span> (line <span class="line-number">31</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
auth_functions_deprecated
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$method</span>, [<span class="var-type"></span> <span class="var-name">$message</span> = <span class="var-default">null</span>])
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$method</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$message</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functionCreateDefaultRelationships" id="functionCreateDefaultRelationships"><!-- --></a>
|
|
<div class="evenrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">CreateDefaultRelationships</span> (line <span class="line-number">150</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">Defunct function for creating default relationships.</p>
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
CreateDefaultRelationships
|
|
</span>
|
|
(<span class="var-type">string</span> <span class="var-name">$username</span>)
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type">string</span>
|
|
<span class="var-name">$username</span><span class="var-description">: The username of the user we are creating relationships for.</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functionCreateHomeCalendar" id="functionCreateHomeCalendar"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">CreateHomeCalendar</span> (line <span class="line-number">141</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">Backward compatibility</p>
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
CreateHomeCalendar
|
|
</span>
|
|
(<span class="var-type">unknown_type</span> <span class="var-name">$username</span>)
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type">unknown_type</span>
|
|
<span class="var-name">$username</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functionCreateHomeCollections" id="functionCreateHomeCollections"><!-- --></a>
|
|
<div class="evenrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">CreateHomeCollections</span> (line <span class="line-number">71</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">Creates some default home collections for the user.</p>
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
CreateHomeCollections
|
|
</span>
|
|
(<span class="var-type">string</span> <span class="var-name">$username</span>)
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type">string</span>
|
|
<span class="var-name">$username</span><span class="var-description">: The username of the user we are creating relationships for.</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functiongetPrincipalByID" id="functiongetPrincipalByID"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">getPrincipalByID</span> (line <span class="line-number">61</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
getPrincipalByID
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$principal_id</span>, [<span class="var-type"></span> <span class="var-name">$use_cache</span> = <span class="var-default">true</span>])
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$principal_id</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$use_cache</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functiongetUserByEMail" id="functiongetUserByEMail"><!-- --></a>
|
|
<div class="evenrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">getUserByEMail</span> (line <span class="line-number">51</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
getUserByEMail
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$email</span>, [<span class="var-type"></span> <span class="var-name">$use_cache</span> = <span class="var-default">true</span>])
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$email</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$use_cache</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functiongetUserByID" id="functiongetUserByID"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">getUserByID</span> (line <span class="line-number">56</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
getUserByID
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$user_no</span>, [<span class="var-type"></span> <span class="var-name">$use_cache</span> = <span class="var-default">true</span>])
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$user_no</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$use_cache</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functiongetUserByName" id="functiongetUserByName"><!-- --></a>
|
|
<div class="evenrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">getUserByName</span> (line <span class="line-number">46</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
getUserByName
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">$username</span>, [<span class="var-type"></span> <span class="var-name">$use_cache</span> = <span class="var-default">true</span>])
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$username</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">$use_cache</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<a name="functionUpdateUserFromExternal" id="functionUpdateUserFromExternal"><!-- --></a>
|
|
<div class="oddrow">
|
|
|
|
<div>
|
|
<img src="../../media/images/Function.png" />
|
|
<span class="method-title">UpdateUserFromExternal</span> (line <span class="line-number">186</span>)
|
|
</div>
|
|
|
|
<!-- ========== Info from phpDoc block ========= -->
|
|
<p class="short-description">Update the local cache of the remote user details</p>
|
|
<div class="method-signature">
|
|
<span class="method-result">void</span>
|
|
<span class="method-name">
|
|
UpdateUserFromExternal
|
|
</span>
|
|
(<span class="var-type"></span> <span class="var-name">&$usr</span>, <span class="var-type">object</span> <span class="var-name">$usr</span>)
|
|
</div>
|
|
|
|
<ul class="parameters">
|
|
<li>
|
|
<span class="var-type">object</span>
|
|
<span class="var-name">$usr</span><span class="var-description">: The user details we read from the remote.</span> </li>
|
|
<li>
|
|
<span class="var-type"></span>
|
|
<span class="var-name">&$usr</span> </li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<p class="notes" id="credit">
|
|
Documentation generated on Tue, 27 Sep 2011 11:30:43 +1300 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
|
|
</p>
|
|
</div></body>
|
|
</html> |