编辑“Discuz:Discuz!通行证整合你的主站用户”

__NOTOC__
{{Discuz! 6.0 top}}
<div style="clear:both;"></div>
<p style="text-indent:2em;">从 [[Discuz]]! 4.0.0 RC4 版本开始，Discuz! 内嵌了一个独特的 Passport（通行证） 接口，利用此接口，用户将很容易将[[论坛]]与其他应用 程序整合，而实现统一登录与退出、用户数据共享、积分同步等功能。可以整合的应用程序包括内容管理系统（[[CMS]]）、商城系统、游戏系统等 等。进行整合之后，用户的注册、登录和退出都由其他的应用程序端来完成，所以只要你在你的应用程序中加入关联Discuz的注册、登录和退出即可。那有人就会问，怎样加入呢？先不急，首先讲讲Discuz！这边的设置，然后讲讲应用程序端改怎么开发这些代码！</p>
<p style="text-indent:2em;">既然Discuz！程序已经释放了用户的接口，那么在这套整合的过程中，无需你改动任何的Discuz！代码，只需后台简单的设置，如图 1 所示：</p>
[[{{ns:image}}:dz569.gif]]
<p style="text-indent:2em;">首先第一项启用通行证是开关，填写好准确的应用程序[[url]]地址，为了保证传输的安全，后台得设置一个私有密钥，这个密钥待会在你写主程序的通行证的时候也得用到，还有就是设置验证字串的有效期，这邪恶都是为安全考虑的，应用程序的注册、登录、退出的地址也要设置好，Discuz！通行证还可以同步一个单项积分，所以可以后台设置需要同步哪个单项积分。</p>
<p style="text-indent:2em;">其实设置之前你就应该把应用程序的登录、注册和退出的代码写好。下面简单讲解一下通行证的登录、注册和退出的流程。</p>
<p style="text-indent:2em;">其实使用通行证之后，用户的身份验证信息将你应用程序端为主，也就是说，你的整套系统中有哪些用户，用户是什么密码都由你的应用程序端的[[数据库]]的存放用户信息的表为主，论坛这边只是一个辅助存储数据的效果。</p>
<h5>下面介绍一下开启通行证后的用户登录流程：</h5>
<p style="text-indent:2em;">如果用户在论坛点击“登录”，则转向到事先设置好的应用程序登录页面（<nowiki>http://www.mywebsite.com/login.php? action=login</nowiki>），并在登录页面 的 URL 中加入参数 forward（加入 forward 后的链接例如 <nowiki>http://www.mywebsite.com/login.php?action=login&forward=http://www.myforums.com/index.php</nowiki>）， 用于在登录后将用户导向到指定的 URL。</p>
<p style="text-indent:2em;">应用程序收到此请求后，按照惯例生成表单，并增加一个表单变量，将 GET 方式传递过来的 forward 参数通过表单进行传递。</p>
<p style="text-indent:2em;">用户在应用程序的表单中填写登录信息，并提交到应用程序的登录验证程序。应用程序验证用户提交的用户名和密码的合法性：</p>
<p style="text-indent:2em;"><span style="color:red;">如果不通过：</span>提示用户名密码错误，要求其返回上一页重新填写。</p>
<p style="text-indent:2em; color:red;">如果通过，需要进行如下操作： </p>
<p style="text-indent:2em;">设置自身 Cookie 或 Session，使得应用程序自身处于登录状态。</p>
<p style="text-indent:2em;">检查表单中是否提交了 forward 变量，如有，则意味着登录请求可能是由论坛而来，将此变量传递到后面的请求中。如没有，自行生成 forward 变量，使得论坛登录后能够跳转回到应用程序中。</p>
<p style="text-indent:2em;">通过 header('Location: <nowiki>http://www.myforums.com/api/passport.php?action=login&auth=xxx&forward=http://yyy&verify=zzz'</nowiki>) 的 方式，将登录请求传递到论坛进行处理。其中 auth 用来将用户信息与资料以特定的格式，加密传递给论坛，forward 用于告知论坛 Passport [[API]] 完成 自身操作后转向到的 URL 地址，verify 用于验证前面两个变量的有效性。auth、forward、verify 格式与结构将在后面进行说明。</p>
<p style="text-indent:2em;">Discuz! Passport API 在接收到由应用程序通过 header() 提交过来的请求后，进行如下操作：</p>
<p style="text-indent:2em;">根据 verify 判断 auth 和 forward 变量是否合法，如合法则继续，否则终止。 </p>
<p style="text-indent:2em;">将 auth 根据既定算法解密，并还原成数组，数组的内容与格式将在后面进行说明。根据数组中的内容，检查此用户是否存在。如存在，则根据 上述数组中的内容 UPDATE 论坛中相应的用户资料。如不存在，则使用数组中的信息 INSERT 到论坛用户资料表中。</p>
<p style="text-indent:2em;">论坛设置 Cookie 或 Session，使得论坛自身处于登录状态。</p>
<p style="text-indent:2em;">根据应用程序反馈的 forward 值，通过 header('Location: <nowiki>http://xxx'</nowiki>) 的形式将页面跳转到 forward 变量指定的 URL。</p>
<p style="text-indent:2em; color:red;">至此，登录流程结束。</p>
<h5>然后是开启通行证后的用户退出流程：</h5>
<p style="text-indent:2em;">如果用户在论坛点击“退出”，则转向到事先设置好的应用程序退出页面（<nowiki>http://www.mywebsite.com/login.php?action=logout</nowiki>），并在登录页面 的 URL 中加入参数 forward（例如 <nowiki>http://www.mywebsite.com/login.php?action=login&forward=http://www.myforums.com/index.php</nowiki>），用于 在退出后将用户导向到指定的 URL。</p>
<p style="text-indent:2em;">应用程序收到此请求后，清除自身 [[Cookie]] 或 Session，使得应用程序自身处于非登录状态。</p>
<p style="text-indent:2em;">检查是否提交了 forward 变量，如有，则意味着登录请求可能是由论坛而来，将此变量传递到后面的请求中。如没有，自行生成 forward 变量，使得论坛登录后能够跳转回到应用程序中。</p>
<p style="text-indent:2em;">通过 header('Location: <nowiki>http://www.myforums.com/api/passport.php?action=logout&forward=http://yyy&verify=zzz'</nowiki>) 的方式，将 退出请求传递到论坛进行处理。其中 forward 用于告知论坛 Passport API 完成自身操作后转向到的 URL 地址，verify 用于验证 forward 变量的 有效性。forward、verify 格式与结构将在后面进行说明。</p>
<p style="text-indent:2em;">Discuz! Passport API 在接收到由应用程序通过 header() 提交过来的请求后，进行如下操作：</p>
<p style="text-indent:2em;">根据 verify 判断 forward 变量是否合法，如合法则继续，否则终止。</p>
<p style="text-indent:2em;">清楚论坛的 Cookie 或 Session，使得论坛自身处于非登录状态。</p>
<p style="text-indent:2em;">根据应用程序反馈的 forward 值，通过 header('Location: <nowiki>http://xxx</nowiki>') 的形式将页面跳转到 forward 变量指定的 URL。</p>
<p style="text-indent:2em; color:red;">至此，退出流程结束。</p>
<h5>开启通行证后的用户注册流程：</h5>
<p style="text-indent:2em;">如果用户在论坛点击“注册”，则转向到事先设置好的应用程序注册页面（<nowiki>http://www.mywebsite.com/register.php</nowiki>），并在注册页面的 URL 中 加入参数 forward（例如 <nowiki>http://www.mywebsite.com/register.php?forward=http://www.myforums.com/index.php</nowiki>），用于在注册后将用户导向到 指定的 URL </p>
<p style="text-indent:2em;">应用程序收到此请求后，按照惯例生成表单，并增加一个表单变量将 GET 方式传递过来的 forward 参数通过表单进行传递 </p>
<p style="text-indent:2em;">用户在应用程序的表单中填写注册信息，并提交到应用程序的注册验证程序。应用程序验证用户提交信息的完整性和合法性：</p>
<p style="text-indent:2em;"><span style="color:red;">如果不通过：</span>提示其问题所在，要求其返回上一页重新填写 </p>
<p style="text-indent:2em; color:red;">如果通过，需要进行如下操作：</p>
<p style="text-indent:2em;">将用户资料插入到应用程序自身用户数据库中。</p>
<p style="text-indent:2em;">设置自身 Cookie 或 Session，使得应用程序自身处于登录状态。</p>
<p style="text-indent:2em;">检查表单中是否提交了 forward 变量，如有，则意味着注册请求可能是由论坛而来，将此变量传递到后面的请求中。如没有，自行生成 forward 变量，使得论坛注册后能够跳转回到应用程序中。 </p>
<p style="text-indent:2em;">通过 header('Location: <nowiki>http://www.myforums.com/api/passport.php?action=login&auth=xxx&forward=http://yyy&verify=zzz</nowiki>') 的 方式，将注册请求传递到论坛进行处理。其中 auth 用来将用户信息与资料以特定的格式，加密传递给论坛，forward 用于告知论坛 Passport API 完成 自身操作后转向到的 URL 地址，verify 用于验证前面两个变量的有效性。auth、forward、verify 格式与结构将在后面进行说明。 </p>
<p style="text-indent:2em;">Discuz! Passport API 在接收到由应用程序通过 header() 提交过来的请求后，进行如下操作：</p>
<p style="text-indent:2em;">根据 verify 判断 auth 和 forward 变量是否合法，如合法则继续，否则终止。 </p>
<p style="text-indent:2em;">将 auth 根据既定算法解密，并还原成数组，数组的内容与格式将在后面进行说明。根据数组中的内容，检查此用户是否存在。如存在，则根据 上述数组中的内容 UPDATE 论坛中相应的用户资料。如不存在，则使用数组中的信息 INSERT 到论坛用户资料表中。 </p>
<p style="text-indent:2em;">论坛设置 Cookie 或 Session，使得论坛自身处于登录状态 。</p>
<p style="text-indent:2em;">根据应用程序反馈的 forward 值，通过 header('Location: <nowiki>http://xxx</nowiki>') 的形式将页面跳转到 forward 变量指定的 URL。</p>
<p style="text-indent:2em; color:red;">至此，注册流程结束。</p>
<p style="text-indent:2em;">这就是通行证的登录、退出和注册的一个简单流程，详细资料请查阅《用户使用说明书》的《高级应用》部分。</p>
<p style="text-indent:2em;">当然，通行证既有它的优势，也有它的局限性。</p>
<h5>Discuz! Passport 的优点：</h5>
<p style="text-indent:2em;">Discuz! Passport 系统使用了 Discuz! 独有的技术，并不等同于以往使用过的一些方法，与传统的实现方式相比，具备（不限于）以下优势： </p>
<p style="text-indent:2em;">1、基于私有密匙的低相关性可逆加密算法，配合 [[MD5]] 校检码技术，使得暴力破解或伪造几乎不可能。 </p>
<p style="text-indent:2em;">2、应用程序可与论坛放置于不同的[[服务器]]及不同的[[域名]]下。可基于不同[[操作系统]]、不同程序语言和不同数据库平台，具备真正的平台无关性。 </p>
<p style="text-indent:2em;">3、不需要任何形式的数据库连接、或强制把两套应用程序的数据放在同一数据库甚至同一数据表中。论坛与应用程序都有各自的用户数据表， 只是在需要时进行无缝同步操作。 </p>
<p style="text-indent:2em;">4、对应用程序的代码改动简便易行，可最快速的完成应用程序与论坛间的整合。 </p>
<h5>Discuz! Passport 的局限：</h5>
<p style="text-indent:2em;">您在开始利用 Discuz! Passport 进行二次开发时，需要了解这个系统的局限性，以对未来的工作进行正确的评估与安排。 </p>
<p style="text-indent:2em;">1、只能工作在用户密码不加密、可逆加密或 MD5 加密的情况下，否则论坛后台无法登录。</p>
<p style="text-indent:2em;">2、只能与一种应用程序关联，即二方关联。不能实现三方关联或与更多的应用程序进行关联。 </p>
<p style="text-indent:2em;">3、应用程序需具有独立的注册、登录、退出页面和链接，否则需要自行修改论坛中的相应表单或程序。</p>
<p style="text-indent:2em;">4、由于论坛的注册人数可能很多，例如百万级以上，且应用程序和论坛间的用户数据是同步的，因此要求应用程序能够稳定的负载大量用户的访问。</p>
<p style="font-weight:bold; color:#f60;">总之，Discuz！通行证接口，让你更加方便的去整合你的用户系统，达到同步登录，注册和退出。有兴趣和需求的站长，赶紧给你的会员使用上吧，让他们在你的所有站长“畅通无阻”。</p>

== 参考来源 ==
*http://faq.comsenz.com/
{{Discuz! 6.0}}
[[category:Discuz后台扩展管理]]