v1

package
v0.12.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 17, 2026 License: AGPL-3.0 Imports: 12 Imported by: 0

Documentation

Overview

Package v1 defines the gRPC AdminService for CLI-to-CP communication. This is a separate proto package from the agent v1 package, enforcing the trust boundary between admin operations (CLI) and agent operations (clawkerd).

Index

Constants

View Source
const (
	AdminService_FirewallInit_FullMethodName            = "/clawker.admin.v1.AdminService/FirewallInit"
	AdminService_FirewallRemove_FullMethodName          = "/clawker.admin.v1.AdminService/FirewallRemove"
	AdminService_FirewallEnable_FullMethodName          = "/clawker.admin.v1.AdminService/FirewallEnable"
	AdminService_FirewallDisable_FullMethodName         = "/clawker.admin.v1.AdminService/FirewallDisable"
	AdminService_FirewallBypass_FullMethodName          = "/clawker.admin.v1.AdminService/FirewallBypass"
	AdminService_FirewallAddRules_FullMethodName        = "/clawker.admin.v1.AdminService/FirewallAddRules"
	AdminService_FirewallRemoveRule_FullMethodName      = "/clawker.admin.v1.AdminService/FirewallRemoveRule"
	AdminService_FirewallListRules_FullMethodName       = "/clawker.admin.v1.AdminService/FirewallListRules"
	AdminService_FirewallReload_FullMethodName          = "/clawker.admin.v1.AdminService/FirewallReload"
	AdminService_FirewallStatus_FullMethodName          = "/clawker.admin.v1.AdminService/FirewallStatus"
	AdminService_FirewallRotateCA_FullMethodName        = "/clawker.admin.v1.AdminService/FirewallRotateCA"
	AdminService_FirewallSyncRoutes_FullMethodName      = "/clawker.admin.v1.AdminService/FirewallSyncRoutes"
	AdminService_FirewallResolveHostname_FullMethodName = "/clawker.admin.v1.AdminService/FirewallResolveHostname"
	AdminService_ListAgents_FullMethodName              = "/clawker.admin.v1.AdminService/ListAgents"
	AdminService_GetSystemTime_FullMethodName           = "/clawker.admin.v1.AdminService/GetSystemTime"
)
View Source
const ServiceName = "clawker.admin.v1.AdminService"

ServiceName is the fully-qualified gRPC service name for AdminService.

Variables

View Source
var (
	AddRuleStatus_name = map[int32]string{
		0: "ADD_RULE_STATUS_UNSPECIFIED",
		1: "ADD_RULE_STATUS_ADDED",
		2: "ADD_RULE_STATUS_MODIFIED",
		3: "ADD_RULE_STATUS_UNCHANGED",
	}
	AddRuleStatus_value = map[string]int32{
		"ADD_RULE_STATUS_UNSPECIFIED": 0,
		"ADD_RULE_STATUS_ADDED":       1,
		"ADD_RULE_STATUS_MODIFIED":    2,
		"ADD_RULE_STATUS_UNCHANGED":   3,
	}
)

Enum value maps for AddRuleStatus.

View Source
var (
	RemoveRuleStatus_name = map[int32]string{
		0: "REMOVE_RULE_STATUS_UNSPECIFIED",
		1: "REMOVE_RULE_STATUS_REMOVED",
		2: "REMOVE_RULE_STATUS_PATH_REMOVED",
		3: "REMOVE_RULE_STATUS_NOT_FOUND",
	}
	RemoveRuleStatus_value = map[string]int32{
		"REMOVE_RULE_STATUS_UNSPECIFIED":  0,
		"REMOVE_RULE_STATUS_REMOVED":      1,
		"REMOVE_RULE_STATUS_PATH_REMOVED": 2,
		"REMOVE_RULE_STATUS_NOT_FOUND":    3,
	}
)

Enum value maps for RemoveRuleStatus.

View Source
var AdminService_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "clawker.admin.v1.AdminService",
	HandlerType: (*AdminServiceServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "FirewallInit",
			Handler:    _AdminService_FirewallInit_Handler,
		},
		{
			MethodName: "FirewallRemove",
			Handler:    _AdminService_FirewallRemove_Handler,
		},
		{
			MethodName: "FirewallEnable",
			Handler:    _AdminService_FirewallEnable_Handler,
		},
		{
			MethodName: "FirewallDisable",
			Handler:    _AdminService_FirewallDisable_Handler,
		},
		{
			MethodName: "FirewallBypass",
			Handler:    _AdminService_FirewallBypass_Handler,
		},
		{
			MethodName: "FirewallAddRules",
			Handler:    _AdminService_FirewallAddRules_Handler,
		},
		{
			MethodName: "FirewallRemoveRule",
			Handler:    _AdminService_FirewallRemoveRule_Handler,
		},
		{
			MethodName: "FirewallListRules",
			Handler:    _AdminService_FirewallListRules_Handler,
		},
		{
			MethodName: "FirewallReload",
			Handler:    _AdminService_FirewallReload_Handler,
		},
		{
			MethodName: "FirewallStatus",
			Handler:    _AdminService_FirewallStatus_Handler,
		},
		{
			MethodName: "FirewallRotateCA",
			Handler:    _AdminService_FirewallRotateCA_Handler,
		},
		{
			MethodName: "FirewallSyncRoutes",
			Handler:    _AdminService_FirewallSyncRoutes_Handler,
		},
		{
			MethodName: "FirewallResolveHostname",
			Handler:    _AdminService_FirewallResolveHostname_Handler,
		},
		{
			MethodName: "ListAgents",
			Handler:    _AdminService_ListAgents_Handler,
		},
		{
			MethodName: "GetSystemTime",
			Handler:    _AdminService_GetSystemTime_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "admin/v1/admin.proto",
}

AdminService_ServiceDesc is the grpc.ServiceDesc for AdminService service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

View Source
var File_admin_v1_admin_proto protoreflect.FileDescriptor

Functions

func AdminMethodScopes

func AdminMethodScopes() map[string]AdminScope

AdminMethodScopes returns the method→scope map for every RPC on AdminService. Every method is enforced at the uniform admin scope (INV-B2-009) EXCEPT GetSystemTime, which is mapped to the public scope (consts.ScopePublic) — no bearer token, served on mTLS alone; see the AuthInterceptor public branch. Future cross-domain methods follow the uniform-admin policy unless they have an equally fundamental bootstrap reason to be public.

Kept beside the generated bindings so proto additions fail closed: a new RPC without a scope entry is caught by TestAdminMethodScopes_CoversAllRPCs, which reflects over AdminService_ServiceDesc.

func EffectivePathDefault added in v0.10.0

func EffectivePathDefault(r config.EgressRule) string

EffectivePathDefault resolves the catch-all action for HTTP paths under a rule that don't match any explicit PathRule entry. Explicit PathDefault always wins; otherwise the action is inferred from the path_rules composition so a user who runs `firewall add foo.com --path /x --action deny` gets denylist semantics (allow all paths except /x) without having to know about the path_default knob:

  • r.PathDefault non-empty → r.PathDefault (explicit override)
  • any PathRule with Action="allow" → "deny" (allowlist mode)
  • all PathRules have Action="deny" → "allow" (denylist mode)
  • no PathRules → "allow" (vacuous; callers that render path tables gate on len(PathRules)>0 themselves)

It is config-typed because the firewall enforcement path (Envoy generation) holds config.EgressRule; proto-typed callers convert via EgressRuleFromProto.

func EgressRuleFromProto added in v0.10.0

func EgressRuleFromProto(r *EgressRule) config.EgressRule

EgressRuleFromProto copies one *EgressRule → config.EgressRule.

func EgressRulesFromProto added in v0.10.0

func EgressRulesFromProto(in []*EgressRule) []config.EgressRule

EgressRulesFromProto copies []*EgressRule → []config.EgressRule, keeping handlers free of gRPC types when calling into the rules store.

func IsHTTPFamilyProto added in v0.11.0

func IsHTTPFamilyProto(proto string) bool

IsHTTPFamilyProto reports whether a proto token carries an L7 HTTP request line the firewall can inspect (so path rules and method gates are enforceable). A closed allow-list: every non-HTTP proto (ftp, smtp, postgres, the opaque tcp/ssh/udp, an unknown token, ...) falls through to false, so the set never needs maintenance as protos are added. Lives beside EffectivePathDefault as shared rule semantics so the CLI (input gating) and the firewall generator (enforcement + warnings) agree on one definition. Operates on real proto tokens only — the legacy `tls` alias is rewritten to `https` before this is reached (NormalizeRule server-side; addRun for CLI input).

func RegisterAdminServiceServer

func RegisterAdminServiceServer(s grpc.ServiceRegistrar, srv AdminServiceServer)

Types

type AddRuleStatus added in v0.9.5

type AddRuleStatus int32

AddRuleStatus is the per-rule outcome of a FirewallAddRules call. statuses[i] on the result message corresponds to rules[i] on the request, preserving input order through normalization.

const (
	AddRuleStatus_ADD_RULE_STATUS_UNSPECIFIED AddRuleStatus = 0
	// ADDED: a new RuleKey was appended to the store.
	AddRuleStatus_ADD_RULE_STATUS_ADDED AddRuleStatus = 1
	// MODIFIED: an existing RuleKey was mutated via MergeRule (Action /
	// PathDefault overwrite; PathRules union by Path).
	AddRuleStatus_ADD_RULE_STATUS_MODIFIED AddRuleStatus = 2
	// UNCHANGED: incoming rule was reflect.DeepEqual to the existing
	// entry after merge; store write was suppressed.
	AddRuleStatus_ADD_RULE_STATUS_UNCHANGED AddRuleStatus = 3
)

func (AddRuleStatus) Descriptor added in v0.9.5

func (AddRuleStatus) Enum added in v0.9.5

func (x AddRuleStatus) Enum() *AddRuleStatus

func (AddRuleStatus) EnumDescriptor deprecated added in v0.9.5

func (AddRuleStatus) EnumDescriptor() ([]byte, []int)

Deprecated: Use AddRuleStatus.Descriptor instead.

func (AddRuleStatus) Number added in v0.9.5

func (AddRuleStatus) String added in v0.9.5

func (x AddRuleStatus) String() string

func (AddRuleStatus) Type added in v0.9.5

type AdminScope added in v0.10.2

type AdminScope string

AdminScope is the OAuth2 scope type for AdminService RPCs. It is a distinct named type (NOT an alias of agent's or any other service's scope type) so the compiler rejects a cross-service scope: an agent scope cannot be placed in AdminMethodScopes, and the admin Hydra client cannot be granted a non-admin scope. The wire value is a plain string — convert with string() at OAuth2/Hydra boundaries.

const ScopeAdmin AdminScope = "admin"

ScopeAdmin is the uniform scope every AdminService RPC requires (INV-B2-009), with the lone exception of the public GetSystemTime.

type AdminServiceClient

type AdminServiceClient interface {
	// FirewallInit brings the firewall stack (Envoy + CoreDNS) up. BPF
	// programs are loaded once at CP startup; this RPC is the idempotent
	// stack-up signal from the CLI. Global — no container_id.
	FirewallInit(ctx context.Context, in *FirewallInitRequest, opts ...grpc.CallOption) (*FirewallInitResult, error)
	// FirewallRemove is global teardown — stops Envoy + CoreDNS, detaches
	// all BPF programs, and flushes all eBPF state plus pending timers.
	FirewallRemove(ctx context.Context, in *FirewallRemoveRequest, opts ...grpc.CallOption) (*FirewallRemoveResult, error)
	// FirewallEnable enrolls a container into the global container_map
	// routing. Idempotent. The CP resolves the container's cgroup path
	// internally via Docker API with drift guard (INV-B2-016) — callers
	// send only container_id.
	FirewallEnable(ctx context.Context, in *FirewallEnableRequest, opts ...grpc.CallOption) (*FirewallEnableResult, error)
	// FirewallDisable removes a container from container_map. BPF links
	// remain attached so re-enable is cheap. BPF fast path exits to bypass
	// on lookup miss.
	FirewallDisable(ctx context.Context, in *FirewallDisableRequest, opts ...grpc.CallOption) (*FirewallDisableResult, error)
	// FirewallBypass = timed Disable + CP-side dead-man timer that calls
	// Enable on expiry. Drift guard inherited from the Enable path.
	FirewallBypass(ctx context.Context, in *FirewallBypassRequest, opts ...grpc.CallOption) (*FirewallBypassResult, error)
	// FirewallAddRules adds egress rules to the store and hot-reloads the
	// stack. Synchronous: returns after the stack is healthy again.
	FirewallAddRules(ctx context.Context, in *FirewallAddRulesRequest, opts ...grpc.CallOption) (*FirewallAddRulesResult, error)
	// FirewallRemoveRule removes a single egress rule keyed by
	// (dst, proto, port), or a single PathRule entry when `path` is set,
	// then hot-reloads the stack. Outcome travels on
	// FirewallRemoveRuleResult.status — REMOVED / PATH_REMOVED / NOT_FOUND.
	// NOT_FOUND is a typed response status, NOT a gRPC codes.NotFound
	// error: typos, wrong-proto/port, and missing-path all collapse to the
	// same outcome on the wire so the CLI never branches between error
	// and response for the same case. Genuine store-I/O / validation
	// failures still surface as gRPC errors.
	FirewallRemoveRule(ctx context.Context, in *FirewallRemoveRuleRequest, opts ...grpc.CallOption) (*FirewallRemoveRuleResult, error)
	// FirewallListRules returns the current normalized/deduplicated rule
	// set from the store. Read-only.
	FirewallListRules(ctx context.Context, in *FirewallListRulesRequest, opts ...grpc.CallOption) (*FirewallListRulesResult, error)
	// FirewallReload regenerates configs and restarts Envoy + CoreDNS from
	// the current rules store state without mutating rules.
	FirewallReload(ctx context.Context, in *FirewallReloadRequest, opts ...grpc.CallOption) (*FirewallReloadResult, error)
	// FirewallStatus is the firewall-domain health snapshot (stack running,
	// Envoy/CoreDNS health, rule count, network topology).
	FirewallStatus(ctx context.Context, in *FirewallStatusRequest, opts ...grpc.CallOption) (*FirewallStatusResult, error)
	// FirewallRotateCA regenerates the MITM CA + per-domain certs. Restarts
	// Envoy so the new chain is picked up.
	FirewallRotateCA(ctx context.Context, in *FirewallRotateCARequest, opts ...grpc.CallOption) (*FirewallRotateCAResult, error)
	// FirewallSyncRoutes atomically replaces the global route_map.
	FirewallSyncRoutes(ctx context.Context, in *FirewallSyncRoutesRequest, opts ...grpc.CallOption) (*FirewallSyncRoutesResult, error)
	// FirewallResolveHostname performs a DNS lookup from inside the CP's
	// network namespace — used to resolve host.docker.internal during
	// per-container enroll.
	FirewallResolveHostname(ctx context.Context, in *FirewallResolveHostnameRequest, opts ...grpc.CallOption) (*FirewallResolveHostnameResult, error)
	// ListAgents returns a snapshot of every agent currently registered
	// with the control plane. Used by `clawker controlplane agents` and
	// diagnostic tooling. Read-only; uniform admin scope.
	ListAgents(ctx context.Context, in *ListAgentsRequest, opts ...grpc.CallOption) (*ListAgentsResult, error)
	// GetSystemTime returns the control plane's current wall-clock time.
	// This RPC is intentionally PUBLIC (the public scope in AdminMethodScopes —
	// no bearer token required), because it bootstraps the very auth flow.
	// The bootstrap assertion is minted in the HOST clock with no iat
	// correction — the host clock is the source of truth and the CP container's
	// clock is always forced toward it (Docker Desktop's LinuxKit VM tracks the
	// host). fosite (Hydra's validator) checks `iat` with zero leeway and
	// exposes no server-side knob, so a host-clock `iat` presented while the CP
	// container's clock is momentarily behind the host (common right after the
	// host sleeps, before the VM clock re-syncs) would be rejected with HTTP 500
	// "Token used before issued". clawker-cp and Hydra share the container, so
	// this clock is exactly the one fosite validates against. Because the CP
	// clock always converges back to the host, the fix is to WAIT: the host-side
	// CP-readiness gate on the container START path polls this RPC and blocks the
	// start until the CP clock has caught up to the host, before clawkerd ever
	// exchanges the baked assertion. mTLS still applies at the listener — the
	// CLI's client cert is long-lived (1y), so the handshake survives a lagging
	// CP clock.
	GetSystemTime(ctx context.Context, in *GetSystemTimeRequest, opts ...grpc.CallOption) (*GetSystemTimeResult, error)
}

AdminServiceClient is the client API for AdminService service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

AdminService is the gRPC surface the clawker CLI calls on the control plane. The CP owns privileged kernel state (BPF programs + pinned maps) and the firewall stack (Envoy + CoreDNS) and handles per-container firewall lifecycle.

Transport: mTLS over TCP (AdminPort, default 7443, configurable via Settings). The CLI presents a client certificate signed by the CLI CA. Authorization: OAuth2 access tokens with the uniform "admin" scope, validated via Hydra token introspection (RFC 7662).

Method naming follows the `<Domain><Action>[<Object>]` convention. Firewall is the only domain today; future domains (Monitor, Hostproxy, Clawkerd, ...) layer additional handlers onto the same AdminService so the CLI sees one unified surface per CP. Every method is registered for "admin" scope enforcement (INV-B2-009).

Response messages are named `Firewall*Result` rather than `Firewall*Response` to match Go's `(Result, error)` convention — the handler returns typed Result structs from queued closures and maps those into the wire messages below.

type AdminServiceServer

type AdminServiceServer interface {
	// FirewallInit brings the firewall stack (Envoy + CoreDNS) up. BPF
	// programs are loaded once at CP startup; this RPC is the idempotent
	// stack-up signal from the CLI. Global — no container_id.
	FirewallInit(context.Context, *FirewallInitRequest) (*FirewallInitResult, error)
	// FirewallRemove is global teardown — stops Envoy + CoreDNS, detaches
	// all BPF programs, and flushes all eBPF state plus pending timers.
	FirewallRemove(context.Context, *FirewallRemoveRequest) (*FirewallRemoveResult, error)
	// FirewallEnable enrolls a container into the global container_map
	// routing. Idempotent. The CP resolves the container's cgroup path
	// internally via Docker API with drift guard (INV-B2-016) — callers
	// send only container_id.
	FirewallEnable(context.Context, *FirewallEnableRequest) (*FirewallEnableResult, error)
	// FirewallDisable removes a container from container_map. BPF links
	// remain attached so re-enable is cheap. BPF fast path exits to bypass
	// on lookup miss.
	FirewallDisable(context.Context, *FirewallDisableRequest) (*FirewallDisableResult, error)
	// FirewallBypass = timed Disable + CP-side dead-man timer that calls
	// Enable on expiry. Drift guard inherited from the Enable path.
	FirewallBypass(context.Context, *FirewallBypassRequest) (*FirewallBypassResult, error)
	// FirewallAddRules adds egress rules to the store and hot-reloads the
	// stack. Synchronous: returns after the stack is healthy again.
	FirewallAddRules(context.Context, *FirewallAddRulesRequest) (*FirewallAddRulesResult, error)
	// FirewallRemoveRule removes a single egress rule keyed by
	// (dst, proto, port), or a single PathRule entry when `path` is set,
	// then hot-reloads the stack. Outcome travels on
	// FirewallRemoveRuleResult.status — REMOVED / PATH_REMOVED / NOT_FOUND.
	// NOT_FOUND is a typed response status, NOT a gRPC codes.NotFound
	// error: typos, wrong-proto/port, and missing-path all collapse to the
	// same outcome on the wire so the CLI never branches between error
	// and response for the same case. Genuine store-I/O / validation
	// failures still surface as gRPC errors.
	FirewallRemoveRule(context.Context, *FirewallRemoveRuleRequest) (*FirewallRemoveRuleResult, error)
	// FirewallListRules returns the current normalized/deduplicated rule
	// set from the store. Read-only.
	FirewallListRules(context.Context, *FirewallListRulesRequest) (*FirewallListRulesResult, error)
	// FirewallReload regenerates configs and restarts Envoy + CoreDNS from
	// the current rules store state without mutating rules.
	FirewallReload(context.Context, *FirewallReloadRequest) (*FirewallReloadResult, error)
	// FirewallStatus is the firewall-domain health snapshot (stack running,
	// Envoy/CoreDNS health, rule count, network topology).
	FirewallStatus(context.Context, *FirewallStatusRequest) (*FirewallStatusResult, error)
	// FirewallRotateCA regenerates the MITM CA + per-domain certs. Restarts
	// Envoy so the new chain is picked up.
	FirewallRotateCA(context.Context, *FirewallRotateCARequest) (*FirewallRotateCAResult, error)
	// FirewallSyncRoutes atomically replaces the global route_map.
	FirewallSyncRoutes(context.Context, *FirewallSyncRoutesRequest) (*FirewallSyncRoutesResult, error)
	// FirewallResolveHostname performs a DNS lookup from inside the CP's
	// network namespace — used to resolve host.docker.internal during
	// per-container enroll.
	FirewallResolveHostname(context.Context, *FirewallResolveHostnameRequest) (*FirewallResolveHostnameResult, error)
	// ListAgents returns a snapshot of every agent currently registered
	// with the control plane. Used by `clawker controlplane agents` and
	// diagnostic tooling. Read-only; uniform admin scope.
	ListAgents(context.Context, *ListAgentsRequest) (*ListAgentsResult, error)
	// GetSystemTime returns the control plane's current wall-clock time.
	// This RPC is intentionally PUBLIC (the public scope in AdminMethodScopes —
	// no bearer token required), because it bootstraps the very auth flow.
	// The bootstrap assertion is minted in the HOST clock with no iat
	// correction — the host clock is the source of truth and the CP container's
	// clock is always forced toward it (Docker Desktop's LinuxKit VM tracks the
	// host). fosite (Hydra's validator) checks `iat` with zero leeway and
	// exposes no server-side knob, so a host-clock `iat` presented while the CP
	// container's clock is momentarily behind the host (common right after the
	// host sleeps, before the VM clock re-syncs) would be rejected with HTTP 500
	// "Token used before issued". clawker-cp and Hydra share the container, so
	// this clock is exactly the one fosite validates against. Because the CP
	// clock always converges back to the host, the fix is to WAIT: the host-side
	// CP-readiness gate on the container START path polls this RPC and blocks the
	// start until the CP clock has caught up to the host, before clawkerd ever
	// exchanges the baked assertion. mTLS still applies at the listener — the
	// CLI's client cert is long-lived (1y), so the handshake survives a lagging
	// CP clock.
	GetSystemTime(context.Context, *GetSystemTimeRequest) (*GetSystemTimeResult, error)
	// contains filtered or unexported methods
}

AdminServiceServer is the server API for AdminService service. All implementations must embed UnimplementedAdminServiceServer for forward compatibility.

AdminService is the gRPC surface the clawker CLI calls on the control plane. The CP owns privileged kernel state (BPF programs + pinned maps) and the firewall stack (Envoy + CoreDNS) and handles per-container firewall lifecycle.

Transport: mTLS over TCP (AdminPort, default 7443, configurable via Settings). The CLI presents a client certificate signed by the CLI CA. Authorization: OAuth2 access tokens with the uniform "admin" scope, validated via Hydra token introspection (RFC 7662).

Method naming follows the `<Domain><Action>[<Object>]` convention. Firewall is the only domain today; future domains (Monitor, Hostproxy, Clawkerd, ...) layer additional handlers onto the same AdminService so the CLI sees one unified surface per CP. Every method is registered for "admin" scope enforcement (INV-B2-009).

Response messages are named `Firewall*Result` rather than `Firewall*Response` to match Go's `(Result, error)` convention — the handler returns typed Result structs from queued closures and maps those into the wire messages below.

type Agent

type Agent struct {

	// agent_name is the short agent name as the user types it on the CLI
	// (e.g. "dev"). The canonical "clawker.project.agent" form is composed
	// CP-side from (NamePrefix, project, agent_name) — kept off the wire to
	// avoid duplication and parsing.
	AgentName string `protobuf:"bytes,1,opt,name=agent_name,json=agentName,proto3" json:"agent_name,omitempty"`
	// container_id is the long Docker container ID the agent runs in.
	ContainerId string `protobuf:"bytes,2,opt,name=container_id,json=containerId,proto3" json:"container_id,omitempty"`
	// cert_thumbprint is the lowercase-hex SHA-256 over the agent's mTLS
	// cert DER — the channel-bound identity key.
	CertThumbprint string `protobuf:"bytes,3,opt,name=cert_thumbprint,json=certThumbprint,proto3" json:"cert_thumbprint,omitempty"`
	// registered_at_unix is the wall-clock timestamp at AgentService.Connect.
	RegisteredAtUnix int64 `protobuf:"varint,4,opt,name=registered_at_unix,json=registeredAtUnix,proto3" json:"registered_at_unix,omitempty"`
	// last_seen_unix is updated on every successful per-agent RPC. Equal
	// to registered_at_unix for B4 because Connect is the only per-agent
	// RPC.
	LastSeenUnix int64 `protobuf:"varint,5,opt,name=last_seen_unix,json=lastSeenUnix,proto3" json:"last_seen_unix,omitempty"`
	// project is the clawker project slug the agent registered under (empty
	// for 2-segment naming). Composite with agent_name when callers need a
	// unique key across projects.
	Project string `protobuf:"bytes,6,opt,name=project,proto3" json:"project,omitempty"`
	// contains filtered or unexported fields
}

func (*Agent) Descriptor deprecated

func (*Agent) Descriptor() ([]byte, []int)

Deprecated: Use Agent.ProtoReflect.Descriptor instead.

func (*Agent) GetAgentName

func (x *Agent) GetAgentName() string

func (*Agent) GetCertThumbprint

func (x *Agent) GetCertThumbprint() string

func (*Agent) GetContainerId

func (x *Agent) GetContainerId() string

func (*Agent) GetLastSeenUnix

func (x *Agent) GetLastSeenUnix() int64

func (*Agent) GetProject

func (x *Agent) GetProject() string

func (*Agent) GetRegisteredAtUnix

func (x *Agent) GetRegisteredAtUnix() int64

func (*Agent) ProtoMessage

func (*Agent) ProtoMessage()

func (*Agent) ProtoReflect

func (x *Agent) ProtoReflect() protoreflect.Message

func (*Agent) Reset

func (x *Agent) Reset()

func (*Agent) String

func (x *Agent) String() string

type EgressRule

type EgressRule struct {
	Dst   string `protobuf:"bytes,1,opt,name=dst,proto3" json:"dst,omitempty"`
	Proto string `protobuf:"bytes,2,opt,name=proto,proto3" json:"proto,omitempty"` // "tls" | "tcp" | "http" | "ssh" | "ip" | "cidr"
	// Dynamic port spec mirroring config.EgressRule.Port: a single port ("443")
	// or an inclusive range ("9000-9100", lo-hi). Empty = protocol default.
	Port        string      `protobuf:"bytes,3,opt,name=port,proto3" json:"port,omitempty"`
	Action      string      `protobuf:"bytes,4,opt,name=action,proto3" json:"action,omitempty"` // "allow" | "deny"
	PathRules   []*PathRule `protobuf:"bytes,5,rep,name=path_rules,json=pathRules,proto3" json:"path_rules,omitempty"`
	PathDefault string      `protobuf:"bytes,6,opt,name=path_default,json=pathDefault,proto3" json:"path_default,omitempty"`
	// contains filtered or unexported fields
}

EgressRule is one egress firewall rule (mirrors config.EgressRule).

func EgressRuleToProto added in v0.10.0

func EgressRuleToProto(r config.EgressRule) *EgressRule

EgressRuleToProto copies one config.EgressRule → *EgressRule. The wire and config representations track identical field sets; these mappers live beside the generated bindings so the gRPC types stay confined to the transport edge and both server and CLI share one conversion instead of each reaching into firewall internals for it.

func EgressRulesToProto added in v0.10.0

func EgressRulesToProto(in []config.EgressRule) []*EgressRule

EgressRulesToProto copies []config.EgressRule → []*EgressRule.

func (*EgressRule) Descriptor deprecated

func (*EgressRule) Descriptor() ([]byte, []int)

Deprecated: Use EgressRule.ProtoReflect.Descriptor instead.

func (*EgressRule) GetAction

func (x *EgressRule) GetAction() string

func (*EgressRule) GetDst

func (x *EgressRule) GetDst() string

func (*EgressRule) GetPathDefault

func (x *EgressRule) GetPathDefault() string

func (*EgressRule) GetPathRules

func (x *EgressRule) GetPathRules() []*PathRule

func (*EgressRule) GetPort

func (x *EgressRule) GetPort() string

func (*EgressRule) GetProto

func (x *EgressRule) GetProto() string

func (*EgressRule) ProtoMessage

func (*EgressRule) ProtoMessage()

func (*EgressRule) ProtoReflect

func (x *EgressRule) ProtoReflect() protoreflect.Message

func (*EgressRule) Reset

func (x *EgressRule) Reset()

func (*EgressRule) String

func (x *EgressRule) String() string

type FirewallAddRulesRequest

type FirewallAddRulesRequest struct {
	Rules []*EgressRule `protobuf:"bytes,1,rep,name=rules,proto3" json:"rules,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallAddRulesRequest) Descriptor deprecated

func (*FirewallAddRulesRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallAddRulesRequest.ProtoReflect.Descriptor instead.

func (*FirewallAddRulesRequest) GetRules

func (x *FirewallAddRulesRequest) GetRules() []*EgressRule

func (*FirewallAddRulesRequest) ProtoMessage

func (*FirewallAddRulesRequest) ProtoMessage()

func (*FirewallAddRulesRequest) ProtoReflect

func (x *FirewallAddRulesRequest) ProtoReflect() protoreflect.Message

func (*FirewallAddRulesRequest) Reset

func (x *FirewallAddRulesRequest) Reset()

func (*FirewallAddRulesRequest) String

func (x *FirewallAddRulesRequest) String() string

type FirewallAddRulesResult

type FirewallAddRulesResult struct {

	// statuses[i] is the outcome for request rules[i], in input order.
	Statuses []AddRuleStatus `protobuf:"varint,1,rep,packed,name=statuses,proto3,enum=clawker.admin.v1.AddRuleStatus" json:"statuses,omitempty"`
	// stack_restarted is true when the live stack was reloaded; false when
	// the stack was down at queue-time and only the on-disk rule change
	// applied. In both cases err==nil — the rule is durable.
	StackRestarted bool `protobuf:"varint,2,opt,name=stack_restarted,json=stackRestarted,proto3" json:"stack_restarted,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallAddRulesResult) Descriptor deprecated

func (*FirewallAddRulesResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallAddRulesResult.ProtoReflect.Descriptor instead.

func (*FirewallAddRulesResult) GetStackRestarted

func (x *FirewallAddRulesResult) GetStackRestarted() bool

func (*FirewallAddRulesResult) GetStatuses added in v0.9.5

func (x *FirewallAddRulesResult) GetStatuses() []AddRuleStatus

func (*FirewallAddRulesResult) ProtoMessage

func (*FirewallAddRulesResult) ProtoMessage()

func (*FirewallAddRulesResult) ProtoReflect

func (x *FirewallAddRulesResult) ProtoReflect() protoreflect.Message

func (*FirewallAddRulesResult) Reset

func (x *FirewallAddRulesResult) Reset()

func (*FirewallAddRulesResult) String

func (x *FirewallAddRulesResult) String() string

type FirewallBypassRequest

type FirewallBypassRequest struct {
	ContainerId    string `protobuf:"bytes,1,opt,name=container_id,json=containerId,proto3" json:"container_id,omitempty"`
	TimeoutSeconds uint32 `protobuf:"varint,2,opt,name=timeout_seconds,json=timeoutSeconds,proto3" json:"timeout_seconds,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallBypassRequest) Descriptor deprecated

func (*FirewallBypassRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallBypassRequest.ProtoReflect.Descriptor instead.

func (*FirewallBypassRequest) GetContainerId

func (x *FirewallBypassRequest) GetContainerId() string

func (*FirewallBypassRequest) GetTimeoutSeconds

func (x *FirewallBypassRequest) GetTimeoutSeconds() uint32

func (*FirewallBypassRequest) ProtoMessage

func (*FirewallBypassRequest) ProtoMessage()

func (*FirewallBypassRequest) ProtoReflect

func (x *FirewallBypassRequest) ProtoReflect() protoreflect.Message

func (*FirewallBypassRequest) Reset

func (x *FirewallBypassRequest) Reset()

func (*FirewallBypassRequest) String

func (x *FirewallBypassRequest) String() string

type FirewallBypassResult

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

func (*FirewallBypassResult) Descriptor deprecated

func (*FirewallBypassResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallBypassResult.ProtoReflect.Descriptor instead.

func (*FirewallBypassResult) ProtoMessage

func (*FirewallBypassResult) ProtoMessage()

func (*FirewallBypassResult) ProtoReflect

func (x *FirewallBypassResult) ProtoReflect() protoreflect.Message

func (*FirewallBypassResult) Reset

func (x *FirewallBypassResult) Reset()

func (*FirewallBypassResult) String

func (x *FirewallBypassResult) String() string

type FirewallDisableRequest

type FirewallDisableRequest struct {
	ContainerId string `protobuf:"bytes,1,opt,name=container_id,json=containerId,proto3" json:"container_id,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallDisableRequest) Descriptor deprecated

func (*FirewallDisableRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallDisableRequest.ProtoReflect.Descriptor instead.

func (*FirewallDisableRequest) GetContainerId

func (x *FirewallDisableRequest) GetContainerId() string

func (*FirewallDisableRequest) ProtoMessage

func (*FirewallDisableRequest) ProtoMessage()

func (*FirewallDisableRequest) ProtoReflect

func (x *FirewallDisableRequest) ProtoReflect() protoreflect.Message

func (*FirewallDisableRequest) Reset

func (x *FirewallDisableRequest) Reset()

func (*FirewallDisableRequest) String

func (x *FirewallDisableRequest) String() string

type FirewallDisableResult

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

func (*FirewallDisableResult) Descriptor deprecated

func (*FirewallDisableResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallDisableResult.ProtoReflect.Descriptor instead.

func (*FirewallDisableResult) ProtoMessage

func (*FirewallDisableResult) ProtoMessage()

func (*FirewallDisableResult) ProtoReflect

func (x *FirewallDisableResult) ProtoReflect() protoreflect.Message

func (*FirewallDisableResult) Reset

func (x *FirewallDisableResult) Reset()

func (*FirewallDisableResult) String

func (x *FirewallDisableResult) String() string

type FirewallEnableRequest

type FirewallEnableRequest struct {
	ContainerId string `protobuf:"bytes,1,opt,name=container_id,json=containerId,proto3" json:"container_id,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallEnableRequest) Descriptor deprecated

func (*FirewallEnableRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallEnableRequest.ProtoReflect.Descriptor instead.

func (*FirewallEnableRequest) GetContainerId

func (x *FirewallEnableRequest) GetContainerId() string

func (*FirewallEnableRequest) ProtoMessage

func (*FirewallEnableRequest) ProtoMessage()

func (*FirewallEnableRequest) ProtoReflect

func (x *FirewallEnableRequest) ProtoReflect() protoreflect.Message

func (*FirewallEnableRequest) Reset

func (x *FirewallEnableRequest) Reset()

func (*FirewallEnableRequest) String

func (x *FirewallEnableRequest) String() string

type FirewallEnableResult

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

func (*FirewallEnableResult) Descriptor deprecated

func (*FirewallEnableResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallEnableResult.ProtoReflect.Descriptor instead.

func (*FirewallEnableResult) ProtoMessage

func (*FirewallEnableResult) ProtoMessage()

func (*FirewallEnableResult) ProtoReflect

func (x *FirewallEnableResult) ProtoReflect() protoreflect.Message

func (*FirewallEnableResult) Reset

func (x *FirewallEnableResult) Reset()

func (*FirewallEnableResult) String

func (x *FirewallEnableResult) String() string

type FirewallInitRequest

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

func (*FirewallInitRequest) Descriptor deprecated

func (*FirewallInitRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallInitRequest.ProtoReflect.Descriptor instead.

func (*FirewallInitRequest) ProtoMessage

func (*FirewallInitRequest) ProtoMessage()

func (*FirewallInitRequest) ProtoReflect

func (x *FirewallInitRequest) ProtoReflect() protoreflect.Message

func (*FirewallInitRequest) Reset

func (x *FirewallInitRequest) Reset()

func (*FirewallInitRequest) String

func (x *FirewallInitRequest) String() string

type FirewallInitResult

type FirewallInitResult struct {
	EnvoyIp   string `protobuf:"bytes,1,opt,name=envoy_ip,json=envoyIp,proto3" json:"envoy_ip,omitempty"`
	CorednsIp string `protobuf:"bytes,2,opt,name=coredns_ip,json=corednsIp,proto3" json:"coredns_ip,omitempty"`
	NetworkId string `protobuf:"bytes,3,opt,name=network_id,json=networkId,proto3" json:"network_id,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallInitResult) Descriptor deprecated

func (*FirewallInitResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallInitResult.ProtoReflect.Descriptor instead.

func (*FirewallInitResult) GetCorednsIp

func (x *FirewallInitResult) GetCorednsIp() string

func (*FirewallInitResult) GetEnvoyIp

func (x *FirewallInitResult) GetEnvoyIp() string

func (*FirewallInitResult) GetNetworkId

func (x *FirewallInitResult) GetNetworkId() string

func (*FirewallInitResult) ProtoMessage

func (*FirewallInitResult) ProtoMessage()

func (*FirewallInitResult) ProtoReflect

func (x *FirewallInitResult) ProtoReflect() protoreflect.Message

func (*FirewallInitResult) Reset

func (x *FirewallInitResult) Reset()

func (*FirewallInitResult) String

func (x *FirewallInitResult) String() string

type FirewallListRulesRequest

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

func (*FirewallListRulesRequest) Descriptor deprecated

func (*FirewallListRulesRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallListRulesRequest.ProtoReflect.Descriptor instead.

func (*FirewallListRulesRequest) ProtoMessage

func (*FirewallListRulesRequest) ProtoMessage()

func (*FirewallListRulesRequest) ProtoReflect

func (x *FirewallListRulesRequest) ProtoReflect() protoreflect.Message

func (*FirewallListRulesRequest) Reset

func (x *FirewallListRulesRequest) Reset()

func (*FirewallListRulesRequest) String

func (x *FirewallListRulesRequest) String() string

type FirewallListRulesResult

type FirewallListRulesResult struct {
	Rules []*EgressRule `protobuf:"bytes,1,rep,name=rules,proto3" json:"rules,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallListRulesResult) Descriptor deprecated

func (*FirewallListRulesResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallListRulesResult.ProtoReflect.Descriptor instead.

func (*FirewallListRulesResult) GetRules

func (x *FirewallListRulesResult) GetRules() []*EgressRule

func (*FirewallListRulesResult) ProtoMessage

func (*FirewallListRulesResult) ProtoMessage()

func (*FirewallListRulesResult) ProtoReflect

func (x *FirewallListRulesResult) ProtoReflect() protoreflect.Message

func (*FirewallListRulesResult) Reset

func (x *FirewallListRulesResult) Reset()

func (*FirewallListRulesResult) String

func (x *FirewallListRulesResult) String() string

type FirewallReloadRequest

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

func (*FirewallReloadRequest) Descriptor deprecated

func (*FirewallReloadRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallReloadRequest.ProtoReflect.Descriptor instead.

func (*FirewallReloadRequest) ProtoMessage

func (*FirewallReloadRequest) ProtoMessage()

func (*FirewallReloadRequest) ProtoReflect

func (x *FirewallReloadRequest) ProtoReflect() protoreflect.Message

func (*FirewallReloadRequest) Reset

func (x *FirewallReloadRequest) Reset()

func (*FirewallReloadRequest) String

func (x *FirewallReloadRequest) String() string

type FirewallReloadResult

type FirewallReloadResult struct {
	StackRestarted bool `protobuf:"varint,1,opt,name=stack_restarted,json=stackRestarted,proto3" json:"stack_restarted,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallReloadResult) Descriptor deprecated

func (*FirewallReloadResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallReloadResult.ProtoReflect.Descriptor instead.

func (*FirewallReloadResult) GetStackRestarted

func (x *FirewallReloadResult) GetStackRestarted() bool

func (*FirewallReloadResult) ProtoMessage

func (*FirewallReloadResult) ProtoMessage()

func (*FirewallReloadResult) ProtoReflect

func (x *FirewallReloadResult) ProtoReflect() protoreflect.Message

func (*FirewallReloadResult) Reset

func (x *FirewallReloadResult) Reset()

func (*FirewallReloadResult) String

func (x *FirewallReloadResult) String() string

type FirewallRemoveRequest

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

func (*FirewallRemoveRequest) Descriptor deprecated

func (*FirewallRemoveRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRemoveRequest.ProtoReflect.Descriptor instead.

func (*FirewallRemoveRequest) ProtoMessage

func (*FirewallRemoveRequest) ProtoMessage()

func (*FirewallRemoveRequest) ProtoReflect

func (x *FirewallRemoveRequest) ProtoReflect() protoreflect.Message

func (*FirewallRemoveRequest) Reset

func (x *FirewallRemoveRequest) Reset()

func (*FirewallRemoveRequest) String

func (x *FirewallRemoveRequest) String() string

type FirewallRemoveResult

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

func (*FirewallRemoveResult) Descriptor deprecated

func (*FirewallRemoveResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRemoveResult.ProtoReflect.Descriptor instead.

func (*FirewallRemoveResult) ProtoMessage

func (*FirewallRemoveResult) ProtoMessage()

func (*FirewallRemoveResult) ProtoReflect

func (x *FirewallRemoveResult) ProtoReflect() protoreflect.Message

func (*FirewallRemoveResult) Reset

func (x *FirewallRemoveResult) Reset()

func (*FirewallRemoveResult) String

func (x *FirewallRemoveResult) String() string

type FirewallRemoveRuleRequest

type FirewallRemoveRuleRequest struct {
	Dst   string `protobuf:"bytes,1,opt,name=dst,proto3" json:"dst,omitempty"`
	Proto string `protobuf:"bytes,2,opt,name=proto,proto3" json:"proto,omitempty"` // "tls" | "tcp" | "http" | "ssh" | "ip" | "cidr"
	// Dynamic port spec ("443" or "9000-9100"); empty = protocol default.
	Port string `protobuf:"bytes,3,opt,name=port,proto3" json:"port,omitempty"`
	// Optional. When set, only the matching PathRule entry is removed from
	// the rule identified by (dst, proto, port); the rule itself remains.
	// When empty, the whole rule is removed.
	Path string `protobuf:"bytes,4,opt,name=path,proto3" json:"path,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallRemoveRuleRequest) Descriptor deprecated

func (*FirewallRemoveRuleRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRemoveRuleRequest.ProtoReflect.Descriptor instead.

func (*FirewallRemoveRuleRequest) GetDst

func (x *FirewallRemoveRuleRequest) GetDst() string

func (*FirewallRemoveRuleRequest) GetPath added in v0.9.5

func (x *FirewallRemoveRuleRequest) GetPath() string

func (*FirewallRemoveRuleRequest) GetPort

func (x *FirewallRemoveRuleRequest) GetPort() string

func (*FirewallRemoveRuleRequest) GetProto

func (x *FirewallRemoveRuleRequest) GetProto() string

func (*FirewallRemoveRuleRequest) ProtoMessage

func (*FirewallRemoveRuleRequest) ProtoMessage()

func (*FirewallRemoveRuleRequest) ProtoReflect

func (*FirewallRemoveRuleRequest) Reset

func (x *FirewallRemoveRuleRequest) Reset()

func (*FirewallRemoveRuleRequest) String

func (x *FirewallRemoveRuleRequest) String() string

type FirewallRemoveRuleResult

type FirewallRemoveRuleResult struct {

	// stack_restarted is true when the live stack was reloaded; false when
	// the stack was down at queue-time and only the on-disk rule change
	// applied. In both cases err==nil — the rule is durable.
	StackRestarted bool `protobuf:"varint,1,opt,name=stack_restarted,json=stackRestarted,proto3" json:"stack_restarted,omitempty"`
	// status names the outcome (REMOVED / PATH_REMOVED / NOT_FOUND).
	Status RemoveRuleStatus `protobuf:"varint,2,opt,name=status,proto3,enum=clawker.admin.v1.RemoveRuleStatus" json:"status,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallRemoveRuleResult) Descriptor deprecated

func (*FirewallRemoveRuleResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRemoveRuleResult.ProtoReflect.Descriptor instead.

func (*FirewallRemoveRuleResult) GetStackRestarted

func (x *FirewallRemoveRuleResult) GetStackRestarted() bool

func (*FirewallRemoveRuleResult) GetStatus added in v0.9.5

func (*FirewallRemoveRuleResult) ProtoMessage

func (*FirewallRemoveRuleResult) ProtoMessage()

func (*FirewallRemoveRuleResult) ProtoReflect

func (x *FirewallRemoveRuleResult) ProtoReflect() protoreflect.Message

func (*FirewallRemoveRuleResult) Reset

func (x *FirewallRemoveRuleResult) Reset()

func (*FirewallRemoveRuleResult) String

func (x *FirewallRemoveRuleResult) String() string

type FirewallResolveHostnameRequest

type FirewallResolveHostnameRequest struct {
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallResolveHostnameRequest) Descriptor deprecated

func (*FirewallResolveHostnameRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallResolveHostnameRequest.ProtoReflect.Descriptor instead.

func (*FirewallResolveHostnameRequest) GetHostname

func (x *FirewallResolveHostnameRequest) GetHostname() string

func (*FirewallResolveHostnameRequest) ProtoMessage

func (*FirewallResolveHostnameRequest) ProtoMessage()

func (*FirewallResolveHostnameRequest) ProtoReflect

func (*FirewallResolveHostnameRequest) Reset

func (x *FirewallResolveHostnameRequest) Reset()

func (*FirewallResolveHostnameRequest) String

type FirewallResolveHostnameResult

type FirewallResolveHostnameResult struct {
	Addresses []string `protobuf:"bytes,1,rep,name=addresses,proto3" json:"addresses,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallResolveHostnameResult) Descriptor deprecated

func (*FirewallResolveHostnameResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallResolveHostnameResult.ProtoReflect.Descriptor instead.

func (*FirewallResolveHostnameResult) GetAddresses

func (x *FirewallResolveHostnameResult) GetAddresses() []string

func (*FirewallResolveHostnameResult) ProtoMessage

func (*FirewallResolveHostnameResult) ProtoMessage()

func (*FirewallResolveHostnameResult) ProtoReflect

func (*FirewallResolveHostnameResult) Reset

func (x *FirewallResolveHostnameResult) Reset()

func (*FirewallResolveHostnameResult) String

type FirewallRotateCARequest

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

func (*FirewallRotateCARequest) Descriptor deprecated

func (*FirewallRotateCARequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRotateCARequest.ProtoReflect.Descriptor instead.

func (*FirewallRotateCARequest) ProtoMessage

func (*FirewallRotateCARequest) ProtoMessage()

func (*FirewallRotateCARequest) ProtoReflect

func (x *FirewallRotateCARequest) ProtoReflect() protoreflect.Message

func (*FirewallRotateCARequest) Reset

func (x *FirewallRotateCARequest) Reset()

func (*FirewallRotateCARequest) String

func (x *FirewallRotateCARequest) String() string

type FirewallRotateCAResult

type FirewallRotateCAResult struct {

	// stack_restarted mirrors the AddRules/Reload distinction: true when
	// the live stack was reloaded with the fresh cert chain; false when
	// regen completed but the stack was down so no restart fired.
	StackRestarted bool `protobuf:"varint,1,opt,name=stack_restarted,json=stackRestarted,proto3" json:"stack_restarted,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallRotateCAResult) Descriptor deprecated

func (*FirewallRotateCAResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallRotateCAResult.ProtoReflect.Descriptor instead.

func (*FirewallRotateCAResult) GetStackRestarted

func (x *FirewallRotateCAResult) GetStackRestarted() bool

func (*FirewallRotateCAResult) ProtoMessage

func (*FirewallRotateCAResult) ProtoMessage()

func (*FirewallRotateCAResult) ProtoReflect

func (x *FirewallRotateCAResult) ProtoReflect() protoreflect.Message

func (*FirewallRotateCAResult) Reset

func (x *FirewallRotateCAResult) Reset()

func (*FirewallRotateCAResult) String

func (x *FirewallRotateCAResult) String() string

type FirewallStatusRequest

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

func (*FirewallStatusRequest) Descriptor deprecated

func (*FirewallStatusRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallStatusRequest.ProtoReflect.Descriptor instead.

func (*FirewallStatusRequest) ProtoMessage

func (*FirewallStatusRequest) ProtoMessage()

func (*FirewallStatusRequest) ProtoReflect

func (x *FirewallStatusRequest) ProtoReflect() protoreflect.Message

func (*FirewallStatusRequest) Reset

func (x *FirewallStatusRequest) Reset()

func (*FirewallStatusRequest) String

func (x *FirewallStatusRequest) String() string

type FirewallStatusResult

type FirewallStatusResult struct {
	Running       bool   `protobuf:"varint,1,opt,name=running,proto3" json:"running,omitempty"`
	EnvoyHealth   bool   `protobuf:"varint,2,opt,name=envoy_health,json=envoyHealth,proto3" json:"envoy_health,omitempty"`
	CorednsHealth bool   `protobuf:"varint,3,opt,name=coredns_health,json=corednsHealth,proto3" json:"coredns_health,omitempty"`
	RuleCount     int32  `protobuf:"varint,4,opt,name=rule_count,json=ruleCount,proto3" json:"rule_count,omitempty"`
	EnvoyIp       string `protobuf:"bytes,5,opt,name=envoy_ip,json=envoyIp,proto3" json:"envoy_ip,omitempty"`
	CorednsIp     string `protobuf:"bytes,6,opt,name=coredns_ip,json=corednsIp,proto3" json:"coredns_ip,omitempty"`
	NetworkId     string `protobuf:"bytes,7,opt,name=network_id,json=networkId,proto3" json:"network_id,omitempty"`
	Cidr          string `protobuf:"bytes,8,opt,name=cidr,proto3" json:"cidr,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallStatusResult) Descriptor deprecated

func (*FirewallStatusResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallStatusResult.ProtoReflect.Descriptor instead.

func (*FirewallStatusResult) GetCidr

func (x *FirewallStatusResult) GetCidr() string

func (*FirewallStatusResult) GetCorednsHealth

func (x *FirewallStatusResult) GetCorednsHealth() bool

func (*FirewallStatusResult) GetCorednsIp

func (x *FirewallStatusResult) GetCorednsIp() string

func (*FirewallStatusResult) GetEnvoyHealth

func (x *FirewallStatusResult) GetEnvoyHealth() bool

func (*FirewallStatusResult) GetEnvoyIp

func (x *FirewallStatusResult) GetEnvoyIp() string

func (*FirewallStatusResult) GetNetworkId

func (x *FirewallStatusResult) GetNetworkId() string

func (*FirewallStatusResult) GetRuleCount

func (x *FirewallStatusResult) GetRuleCount() int32

func (*FirewallStatusResult) GetRunning

func (x *FirewallStatusResult) GetRunning() bool

func (*FirewallStatusResult) ProtoMessage

func (*FirewallStatusResult) ProtoMessage()

func (*FirewallStatusResult) ProtoReflect

func (x *FirewallStatusResult) ProtoReflect() protoreflect.Message

func (*FirewallStatusResult) Reset

func (x *FirewallStatusResult) Reset()

func (*FirewallStatusResult) String

func (x *FirewallStatusResult) String() string

type FirewallSyncRoutesRequest

type FirewallSyncRoutesRequest struct {

	// routes is retained for wire compatibility but is IGNORED by the
	// server. Post-queue the server rebuilds the route_map from the
	// current rules store — see
	// internal/controlplane/firewall.Handler.FirewallSyncRoutes for the
	// rationale (coalescing with concurrent AddRules/Reload would
	// silently discard a caller's stale route set).
	Routes []*Route `protobuf:"bytes,1,rep,name=routes,proto3" json:"routes,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallSyncRoutesRequest) Descriptor deprecated

func (*FirewallSyncRoutesRequest) Descriptor() ([]byte, []int)

Deprecated: Use FirewallSyncRoutesRequest.ProtoReflect.Descriptor instead.

func (*FirewallSyncRoutesRequest) GetRoutes

func (x *FirewallSyncRoutesRequest) GetRoutes() []*Route

func (*FirewallSyncRoutesRequest) ProtoMessage

func (*FirewallSyncRoutesRequest) ProtoMessage()

func (*FirewallSyncRoutesRequest) ProtoReflect

func (*FirewallSyncRoutesRequest) Reset

func (x *FirewallSyncRoutesRequest) Reset()

func (*FirewallSyncRoutesRequest) String

func (x *FirewallSyncRoutesRequest) String() string

type FirewallSyncRoutesResult

type FirewallSyncRoutesResult struct {
	Applied uint32 `protobuf:"varint,1,opt,name=applied,proto3" json:"applied,omitempty"`
	// contains filtered or unexported fields
}

func (*FirewallSyncRoutesResult) Descriptor deprecated

func (*FirewallSyncRoutesResult) Descriptor() ([]byte, []int)

Deprecated: Use FirewallSyncRoutesResult.ProtoReflect.Descriptor instead.

func (*FirewallSyncRoutesResult) GetApplied

func (x *FirewallSyncRoutesResult) GetApplied() uint32

func (*FirewallSyncRoutesResult) ProtoMessage

func (*FirewallSyncRoutesResult) ProtoMessage()

func (*FirewallSyncRoutesResult) ProtoReflect

func (x *FirewallSyncRoutesResult) ProtoReflect() protoreflect.Message

func (*FirewallSyncRoutesResult) Reset

func (x *FirewallSyncRoutesResult) Reset()

func (*FirewallSyncRoutesResult) String

func (x *FirewallSyncRoutesResult) String() string

type GetSystemTimeRequest added in v0.10.2

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

func (*GetSystemTimeRequest) Descriptor deprecated added in v0.10.2

func (*GetSystemTimeRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetSystemTimeRequest.ProtoReflect.Descriptor instead.

func (*GetSystemTimeRequest) ProtoMessage added in v0.10.2

func (*GetSystemTimeRequest) ProtoMessage()

func (*GetSystemTimeRequest) ProtoReflect added in v0.10.2

func (x *GetSystemTimeRequest) ProtoReflect() protoreflect.Message

func (*GetSystemTimeRequest) Reset added in v0.10.2

func (x *GetSystemTimeRequest) Reset()

func (*GetSystemTimeRequest) String added in v0.10.2

func (x *GetSystemTimeRequest) String() string

type GetSystemTimeResult added in v0.10.2

type GetSystemTimeResult struct {

	// unix_nanos is the CP's current wall-clock time as Unix nanoseconds since
	// the epoch. Unix nanoseconds are an absolute instant counted from the epoch,
	// so the value is inherently timezone-independent with no dependency on any TZ
	// setting on the CP host (no UTC conversion is applied or needed server-side).
	// The host-side CP-readiness gate reads it back and compares against its own
	// time.Now().UTC() to decide whether the CP clock has caught up to the host
	// before the container start is allowed to proceed.
	UnixNanos int64 `protobuf:"varint,1,opt,name=unix_nanos,json=unixNanos,proto3" json:"unix_nanos,omitempty"`
	// contains filtered or unexported fields
}

func (*GetSystemTimeResult) Descriptor deprecated added in v0.10.2

func (*GetSystemTimeResult) Descriptor() ([]byte, []int)

Deprecated: Use GetSystemTimeResult.ProtoReflect.Descriptor instead.

func (*GetSystemTimeResult) GetUnixNanos added in v0.10.2

func (x *GetSystemTimeResult) GetUnixNanos() int64

func (*GetSystemTimeResult) ProtoMessage added in v0.10.2

func (*GetSystemTimeResult) ProtoMessage()

func (*GetSystemTimeResult) ProtoReflect added in v0.10.2

func (x *GetSystemTimeResult) ProtoReflect() protoreflect.Message

func (*GetSystemTimeResult) Reset added in v0.10.2

func (x *GetSystemTimeResult) Reset()

func (*GetSystemTimeResult) String added in v0.10.2

func (x *GetSystemTimeResult) String() string

type ListAgentsRequest

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

func (*ListAgentsRequest) Descriptor deprecated

func (*ListAgentsRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListAgentsRequest.ProtoReflect.Descriptor instead.

func (*ListAgentsRequest) ProtoMessage

func (*ListAgentsRequest) ProtoMessage()

func (*ListAgentsRequest) ProtoReflect

func (x *ListAgentsRequest) ProtoReflect() protoreflect.Message

func (*ListAgentsRequest) Reset

func (x *ListAgentsRequest) Reset()

func (*ListAgentsRequest) String

func (x *ListAgentsRequest) String() string

type ListAgentsResult

type ListAgentsResult struct {
	Agents []*Agent `protobuf:"bytes,1,rep,name=agents,proto3" json:"agents,omitempty"`
	// contains filtered or unexported fields
}

func (*ListAgentsResult) Descriptor deprecated

func (*ListAgentsResult) Descriptor() ([]byte, []int)

Deprecated: Use ListAgentsResult.ProtoReflect.Descriptor instead.

func (*ListAgentsResult) GetAgents

func (x *ListAgentsResult) GetAgents() []*Agent

func (*ListAgentsResult) ProtoMessage

func (*ListAgentsResult) ProtoMessage()

func (*ListAgentsResult) ProtoReflect

func (x *ListAgentsResult) ProtoReflect() protoreflect.Message

func (*ListAgentsResult) Reset

func (x *ListAgentsResult) Reset()

func (*ListAgentsResult) String

func (x *ListAgentsResult) String() string

type PathRule

type PathRule struct {
	Path   string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	Action string `protobuf:"bytes,2,opt,name=action,proto3" json:"action,omitempty"`
	// HTTP methods this path rule's action applies to (e.g. ["GET", "HEAD"]).
	// Empty = all methods. HTTP-family protos only; ignored on opaque protos.
	Methods []string `protobuf:"bytes,3,rep,name=methods,proto3" json:"methods,omitempty"`
	// contains filtered or unexported fields
}

func (*PathRule) Descriptor deprecated

func (*PathRule) Descriptor() ([]byte, []int)

Deprecated: Use PathRule.ProtoReflect.Descriptor instead.

func (*PathRule) GetAction

func (x *PathRule) GetAction() string

func (*PathRule) GetMethods added in v0.11.0

func (x *PathRule) GetMethods() []string

func (*PathRule) GetPath

func (x *PathRule) GetPath() string

func (*PathRule) ProtoMessage

func (*PathRule) ProtoMessage()

func (*PathRule) ProtoReflect

func (x *PathRule) ProtoReflect() protoreflect.Message

func (*PathRule) Reset

func (x *PathRule) Reset()

func (*PathRule) String

func (x *PathRule) String() string

type RemoveRuleStatus added in v0.9.5

type RemoveRuleStatus int32

RemoveRuleStatus is the outcome of a FirewallRemoveRule call. NOT_FOUND is surfaced through this field, not as a gRPC codes.NotFound error — genuine errors (store I/O, validation) still return as gRPC errors.

const (
	RemoveRuleStatus_REMOVE_RULE_STATUS_UNSPECIFIED RemoveRuleStatus = 0
	// REMOVED: the whole rule keyed by (dst, proto, port) was deleted.
	RemoveRuleStatus_REMOVE_RULE_STATUS_REMOVED RemoveRuleStatus = 1
	// PATH_REMOVED: only the matching PathRule entry was deleted; the rule
	// itself remains in the store.
	RemoveRuleStatus_REMOVE_RULE_STATUS_PATH_REMOVED RemoveRuleStatus = 2
	// NOT_FOUND: either the RuleKey does not exist, or (when path is set)
	// no PathRule matched the requested path.
	RemoveRuleStatus_REMOVE_RULE_STATUS_NOT_FOUND RemoveRuleStatus = 3
)

func (RemoveRuleStatus) Descriptor added in v0.9.5

func (RemoveRuleStatus) Enum added in v0.9.5

func (RemoveRuleStatus) EnumDescriptor deprecated added in v0.9.5

func (RemoveRuleStatus) EnumDescriptor() ([]byte, []int)

Deprecated: Use RemoveRuleStatus.Descriptor instead.

func (RemoveRuleStatus) Number added in v0.9.5

func (RemoveRuleStatus) String added in v0.9.5

func (x RemoveRuleStatus) String() string

func (RemoveRuleStatus) Type added in v0.9.5

type Route

type Route struct {
	DomainHash uint32 `protobuf:"varint,1,opt,name=domain_hash,json=domainHash,proto3" json:"domain_hash,omitempty"`
	DstPort    uint32 `protobuf:"varint,2,opt,name=dst_port,json=dstPort,proto3" json:"dst_port,omitempty"`
	EnvoyPort  uint32 `protobuf:"varint,3,opt,name=envoy_port,json=envoyPort,proto3" json:"envoy_port,omitempty"`
	// contains filtered or unexported fields
}

Route is one entry in the global route_map.

func (*Route) Descriptor deprecated

func (*Route) Descriptor() ([]byte, []int)

Deprecated: Use Route.ProtoReflect.Descriptor instead.

func (*Route) GetDomainHash

func (x *Route) GetDomainHash() uint32

func (*Route) GetDstPort

func (x *Route) GetDstPort() uint32

func (*Route) GetEnvoyPort

func (x *Route) GetEnvoyPort() uint32

func (*Route) ProtoMessage

func (*Route) ProtoMessage()

func (*Route) ProtoReflect

func (x *Route) ProtoReflect() protoreflect.Message

func (*Route) Reset

func (x *Route) Reset()

func (*Route) String

func (x *Route) String() string

type UnimplementedAdminServiceServer

type UnimplementedAdminServiceServer struct{}

UnimplementedAdminServiceServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

func (UnimplementedAdminServiceServer) FirewallAddRules

func (UnimplementedAdminServiceServer) FirewallBypass

func (UnimplementedAdminServiceServer) FirewallDisable

func (UnimplementedAdminServiceServer) FirewallEnable

func (UnimplementedAdminServiceServer) FirewallInit

func (UnimplementedAdminServiceServer) FirewallListRules

func (UnimplementedAdminServiceServer) FirewallReload

func (UnimplementedAdminServiceServer) FirewallRemove

func (UnimplementedAdminServiceServer) FirewallRemoveRule

func (UnimplementedAdminServiceServer) FirewallRotateCA

func (UnimplementedAdminServiceServer) FirewallStatus

func (UnimplementedAdminServiceServer) FirewallSyncRoutes

func (UnimplementedAdminServiceServer) GetSystemTime added in v0.10.2

func (UnimplementedAdminServiceServer) ListAgents

type UnsafeAdminServiceServer

type UnsafeAdminServiceServer interface {
	// contains filtered or unexported methods
}

UnsafeAdminServiceServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to AdminServiceServer will result in compilation errors.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL