docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// 本文件把 Google、Slack、邮箱等提供方身份归一为项目账户,并签发一次性交换码。
|
||||
package auth
|
||||
|
||||
import (
|
||||
@@ -8,7 +9,10 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// identityGrant 由已完成提供方验证的登录流程调用;subject 必须是该提供方的稳定身份。
|
||||
// challenge 来自前端登录起点,后续 exchange 必须提交对应 verifier 才能换取会话。
|
||||
func (s *service) identityGrant(ctx context.Context, project, provider, subject string, email *string, name, picture, challenge string) (string, error) {
|
||||
// 外部资料仅作为初始显示信息:限制姓名长度,头像只接受无用户信息的 HTTPS URL。
|
||||
name = strings.TrimSpace(name)
|
||||
if len(name) > 160 {
|
||||
name = ""
|
||||
@@ -20,13 +24,15 @@ func (s *service) identityGrant(ctx context.Context, project, provider, subject
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
// 账户、身份关联和短期 grant 同事务提交;任一步失败都不遗留半注册账户。
|
||||
defer tx.Rollback()
|
||||
// Serialize first registration for the same provider identity.
|
||||
// 事务级 advisory lock 串行化同项目、同提供方、同 subject 的首次注册;事务结束即释放。
|
||||
if _, err = tx.ExecContext(ctx, "SELECT pg_advisory_xact_lock(hashtextextended($1,0))", project+":"+provider+":"+subject); err != nil {
|
||||
return "", err
|
||||
}
|
||||
var account string
|
||||
err = tx.QueryRowContext(ctx, "SELECT account_id::text FROM account_identities WHERE project=$1 AND provider=$2 AND subject=$3", project, provider, subject).Scan(&account)
|
||||
// 身份不存在才建账户;不会仅凭相同邮箱自动合并不同提供方的身份。
|
||||
if errors.Is(err, sql.ErrNoRows) {
|
||||
var googleSubject *string
|
||||
if provider == "google" {
|
||||
@@ -44,6 +50,7 @@ SELECT $1,id,$2,$3,
|
||||
}
|
||||
_, err = tx.ExecContext(ctx, "INSERT INTO account_identities(project,provider,subject,account_id) VALUES($1,$2,$3,$4)", project, provider, subject, account)
|
||||
} else if err == nil {
|
||||
// 老账户保留已有显示名/头像,只补空值;非空提供方邮箱会更新账户邮箱。
|
||||
_, err = tx.ExecContext(ctx, `
|
||||
UPDATE project_accounts SET email=COALESCE($3,email),
|
||||
display_name=CASE WHEN display_name='' THEN $4 ELSE display_name END,
|
||||
@@ -55,6 +62,7 @@ UPDATE project_accounts SET email=COALESCE($3,email),
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
// 只落库交换码摘要,明文仅返回给回调方;一分钟期限和前端 challenge 限制兑换。
|
||||
grant := token()
|
||||
_, err = tx.ExecContext(ctx, "INSERT INTO login_grants VALUES($1,$2,$3,$4,now()+interval '1 minute')", digest(grant), project, account, challenge)
|
||||
if err != nil {
|
||||
|
||||
Reference in New Issue
Block a user