[{"data":1,"prerenderedAt":396},["ShallowReactive",2],{"blog:zh:how-a-login-works":3,"blog-next:zh":318},{"id":4,"title":5,"author":6,"body":7,"date":303,"description":304,"extension":305,"meta":306,"navigation":307,"path":308,"publishAt":309,"seo":310,"stem":311,"tags":312,"__hash__":317},"blog_zh\u002Fblog\u002Fhow-a-login-works\u002Fzh.md","登录是如何工作的","Aptli",{"type":8,"value":9,"toc":286},"minimark",[10,14,17,20,23,27,39,49,59,66,73,80,87,94,101,108,115,121,124,128,131,134,137,141,144,147,150,153,156,159,162,165,168,171,174,268,271,274,277,280,283],[11,12,13],"p",{},"我们的实习生的第一个项目，是一个属于她自己、没有任何客户依赖的网站。它让她学习我们的文件结构、命名约定，以及我们打包组件和工具函数的模式。它也给了她一个可以继续构建的基础。",[11,15,16],{},"页面和路由很快就完成了。登录是第一个难题。对没有做过登录的人来说，它很复杂，一张图会有帮助。下面是我们的做法。",[11,18,19],{},"登录看起来只是一个表单。在它背后，浏览器、服务器和数据库之间传递十几条消息，沿途的检查保护着账户安全。",[11,21,22],{},"这是登录的基本模式，我们团队的每位开发者都最先学习它。",[24,25,26],"h2",{"id":26},"主干流程",[11,28,29,30,38],{},"  ",[31,32,34],"span",{"style":33},"color:#2563eb",[35,36,37],"strong",{},"浏览器："," 把登录信息发送给服务器。",[11,40,41,42,48],{},"      ",[31,43,45],{"style":44},"color:#0f766e",[35,46,47],{},"服务器："," 查找该用户。",[11,50,51,52,58],{},"          ",[31,53,55],{"style":54},"color:#7c3aed",[35,56,57],{},"数据库："," 返回存储的记录。",[11,60,41,61,65],{},[31,62,63],{"style":44},[35,64,47],{}," 将登录信息与存储的记录进行核对，并创建一个带有过期时间的会话。",[11,67,51,68,72],{},[31,69,70],{"style":54},[35,71,57],{}," 存储该会话。",[11,74,41,75,79],{},[31,76,77],{"style":44},[35,78,47],{}," 把令牌放在 Cookie 中返回给浏览器。",[11,81,29,82,86],{},[31,83,84],{"style":33},[35,85,37],{}," 在之后的每个请求中都带上这个 Cookie。",[11,88,41,89,93],{},[31,90,91],{"style":44},[35,92,47],{}," 在返回任何数据之前检查会话。",[11,95,51,96,100],{},[31,97,98],{"style":54},[35,99,57],{}," 确认会话存在且仍然有效。",[11,102,41,103,107],{},[31,104,105],{"style":44},[35,106,47],{}," 拒绝已过期的会话，并在用户登出时结束会话。",[11,109,51,110,114],{},[31,111,112],{"style":54},[35,113,57],{}," 无论哪种情况，都删除会话记录。",[11,116,117],{},[118,119],"img",{"alt":5,"src":120},"\u002Fimages\u002Fblog\u002Fhow-a-login-works\u002Flogin-flow.png",[24,122,123],{"id":123},"关键检查点",[125,126,127],"h3",{"id":127},"服务器在每个请求上做决定",[11,129,130],{},"服务器决定用户是谁、能访问什么。浏览器出示登录信息或令牌。服务器验证它们，在每个请求上检查数据库中的会话记录，并返回该用户可以看到的内容。没有有效会话的请求会得到 401，且没有任何数据。",[125,132,133],{"id":133},"为每个密码存储慢速哈希",[11,135,136],{},"服务器为每个密码存储一个慢速、单向的哈希值，并配有唯一的盐值。密码本身从不存储。登录时，服务器用同样的方式对提交的密码做哈希，并比较两个结果。被盗的数据库里只有加盐的哈希值，针对它们的每一次猜测都很慢。",[125,138,140],{"id":139},"把令牌放在受保护的-cookie-中","把令牌放在受保护的 Cookie 中",[11,142,143],{},"浏览器会自动在发往您网站的每个请求上附带 Cookie，并且可以让页面上的脚本无法访问它。为 Cookie 设置三个标志。HttpOnly 让页面上的脚本无法读取它。Secure 让它只通过 HTTPS 发送。SameSite 防止其他网站在发往您网站的表单和后台请求中附带它。",[125,145,146],{"id":146},"在每个数据请求上检查访问权限",[11,148,149],{},"有效的会话证明了用户是谁。每个返回数据的调用还会检查该用户是否可以查看所请求的记录。每位客户的会话只能访问该客户自己的数据。",[125,151,152],{"id":152},"为每个会话设置过期时间",[11,154,155],{},"服务器把每个会话连同其过期时间存入数据库。在每个请求上，服务器先检查过期时间，再返回数据。会话在设定的时间或一段时间无操作后结束，服务器会从数据库中删除它的记录。较短的过期时间和无操作超时，限制了被复制的令牌能使用多久。",[125,157,158],{"id":158},"在服务器上登出",[11,160,161],{},"浏览器请求服务器登出。服务器从数据库中删除会话记录，然后清除 Cookie。记录一旦删除，被复制的令牌立即失效。",[125,163,164],{"id":164},"对每次登录失败给出相同的回答",[11,166,167],{},"“用户名或密码不正确”涵盖所有失败情况。对未知用户和错误密码分别给出提示，会让攻击者知道哪些账户存在。服务器还会针对每个账户和每个地址减缓重复尝试。",[24,169,170],{"id":170},"按工作流程组织的代码",[11,172,173],{},"图中展示了十几条消息。它们背后的代码按工作流程组织。一个调用处理多个步骤，各步骤共享的逻辑集中在一处。",[175,176,177,193],"table",{},[178,179,180],"thead",{},[181,182,183,187,190],"tr",{},[184,185,186],"th",{},"工作流程",[184,188,189],{},"示例",[184,191,192],{},"涵盖内容",[194,195,196,211,222,233,246,257],"tbody",{},[181,197,198,202,208],{},[199,200,201],"td",{},"登录",[199,203,204],{},[205,206,207],"code",{},"POST \u002Fapi\u002Flogin",[199,209,210],{},"哈希、受保护的 Cookie 和统一的失败提示",[181,212,213,216,219],{},[199,214,215],{},"每个请求",[199,217,218],{},"在每个受保护路由之前运行的检查",[199,220,221],{},"服务器的决定、有效会话和过期",[181,223,224,227,230],{},[199,225,226],{},"数据调用",[199,228,229],{},"每个返回记录的接口",[199,231,232],{},"对所请求记录的数据访问",[181,234,235,238,243],{},[199,236,237],{},"登出",[199,239,240],{},[205,241,242],{},"POST \u002Fapi\u002Flogout",[199,244,245],{},"在服务器和数据库中结束会话",[181,247,248,251,254],{},[199,249,250],{},"共享逻辑",[199,252,253],{},"上述调用共享的一个模块",[199,255,256],{},"密码哈希、会话、Cookie 标志和过期",[181,258,259,262,265],{},[199,260,261],{},"浏览器端",[199,263,264],{},"每个页面都使用的一个辅助函数",[199,266,267],{},"登录、登出和当前用户",[11,269,270],{},"登录调用在一个请求中完成整个登录。它查找用户、比较哈希值并设置 Cookie。对每种失败都返回相同的错误。",[11,272,273],{},"请求检查在每个受保护路由之前运行。它读取 Cookie，检查数据库中的会话，并在会话不存在时返回 401。",[11,275,276],{},"共享模块包含上述调用共享的逻辑。哈希、Cookie 标志和过期规则在那里各只出现一次。每个调用都以相同的方式应用它们。",[11,278,279],{},"浏览器辅助函数为每个页面提供相同的登录、登出和当前用户。它决定页面显示什么。服务器决定哪些数据可以发出。",[24,281,282],{"id":282},"在此基础上扩展",[11,284,285],{},"这个模式是可扩展的，这正是它的主要优点。基础一旦就位，每个部分都可以替换。通过 OpenID Connect 或 SAML 实现的单点登录，改变了用户证明身份的方式。通行密钥也是如此。服务器端和浏览器端的中间件挂接到同样的步骤上。它们都从上面的基础出发。",{"title":287,"searchDepth":288,"depth":288,"links":289},"",2,[290,291,301,302],{"id":26,"depth":288,"text":26},{"id":123,"depth":288,"text":123,"children":292},[293,295,296,297,298,299,300],{"id":127,"depth":294,"text":127},3,{"id":133,"depth":294,"text":133},{"id":139,"depth":294,"text":140},{"id":146,"depth":294,"text":146},{"id":152,"depth":294,"text":152},{"id":158,"depth":294,"text":158},{"id":164,"depth":294,"text":164},{"id":170,"depth":288,"text":170},{"id":282,"depth":288,"text":282},"2026-11-16","登录看起来只是一个表单。在它背后，浏览器、服务器和数据库之间传递十几条消息，沿途的检查保护着账户安全。这是我们团队每位开发者最先学习的基本模式。","md",{},true,"\u002Fblog\u002Fhow-a-login-works\u002Fzh",null,{"title":5,"description":304},"blog\u002Fhow-a-login-works\u002Fzh",[313,314,315,316],"engineering","how-we-work","authentication","security","GLb_lQZrNP9W61v56KP78I0n1ucWHeR2m6I268c-d3Y",[319,323,327,331,335,339,343,347,351,355,356,360,364,368,372,376,380,384,388,392],{"title":320,"description":321,"path":322},"一国政府为 AI 普及定下了日期","2026 年 6 月 4 日，加拿大推出了一项国家 AI 战略，其核心是一个附有具体年份的普及目标。正是这种具体性值得细看。","\u002Fblog\u002Fa-date-on-ai-adoption\u002Fzh",{"title":324,"description":325,"path":326},"Aptli 的重要里程碑","今天上午，安大略创新中心批准了对 Aptli 的 CIT 开发与商业化项目资助。几小时后，我们签署了第一个商业试点协议。这一时刻意味着什么，以及接下来我们将做什么。","\u002Fblog\u002Fa-milestone-day\u002Fzh",{"title":328,"description":329,"path":330},"随工程进展而不断完善的竣工图记录","竣工图在工程施工过程中实时绘制时最为准确。以下将介绍该地图如何逐步成为竣工图的，这一过程是通过逐一审核现场变更来实现的。","\u002Fblog\u002Fas-built-records\u002Fzh",{"title":332,"description":333,"path":334},"宽带建设面临后端运营问题","数十亿政府资金正涌入光纤部署领域，相关政策也已出台。政策的落实取决于负责协调施工的后勤部门，而该部门的能力将决定工程推进的速度。","\u002Fblog\u002Fbroadband-back-office-problem\u002Fzh",{"title":336,"description":337,"path":338},"承包商分层分离","当多个方（员工、分包商，甚至是竞争对手承包商）共享一个平台时，每个方都需要查看自己的工作内容以及共享层。以下说明了如何通过两层授权机制来实现这一点。","\u002Fblog\u002Fcontractor-separation\u002Fzh",{"title":340,"description":341,"path":342},"数据主权：新的地缘政治战场","对数据的控制已与国家安全、经济竞争力和民主韧性密不可分。","\u002Fblog\u002Fdata-sovereignty\u002Fzh",{"title":344,"description":345,"path":346},"2026 年秋季更新日志：所有工作集中在一棵树中、调查案件，以及能听懂口述内容的门户","仲夏以来的更新：项目与工作集中在一棵树中，资产与库存集中在一个页面，调查与收费附带相应文书，传感器读数驱动自动化，Power BI 报表，以及能根据口述内容选择表单的服务门户。","\u002Fblog\u002Ffall-2026-changelog\u002Fzh",{"title":348,"description":349,"path":350},"Git 用于现场数据","软件开发领域早已通过暂存、提交、冲突检查和代码审查等机制解决了并发编辑的问题。现场数据也有同样的需求，而Aptli采用了相同的处理模式。","\u002Fblog\u002Fgit-for-field-data\u002Fzh",{"title":352,"description":353,"path":354},"用你所构建的东西来治理 AI","隐私实践靠封堵起作用，因为组织拥有数据所在的地方。AI 的使用发生在一个不属于组织的文本框里。在那里起作用的控制，是一条留有记录的更好的路径。","\u002Fblog\u002Fgovern-ai-by-what-you-build\u002Fzh",{"title":5,"description":304,"path":308},{"title":357,"description":358,"path":359},"我们如何在动手构建之前就一种形态达成一致","几周前，我们写过设计模式如何在没有类的情况下出现在我们的代码中。我们团队内部的讨论并没有在发布时停止。本文讲的是这一切背后的习惯，以及我们为何把它当作有意为之的工作。","\u002Fblog\u002Fhow-we-agree-on-a-shape\u002Fzh",{"title":361,"description":362,"path":363},"线缆去哪儿了？从仓库到安装的材料流转记录","现场作业中大部分物料短缺其实是账面问题：即已发出的物料与能核对出的物料之间的差额。以下说明了如何通过记录完整的流转链（从仓库到安装）来弥补这一缺口。","\u002Fblog\u002Fmaterial-chain-of-custody\u002Fzh",{"title":365,"description":366,"path":367},"一位 Java 开发者向我们提出的问题","你们使用哪些设计模式？我们的前端几乎没有类。这个问题的回答，变成了对我们如何决定构建什么、以及如何彼此讨论这些决定的一段很好的描述。","\u002Fblog\u002Fobject-oriented-without-classes\u002Fzh",{"title":369,"description":370,"path":371},"许可与它所放行的工程一同跟踪","许可是工作的前提，它应与工作并列。以下是 Aptli 如何将许可作为工作单来管理，其规划、跟踪、验证和审计追踪功能与所批准的工作完全一致。","\u002Fblog\u002Fpermitting-without-a-module\u002Fzh",{"title":373,"description":374,"path":375},"PHP2Shell 与 Aptli","Aptli 已针对 PHP2Shell 检查了自身系统。PHP2Shell 是 10 月 20 日披露的 PHP 远程代码执行漏洞。Aptli 未受影响。","\u002Fblog\u002Fphp2shell\u002Fzh",{"title":377,"description":378,"path":379},"光纤铺设延误从何而起，以及如何及早发现","宽带项目延误的原因往往在于许可审批、公用设施和供应链。追溯延误的根源通常会发现问题出在项目内部的协调上，而这一部分是可以解决的。","\u002Fblog\u002Freal-reason-fiber-is-late\u002Fzh",{"title":381,"description":382,"path":383},"当规则的变化快过你的发布周期","AI 与隐私法规的变化速度已经超过多数产品周期。持久的问题是：下一次变化到来时，你能否消化它，还是选择退出那个市场。本文说明我们如何看待这个决定。","\u002Fblog\u002Frules-move-faster-than-release-cycle\u002Fzh",{"title":385,"description":386,"path":387},"名字之下的角色","曾有一位 Java 开发者问我们用哪些设计模式。此后的讨论落到了一个更简单的点上。模式的名字是一条捷径，名字之下的角色是团队共有的东西。","\u002Fblog\u002Fthe-role-under-the-name\u002Fzh",{"title":389,"description":390,"path":391},"我们为该网络提供了资金支持。现在，让我们着手建设它吧。","加拿大已为宽带基础设施投入了创纪录的资金。如何将这笔资金转化为实际网络，现在已成为一个执行层面的问题，以下是弥合这一差距所需采取的措施。","\u002Fblog\u002Fwe-funded-the-network\u002Fzh",{"title":393,"description":394,"path":395},"宽带项目在哪些方面亏损，以及如何堵住漏洞","一个网络项目上线后，就能确定该版本是否在预算范围内。而要找出资金流失的环节则需要更多工作。以下是项目中资金流失的七个环节，以及各自的解决对策。","\u002Fblog\u002Fwhere-broadband-projects-lose-money\u002Fzh",1794858610409]