k2safe/orbit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: support permanent credentials and overlapping token rotation

Browse Source
This commit is contained in:
k2safe
2026-09-27 11:45:15 +08:00
parent 87aa710013
commit 385a618154
29 changed files with 718 additions and 161 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
internal/consoleauth/applications.go
View File

@@ -32,12 +32,13 @@ type AccessQueue struct {
// 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 动作和队列授权范围。
PreviousValidUntil *time.Time `json:"previous_valid_until,omitempty"` // PreviousValidUntil 上一代令牌实际截止，空表示无旧令牌。
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 展示一个命名空间的队列和凭据，读取量有界。
@@ -48,9 +49,9 @@ type ApplicationDetail struct {
Truncated bool `json:"truncated"` // Truncated 为真时不得把当前结果解释为完整清单。
}
// ApplicationInput 描述创建应用或轮换凭据的管理员意图。
// ApplicationInput 描述创建应用或变更凭据的管理员意图。
type ApplicationInput struct {
Kind string `json:"kind"` // Kind CREATE 或 ROTATE。
Kind string `json:"kind"` // Kind CREATE、ROTATE、SET_EXPIRY 或 FINALIZE。
Application string `json:"application"` // Application 新应用名称，仅 CREATE 使用。
Namespace string `json:"namespace"` // Namespace 新命名空间名称，仅 CREATE 使用。
Environment string `json:"environment"` // Environment 新环境名称，仅 CREATE 使用。
@@ -59,21 +60,24 @@ type ApplicationInput struct {
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。
ValidDays int `json:"valid_days"` // ValidDays 有效天数；0 为长期，1–365 为定期。
GraceDays int `json:"grace_days,omitempty"` // GraceDays ROTATE 的旧令牌过渡天数，0–30；0 显式立即失效。
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 首次准备时冻结的绝对到期时间。
Version int `json:"version,omitempty"` // Version v2 支持长期令牌与过渡；旧固定操作未设置时沿用 v1。
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,omitempty"` // Token 一次性交付的秘密，只留在调用方内存或私密下载文件。
ExpiresAt *time.Time `json:"expires_at,omitempty"` // ExpiresAt 固定到期时间，空表示长期或不适用。
PreviousValidUntil *time.Time `json:"previous_valid_until,omitempty"` // PreviousValidUntil ROTATE 固定过渡截止。
}
// ApplicationReceipt 是数据库持久化的脱敏回执。