feat: add single-admin application onboarding and token rotation

2026-09-27 10:18:31 +08:00
parent 98ff028228
commit 87aa710013
24 changed files with 1341 additions and 25 deletions
--- a/internal/consoleauth/applications.go
+++ b/internal/consoleauth/applications.go
@@ -0,0 +1,95 @@
+package consoleauth
+
+import (
+	"context"
+	"time"
+
+	core "git.yuntuo.hk/k2safe/orbit/model"
+	"git.yuntuo.hk/k2safe/orbit/platform/auth"
+)
+
+// ApplicationEntry 是应用接入列表的一行；同一应用的不同命名空间分别展示。
+type ApplicationEntry struct {
+	ApplicationID core.ID `json:"application_id"` // ApplicationID 所属应用标识。
+	Application   string  `json:"application"`    // Application 应用名称。
+	NamespaceID   core.ID `json:"namespace_id"`   // NamespaceID 数据隔离范围标识。
+	Namespace     string  `json:"namespace"`      // Namespace 命名空间名称。
+	Environment   string  `json:"environment"`    // Environment 环境名称。
+	Enabled       bool    `json:"enabled"`        // Enabled 应用与命名空间均启用时为真。
+}
+
+// ApplicationPage 按命名空间标识分页，每页最多 50 行，不包含秘密。
+type ApplicationPage struct {
+	Items []ApplicationEntry `json:"items"`          // Items 当前页接入范围。
+	Next  core.ID            `json:"next,omitempty"` // Next 下一页的排他起点。
+}
+
+// AccessQueue 是接入配置可选的队列。
+type AccessQueue struct {
+	ID   core.ID `json:"id"`   // ID 队列标识。
+	Name string  `json:"name"` // Name 队列名称。
+}
+
+// AccessCredential 是脱敏的凭据元数据，绝不返回秘密或秘密摘要。
+type AccessCredential struct {
+	ID          core.ID          `json:"id"`                   // ID 凭据标识，重新生成 Token 时不改变。
+	Name        string           `json:"name"`                 // Name 凭据名称。
+	Revision    uint64           `json:"revision,string"`      // Revision 轮换的并发校验版本。
+	ExpiresAt   *time.Time       `json:"expires_at,omitempty"` // ExpiresAt 到期时间，空表示无固定到期时间。
+	RevokedAt   *time.Time       `json:"revoked_at,omitempty"` // RevokedAt 撤销时间，非空时禁止轮换。
+	Permissions auth.Permissions `json:"permissions"`          // Permissions 动作和队列授权范围。
+}
+
+// ApplicationDetail 展示一个命名空间的队列和凭据，读取量有界。
+type ApplicationDetail struct {
+	Entry       ApplicationEntry   `json:"entry"`       // Entry 当前应用与环境。
+	Queues      []AccessQueue      `json:"queues"`      // Queues 最多 100 个队列。
+	Credentials []AccessCredential `json:"credentials"` // Credentials 最多 100 张凭据。
+	Truncated   bool               `json:"truncated"`   // Truncated 为真时不得把当前结果解释为完整清单。
+}
+
+// ApplicationInput 描述创建应用或轮换凭据的管理员意图。
+type ApplicationInput struct {
+	Kind             string   `json:"kind"`                     // Kind CREATE 或 ROTATE。
+	Application      string   `json:"application"`              // Application 新应用名称，仅 CREATE 使用。
+	Namespace        string   `json:"namespace"`                // Namespace 新命名空间名称，仅 CREATE 使用。
+	Environment      string   `json:"environment"`              // Environment 新环境名称，仅 CREATE 使用。
+	Queue            string   `json:"queue"`                    // Queue 初始队列名称，仅 CREATE 使用。
+	Capabilities     []string `json:"capabilities,omitempty"`   // Capabilities 显式选择的业务权限组，仅 CREATE 使用。
+	NamespaceID      core.ID  `json:"namespace_id,omitempty"`   // NamespaceID 轮换目标所属范围。
+	CredentialID     core.ID  `json:"credential_id,omitempty"`  // CredentialID 轮换目标凭据。
+	ExpectedRevision uint64   `json:"expected_revision,string"` // ExpectedRevision 轮换时读取到的版本。
+	ValidDays        int      `json:"valid_days"`               // ValidDays 新令牌有效天数，1–365。
+	Reason           string   `json:"reason"`                   // Reason 写入审计的变更原因。
+}
+
+// ApplicationOperation 是浏览器在提交前保存的固定操作；Token 不写入数据库。
+// 网络结果未知时重放同一份内容，禁止重新生成操作身份或秘密。
+type ApplicationOperation struct {
+	Input         ApplicationInput `json:"input"`              // Input 固定的管理员意图。
+	OperationID   core.ID          `json:"operation_id"`       // OperationID 稳定幂等身份。
+	ApplicationID core.ID          `json:"application_id"`     // ApplicationID 新建或已核验的应用标识。
+	NamespaceID   core.ID          `json:"namespace_id"`       // NamespaceID 固定命名空间标识。
+	QueueID       core.ID          `json:"queue_id,omitempty"` // QueueID 新建应用的初始队列。
+	CredentialID  core.ID          `json:"credential_id"`      // CredentialID 固定凭据身份。
+	Token         string           `json:"token"`              // Token 一次性交付的秘密，只留在调用方内存或私密下载文件。
+	ExpiresAt     time.Time        `json:"expires_at"`         // ExpiresAt 首次准备时冻结的绝对到期时间。
+}
+
+// ApplicationReceipt 是数据库持久化的脱敏回执。
+type ApplicationReceipt struct {
+	OperationID   core.ID `json:"operation_id"`    // OperationID 原操作身份。
+	ApplicationID core.ID `json:"application_id"`  // ApplicationID 应用标识。
+	NamespaceID   core.ID `json:"namespace_id"`    // NamespaceID 命名空间标识。
+	CredentialID  core.ID `json:"credential_id"`   // CredentialID 凭据标识。
+	Revision      uint64  `json:"revision,string"` // Revision 操作提交后的凭据版本。
+	Deduplicated  bool    `json:"deduplicated"`    // Deduplicated 命中原回执，不代表当前 Token 仍有效。
+}
+
+// Applications 只面向部署指定的单管理员浏览器会话，不接收业务 SDK 身份。
+type Applications interface {
+	ListApplications(context.Context, auth.Token, core.ID) (ApplicationPage, error)
+	GetApplication(context.Context, auth.Token, core.ID) (ApplicationDetail, error)
+	PrepareApplication(context.Context, auth.Token, ApplicationInput) (ApplicationOperation, error)
+	ApplyApplication(context.Context, auth.Token, ApplicationOperation) (ApplicationReceipt, error)
+}