45 lines
2.3 KiB
Go
45 lines
2.3 KiB
Go
package usecase
|
||
|
||
import (
|
||
"context"
|
||
|
||
"backend/pkg/permission/domain/entity"
|
||
)
|
||
|
||
// TokenUseCase 定義與 Token 相關的操作接口
|
||
//
|
||
//nolint:interfacebloat
|
||
type TokenUseCase interface {
|
||
// NewToken 創建新 Token，通常為 Access Token
|
||
NewToken(ctx context.Context, req entity.AuthorizationReq) (entity.TokenResp, error)
|
||
// RefreshToken 刷新目前的 Token，包括一次性 Token
|
||
RefreshToken(ctx context.Context, req entity.RefreshTokenReq) (entity.RefreshTokenResp, error)
|
||
// CancelToken 取消 Token，包括取消其關聯的 One-Time Token
|
||
CancelToken(ctx context.Context, req entity.CancelTokenReq) error
|
||
// ValidationToken 驗證 Token 是否有效
|
||
ValidationToken(ctx context.Context, req entity.ValidationTokenReq) (entity.ValidationTokenResp, error)
|
||
// CancelTokens 根據 UID 或 Token ID 取消所有相關 Token，通常在用戶登出時使用
|
||
CancelTokens(ctx context.Context, req entity.DoTokenByUIDReq) error
|
||
// CancelTokenByDeviceID 根據 Device ID 取消所有相關的 Token
|
||
CancelTokenByDeviceID(ctx context.Context, req entity.DoTokenByDeviceIDReq) error
|
||
// GetUserTokensByDeviceID 根據 Device ID 獲取所有 Token
|
||
GetUserTokensByDeviceID(ctx context.Context, req entity.DoTokenByDeviceIDReq) ([]*entity.TokenResp, error)
|
||
// GetUserTokensByUID 根據 UID 獲取所有 Token
|
||
GetUserTokensByUID(ctx context.Context, req entity.QueryTokenByUIDReq) ([]*entity.TokenResp, error)
|
||
// NewOneTimeToken 創建一次性 Token，例如 Refresh Token
|
||
NewOneTimeToken(ctx context.Context, req entity.CreateOneTimeTokenReq) (entity.CreateOneTimeTokenResp, error)
|
||
// CancelOneTimeToken 取消一次性 Token
|
||
CancelOneTimeToken(ctx context.Context, req entity.CancelOneTimeTokenReq) error
|
||
// ReadTokenBasicData 檢查Token 帶的資料
|
||
ReadTokenBasicData(ctx context.Context, token string) (map[string]string, error)
|
||
|
||
// Blacklist operations
|
||
|
||
// BlacklistToken 將 JWT token 加入黑名單 (立即撤銷)
|
||
BlacklistToken(ctx context.Context, token string, reason string) error
|
||
// IsTokenBlacklisted 檢查 JWT token 是否在黑名單中
|
||
IsTokenBlacklisted(ctx context.Context, jti string) (bool, error)
|
||
// BlacklistAllUserTokens 將用戶的所有 token 加入黑名單 (全設備登出)
|
||
BlacklistAllUserTokens(ctx context.Context, uid string, reason string) error
|
||
}
|