actor

type Actor ¶

type Actor interface {
	ID() string
	Type() Type
	DisplayName() string
}

Actor 表示请求发起者的最小调用源拓扑通用语：仅含 ID/Type/DisplayName 三件套。

协议特定字段（OAuth/OIDC：Email/Subject/ClientID/Realm/Roles/Scopes 与开放扩展袋 Attrs）不在该接口暴露；如业务需要，请由业务自定义 ctx 信道（如业务自家 IAM 包提供的 WithUserInfo / UserInfoFromContext）承载，servora 主仓不预设 OIDC ctx 信道。

func From(ctx context.Context) (Actor, bool)

func MustFrom(ctx context.Context) Actor

type AnonymousActor ¶

type AnonymousActor struct{}

AnonymousActor represents an unauthenticated request initiator.

func NewAnonymousActor() *AnonymousActor

func (a *AnonymousActor) DisplayName() string

func (a *AnonymousActor) ID() string

func (a *AnonymousActor) Type() Type

type ServiceActor ¶

type ServiceActor struct {
	// contains filtered or unexported fields
}

ServiceActor represents a service-to-service caller identity (machine principal). It is used when X-Principal-Type: service is injected by the gateway.

func NewServiceActor(id, displayName string) *ServiceActor

func (s *ServiceActor) DisplayName() string

func (s *ServiceActor) ID() string

func (s *ServiceActor) Type() Type

type SystemActor ¶

type SystemActor struct {
	// contains filtered or unexported fields
}

SystemActor represents a non-user, non-service framework / platform principal (e.g. cron jobs, internal background processes).

func NewSystemActor(id, serviceName string) *SystemActor

func (s *SystemActor) DisplayName() string

func (s *SystemActor) ID() string

func (s *SystemActor) Type() Type

type Type ¶

type Type string

Type identifies the kind of request initiator (generic identity, not domain model).

const (
	TypeUser      Type = "user"
	TypeSystem    Type = "system"
	TypeAnonymous Type = "anonymous"
	TypeService   Type = "service"
)

type UserActor ¶

type UserActor struct {
	// contains filtered or unexported fields
}

UserActor is the concrete actor for an authenticated user.

func NewUserActor(id, displayName string) *UserActor

func (u *UserActor) DisplayName() string

func (u *UserActor) ID() string

func (u *UserActor) Type() Type