认证 - Revision history

ShengGang at 07:44, 26 September 2023

2023-09-26T07:44:40Z

← Older revision		Revision as of 07:44, 26 September 2023
Line 13:		Line 13:
	{{Template用户手册}}		{{Template用户手册}}
	{{TemplateMainPageZh}}		{{TemplateMainPageZh}}




	=简介=		=简介=

ShengGang at 07:44, 26 September 2023

2023-09-26T07:44:24Z

← Older revision		Revision as of 07:44, 26 September 2023
Line 9:		Line 9:

	[[Category:Core]]		[[Category:Core]]
			[[Category:开发]]
	{{Template开发文档}}		{{Template开发文档}}
	{{Template用户手册}}		{{Template用户手册}}

ShengGang: /* 模块 */

2023-09-26T07:44:05Z

模块

← Older revision		Revision as of 07:44, 26 September 2023
Line 42:		Line 42:
	有关身份验证模式列表（可能的“xxx”值及其特殊性），请参阅 [https://wiki.dolibarr.org/Authentication,_SSO_and_SSL Authentication,_SSO_and_SSL] 。		有关身份验证模式列表（可能的“xxx”值及其特殊性），请参阅 [https://wiki.dolibarr.org/Authentication,_SSO_and_SSL Authentication,_SSO_and_SSL] 。

	==模块==		==登录模块==

	登录模块是包含检查用户/密码有效性的函数的文件。		登录模块是包含检查用户/密码有效性的函数的文件。

ShengGang: /* 身份验证模式和登录模块 */

2023-09-26T07:42:20Z

身份验证模式和登录模块

← Older revision		Revision as of 07:42, 26 September 2023
Line 42:		Line 42:
	有关身份验证模式列表（可能的“xxx”值及其特殊性），请参阅 [https://wiki.dolibarr.org/Authentication,_SSO_and_SSL Authentication,_SSO_and_SSL] 。		有关身份验证模式列表（可能的“xxx”值及其特殊性），请参阅 [https://wiki.dolibarr.org/Authentication,_SSO_and_SSL Authentication,_SSO_and_SSL] 。

	模块		==模块==

	登录模块是包含检查用户/密码有效性的函数的文件。		登录模块是包含检查用户/密码有效性的函数的文件。

ShengGang: /* 登录模块 */

2023-09-26T07:41:35Z

登录模块

← Older revision		Revision as of 07:41, 26 September 2023
Line 34:		Line 34:
	''#3#'' 对应于检查业务权限，如果可以，则显示页面。有关更多信息，请参阅 [[用户权限]] 页面。		''#3#'' 对应于检查业务权限，如果可以，则显示页面。有关更多信息，请参阅 [[用户权限]] 页面。

	=~~登录模块~~=		=身份验证模式和登录模块=

			调用 checkLoginPassEntity 以验证用户名/密码对（或在某些情况下仅验证用户），将调用登录模块的函数'''check_user_password_xxx'''。调用的连接模块取决于 '''conf/conf.php''' 文件中定义的身份验证模式。

			使用的文件名为 '''htdocs/core/login/functions_xxx.php''' ，值 '''xxx''' 对应于配置文件 '''conf/conf.php''' 中 '''dolibarr_main_authentication''' 中定义的值。

			有关身份验证模式列表（可能的“xxx”值及其特殊性），请参阅 [https://wiki.dolibarr.org/Authentication,_SSO_and_SSL Authentication,_SSO_and_SSL] 。

			模块

	登录模块是包含检查用户/密码有效性的函数的文件。		登录模块是包含检查用户/密码有效性的函数的文件。

ShengGang at 07:29, 26 September 2023

2023-09-26T07:29:27Z

← Older revision		Revision as of 07:29, 26 September 2023
Line 16:		Line 16:


	= 介绍 =		=简介=

	~~本页描述Dolibarr认证过程是如何工作的。您必须熟悉PHP sessions才能正确理解发生的事情。~~		Dolibarr的身份验证系统变得相当复杂，如果不熟悉身份验证流程，就很难找到bug。本页介绍了认证流程的一部分，允许您遵循流程并在需要时进行干预。您必须熟悉 PHP sessions 才能正确理解发生的事情。

	= 过程 =		=流程=

	~~当您调用要查看的页面时，进程开始。例如index.php (htdocs~~/index.php~~)。但这不是要求认证的文件。每个Dolibarr PHP页面都包含一个名为main~~.inc.~~php的文件，这个文件包含一个名为master~~.inc.~~php的文件。~~		该过程从调用您要查看的页面开始。例如，htdocs/index.php 主页。但不是该文件提供身份验证请求。事实上，Dolibarr中的每个页面都包含一个 main.inc.php 文件，该文件本身包含 master.inc.php 文件。因此，我们有：

	~~所以我们有:~~

	{{Template:CodeSampleForLoginProcess}}		{{Template:CodeSampleForLoginProcess}}

	#1#表示我们稍后将使用的许多库的加载，但也初始化包含正在运行的PHP上下文的对象和变量（加载配置文件、加载语言文件以及创建尚未经过身份验证的空用户）。		''#1#'' 表示加载一大堆我们稍后将使用的库，并初始化PHP代码的执行上下文（加载配置文件、加载语言文件并创建一个尚未经过身份验证的空用户）。

	#2#~~表示用于身份验证的代码：程序检查我们是否在日志会话中（这意味着~~$_SESSION["dol_login"]存在）。如果没有，我们检查我们是否从登录和密码表单接收数据。在页面的第一次调用期间，由于用户还没有查看登录表单，情况并非如此。因此，我们继续和 $login ~~的值仍然是false，所以我们输出登录表单，结束脚本。~~		''#2#'' 表示身份验证代码：程序检查您是否处于已登录会话中（这意味着 $_SESSION["dol_login"] 存在）。如果不是，则检查是否从登录名/密码表单接收到传递的数据。在第一次调用时，情况并非如此，因为我们还没有在屏幕上显示表单。因此，我们使用 if 判断，如果 $login 为 false，则显示登录的HTML表单，脚本结束。

	~~在提交登录之后，相同的页面（仍然调用index~~.~~php），我们仍然进入~~#1#~~，然后~~#2#~~，现在定义了~~$_POST["username"]~~。因此，我们检查用户和密码是否正常（检查数据库，LDAP，它取决于配置文件中的~~$~~dolibarr_main_authentication的值）。如果可以，则设置了~~$~~login变量，因此不再显示表单，并且设置~~$_SESSION["dol_login"]~~，因此下次调用页面时，我们永远不会进入"if~~ (! isset($_SESSION["dol_login"]))"。		提交登录名和密码后，调用同一个页面（仍是 index.php），我们还是先进入#1#，然后进入#2#，这次设置了$_POST["username"]。此外，我们还检查用户名和密码是否正确（检查是在数据库、LDAP或其他地方进行的，这取决于配置文件中的 $dolibarr_main_authentication 变量值）。如果 login/pass 对正确，则设置 $login 变量，因此我们不会再次显示表单，而是继续并设置 $_SESSION["dol_login"]，以便在下一次调用页面时，我们不再进入“if (! isset($_SESSION["dol_login"]))”。

	#3#~~是检查业务权限并显示页面。请参阅~~[[~~Permissions En\|Permissions~~]]~~页以获取更多信息。~~		''#3#'' 对应于检查业务权限，如果可以，则显示页面。有关更多信息，请参阅 [[用户权限]] 页面。

	= 登录模块 =		=登录模块=

	登录模块是包含检查用户/密码有效性的函数的文件。		登录模块是包含检查用户/密码有效性的函数的文件。
Line 42:		Line 40:
	一个文件按模块，一个文件按函数。每个文件都进行不同类型的检查。		一个文件按模块，一个文件按函数。每个文件都进行不同类型的检查。

	* 文件'''htdocs/core/login/functions_http.php'''使用HTTP基本身份验证检查用户/密码的有效性。		*文件'''htdocs/core/login/functions_http.php'''使用HTTP基本身份验证检查用户/密码的有效性。
	* 文件'''htdocs/core/login/functions_ldap.php''' 使用LDAP检查用户/密码的有效性。		*文件'''htdocs/core/login/functions_ldap.php''' 使用LDAP检查用户/密码的有效性。
	* 文件'''htdocs/core/login/functions_dolibarr.php'''使用Dolibarr数据库中数据检查用户/密码的有效性。		*文件'''htdocs/core/login/functions_dolibarr.php'''使用Dolibarr数据库中数据检查用户/密码的有效性。

	每个文件只包含一个名为'''check_user_password_xxx'''的函数（xxx为http/ldap/dolobarr），但Dolibarr只使用其中的一个。具体使用哪一个文件，'''xxx'''的值与配置文件'''conf/conf.php'''中的 '''dolibarr_main_authentication''' 的值匹配。		每个文件只包含一个名为'''check_user_password_xxx'''的函数（xxx为http/ldap/dolobarr），但Dolibarr只使用其中的一个。具体使用哪一个文件，'''xxx'''的值与配置文件'''conf/conf.php'''中的 '''dolibarr_main_authentication''' 的值匹配。

	Dolibarr将运行文件包含的唯一函数，方法是将它们作为参数，仅发送从post登录表单接收的用户和密码。如果用户/密码有效，函数返回true，否则为false。		Dolibarr将运行文件包含的唯一函数，方法是将它们作为参数，仅发送从post登录表单接收的用户和密码。如果用户/密码有效，函数返回true，否则为false。

Eldy: /* 过程 */

2023-01-17T08:40:04Z

过程

@@ Line 25: / Line 25: @@
 所以我们有:
-<source lang="php">
- <mypage.php>
+{{Template:CodeSampleForLoginProcess}}
    #1#表示我们稍后将使用的许多库的加载，但也初始化包含正在运行的PHP上下文的对象和变量（加载配置文件、加载语言文件以及创建尚未经过身份验证的空用户）。

PolyglotBot: Import interlang links (links to translated versions of this page in other languages) from origin English page "Authentication".

2019-07-23T13:20:02Z

Import interlang links (links to translated versions of this page in other languages) from origin English page "Authentication".

← Older revision		Revision as of 13:20, 23 July 2019
Line 1:		Line 1:
			<!-- BEGIN interlang links -->
			<!-- Do NOT edit this section
			Links below are automatically managed by PolyglotBot
			You can edit links on the English source page : Authentication -->
			[[en:Authentication]]
			[[fr:Authentification]]
			[[es:Autentificación]]
			<!-- END interlang links -->

	[[Category:Core]]		[[Category:Core]]
	{{Template开发文档}}		{{Template开发文档}}

R.ivnun: /* 过程 */

2018-10-09T08:35:48Z

过程

← Older revision		Revision as of 08:35, 9 October 2018
Line 45:		Line 45:
	</source>		</source>

	#1#表示我们稍后将使用的许多库的加载，但也初始化包含正在运行的PHP上下文的对象和变量（加载配置文件、加载语言文件以及创建尚未经过身份验证的空用户）。		#1#表示我们稍后将使用的许多库的加载，但也初始化包含正在运行的PHP上下文的对象和变量（加载配置文件、加载语言文件以及创建尚未经过身份验证的空用户）。

	#2#表示用于身份验证的代码：程序检查我们是否在日志会话中（这意味着$_SESSION["dol_login"]存在）。如果没有，我们检查我们是否从登录和密码表单接收数据。在页面的第一次调用期间，由于用户还没有查看登录表单，情况并非如此。因此，我们继续和 $login 的值仍然是false，所以我们输出登录表单，结束脚本。		#2#表示用于身份验证的代码：程序检查我们是否在日志会话中（这意味着$_SESSION["dol_login"]存在）。如果没有，我们检查我们是否从登录和密码表单接收数据。在页面的第一次调用期间，由于用户还没有查看登录表单，情况并非如此。因此，我们继续和 $login 的值仍然是false，所以我们输出登录表单，结束脚本。

	在提交登录之后，相同的页面（仍然调用index.php），我们仍然进入#1#，然后#2#，现在定义了$_POST["username"]。因此，我们检查用户和密码是否正常（检查数据库，LDAP，它取决于配置文件中的$dolibarr_main_authentication的值）。如果可以，则设置了$login变量，因此不再显示表单，并且设置$_SESSION["dol_login"]，因此下次调用页面时，我们永远不会进入"if (! isset($_SESSION["dol_login"]))"。		在提交登录之后，相同的页面（仍然调用index.php），我们仍然进入#1#，然后#2#，现在定义了$_POST["username"]。因此，我们检查用户和密码是否正常（检查数据库，LDAP，它取决于配置文件中的$dolibarr_main_authentication的值）。如果可以，则设置了$login变量，因此不再显示表单，并且设置$_SESSION["dol_login"]，因此下次调用页面时，我们永远不会进入"if (! isset($_SESSION["dol_login"]))"。

	~~第3类是检查业务权限并显示页面。请参阅~~[[Permissions En\|Permissions]]页以获取更多信息。		#3#是检查业务权限并显示页面。请参阅[[Permissions En\|Permissions]]页以获取更多信息。

	= 登录模块 =		= 登录模块 =

R.ivnun: Created page with "Category:Core {{Template开发文档}} {{Template用户手册}} {{TemplateMainPageZh}} = 介绍 = 本页描述Dolibarr认证过程是如何工作的。您必须熟悉PHP..."

2018-10-09T08:33:45Z

Created page with "Category:Core {{Template开发文档}} {{Template用户手册}} {{TemplateMainPageZh}} = 介绍 = 本页描述Dolibarr认证过程是如何工作的。您必须熟悉PHP..."

New page

[[Category:Core]]
{{Template开发文档}}
{{Template用户手册}}
{{TemplateMainPageZh}}

= 介绍 =

本页描述Dolibarr认证过程是如何工作的。您必须熟悉PHP sessions才能正确理解发生的事情。

= 过程 =

当您调用要查看的页面时，进程开始。例如index.php (htdocs/index.php)。但这不是要求认证的文件。每个Dolibarr PHP页面都包含一个名为main.inc.php的文件，这个文件包含一个名为master.inc.php的文件。

所以我们有:
<source lang="php">
<mypage.php>
<main.inc.php>
<master.inc.php>
#1#
</master.inc.php>
#2#
if (! isset($_SESSION["dol_login"]))
{
if (isset($_POST["username"]))
{
...
// if user and pass are ok, we set $login
$login=
}
if (! $login)
{
// We show login page
include_once(DOL_DOCUMENT_ROOT."/lib/security.lib.php");
dol_loginfunction($langs,$conf,$mysoc);
exit;
}
...
}
</main.inc.php>
#3#
</mypage.php>
</source>

#1#表示我们稍后将使用的许多库的加载，但也初始化包含正在运行的PHP上下文的对象和变量（加载配置文件、加载语言文件以及创建尚未经过身份验证的空用户）。

#2#表示用于身份验证的代码：程序检查我们是否在日志会话中（这意味着$_SESSION["dol_login"]存在）。如果没有，我们检查我们是否从登录和密码表单接收数据。在页面的第一次调用期间，由于用户还没有查看登录表单，情况并非如此。因此，我们继续和 $login 的值仍然是false，所以我们输出登录表单，结束脚本。

在提交登录之后，相同的页面（仍然调用index.php），我们仍然进入#1#，然后#2#，现在定义了$_POST["username"]。因此，我们检查用户和密码是否正常（检查数据库，LDAP，它取决于配置文件中的$dolibarr_main_authentication的值）。如果可以，则设置了$login变量，因此不再显示表单，并且设置$_SESSION["dol_login"]，因此下次调用页面时，我们永远不会进入"if (! isset($_SESSION["dol_login"]))"。

第3类是检查业务权限并显示页面。请参阅[[Permissions En|Permissions]]页以获取更多信息。

= 登录模块 =

登录模块是包含检查用户/密码有效性的函数的文件。

一个文件按模块，一个文件按函数。每个文件都进行不同类型的检查。

* 文件'''htdocs/core/login/functions_http.php'''使用HTTP基本身份验证检查用户/密码的有效性。
* 文件'''htdocs/core/login/functions_ldap.php''' 使用LDAP检查用户/密码的有效性。
* 文件'''htdocs/core/login/functions_dolibarr.php'''使用Dolibarr数据库中数据检查用户/密码的有效性。

每个文件只包含一个名为'''check_user_password_xxx'''的函数（xxx为http/ldap/dolobarr），但Dolibarr只使用其中的一个。具体使用哪一个文件，'''xxx'''的值与配置文件'''conf/conf.php'''中的 '''dolibarr_main_authentication''' 的值匹配。

Dolibarr将运行文件包含的唯一函数，方法是将它们作为参数，仅发送从post登录表单接收的用户和密码。如果用户/密码有效，函数返回true，否则为false。