sandboxv1

package
v0.1.7 Latest Latest
Warning

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

Go to latest
Published: Nov 3, 2026 License: Apache-2.0 Imports: 8 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	NetworkTlsMode_name = map[int32]string{
		0: "NETWORK_TLS_MODE_UNSPECIFIED",
		1: "NETWORK_TLS_MODE_SKIP",
		2: "NETWORK_TLS_MODE_TERMINATE",
		3: "NETWORK_TLS_MODE_PASSTHROUGH",
	}
	NetworkTlsMode_value = map[string]int32{
		"NETWORK_TLS_MODE_UNSPECIFIED": 0,
		"NETWORK_TLS_MODE_SKIP":        1,
		"NETWORK_TLS_MODE_TERMINATE":   2,
		"NETWORK_TLS_MODE_PASSTHROUGH": 3,
	}
)

Enum value maps for NetworkTlsMode.

View Source
var (
	NetworkEnforcementMode_name = map[int32]string{
		0: "NETWORK_ENFORCEMENT_MODE_UNSPECIFIED",
		1: "NETWORK_ENFORCEMENT_MODE_ENFORCE",
		2: "NETWORK_ENFORCEMENT_MODE_AUDIT",
	}
	NetworkEnforcementMode_value = map[string]int32{
		"NETWORK_ENFORCEMENT_MODE_UNSPECIFIED": 0,
		"NETWORK_ENFORCEMENT_MODE_ENFORCE":     1,
		"NETWORK_ENFORCEMENT_MODE_AUDIT":       2,
	}
)

Enum value maps for NetworkEnforcementMode.

View Source
var (
	NetworkAccessPreset_name = map[int32]string{
		0: "NETWORK_ACCESS_PRESET_UNSPECIFIED",
		1: "NETWORK_ACCESS_PRESET_READ_ONLY",
		2: "NETWORK_ACCESS_PRESET_READ_WRITE",
		3: "NETWORK_ACCESS_PRESET_FULL",
	}
	NetworkAccessPreset_value = map[string]int32{
		"NETWORK_ACCESS_PRESET_UNSPECIFIED": 0,
		"NETWORK_ACCESS_PRESET_READ_ONLY":   1,
		"NETWORK_ACCESS_PRESET_READ_WRITE":  2,
		"NETWORK_ACCESS_PRESET_FULL":        3,
	}
)

Enum value maps for NetworkAccessPreset.

View Source
var (
	SettingScope_name = map[int32]string{
		0: "SETTING_SCOPE_UNSPECIFIED",
		1: "SETTING_SCOPE_SANDBOX",
		2: "SETTING_SCOPE_GLOBAL",
	}
	SettingScope_value = map[string]int32{
		"SETTING_SCOPE_UNSPECIFIED": 0,
		"SETTING_SCOPE_SANDBOX":     1,
		"SETTING_SCOPE_GLOBAL":      2,
	}
)

Enum value maps for SettingScope.

View Source
var (
	PolicySource_name = map[int32]string{
		0: "POLICY_SOURCE_UNSPECIFIED",
		1: "POLICY_SOURCE_SANDBOX",
		2: "POLICY_SOURCE_GLOBAL",
	}
	PolicySource_value = map[string]int32{
		"POLICY_SOURCE_UNSPECIFIED": 0,
		"POLICY_SOURCE_SANDBOX":     1,
		"POLICY_SOURCE_GLOBAL":      2,
	}
)

Enum value maps for PolicySource.

View Source
var (
	SupervisorMiddlewareBindingPolicy_name = map[int32]string{
		0: "SUPERVISOR_MIDDLEWARE_BINDING_POLICY_UNSPECIFIED",
		1: "SUPERVISOR_MIDDLEWARE_BINDING_POLICY_DYNAMIC",
		2: "SUPERVISOR_MIDDLEWARE_BINDING_POLICY_ALLOWLIST",
		3: "SUPERVISOR_MIDDLEWARE_BINDING_POLICY_EXACT",
	}
	SupervisorMiddlewareBindingPolicy_value = map[string]int32{
		"SUPERVISOR_MIDDLEWARE_BINDING_POLICY_UNSPECIFIED": 0,
		"SUPERVISOR_MIDDLEWARE_BINDING_POLICY_DYNAMIC":     1,
		"SUPERVISOR_MIDDLEWARE_BINDING_POLICY_ALLOWLIST":   2,
		"SUPERVISOR_MIDDLEWARE_BINDING_POLICY_EXACT":       3,
	}
)

Enum value maps for SupervisorMiddlewareBindingPolicy.

View Source
var (
	SupervisorMiddlewareBinding_name = map[int32]string{
		0: "SUPERVISOR_MIDDLEWARE_BINDING_UNSPECIFIED",
		1: "SUPERVISOR_MIDDLEWARE_BINDING_HTTP_REQUEST_PRE_CREDENTIALS",
		2: "SUPERVISOR_MIDDLEWARE_BINDING_HTTP_RESPONSE_PRE_RETURN",
		3: "SUPERVISOR_MIDDLEWARE_BINDING_WEBSOCKET_MESSAGE_PRE_CREDENTIALS",
	}
	SupervisorMiddlewareBinding_value = map[string]int32{
		"SUPERVISOR_MIDDLEWARE_BINDING_UNSPECIFIED":                       0,
		"SUPERVISOR_MIDDLEWARE_BINDING_HTTP_REQUEST_PRE_CREDENTIALS":      1,
		"SUPERVISOR_MIDDLEWARE_BINDING_HTTP_RESPONSE_PRE_RETURN":          2,
		"SUPERVISOR_MIDDLEWARE_BINDING_WEBSOCKET_MESSAGE_PRE_CREDENTIALS": 3,
	}
)

Enum value maps for SupervisorMiddlewareBinding.

View Source
var File_sandbox_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type EffectiveSetting

type EffectiveSetting struct {
	Value *SettingValue `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
	Scope SettingScope  `protobuf:"varint,2,opt,name=scope,proto3,enum=openshell.sandbox.v1.SettingScope" json:"scope,omitempty"`
	// contains filtered or unexported fields
}

Effective setting value and the scope it was resolved from.

func (*EffectiveSetting) Descriptor deprecated

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

Deprecated: Use EffectiveSetting.ProtoReflect.Descriptor instead.

func (*EffectiveSetting) GetScope

func (x *EffectiveSetting) GetScope() SettingScope

func (*EffectiveSetting) GetValue

func (x *EffectiveSetting) GetValue() *SettingValue

func (*EffectiveSetting) ProtoMessage

func (*EffectiveSetting) ProtoMessage()

func (*EffectiveSetting) ProtoReflect

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

func (*EffectiveSetting) Reset

func (x *EffectiveSetting) Reset()

func (*EffectiveSetting) String

func (x *EffectiveSetting) String() string

type FilesystemPolicy

type FilesystemPolicy struct {

	// Automatically include the workdir as read-write.
	IncludeWorkdir bool `protobuf:"varint,1,opt,name=include_workdir,json=includeWorkdir,proto3" json:"include_workdir,omitempty"`
	// Read-only directory allow list.
	ReadOnly []string `protobuf:"bytes,2,rep,name=read_only,json=readOnly,proto3" json:"read_only,omitempty"`
	// Read-write directory allow list.
	ReadWrite []string `protobuf:"bytes,3,rep,name=read_write,json=readWrite,proto3" json:"read_write,omitempty"`
	// contains filtered or unexported fields
}

Filesystem access policy.

func (*FilesystemPolicy) Descriptor deprecated

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

Deprecated: Use FilesystemPolicy.ProtoReflect.Descriptor instead.

func (*FilesystemPolicy) GetIncludeWorkdir

func (x *FilesystemPolicy) GetIncludeWorkdir() bool

func (*FilesystemPolicy) GetReadOnly

func (x *FilesystemPolicy) GetReadOnly() []string

func (*FilesystemPolicy) GetReadWrite

func (x *FilesystemPolicy) GetReadWrite() []string

func (*FilesystemPolicy) ProtoMessage

func (*FilesystemPolicy) ProtoMessage()

func (*FilesystemPolicy) ProtoReflect

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

func (*FilesystemPolicy) Reset

func (x *FilesystemPolicy) Reset()

func (*FilesystemPolicy) String

func (x *FilesystemPolicy) String() string

type GetGatewayConfigRequest

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

Request to get gateway-global settings.

func (*GetGatewayConfigRequest) Descriptor deprecated

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

Deprecated: Use GetGatewayConfigRequest.ProtoReflect.Descriptor instead.

func (*GetGatewayConfigRequest) ProtoMessage

func (*GetGatewayConfigRequest) ProtoMessage()

func (*GetGatewayConfigRequest) ProtoReflect

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

func (*GetGatewayConfigRequest) Reset

func (x *GetGatewayConfigRequest) Reset()

func (*GetGatewayConfigRequest) String

func (x *GetGatewayConfigRequest) String() string

type GetGatewayConfigResponse

type GetGatewayConfigResponse struct {

	// Gateway-global settings map excluding the reserved policy key.
	// Registered keys without a configured value are returned with an empty SettingValue.
	Settings map[string]*SettingValue `` /* 143-byte string literal not displayed */
	// Monotonically increasing revision for gateway-global settings.
	SettingsRevision uint64 `protobuf:"varint,2,opt,name=settings_revision,json=settingsRevision,proto3" json:"settings_revision,omitempty"`
	// contains filtered or unexported fields
}

Response containing gateway-global settings.

func (*GetGatewayConfigResponse) Descriptor deprecated

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

Deprecated: Use GetGatewayConfigResponse.ProtoReflect.Descriptor instead.

func (*GetGatewayConfigResponse) GetSettings

func (x *GetGatewayConfigResponse) GetSettings() map[string]*SettingValue

func (*GetGatewayConfigResponse) GetSettingsRevision

func (x *GetGatewayConfigResponse) GetSettingsRevision() uint64

func (*GetGatewayConfigResponse) ProtoMessage

func (*GetGatewayConfigResponse) ProtoMessage()

func (*GetGatewayConfigResponse) ProtoReflect

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

func (*GetGatewayConfigResponse) Reset

func (x *GetGatewayConfigResponse) Reset()

func (*GetGatewayConfigResponse) String

func (x *GetGatewayConfigResponse) String() string

type GetSandboxConfigRequest

type GetSandboxConfigRequest struct {

	// Workspace scope. Select one named workspace; authenticated sandbox callers may omit it during bootstrap.
	WorkspaceScope *datamodelv1.WorkspaceSelector `protobuf:"bytes,3,opt,name=workspace_scope,json=workspaceScope,proto3" json:"workspace_scope,omitempty"`
	Name           string                         `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

Request to get sandbox settings by sandbox name.

func (*GetSandboxConfigRequest) Descriptor deprecated

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

Deprecated: Use GetSandboxConfigRequest.ProtoReflect.Descriptor instead.

func (*GetSandboxConfigRequest) GetName

func (x *GetSandboxConfigRequest) GetName() string

func (*GetSandboxConfigRequest) GetWorkspaceScope

func (x *GetSandboxConfigRequest) GetWorkspaceScope() *datamodelv1.WorkspaceSelector

func (*GetSandboxConfigRequest) ProtoMessage

func (*GetSandboxConfigRequest) ProtoMessage()

func (*GetSandboxConfigRequest) ProtoReflect

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

func (*GetSandboxConfigRequest) Reset

func (x *GetSandboxConfigRequest) Reset()

func (*GetSandboxConfigRequest) String

func (x *GetSandboxConfigRequest) String() string

type GetSandboxConfigResponse

type GetSandboxConfigResponse struct {

	// The sandbox policy configuration.
	Policy *SandboxPolicy `protobuf:"bytes,1,opt,name=policy,proto3" json:"policy,omitempty"`
	// Current policy version (monotonically increasing per sandbox).
	Version uint32 `protobuf:"varint,2,opt,name=version,proto3" json:"version,omitempty"`
	// SHA-256 hash of the serialized policy payload.
	PolicyHash string `protobuf:"bytes,3,opt,name=policy_hash,json=policyHash,proto3" json:"policy_hash,omitempty"`
	// Effective settings resolved for this sandbox, excluding the reserved policy key.
	// Registered keys without a configured value are returned with an empty EffectiveSetting.value.
	Settings map[string]*EffectiveSetting `` /* 143-byte string literal not displayed */
	// Fingerprint for effective config (policy + settings). Changes when any effective input changes.
	ConfigRevision uint64 `protobuf:"varint,5,opt,name=config_revision,json=configRevision,proto3" json:"config_revision,omitempty"`
	// Source of the policy payload for this response.
	PolicySource PolicySource `` /* 137-byte string literal not displayed */
	// When policy_source is GLOBAL, the version of the global policy revision.
	// Zero when no global policy is active or when policy_source is SANDBOX.
	GlobalPolicyVersion uint32 `protobuf:"varint,7,opt,name=global_policy_version,json=globalPolicyVersion,proto3" json:"global_policy_version,omitempty"`
	// Fingerprint for provider credential inputs attached to this sandbox.
	// Changes when attached provider names or attached provider records change.
	ProviderEnvRevision uint64 `protobuf:"varint,8,opt,name=provider_env_revision,json=providerEnvRevision,proto3" json:"provider_env_revision,omitempty"`
	// Operator-registered supervisor middleware services required by the
	// effective policy. Built-in middleware is not included.
	SupervisorMiddlewareServices []*SupervisorMiddlewareService `` /* 147-byte string literal not displayed */
	// Workspace the sandbox belongs to. Allows the supervisor to learn its
	// workspace context for subsequent workspace-scoped RPCs.
	Workspace string `protobuf:"bytes,10,opt,name=workspace,proto3" json:"workspace,omitempty"`
	// Gateway-configured posture for rejected policy generations. Valid values
	// are "fail_closed" and "retain_last_valid". Unknown or empty values must
	// be treated as fail_closed by the supervisor.
	PolicyValidationFailureMode string `` /* 147-byte string literal not displayed */
	// Whether this gateway can mint authenticated extension credentials.
	// False also covers older gateways that do not advertise this capability;
	// supervisors preserve their legacy unauthenticated connection behavior.
	ExtensionAuthenticationEnabled bool `` /* 155-byte string literal not displayed */
	// Gateway-owned attachment identity captured with this desired configuration.
	// Compare for equality; reattachment invalidates previous installation evidence.
	ProviderAttachmentEpoch string `` /* 133-byte string literal not displayed */
	// True only after validating this complete policy/provider composition.
	// Missing (older gateway) is deliberately not admission.
	ConfigurationAdmitted bool `` /* 126-byte string literal not displayed */
	// Bounded, credential-free admission diagnostic. Empty for admitted policy.
	ConfigurationError string `protobuf:"bytes,16,opt,name=configuration_error,json=configurationError,proto3" json:"configuration_error,omitempty"`
	// Registration fence for a new supervisor; capture once and retain on retry.
	ConfigurationInstanceId string `` /* 133-byte string literal not displayed */
	// Monotonic revision of the sandbox-scoped settings row.
	SettingsRevision uint64                 `protobuf:"varint,17,opt,name=settings_revision,json=settingsRevision,proto3" json:"settings_revision,omitempty"`
	ServiceRoutes    []*SandboxServiceRoute `protobuf:"bytes,18,rep,name=service_routes,json=serviceRoutes,proto3" json:"service_routes,omitempty"`
	// contains filtered or unexported fields
}

Response containing effective sandbox settings and policy, projected from the SandboxConfigSnapshot that push supervisors receive.

func (*GetSandboxConfigResponse) Descriptor deprecated

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

Deprecated: Use GetSandboxConfigResponse.ProtoReflect.Descriptor instead.

func (*GetSandboxConfigResponse) GetConfigRevision

func (x *GetSandboxConfigResponse) GetConfigRevision() uint64

func (*GetSandboxConfigResponse) GetConfigurationAdmitted

func (x *GetSandboxConfigResponse) GetConfigurationAdmitted() bool

func (*GetSandboxConfigResponse) GetConfigurationError

func (x *GetSandboxConfigResponse) GetConfigurationError() string

func (*GetSandboxConfigResponse) GetConfigurationInstanceId

func (x *GetSandboxConfigResponse) GetConfigurationInstanceId() string

func (*GetSandboxConfigResponse) GetExtensionAuthenticationEnabled

func (x *GetSandboxConfigResponse) GetExtensionAuthenticationEnabled() bool

func (*GetSandboxConfigResponse) GetGlobalPolicyVersion

func (x *GetSandboxConfigResponse) GetGlobalPolicyVersion() uint32

func (*GetSandboxConfigResponse) GetPolicy

func (x *GetSandboxConfigResponse) GetPolicy() *SandboxPolicy

func (*GetSandboxConfigResponse) GetPolicyHash

func (x *GetSandboxConfigResponse) GetPolicyHash() string

func (*GetSandboxConfigResponse) GetPolicySource

func (x *GetSandboxConfigResponse) GetPolicySource() PolicySource

func (*GetSandboxConfigResponse) GetPolicyValidationFailureMode

func (x *GetSandboxConfigResponse) GetPolicyValidationFailureMode() string

func (*GetSandboxConfigResponse) GetProviderAttachmentEpoch

func (x *GetSandboxConfigResponse) GetProviderAttachmentEpoch() string

func (*GetSandboxConfigResponse) GetProviderEnvRevision

func (x *GetSandboxConfigResponse) GetProviderEnvRevision() uint64

func (*GetSandboxConfigResponse) GetServiceRoutes added in v0.1.7

func (x *GetSandboxConfigResponse) GetServiceRoutes() []*SandboxServiceRoute

func (*GetSandboxConfigResponse) GetSettings

func (x *GetSandboxConfigResponse) GetSettings() map[string]*EffectiveSetting

func (*GetSandboxConfigResponse) GetSettingsRevision

func (x *GetSandboxConfigResponse) GetSettingsRevision() uint64

func (*GetSandboxConfigResponse) GetSupervisorMiddlewareServices

func (x *GetSandboxConfigResponse) GetSupervisorMiddlewareServices() []*SupervisorMiddlewareService

func (*GetSandboxConfigResponse) GetVersion

func (x *GetSandboxConfigResponse) GetVersion() uint32

func (*GetSandboxConfigResponse) GetWorkspace

func (x *GetSandboxConfigResponse) GetWorkspace() string

func (*GetSandboxConfigResponse) ProtoMessage

func (*GetSandboxConfigResponse) ProtoMessage()

func (*GetSandboxConfigResponse) ProtoReflect

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

func (*GetSandboxConfigResponse) Reset

func (x *GetSandboxConfigResponse) Reset()

func (*GetSandboxConfigResponse) String

func (x *GetSandboxConfigResponse) String() string

type GraphqlOperation

type GraphqlOperation struct {

	// Operation type: "query", "mutation", or "subscription".
	OperationType string `protobuf:"bytes,1,opt,name=operation_type,json=operationType,proto3" json:"operation_type,omitempty"`
	// Operation name, if known.
	OperationName string `protobuf:"bytes,2,opt,name=operation_name,json=operationName,proto3" json:"operation_name,omitempty"`
	// Root field names selected by the operation.
	Fields []string `protobuf:"bytes,3,rep,name=fields,proto3" json:"fields,omitempty"`
	// contains filtered or unexported fields
}

Trusted GraphQL operation classification.

func (*GraphqlOperation) Descriptor deprecated

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

Deprecated: Use GraphqlOperation.ProtoReflect.Descriptor instead.

func (*GraphqlOperation) GetFields

func (x *GraphqlOperation) GetFields() []string

func (*GraphqlOperation) GetOperationName

func (x *GraphqlOperation) GetOperationName() string

func (*GraphqlOperation) GetOperationType

func (x *GraphqlOperation) GetOperationType() string

func (*GraphqlOperation) ProtoMessage

func (*GraphqlOperation) ProtoMessage()

func (*GraphqlOperation) ProtoReflect

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

func (*GraphqlOperation) Reset

func (x *GraphqlOperation) Reset()

func (*GraphqlOperation) String

func (x *GraphqlOperation) String() string

type L7Allow

type L7Allow struct {

	// Protocol method: HTTP method (REST/WebSocket), JSON-RPC method name, or
	// "*" for any when supported by the protocol.
	Method string `protobuf:"bytes,1,opt,name=method,proto3" json:"method,omitempty"`
	// URL path glob pattern (REST): "/repos/**", "**" for any.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// SQL command (SQL): SELECT, INSERT, etc. or "*" for any.
	Command string `protobuf:"bytes,3,opt,name=command,proto3" json:"command,omitempty"`
	// Query parameter matcher map (REST).
	// Key is the decoded query parameter name (case-sensitive).
	// Value supports either a single glob (`glob`) or a list (`any`).
	Query map[string]*L7QueryMatcher `` /* 137-byte string literal not displayed */
	// GraphQL operation type: "query", "mutation", "subscription", or "*" for any.
	OperationType string `protobuf:"bytes,5,opt,name=operation_type,json=operationType,proto3" json:"operation_type,omitempty"`
	// GraphQL operation name glob. "*" matches any operation name.
	OperationName string `protobuf:"bytes,6,opt,name=operation_name,json=operationName,proto3" json:"operation_name,omitempty"`
	// GraphQL root field globs. Allow rules match only when every selected root
	// field matches one of the configured globs. Omit to match all fields.
	Fields []string `protobuf:"bytes,7,rep,name=fields,proto3" json:"fields,omitempty"`
	// MCP params matcher map. Currently only params.name is supported for
	// tools/call filtering. Generic protocol "json-rpc" rejects params matchers.
	Params map[string]*L7QueryMatcher `` /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

Allowed action definition for L7 rules.

func (*L7Allow) Descriptor deprecated

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

Deprecated: Use L7Allow.ProtoReflect.Descriptor instead.

func (*L7Allow) GetCommand

func (x *L7Allow) GetCommand() string

func (*L7Allow) GetFields

func (x *L7Allow) GetFields() []string

func (*L7Allow) GetMethod

func (x *L7Allow) GetMethod() string

func (*L7Allow) GetOperationName

func (x *L7Allow) GetOperationName() string

func (*L7Allow) GetOperationType

func (x *L7Allow) GetOperationType() string

func (*L7Allow) GetParams

func (x *L7Allow) GetParams() map[string]*L7QueryMatcher

func (*L7Allow) GetPath

func (x *L7Allow) GetPath() string

func (*L7Allow) GetQuery

func (x *L7Allow) GetQuery() map[string]*L7QueryMatcher

func (*L7Allow) ProtoMessage

func (*L7Allow) ProtoMessage()

func (*L7Allow) ProtoReflect

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

func (*L7Allow) Reset

func (x *L7Allow) Reset()

func (*L7Allow) String

func (x *L7Allow) String() string

type L7DenyRule

type L7DenyRule struct {

	// Protocol method: HTTP method (REST/WebSocket), JSON-RPC method name, or
	// "*" for any when supported by the protocol.
	Method string `protobuf:"bytes,1,opt,name=method,proto3" json:"method,omitempty"`
	// URL path glob pattern (REST): "/repos/*/pulls/*/reviews", "**" for any.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// SQL command (SQL): SELECT, INSERT, etc. or "*" for any.
	Command string `protobuf:"bytes,3,opt,name=command,proto3" json:"command,omitempty"`
	// Query parameter matcher map (REST).
	// Same semantics as L7Allow.query.
	Query map[string]*L7QueryMatcher `` /* 137-byte string literal not displayed */
	// GraphQL operation type: "query", "mutation", "subscription", or "*" for any.
	OperationType string `protobuf:"bytes,5,opt,name=operation_type,json=operationType,proto3" json:"operation_type,omitempty"`
	// GraphQL operation name glob. "*" matches any operation name.
	OperationName string `protobuf:"bytes,6,opt,name=operation_name,json=operationName,proto3" json:"operation_name,omitempty"`
	// GraphQL root field globs. Deny rules match when any selected root field
	// matches any configured glob.
	Fields []string `protobuf:"bytes,7,rep,name=fields,proto3" json:"fields,omitempty"`
	// MCP params matcher map. Currently only params.name is supported for
	// tools/call filtering. Generic protocol "json-rpc" rejects params matchers.
	Params map[string]*L7QueryMatcher `` /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

An L7 deny rule that blocks specific requests. Mirrors L7Allow — same fields, same matching semantics, inverted effect. Deny rules are evaluated after allow rules and take precedence.

func (*L7DenyRule) Descriptor deprecated

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

Deprecated: Use L7DenyRule.ProtoReflect.Descriptor instead.

func (*L7DenyRule) GetCommand

func (x *L7DenyRule) GetCommand() string

func (*L7DenyRule) GetFields

func (x *L7DenyRule) GetFields() []string

func (*L7DenyRule) GetMethod

func (x *L7DenyRule) GetMethod() string

func (*L7DenyRule) GetOperationName

func (x *L7DenyRule) GetOperationName() string

func (*L7DenyRule) GetOperationType

func (x *L7DenyRule) GetOperationType() string

func (*L7DenyRule) GetParams

func (x *L7DenyRule) GetParams() map[string]*L7QueryMatcher

func (*L7DenyRule) GetPath

func (x *L7DenyRule) GetPath() string

func (*L7DenyRule) GetQuery

func (x *L7DenyRule) GetQuery() map[string]*L7QueryMatcher

func (*L7DenyRule) ProtoMessage

func (*L7DenyRule) ProtoMessage()

func (*L7DenyRule) ProtoReflect

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

func (*L7DenyRule) Reset

func (x *L7DenyRule) Reset()

func (*L7DenyRule) String

func (x *L7DenyRule) String() string

type L7QueryMatcher

type L7QueryMatcher struct {

	// Single glob pattern.
	Glob string `protobuf:"bytes,1,opt,name=glob,proto3" json:"glob,omitempty"`
	// Any-of glob patterns.
	Any []string `protobuf:"bytes,2,rep,name=any,proto3" json:"any,omitempty"`
	// contains filtered or unexported fields
}

Query value matcher for one query parameter key.

func (*L7QueryMatcher) Descriptor deprecated

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

Deprecated: Use L7QueryMatcher.ProtoReflect.Descriptor instead.

func (*L7QueryMatcher) GetAny

func (x *L7QueryMatcher) GetAny() []string

func (*L7QueryMatcher) GetGlob

func (x *L7QueryMatcher) GetGlob() string

func (*L7QueryMatcher) ProtoMessage

func (*L7QueryMatcher) ProtoMessage()

func (*L7QueryMatcher) ProtoReflect

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

func (*L7QueryMatcher) Reset

func (x *L7QueryMatcher) Reset()

func (*L7QueryMatcher) String

func (x *L7QueryMatcher) String() string

type L7Rule

type L7Rule struct {
	Allow *L7Allow `protobuf:"bytes,1,opt,name=allow,proto3" json:"allow,omitempty"`
	// contains filtered or unexported fields
}

An L7 policy rule (allow-only).

func (*L7Rule) Descriptor deprecated

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

Deprecated: Use L7Rule.ProtoReflect.Descriptor instead.

func (*L7Rule) GetAllow

func (x *L7Rule) GetAllow() *L7Allow

func (*L7Rule) ProtoMessage

func (*L7Rule) ProtoMessage()

func (*L7Rule) ProtoReflect

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

func (*L7Rule) Reset

func (x *L7Rule) Reset()

func (*L7Rule) String

func (x *L7Rule) String() string

type LandlockPolicy

type LandlockPolicy struct {

	// Compatibility mode (e.g. "best_effort", "hard_requirement").
	Compatibility string `protobuf:"bytes,1,opt,name=compatibility,proto3" json:"compatibility,omitempty"`
	// contains filtered or unexported fields
}

Landlock policy configuration.

func (*LandlockPolicy) Descriptor deprecated

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

Deprecated: Use LandlockPolicy.ProtoReflect.Descriptor instead.

func (*LandlockPolicy) GetCompatibility

func (x *LandlockPolicy) GetCompatibility() string

func (*LandlockPolicy) ProtoMessage

func (*LandlockPolicy) ProtoMessage()

func (*LandlockPolicy) ProtoReflect

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

func (*LandlockPolicy) Reset

func (x *LandlockPolicy) Reset()

func (*LandlockPolicy) String

func (x *LandlockPolicy) String() string

type McpOptions

type McpOptions struct {

	// Hardening boundary for tools/call params.name. When unset or true, the
	// supervisor enforces the MCP recommended tool-name syntax
	// ^[A-Za-z0-9_.-]{1,128}$ before policy evaluation. Set false only for
	// compatibility with servers that intentionally use non-recommended names.
	//
	// Source:
	// - https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-names
	StrictToolNames *bool `protobuf:"varint,1,opt,name=strict_tool_names,json=strictToolNames,proto3,oneof" json:"strict_tool_names,omitempty"`
	// Method-layer default for MCP endpoints. When true, OpenShell allows parsed
	// MCP-family methods at the method layer unless a tool-name policy narrows
	// tools/call. When unset or false, explicit method rules are required.
	AllowAllKnownMcpMethods *bool `` /* 143-byte string literal not displayed */
	// Exact MCP protocol revisions accepted by the endpoint's policy schema.
	// Authors may omit this field. Because proto3 repeated fields do not retain
	// presence, omission reaches protobuf ingress as an empty list. Checked
	// normalization materializes OpenShell's pinned default revision
	// "2025-11-25" before producing canonical downstream state, which is always
	// nonempty.
	//
	// An explicit nonempty list remains an exact allowlist. Duplicates, moving
	// aliases such as "draft" and "latest", and unknown dates are invalid.
	// Normalization stores valid values in canonical semantic order. These
	// values identify core revisions; they do not enable separate SEP overlays
	// or select runtime parsing and forwarding behavior.
	Versions []string `protobuf:"bytes,3,rep,name=versions,proto3" json:"versions,omitempty"`
	// contains filtered or unexported fields
}

MCP options are grouped so MCP-specific policy can grow without adding more top-level NetworkEndpoint fields. OpenShell owns the supported revision profiles instead of treating dependency enums as the policy contract.

Sources: - https://modelcontextprotocol.io/specification/2025-03-26/basic/transports - https://modelcontextprotocol.io/specification/2025-06-18/basic/transports - https://modelcontextprotocol.io/specification/2025-11-25/basic/transports

func (*McpOptions) Descriptor deprecated

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

Deprecated: Use McpOptions.ProtoReflect.Descriptor instead.

func (*McpOptions) GetAllowAllKnownMcpMethods

func (x *McpOptions) GetAllowAllKnownMcpMethods() bool

func (*McpOptions) GetStrictToolNames

func (x *McpOptions) GetStrictToolNames() bool

func (*McpOptions) GetVersions

func (x *McpOptions) GetVersions() []string

func (*McpOptions) ProtoMessage

func (*McpOptions) ProtoMessage()

func (*McpOptions) ProtoReflect

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

func (*McpOptions) Reset

func (x *McpOptions) Reset()

func (*McpOptions) String

func (x *McpOptions) String() string

type MiddlewareEndpointSelector

type MiddlewareEndpointSelector struct {

	// Exact host or DNS glob patterns included in the selection. Include and
	// exclude accept at most 32 combined patterns.
	Include []string `protobuf:"bytes,1,rep,name=include,proto3" json:"include,omitempty"`
	// Exact host or DNS glob patterns removed from the selection.
	// Exclusions take precedence over inclusions.
	Exclude []string `protobuf:"bytes,2,rep,name=exclude,proto3" json:"exclude,omitempty"`
	// contains filtered or unexported fields
}

Host selector controlling which admitted destinations use a middleware config.

func (*MiddlewareEndpointSelector) Descriptor deprecated

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

Deprecated: Use MiddlewareEndpointSelector.ProtoReflect.Descriptor instead.

func (*MiddlewareEndpointSelector) GetExclude

func (x *MiddlewareEndpointSelector) GetExclude() []string

func (*MiddlewareEndpointSelector) GetInclude

func (x *MiddlewareEndpointSelector) GetInclude() []string

func (*MiddlewareEndpointSelector) ProtoMessage

func (*MiddlewareEndpointSelector) ProtoMessage()

func (*MiddlewareEndpointSelector) ProtoReflect

func (*MiddlewareEndpointSelector) Reset

func (x *MiddlewareEndpointSelector) Reset()

func (*MiddlewareEndpointSelector) String

func (x *MiddlewareEndpointSelector) String() string

type NetworkAccessPreset

type NetworkAccessPreset int32

Shorthand access policy for an inspected network endpoint.

const (
	// No access preset; explicit rules may define allowed traffic.
	NetworkAccessPreset_NETWORK_ACCESS_PRESET_UNSPECIFIED NetworkAccessPreset = 0
	// Allow read-only operations for the selected protocol.
	NetworkAccessPreset_NETWORK_ACCESS_PRESET_READ_ONLY NetworkAccessPreset = 1
	// Allow read and write operations for the selected protocol.
	NetworkAccessPreset_NETWORK_ACCESS_PRESET_READ_WRITE NetworkAccessPreset = 2
	// Allow every operation supported by the selected protocol.
	NetworkAccessPreset_NETWORK_ACCESS_PRESET_FULL NetworkAccessPreset = 3
)

func (NetworkAccessPreset) Descriptor

func (NetworkAccessPreset) Enum

func (NetworkAccessPreset) EnumDescriptor deprecated

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

Deprecated: Use NetworkAccessPreset.Descriptor instead.

func (NetworkAccessPreset) Number

func (NetworkAccessPreset) String

func (x NetworkAccessPreset) String() string

func (NetworkAccessPreset) Type

type NetworkBinary

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

A binary identity for network policy matching.

func (*NetworkBinary) Descriptor deprecated

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

Deprecated: Use NetworkBinary.ProtoReflect.Descriptor instead.

func (*NetworkBinary) GetPath

func (x *NetworkBinary) GetPath() string

func (*NetworkBinary) ProtoMessage

func (*NetworkBinary) ProtoMessage()

func (*NetworkBinary) ProtoReflect

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

func (*NetworkBinary) Reset

func (x *NetworkBinary) Reset()

func (*NetworkBinary) String

func (x *NetworkBinary) String() string

type NetworkCredentialBinding

type NetworkCredentialBinding struct {

	// Name of the provider attached to this sandbox whose static credentials
	// may be resolved for requests admitted by this endpoint.
	Provider string `protobuf:"bytes,1,opt,name=provider,proto3" json:"provider,omitempty"`
	// contains filtered or unexported fields
}

Binds a policy endpoint to static credentials from a sandbox provider.

func (*NetworkCredentialBinding) Descriptor deprecated

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

Deprecated: Use NetworkCredentialBinding.ProtoReflect.Descriptor instead.

func (*NetworkCredentialBinding) GetProvider

func (x *NetworkCredentialBinding) GetProvider() string

func (*NetworkCredentialBinding) ProtoMessage

func (*NetworkCredentialBinding) ProtoMessage()

func (*NetworkCredentialBinding) ProtoReflect

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

func (*NetworkCredentialBinding) Reset

func (x *NetworkCredentialBinding) Reset()

func (*NetworkCredentialBinding) String

func (x *NetworkCredentialBinding) String() string

type NetworkEndpoint

type NetworkEndpoint struct {

	// Hostname or host glob pattern. Exact match is case-insensitive.
	// Glob patterns use "." as delimiter: "*.example.com" matches a single
	// subdomain label, "**.example.com" matches across labels.
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Single port (backwards compat). Use `ports` for multiple ports.
	// Mutually exclusive with `ports` — if both are set, `ports` takes precedence.
	Port uint32 `protobuf:"varint,2,opt,name=port,proto3" json:"port,omitempty"`
	// Endpoint protocol. "tcp" and "" select L4-only handling; "rest",
	// "websocket", "graphql", "sql", "json-rpc", and "mcp" select L7 inspection.
	Protocol string `protobuf:"bytes,3,opt,name=protocol,proto3" json:"protocol,omitempty"`
	// TLS handling. Unspecified enables automatic detection and termination.
	Tls NetworkTlsMode `protobuf:"varint,4,opt,name=tls,proto3,enum=openshell.sandbox.v1.NetworkTlsMode" json:"tls,omitempty"`
	// Enforcement mode. Unspecified preserves the audit default.
	Enforcement NetworkEnforcementMode `protobuf:"varint,5,opt,name=enforcement,proto3,enum=openshell.sandbox.v1.NetworkEnforcementMode" json:"enforcement,omitempty"`
	// Access preset shorthand. Unspecified means no preset.
	// Mutually exclusive with rules.
	Access NetworkAccessPreset `protobuf:"varint,6,opt,name=access,proto3,enum=openshell.sandbox.v1.NetworkAccessPreset" json:"access,omitempty"`
	// Explicit L7 rules (mutually exclusive with access).
	Rules []*L7Rule `protobuf:"bytes,7,rep,name=rules,proto3" json:"rules,omitempty"`
	// Allowed resolved IP addresses or CIDR ranges for this endpoint.
	// When non-empty, the SSRF internal-IP check is replaced by an allowlist check:
	//   - If host is also set: domain must resolve to an IP in this list.
	//   - If host is empty: any domain is allowed as long as it resolves to an IP in this list.
	//
	// Supports exact IPs ("10.0.5.20") and CIDR notation ("10.0.5.0/24").
	// Loopback (127.0.0.0/8) and link-local (169.254.0.0/16) are always blocked
	// regardless of this field.
	AllowedIps []string `protobuf:"bytes,8,rep,name=allowed_ips,json=allowedIps,proto3" json:"allowed_ips,omitempty"`
	// Multiple ports. When non-empty, this endpoint covers all listed ports.
	// If `port` is set and `ports` is empty, `port` is normalized to `ports: [port]`.
	// If both are set, `ports` takes precedence.
	Ports []uint32 `protobuf:"varint,9,rep,packed,name=ports,proto3" json:"ports,omitempty"`
	// Explicit L7 deny rules. When present, requests matching any deny rule
	// are blocked even if they match an allow rule or access preset.
	// Deny rules take precedence over allow rules.
	DenyRules []*L7DenyRule `protobuf:"bytes,10,rep,name=deny_rules,json=denyRules,proto3" json:"deny_rules,omitempty"`
	// When true, percent-encoded '/' (%2F) is preserved in path segments
	// rather than rejected by the L7 path canonicalizer. Required for
	// upstreams like GitLab that embed %2F in namespaced resource paths.
	// Defaults to false (strict).
	AllowEncodedSlash bool `protobuf:"varint,11,opt,name=allow_encoded_slash,json=allowEncodedSlash,proto3" json:"allow_encoded_slash,omitempty"`
	// GraphQL persisted-query behavior for hash-only/saved-query requests:
	// "deny" (default) or "allow_registered".
	PersistedQueries string `protobuf:"bytes,12,opt,name=persisted_queries,json=persistedQueries,proto3" json:"persisted_queries,omitempty"`
	// Trusted GraphQL persisted-query registry keyed by hash or service-specific ID.
	// Only used when persisted_queries is "allow_registered".
	GraphqlPersistedQueries map[string]*GraphqlOperation `` /* 207-byte string literal not displayed */
	// Maximum GraphQL request body bytes to buffer for inspection.
	// Defaults to 65536 when unset.
	GraphqlMaxBodyBytes uint32 `protobuf:"varint,14,opt,name=graphql_max_body_bytes,json=graphqlMaxBodyBytes,proto3" json:"graphql_max_body_bytes,omitempty"`
	// Optional HTTP path glob that scopes this L7 endpoint on shared host:port APIs.
	// Example: use path "/graphql" for protocol "graphql" and "/repos/**" for
	// protocol "rest" when both surfaces live under api.example.com:443.
	// Empty means all paths.
	Path string `protobuf:"bytes,15,opt,name=path,proto3" json:"path,omitempty"`
	// When true on a "rest" endpoint, OpenShell rewrites credential placeholders
	// inside client-to-server WebSocket text messages after an allowed HTTP 101
	// upgrade. Defaults to false.
	WebsocketCredentialRewrite bool `` /* 143-byte string literal not displayed */
	// When true on a "rest" endpoint, OpenShell rewrites credential placeholders
	// inside supported textual HTTP request bodies before forwarding upstream.
	// Defaults to false.
	RequestBodyCredentialRewrite bool `` /* 151-byte string literal not displayed */
	// Internal provenance marker for policy-advisor generated endpoints.
	// Advisor-proposed endpoints must not satisfy exact-host SSRF trust unless
	// they are converted through an explicit user-authored policy path.
	AdvisorProposed bool `protobuf:"varint,18,opt,name=advisor_proposed,json=advisorProposed,proto3" json:"advisor_proposed,omitempty"`
	// Proxy-side credential signing mode: "sigv4" for AWS SigV4 re-signing.
	// When set, the proxy strips the client's Authorization header and computes
	// a fresh SigV4 signature using real credentials from the provider.
	CredentialSigning string `protobuf:"bytes,19,opt,name=credential_signing,json=credentialSigning,proto3" json:"credential_signing,omitempty"`
	// AWS signing service name override. Required when credential_signing is
	// "sigv4" — e.g. "bedrock" for bedrock-runtime endpoints.
	SigningService string `protobuf:"bytes,20,opt,name=signing_service,json=signingService,proto3" json:"signing_service,omitempty"`
	// AWS region override for SigV4 signing. When set, takes precedence over
	// hostname-based region extraction. Required for non-standard endpoints.
	SigningRegion string `protobuf:"bytes,21,opt,name=signing_region,json=signingRegion,proto3" json:"signing_region,omitempty"`
	// Maximum JSON-RPC-over-HTTP request body bytes to buffer for inspection.
	// Defaults to 65536 when unset.
	JsonRpcMaxBodyBytes uint32 `` /* 126-byte string literal not displayed */
	// MCP-only policy and inspection options. Only used when protocol is "mcp".
	Mcp *McpOptions `protobuf:"bytes,23,opt,name=mcp,proto3" json:"mcp,omitempty"`
	// Explicit binding authority for static credentials from an attached
	// endpointless provider profile. Profiles that already define endpoints
	// continue to use those profile endpoints as their credential boundary.
	CredentialBinding *NetworkCredentialBinding `protobuf:"bytes,24,opt,name=credential_binding,json=credentialBinding,proto3" json:"credential_binding,omitempty"`
	// Explicitly permits credential-bearing traffic to use paths that OpenShell
	// cannot inspect or rewrite. Defaults to false. This is a security-sensitive
	// escape hatch and must be explicitly approved.
	AllowUninspectedCredentials bool `` /* 146-byte string literal not displayed */
	// Internal gateway-derived marker indicating that this endpoint belongs to
	// an attached credentialed provider. User-authored values are ignored.
	ProviderCredentialed bool `protobuf:"varint,26,opt,name=provider_credentialed,json=providerCredentialed,proto3" json:"provider_credentialed,omitempty"`
	// Internal gateway-derived identity of this endpoint's token-grant authority.
	// It binds the provider record and complete profile policy, or the active
	// global policy, to this endpoint. User-authored values are ignored.
	TokenGrantOwner string `protobuf:"bytes,27,opt,name=token_grant_owner,json=tokenGrantOwner,proto3" json:"token_grant_owner,omitempty"`
	// contains filtered or unexported fields
}

A network endpoint (host + port) with optional L7 inspection config.

func (*NetworkEndpoint) Descriptor deprecated

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

Deprecated: Use NetworkEndpoint.ProtoReflect.Descriptor instead.

func (*NetworkEndpoint) GetAccess

func (x *NetworkEndpoint) GetAccess() NetworkAccessPreset

func (*NetworkEndpoint) GetAdvisorProposed

func (x *NetworkEndpoint) GetAdvisorProposed() bool

func (*NetworkEndpoint) GetAllowEncodedSlash

func (x *NetworkEndpoint) GetAllowEncodedSlash() bool

func (*NetworkEndpoint) GetAllowUninspectedCredentials

func (x *NetworkEndpoint) GetAllowUninspectedCredentials() bool

func (*NetworkEndpoint) GetAllowedIps

func (x *NetworkEndpoint) GetAllowedIps() []string

func (*NetworkEndpoint) GetCredentialBinding

func (x *NetworkEndpoint) GetCredentialBinding() *NetworkCredentialBinding

func (*NetworkEndpoint) GetCredentialSigning

func (x *NetworkEndpoint) GetCredentialSigning() string

func (*NetworkEndpoint) GetDenyRules

func (x *NetworkEndpoint) GetDenyRules() []*L7DenyRule

func (*NetworkEndpoint) GetEnforcement

func (x *NetworkEndpoint) GetEnforcement() NetworkEnforcementMode

func (*NetworkEndpoint) GetGraphqlMaxBodyBytes

func (x *NetworkEndpoint) GetGraphqlMaxBodyBytes() uint32

func (*NetworkEndpoint) GetGraphqlPersistedQueries

func (x *NetworkEndpoint) GetGraphqlPersistedQueries() map[string]*GraphqlOperation

func (*NetworkEndpoint) GetHost

func (x *NetworkEndpoint) GetHost() string

func (*NetworkEndpoint) GetJsonRpcMaxBodyBytes

func (x *NetworkEndpoint) GetJsonRpcMaxBodyBytes() uint32

func (*NetworkEndpoint) GetMcp

func (x *NetworkEndpoint) GetMcp() *McpOptions

func (*NetworkEndpoint) GetPath

func (x *NetworkEndpoint) GetPath() string

func (*NetworkEndpoint) GetPersistedQueries

func (x *NetworkEndpoint) GetPersistedQueries() string

func (*NetworkEndpoint) GetPort

func (x *NetworkEndpoint) GetPort() uint32

func (*NetworkEndpoint) GetPorts

func (x *NetworkEndpoint) GetPorts() []uint32

func (*NetworkEndpoint) GetProtocol

func (x *NetworkEndpoint) GetProtocol() string

func (*NetworkEndpoint) GetProviderCredentialed

func (x *NetworkEndpoint) GetProviderCredentialed() bool

func (*NetworkEndpoint) GetRequestBodyCredentialRewrite

func (x *NetworkEndpoint) GetRequestBodyCredentialRewrite() bool

func (*NetworkEndpoint) GetRules

func (x *NetworkEndpoint) GetRules() []*L7Rule

func (*NetworkEndpoint) GetSigningRegion

func (x *NetworkEndpoint) GetSigningRegion() string

func (*NetworkEndpoint) GetSigningService

func (x *NetworkEndpoint) GetSigningService() string

func (*NetworkEndpoint) GetTls

func (x *NetworkEndpoint) GetTls() NetworkTlsMode

func (*NetworkEndpoint) GetTokenGrantOwner

func (x *NetworkEndpoint) GetTokenGrantOwner() string

func (*NetworkEndpoint) GetWebsocketCredentialRewrite

func (x *NetworkEndpoint) GetWebsocketCredentialRewrite() bool

func (*NetworkEndpoint) ProtoMessage

func (*NetworkEndpoint) ProtoMessage()

func (*NetworkEndpoint) ProtoReflect

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

func (*NetworkEndpoint) Reset

func (x *NetworkEndpoint) Reset()

func (*NetworkEndpoint) String

func (x *NetworkEndpoint) String() string

type NetworkEnforcementMode

type NetworkEnforcementMode int32

Enforcement behavior for inspected network traffic.

const (
	// Preserve the existing default: log violations and allow traffic.
	NetworkEnforcementMode_NETWORK_ENFORCEMENT_MODE_UNSPECIFIED NetworkEnforcementMode = 0
	// Deny traffic that does not satisfy the endpoint policy.
	NetworkEnforcementMode_NETWORK_ENFORCEMENT_MODE_ENFORCE NetworkEnforcementMode = 1
	// Log policy violations and allow the traffic.
	NetworkEnforcementMode_NETWORK_ENFORCEMENT_MODE_AUDIT NetworkEnforcementMode = 2
)

func (NetworkEnforcementMode) Descriptor

func (NetworkEnforcementMode) Enum

func (NetworkEnforcementMode) EnumDescriptor deprecated

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

Deprecated: Use NetworkEnforcementMode.Descriptor instead.

func (NetworkEnforcementMode) Number

func (NetworkEnforcementMode) String

func (x NetworkEnforcementMode) String() string

func (NetworkEnforcementMode) Type

type NetworkMiddlewareConfig

type NetworkMiddlewareConfig struct {

	// Human-readable name for this middleware config.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Built-in middleware name or operator-owned registration name.
	Middleware string `protobuf:"bytes,2,opt,name=middleware,proto3" json:"middleware,omitempty"`
	// Service-specific configuration.
	Config *structpb.Struct `protobuf:"bytes,3,opt,name=config,proto3" json:"config,omitempty"`
	// Failure behavior: "fail_closed" (default) or "fail_open".
	OnError string `protobuf:"bytes,4,opt,name=on_error,json=onError,proto3" json:"on_error,omitempty"`
	// Host selector controlling which admitted destinations use this config.
	Endpoints *MiddlewareEndpointSelector `protobuf:"bytes,5,opt,name=endpoints,proto3" json:"endpoints,omitempty"`
	// Execution order. Values must be unique within a policy; lower values run first.
	Order int32 `protobuf:"varint,6,opt,name=order,proto3" json:"order,omitempty"`
	// contains filtered or unexported fields
}

A reusable middleware config selected for admitted egress by host.

func (*NetworkMiddlewareConfig) Descriptor deprecated

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

Deprecated: Use NetworkMiddlewareConfig.ProtoReflect.Descriptor instead.

func (*NetworkMiddlewareConfig) GetConfig

func (x *NetworkMiddlewareConfig) GetConfig() *structpb.Struct

func (*NetworkMiddlewareConfig) GetEndpoints

func (*NetworkMiddlewareConfig) GetMiddleware

func (x *NetworkMiddlewareConfig) GetMiddleware() string

func (*NetworkMiddlewareConfig) GetName

func (x *NetworkMiddlewareConfig) GetName() string

func (*NetworkMiddlewareConfig) GetOnError

func (x *NetworkMiddlewareConfig) GetOnError() string

func (*NetworkMiddlewareConfig) GetOrder

func (x *NetworkMiddlewareConfig) GetOrder() int32

func (*NetworkMiddlewareConfig) ProtoMessage

func (*NetworkMiddlewareConfig) ProtoMessage()

func (*NetworkMiddlewareConfig) ProtoReflect

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

func (*NetworkMiddlewareConfig) Reset

func (x *NetworkMiddlewareConfig) Reset()

func (*NetworkMiddlewareConfig) String

func (x *NetworkMiddlewareConfig) String() string

type NetworkPolicyRule

type NetworkPolicyRule struct {

	// Human-readable name for this policy rule.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Allowed endpoint (host:port) pairs.
	Endpoints []*NetworkEndpoint `protobuf:"bytes,2,rep,name=endpoints,proto3" json:"endpoints,omitempty"`
	// Allowed binary identities.
	Binaries []*NetworkBinary `protobuf:"bytes,3,rep,name=binaries,proto3" json:"binaries,omitempty"`
	// contains filtered or unexported fields
}

A named network access policy rule.

func (*NetworkPolicyRule) Descriptor deprecated

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

Deprecated: Use NetworkPolicyRule.ProtoReflect.Descriptor instead.

func (*NetworkPolicyRule) GetBinaries

func (x *NetworkPolicyRule) GetBinaries() []*NetworkBinary

func (*NetworkPolicyRule) GetEndpoints

func (x *NetworkPolicyRule) GetEndpoints() []*NetworkEndpoint

func (*NetworkPolicyRule) GetName

func (x *NetworkPolicyRule) GetName() string

func (*NetworkPolicyRule) ProtoMessage

func (*NetworkPolicyRule) ProtoMessage()

func (*NetworkPolicyRule) ProtoReflect

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

func (*NetworkPolicyRule) Reset

func (x *NetworkPolicyRule) Reset()

func (*NetworkPolicyRule) String

func (x *NetworkPolicyRule) String() string

type NetworkTlsMode

type NetworkTlsMode int32

TLS handling for a network endpoint.

const (
	// Auto-detect TLS and terminate it when inspection is configured.
	NetworkTlsMode_NETWORK_TLS_MODE_UNSPECIFIED NetworkTlsMode = 0
	// Disable TLS detection and relay the connection without inspection.
	NetworkTlsMode_NETWORK_TLS_MODE_SKIP NetworkTlsMode = 1
	// Rejected by policy validation; use NETWORK_TLS_MODE_UNSPECIFIED.
	//
	// Deprecated: Marked as deprecated in sandbox.proto.
	NetworkTlsMode_NETWORK_TLS_MODE_TERMINATE NetworkTlsMode = 2
	// Rejected by policy validation; use NETWORK_TLS_MODE_UNSPECIFIED.
	//
	// Deprecated: Marked as deprecated in sandbox.proto.
	NetworkTlsMode_NETWORK_TLS_MODE_PASSTHROUGH NetworkTlsMode = 3
)

func (NetworkTlsMode) Descriptor

func (NetworkTlsMode) Enum

func (x NetworkTlsMode) Enum() *NetworkTlsMode

func (NetworkTlsMode) EnumDescriptor deprecated

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

Deprecated: Use NetworkTlsMode.Descriptor instead.

func (NetworkTlsMode) Number

func (NetworkTlsMode) String

func (x NetworkTlsMode) String() string

func (NetworkTlsMode) Type

type PolicySource

type PolicySource int32

Source used for a sandbox configuration payload.

const (
	PolicySource_POLICY_SOURCE_UNSPECIFIED PolicySource = 0
	PolicySource_POLICY_SOURCE_SANDBOX     PolicySource = 1
	PolicySource_POLICY_SOURCE_GLOBAL      PolicySource = 2
)

func (PolicySource) Descriptor

func (PolicySource) Enum

func (x PolicySource) Enum() *PolicySource

func (PolicySource) EnumDescriptor deprecated

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

Deprecated: Use PolicySource.Descriptor instead.

func (PolicySource) Number

func (PolicySource) String

func (x PolicySource) String() string

func (PolicySource) Type

type ProcessPolicy

type ProcessPolicy struct {

	// User name to run the sandboxed process as.
	RunAsUser string `protobuf:"bytes,1,opt,name=run_as_user,json=runAsUser,proto3" json:"run_as_user,omitempty"`
	// Group name to run the sandboxed process as.
	RunAsGroup string `protobuf:"bytes,2,opt,name=run_as_group,json=runAsGroup,proto3" json:"run_as_group,omitempty"`
	// contains filtered or unexported fields
}

Process execution policy.

func (*ProcessPolicy) Descriptor deprecated

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

Deprecated: Use ProcessPolicy.ProtoReflect.Descriptor instead.

func (*ProcessPolicy) GetRunAsGroup

func (x *ProcessPolicy) GetRunAsGroup() string

func (*ProcessPolicy) GetRunAsUser

func (x *ProcessPolicy) GetRunAsUser() string

func (*ProcessPolicy) ProtoMessage

func (*ProcessPolicy) ProtoMessage()

func (*ProcessPolicy) ProtoReflect

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

func (*ProcessPolicy) Reset

func (x *ProcessPolicy) Reset()

func (*ProcessPolicy) String

func (x *ProcessPolicy) String() string

type SandboxConfigSnapshot

type SandboxConfigSnapshot struct {
	Policy                         *SandboxPolicy                 `protobuf:"bytes,1,opt,name=policy,proto3" json:"policy,omitempty"`
	Version                        uint32                         `protobuf:"varint,2,opt,name=version,proto3" json:"version,omitempty"`
	PolicyHash                     string                         `protobuf:"bytes,3,opt,name=policy_hash,json=policyHash,proto3" json:"policy_hash,omitempty"`
	Settings                       map[string]*EffectiveSetting   `` /* 143-byte string literal not displayed */
	ConfigRevision                 uint64                         `protobuf:"varint,5,opt,name=config_revision,json=configRevision,proto3" json:"config_revision,omitempty"`
	PolicySource                   PolicySource                   `` /* 137-byte string literal not displayed */
	GlobalPolicyVersion            uint32                         `protobuf:"varint,7,opt,name=global_policy_version,json=globalPolicyVersion,proto3" json:"global_policy_version,omitempty"`
	ProviderEnvRevision            uint64                         `protobuf:"varint,8,opt,name=provider_env_revision,json=providerEnvRevision,proto3" json:"provider_env_revision,omitempty"`
	SupervisorMiddlewareServices   []*SupervisorMiddlewareService `` /* 147-byte string literal not displayed */
	Workspace                      string                         `protobuf:"bytes,10,opt,name=workspace,proto3" json:"workspace,omitempty"`
	PolicyValidationFailureMode    string                         `` /* 147-byte string literal not displayed */
	ExtensionAuthenticationEnabled bool                           `` /* 155-byte string literal not displayed */
	ConfigurationAdmitted          bool                           `` /* 126-byte string literal not displayed */
	ProviderAttachmentEpoch        string                         `` /* 133-byte string literal not displayed */
	ConfigurationInstanceId        string                         `` /* 133-byte string literal not displayed */
	ConfigurationError             string                         `protobuf:"bytes,16,opt,name=configuration_error,json=configurationError,proto3" json:"configuration_error,omitempty"`
	SettingsRevision               uint64                         `protobuf:"varint,17,opt,name=settings_revision,json=settingsRevision,proto3" json:"settings_revision,omitempty"`
	// Explicit application ingress allowlist. Absent means no app routes.
	ServiceRoutes []*SandboxServiceRoute `protobuf:"bytes,18,rep,name=service_routes,json=serviceRoutes,proto3" json:"service_routes,omitempty"`
	// contains filtered or unexported fields
}

Complete effective sandbox configuration delivered to a supervisor. Fields have the same meaning as the identically numbered GetSandboxConfigResponse fields, including fail-closed handling of an unknown policy_validation_failure_mode and treating absent configuration_admitted as not admitted. Move those field comments here when the polling RPC is removed.

func (*SandboxConfigSnapshot) Descriptor deprecated

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

Deprecated: Use SandboxConfigSnapshot.ProtoReflect.Descriptor instead.

func (*SandboxConfigSnapshot) GetConfigRevision

func (x *SandboxConfigSnapshot) GetConfigRevision() uint64

func (*SandboxConfigSnapshot) GetConfigurationAdmitted

func (x *SandboxConfigSnapshot) GetConfigurationAdmitted() bool

func (*SandboxConfigSnapshot) GetConfigurationError

func (x *SandboxConfigSnapshot) GetConfigurationError() string

func (*SandboxConfigSnapshot) GetConfigurationInstanceId

func (x *SandboxConfigSnapshot) GetConfigurationInstanceId() string

func (*SandboxConfigSnapshot) GetExtensionAuthenticationEnabled

func (x *SandboxConfigSnapshot) GetExtensionAuthenticationEnabled() bool

func (*SandboxConfigSnapshot) GetGlobalPolicyVersion

func (x *SandboxConfigSnapshot) GetGlobalPolicyVersion() uint32

func (*SandboxConfigSnapshot) GetPolicy

func (x *SandboxConfigSnapshot) GetPolicy() *SandboxPolicy

func (*SandboxConfigSnapshot) GetPolicyHash

func (x *SandboxConfigSnapshot) GetPolicyHash() string

func (*SandboxConfigSnapshot) GetPolicySource

func (x *SandboxConfigSnapshot) GetPolicySource() PolicySource

func (*SandboxConfigSnapshot) GetPolicyValidationFailureMode

func (x *SandboxConfigSnapshot) GetPolicyValidationFailureMode() string

func (*SandboxConfigSnapshot) GetProviderAttachmentEpoch

func (x *SandboxConfigSnapshot) GetProviderAttachmentEpoch() string

func (*SandboxConfigSnapshot) GetProviderEnvRevision

func (x *SandboxConfigSnapshot) GetProviderEnvRevision() uint64

func (*SandboxConfigSnapshot) GetServiceRoutes added in v0.1.7

func (x *SandboxConfigSnapshot) GetServiceRoutes() []*SandboxServiceRoute

func (*SandboxConfigSnapshot) GetSettings

func (x *SandboxConfigSnapshot) GetSettings() map[string]*EffectiveSetting

func (*SandboxConfigSnapshot) GetSettingsRevision

func (x *SandboxConfigSnapshot) GetSettingsRevision() uint64

func (*SandboxConfigSnapshot) GetSupervisorMiddlewareServices

func (x *SandboxConfigSnapshot) GetSupervisorMiddlewareServices() []*SupervisorMiddlewareService

func (*SandboxConfigSnapshot) GetVersion

func (x *SandboxConfigSnapshot) GetVersion() uint32

func (*SandboxConfigSnapshot) GetWorkspace

func (x *SandboxConfigSnapshot) GetWorkspace() string

func (*SandboxConfigSnapshot) ProtoMessage

func (*SandboxConfigSnapshot) ProtoMessage()

func (*SandboxConfigSnapshot) ProtoReflect

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

func (*SandboxConfigSnapshot) Reset

func (x *SandboxConfigSnapshot) Reset()

func (*SandboxConfigSnapshot) String

func (x *SandboxConfigSnapshot) String() string

type SandboxPolicy

type SandboxPolicy struct {

	// Policy version.
	Version uint32 `protobuf:"varint,1,opt,name=version,proto3" json:"version,omitempty"`
	// Filesystem access policy.
	Filesystem *FilesystemPolicy `protobuf:"bytes,2,opt,name=filesystem,proto3" json:"filesystem,omitempty"`
	// Landlock configuration.
	Landlock *LandlockPolicy `protobuf:"bytes,3,opt,name=landlock,proto3" json:"landlock,omitempty"`
	// Process execution policy.
	Process *ProcessPolicy `protobuf:"bytes,4,opt,name=process,proto3" json:"process,omitempty"`
	// Network access policies keyed by name (e.g. "claude_code", "gitlab").
	NetworkPolicies map[string]*NetworkPolicyRule `` /* 180-byte string literal not displayed */
	// Reusable supervisor middleware configs for network egress, keyed by their
	// policy-local names. At most 10 configs are accepted, and at most 10 stages
	// can be selected per request.
	NetworkMiddlewares map[string]*NetworkMiddlewareConfig `` /* 189-byte string literal not displayed */
	// contains filtered or unexported fields
}

Sandbox security policy configuration.

func (*SandboxPolicy) Descriptor deprecated

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

Deprecated: Use SandboxPolicy.ProtoReflect.Descriptor instead.

func (*SandboxPolicy) GetFilesystem

func (x *SandboxPolicy) GetFilesystem() *FilesystemPolicy

func (*SandboxPolicy) GetLandlock

func (x *SandboxPolicy) GetLandlock() *LandlockPolicy

func (*SandboxPolicy) GetNetworkMiddlewares

func (x *SandboxPolicy) GetNetworkMiddlewares() map[string]*NetworkMiddlewareConfig

func (*SandboxPolicy) GetNetworkPolicies

func (x *SandboxPolicy) GetNetworkPolicies() map[string]*NetworkPolicyRule

func (*SandboxPolicy) GetProcess

func (x *SandboxPolicy) GetProcess() *ProcessPolicy

func (*SandboxPolicy) GetVersion

func (x *SandboxPolicy) GetVersion() uint32

func (*SandboxPolicy) ProtoMessage

func (*SandboxPolicy) ProtoMessage()

func (*SandboxPolicy) ProtoReflect

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

func (*SandboxPolicy) Reset

func (x *SandboxPolicy) Reset()

func (*SandboxPolicy) String

func (x *SandboxPolicy) String() string

type SandboxServiceRoute added in v0.1.7

type SandboxServiceRoute struct {
	EndpointId        string `protobuf:"bytes,1,opt,name=endpoint_id,json=endpointId,proto3" json:"endpoint_id,omitempty"`
	Name              string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	TargetPort        uint32 `protobuf:"varint,3,opt,name=target_port,json=targetPort,proto3" json:"target_port,omitempty"`
	AuthorizationMode int32  `protobuf:"varint,4,opt,name=authorization_mode,json=authorizationMode,proto3" json:"authorization_mode,omitempty"`
	ResourceVersion   uint64 `protobuf:"varint,5,opt,name=resource_version,json=resourceVersion,proto3" json:"resource_version,omitempty"`
	// contains filtered or unexported fields
}

Gateway-declared service installed by a supervisor; this does not grant access to arbitrary workload ports or assert application health.

func (*SandboxServiceRoute) Descriptor deprecated added in v0.1.7

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

Deprecated: Use SandboxServiceRoute.ProtoReflect.Descriptor instead.

func (*SandboxServiceRoute) GetAuthorizationMode added in v0.1.7

func (x *SandboxServiceRoute) GetAuthorizationMode() int32

func (*SandboxServiceRoute) GetEndpointId added in v0.1.7

func (x *SandboxServiceRoute) GetEndpointId() string

func (*SandboxServiceRoute) GetName added in v0.1.7

func (x *SandboxServiceRoute) GetName() string

func (*SandboxServiceRoute) GetResourceVersion added in v0.1.7

func (x *SandboxServiceRoute) GetResourceVersion() uint64

func (*SandboxServiceRoute) GetTargetPort added in v0.1.7

func (x *SandboxServiceRoute) GetTargetPort() uint32

func (*SandboxServiceRoute) ProtoMessage added in v0.1.7

func (*SandboxServiceRoute) ProtoMessage()

func (*SandboxServiceRoute) ProtoReflect added in v0.1.7

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

func (*SandboxServiceRoute) Reset added in v0.1.7

func (x *SandboxServiceRoute) Reset()

func (*SandboxServiceRoute) String added in v0.1.7

func (x *SandboxServiceRoute) String() string

type SettingScope

type SettingScope int32

Scope that currently controls a setting.

const (
	SettingScope_SETTING_SCOPE_UNSPECIFIED SettingScope = 0
	SettingScope_SETTING_SCOPE_SANDBOX     SettingScope = 1
	SettingScope_SETTING_SCOPE_GLOBAL      SettingScope = 2
)

func (SettingScope) Descriptor

func (SettingScope) Enum

func (x SettingScope) Enum() *SettingScope

func (SettingScope) EnumDescriptor deprecated

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

Deprecated: Use SettingScope.Descriptor instead.

func (SettingScope) Number

func (SettingScope) String

func (x SettingScope) String() string

func (SettingScope) Type

type SettingValue

type SettingValue struct {

	// Types that are valid to be assigned to Value:
	//
	//	*SettingValue_StringValue
	//	*SettingValue_BoolValue
	//	*SettingValue_IntValue
	//	*SettingValue_BytesValue
	Value isSettingValue_Value `protobuf_oneof:"value"`
	// contains filtered or unexported fields
}

Type-aware setting value for sandbox/gateway settings.

func (*SettingValue) Descriptor deprecated

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

Deprecated: Use SettingValue.ProtoReflect.Descriptor instead.

func (*SettingValue) GetBoolValue

func (x *SettingValue) GetBoolValue() bool

func (*SettingValue) GetBytesValue

func (x *SettingValue) GetBytesValue() []byte

func (*SettingValue) GetIntValue

func (x *SettingValue) GetIntValue() int64

func (*SettingValue) GetStringValue

func (x *SettingValue) GetStringValue() string

func (*SettingValue) GetValue

func (x *SettingValue) GetValue() isSettingValue_Value

func (*SettingValue) ProtoMessage

func (*SettingValue) ProtoMessage()

func (*SettingValue) ProtoReflect

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

func (*SettingValue) Reset

func (x *SettingValue) Reset()

func (*SettingValue) String

func (x *SettingValue) String() string

type SettingValue_BoolValue

type SettingValue_BoolValue struct {
	BoolValue bool `protobuf:"varint,2,opt,name=bool_value,json=boolValue,proto3,oneof"`
}

type SettingValue_BytesValue

type SettingValue_BytesValue struct {
	BytesValue []byte `protobuf:"bytes,4,opt,name=bytes_value,json=bytesValue,proto3,oneof"`
}

type SettingValue_IntValue

type SettingValue_IntValue struct {
	IntValue int64 `protobuf:"varint,3,opt,name=int_value,json=intValue,proto3,oneof"`
}

type SettingValue_StringValue

type SettingValue_StringValue struct {
	StringValue string `protobuf:"bytes,1,opt,name=string_value,json=stringValue,proto3,oneof"`
}

type SupervisorMiddlewareBinding

type SupervisorMiddlewareBinding int32

An operation/phase pair that the platform can authorize. These identify platform capabilities, not service-owned binding names.

const (
	SupervisorMiddlewareBinding_SUPERVISOR_MIDDLEWARE_BINDING_UNSPECIFIED                       SupervisorMiddlewareBinding = 0
	SupervisorMiddlewareBinding_SUPERVISOR_MIDDLEWARE_BINDING_HTTP_REQUEST_PRE_CREDENTIALS      SupervisorMiddlewareBinding = 1
	SupervisorMiddlewareBinding_SUPERVISOR_MIDDLEWARE_BINDING_HTTP_RESPONSE_PRE_RETURN          SupervisorMiddlewareBinding = 2
	SupervisorMiddlewareBinding_SUPERVISOR_MIDDLEWARE_BINDING_WEBSOCKET_MESSAGE_PRE_CREDENTIALS SupervisorMiddlewareBinding = 3
)

func (SupervisorMiddlewareBinding) Descriptor

func (SupervisorMiddlewareBinding) Enum

func (SupervisorMiddlewareBinding) EnumDescriptor deprecated

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

Deprecated: Use SupervisorMiddlewareBinding.Descriptor instead.

func (SupervisorMiddlewareBinding) Number

func (SupervisorMiddlewareBinding) String

func (SupervisorMiddlewareBinding) Type

type SupervisorMiddlewareBindingPolicy

type SupervisorMiddlewareBindingPolicy int32

Operator authority over the bindings in a supervisor middleware manifest.

const (
	// Older gateways omit this field, which selects dynamic discovery.
	SupervisorMiddlewareBindingPolicy_SUPERVISOR_MIDDLEWARE_BINDING_POLICY_UNSPECIFIED SupervisorMiddlewareBindingPolicy = 0
	// Accept all supported bindings in the manifest.
	SupervisorMiddlewareBindingPolicy_SUPERVISOR_MIDDLEWARE_BINDING_POLICY_DYNAMIC SupervisorMiddlewareBindingPolicy = 1
	// Require and enable the listed bindings; ignore other supported bindings.
	SupervisorMiddlewareBindingPolicy_SUPERVISOR_MIDDLEWARE_BINDING_POLICY_ALLOWLIST SupervisorMiddlewareBindingPolicy = 2
	// Require the listed bindings and reject additional bindings.
	SupervisorMiddlewareBindingPolicy_SUPERVISOR_MIDDLEWARE_BINDING_POLICY_EXACT SupervisorMiddlewareBindingPolicy = 3
)

func (SupervisorMiddlewareBindingPolicy) Descriptor

func (SupervisorMiddlewareBindingPolicy) Enum

func (SupervisorMiddlewareBindingPolicy) EnumDescriptor deprecated

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

Deprecated: Use SupervisorMiddlewareBindingPolicy.Descriptor instead.

func (SupervisorMiddlewareBindingPolicy) Number

func (SupervisorMiddlewareBindingPolicy) String

func (SupervisorMiddlewareBindingPolicy) Type

type SupervisorMiddlewareService

type SupervisorMiddlewareService struct {

	// Operator-owned registration name used by policy attachments and diagnostics.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// gRPC endpoint reachable from the sandbox supervisor.
	GrpcEndpoint string `protobuf:"bytes,2,opt,name=grpc_endpoint,json=grpcEndpoint,proto3" json:"grpc_endpoint,omitempty"`
	// Operator-owned logical payload limit applied to every binding exposed by
	// the service. This caps HTTP bodies and complete WebSocket messages.
	MaxPayloadBytes uint64 `protobuf:"varint,3,opt,name=max_payload_bytes,json=maxPayloadBytes,proto3" json:"max_payload_bytes,omitempty"`
	// Default RPC timeout for this service. Absence uses the platform default of
	// 500ms. Values must be between 10ms and 30s.
	RequestTimeout *durationpb.Duration `protobuf:"bytes,104,opt,name=request_timeout,json=requestTimeout,proto3" json:"request_timeout,omitempty"`
	// PEM-encoded trust roots loaded by the gateway from the operator-configured
	// tls_ca_cert_path. Empty uses the platform trust store.
	TlsCaCertPem []byte `protobuf:"bytes,5,opt,name=tls_ca_cert_pem,json=tlsCaCertPem,proto3" json:"tls_ca_cert_pem,omitempty"`
	// Exact JWT audience for this service. The gateway resolves an omitted
	// operator value to a kind-scoped audience derived from the registration
	// name before sending sandbox config.
	Audience string `protobuf:"bytes,6,opt,name=audience,proto3" json:"audience,omitempty"`
	// Operator opt-out from extension authentication for this registration.
	// When true the service may use a plaintext endpoint and OpenShell attaches
	// no bearer credential; supervisors must not request one. Intended only for
	// trusted-network development deployments.
	AllowInsecureTransport bool `` /* 130-byte string literal not displayed */
	// How the gateway and supervisor authorize the bindings returned by Describe.
	// Absence preserves dynamic discovery. A supervisor predating this field
	// cannot enforce a binding policy; upgrade supervisors before requiring one.
	BindingPolicy SupervisorMiddlewareBindingPolicy `` /* 161-byte string literal not displayed */
	// Operation/phase pairs required by an allowlist or exact policy. Every
	// listed binding must be advertised, and only listed bindings may run.
	Bindings []SupervisorMiddlewareBinding `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

Connection details for one operator-registered supervisor middleware service. V1 supports plaintext and server-authenticated TLS gRPC.

func (*SupervisorMiddlewareService) Descriptor deprecated

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

Deprecated: Use SupervisorMiddlewareService.ProtoReflect.Descriptor instead.

func (*SupervisorMiddlewareService) GetAllowInsecureTransport

func (x *SupervisorMiddlewareService) GetAllowInsecureTransport() bool

func (*SupervisorMiddlewareService) GetAudience

func (x *SupervisorMiddlewareService) GetAudience() string

func (*SupervisorMiddlewareService) GetBindingPolicy

func (*SupervisorMiddlewareService) GetBindings

func (*SupervisorMiddlewareService) GetGrpcEndpoint

func (x *SupervisorMiddlewareService) GetGrpcEndpoint() string

func (*SupervisorMiddlewareService) GetMaxPayloadBytes

func (x *SupervisorMiddlewareService) GetMaxPayloadBytes() uint64

func (*SupervisorMiddlewareService) GetName

func (x *SupervisorMiddlewareService) GetName() string

func (*SupervisorMiddlewareService) GetRequestTimeout

func (x *SupervisorMiddlewareService) GetRequestTimeout() *durationpb.Duration

func (*SupervisorMiddlewareService) GetTlsCaCertPem

func (x *SupervisorMiddlewareService) GetTlsCaCertPem() []byte

func (*SupervisorMiddlewareService) ProtoMessage

func (*SupervisorMiddlewareService) ProtoMessage()

func (*SupervisorMiddlewareService) ProtoReflect

func (*SupervisorMiddlewareService) Reset

func (x *SupervisorMiddlewareService) Reset()

func (*SupervisorMiddlewareService) String

func (x *SupervisorMiddlewareService) String() string

Jump to

Keyboard shortcuts

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