docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// Slack OIDC 登录验证独立 ID token,再复用 identityGrant 和前端 grant 兑换协议。
|
||||
package auth
|
||||
|
||||
import (
|
||||
@@ -18,6 +19,7 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// SlackConfig 保存可选客户端凭据以及由 mu 保护的签名公钥缓存。
|
||||
type SlackConfig struct {
|
||||
ClientID, Secret, RedirectURI string
|
||||
mu sync.Mutex
|
||||
@@ -25,6 +27,7 @@ type SlackConfig struct {
|
||||
fetchedAt time.Time
|
||||
}
|
||||
|
||||
// SlackConfigFromEnv 允许整组缺省以关闭 Slack;只配置一半会阻止服务启动。
|
||||
func SlackConfigFromEnv(redirect string) (*SlackConfig, error) {
|
||||
id, secret := os.Getenv("SLACK_CLIENT_ID"), os.Getenv("SLACK_CLIENT_SECRET")
|
||||
if id == "" && secret == "" {
|
||||
@@ -36,6 +39,7 @@ func SlackConfigFromEnv(redirect string) (*SlackConfig, error) {
|
||||
return &SlackConfig{ClientID: id, Secret: secret, RedirectURI: redirect}, nil
|
||||
}
|
||||
|
||||
// slackClaims 仅在验签、发行方/受众/时间和 nonce 校验后用于账户身份。
|
||||
type slackClaims struct {
|
||||
Issuer string `json:"iss"`
|
||||
Subject string `json:"sub"`
|
||||
@@ -50,6 +54,7 @@ type slackClaims struct {
|
||||
Picture string `json:"picture"`
|
||||
}
|
||||
|
||||
// slackKey 在互斥锁内加载并缓存 JWKS 一分钟;缓存期遇到未知 kid 直接拒绝,避免重复拉取。
|
||||
func (s *service) slackKey(ctx context.Context, kid string) (*rsa.PublicKey, error) {
|
||||
c := s.slack
|
||||
c.mu.Lock()
|
||||
@@ -73,6 +78,7 @@ func (s *service) slackKey(ctx context.Context, kid string) (*rsa.PublicKey, err
|
||||
if err := s.googleJSON(ctx, "GET", "https://slack.com/openid/connect/keys", nil, "", &document); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
// 只接收可用于 RS256 签名的 RSA 公钥,并约束模数和指数大小。
|
||||
keys := map[string]*rsa.PublicKey{}
|
||||
for _, key := range document.Keys {
|
||||
n, nErr := base64.RawURLEncoding.DecodeString(key.N)
|
||||
@@ -93,6 +99,8 @@ func (s *service) slackKey(ctx context.Context, kid string) (*rsa.PublicKey, err
|
||||
}
|
||||
return nil, errors.New("unknown Slack signing key")
|
||||
}
|
||||
|
||||
// verifySlack 限制 token 长度与算法,先验签再信任 payload;nonce 将身份绑定到本次登录。
|
||||
func (s *service) verifySlack(ctx context.Context, value, nonce string) (slackClaims, error) {
|
||||
var claims slackClaims
|
||||
invalid := errors.New("invalid Slack identity token")
|
||||
@@ -136,6 +144,8 @@ func (s *service) verifySlack(ctx context.Context, value, nonce string) (slackCl
|
||||
}
|
||||
return claims, nil
|
||||
}
|
||||
|
||||
// startSlack 写十分钟尝试和 OIDC nonce,Cookie 采用 SameSite=None 以接收跨站 POST 回调。
|
||||
func (s *service) startSlack(w http.ResponseWriter, r *http.Request, project string) error {
|
||||
if s.slack == nil {
|
||||
return reject(w, 503, "slack_not_configured")
|
||||
@@ -159,6 +169,8 @@ VALUES($1,$2,$3,$4,'',now()+interval '10 minutes','slack',$5)
|
||||
http.Redirect(w, r, "https://slack.com/openid/connect/authorize?"+query.Encode(), 302)
|
||||
return nil
|
||||
}
|
||||
|
||||
// slackCallback 接受 GET/POST,先一次性消费浏览器绑定的尝试,再向 Slack 兑换 ID token。
|
||||
func (s *service) slackCallback(w http.ResponseWriter, r *http.Request) error {
|
||||
if s.slack == nil {
|
||||
return reject(w, 503, "slack_not_configured")
|
||||
@@ -216,6 +228,7 @@ RETURNING project,frontend_challenge,oidc_nonce
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
// 团队和用户共同构成 subject;verifySlack 已拒绝冒号,避免拼接身份产生歧义。
|
||||
grant, err := s.identityGrant(r.Context(), project, "slack", claims.Team+":"+claims.Subject, claims.Email, claims.Name, claims.Picture, challenge)
|
||||
if err != nil {
|
||||
return err
|
||||
|
||||
Reference in New Issue
Block a user