67 lines
2.7 KiB
Go
67 lines
2.7 KiB
Go
// Package identity 定义注册、self.*、对话密码授权、停用与删除级联的接口。
|
|
package identity
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
|
|
"git.asio.asia/nixevol/NixMsg/internal/protocol"
|
|
)
|
|
|
|
// ErrNotImplemented 表示假实现未提供业务能力。
|
|
var ErrNotImplemented = errors.New("identity: not implemented")
|
|
|
|
// RegisterRequest 对应 POST /api/client/register 与后台开通的公共字段。
|
|
type RegisterRequest struct {
|
|
RegistrationCode string
|
|
ID string
|
|
LoginPassword string
|
|
Name string
|
|
TalkPassword string
|
|
Remark string
|
|
DefaultDelayMs int64
|
|
Source string // admin | self
|
|
RemoteIP string
|
|
}
|
|
|
|
// RegisterResult 是注册/开通结果。
|
|
type RegisterResult struct {
|
|
ID string
|
|
LoginPassword string // 仅当请求留空由服务器生成时非空
|
|
}
|
|
|
|
// SelfInfo 是 self.get 返回。
|
|
type SelfInfo struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
DefaultDelayMs int64 `json:"default_delay_ms"`
|
|
TalkPasswordSet bool `json:"talk_password_set"`
|
|
}
|
|
|
|
// Service 是身份子系统契约。
|
|
type Service interface {
|
|
// Register 处理自助注册或供管理开通复用（第 6.9 节）。
|
|
Register(ctx context.Context, req RegisterRequest) (RegisterResult, error)
|
|
|
|
SelfGet(ctx context.Context, endpointID string) (SelfInfo, error)
|
|
SelfUpdate(ctx context.Context, endpointID string, req *protocol.SelfUpdate) error
|
|
SelfSetTalkPassword(ctx context.Context, endpointID string, talkPassword string) error
|
|
// SelfChangeLoginPassword 校验旧密码后换新密码并签发新会话令牌；remoteIP 计入登录锁定。
|
|
SelfChangeLoginPassword(ctx context.Context, endpointID, oldPassword, newPassword, remoteIP string) (sessionToken string, err error)
|
|
SelfLogout(ctx context.Context, endpointID string) error
|
|
|
|
// UnlockTalk 校验并写入 password 类对话授权（第 6.6 节 unlock）；remoteIP 计入对话密码锁定。
|
|
UnlockTalk(ctx context.Context, senderID, targetID, talkPassword, remoteIP string) error
|
|
// HasTalkGrant 查询发送方对目标是否有有效授权（无对话密码或已有匹配版本授权）。
|
|
HasTalkGrant(ctx context.Context, senderID, targetID string) (bool, error)
|
|
// CheckTalkPasswordForJoin 加人时校验对话密码：已有单聊授权不能代替，必须当次带对。
|
|
CheckTalkPasswordForJoin(ctx context.Context, actorID, targetID, talkPassword, remoteIP string) error
|
|
|
|
// Disable 停用端并作废相关消息/令牌（第 7.6 节）。
|
|
Disable(ctx context.Context, endpointID string) error
|
|
// Enable 重新启用。
|
|
Enable(ctx context.Context, endpointID string) error
|
|
// Delete 删除端并做级联清理。
|
|
Delete(ctx context.Context, endpointID string) error
|
|
}
|