Skip to content

Agent Mesh

router: announce the time away on shutdown through the lease ttl

Antonio Ojea64b9d26ae72d
diff --git a/api/sam.pb.go b/api/sam.pb.go
index e2264df2..7c532315 100644
--- a/api/sam.pb.go
+++ b/api/sam.pb.go
@@ -1437,8 +1437,14 @@ type RouterLeaseRequest struct {
// not proof: routers hand theirs to every peer they authenticate.
ChallengeUnixMs int64 `protobuf:"varint,6,opt,name=challenge_unix_ms,json=challengeUnixMs,proto3" json:"challenge_unix_ms,omitempty"`
ChallengeSignature []byte `protobuf:"bytes,7,opt,name=challenge_signature,json=challengeSignature,proto3" json:"challenge_signature,omitempty"`
- unknownFields protoimpl.UnknownFields
- sizeCache protoimpl.SizeCache
+ // How long this lease stays valid. Unset means the control plane's lease
+ // duration. A router may shorten its lease, never lengthen it: on its last
+ // renewal before stopping it sets the time it expects to be away, zero to
+ // be withdrawn at once, so a joiner is not handed a router that is gone
+ // and a router back within that time is still listed.
+ Ttl *durationpb.Duration `protobuf:"bytes,8,opt,name=ttl,proto3" json:"ttl,omitempty"`
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
}
func (x *RouterLeaseRequest) Reset() {
@@ -1520,6 +1526,13 @@ func (x *RouterLeaseRequest) GetChallengeSignature() []byte {
return nil
}
+func (x *RouterLeaseRequest) GetTtl() *durationpb.Duration {
+ if x != nil {
+ return x.Ttl
+ }
+ return nil
+}
+
type RouterLeaseResponse struct {
state protoimpl.MessageState `protogen:"open.v1"`
Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
@@ -5385,7 +5398,7 @@ const file_api_sam_proto_rawDesc = "" +
"\tclient_id\x18\x02 \x01(\tR\bclientId\x12\x1a\n" +
"\baudience\x18\x03 \x01(\tR\baudience\x12)\n" +
"\x10router_addresses\x18\x04 \x03(\tR\x0frouterAddresses\x12&\n" +
- "\x0fbanned_peer_ids\x18\x05 \x03(\tR\rbannedPeerIds\"\x86\x02\n" +
+ "\x0fbanned_peer_ids\x18\x05 \x03(\tR\rbannedPeerIds\"\xb3\x02\n" +
"\x12RouterLeaseRequest\x12\x17\n" +
"\apeer_id\x18\x01 \x01(\tR\x06peerId\x12\x1c\n" +
"\taddresses\x18\x02 \x03(\tR\taddresses\x12\x18\n" +
@@ -5393,7 +5406,8 @@ const file_api_sam_proto_rawDesc = "" +
"\x0fconnected_peers\x18\x04 \x03(\tR\x0econnectedPeers\x12\x19\n" +
"\bdht_size\x18\x05 \x01(\x05R\adhtSize\x12*\n" +
"\x11challenge_unix_ms\x18\x06 \x01(\x03R\x0fchallengeUnixMs\x12/\n" +
- "\x13challenge_signature\x18\a \x01(\fR\x12challengeSignature\"\x82\x01\n" +
+ "\x13challenge_signature\x18\a \x01(\fR\x12challengeSignature\x12+\n" +
+ "\x03ttl\x18\b \x01(\v2\x19.google.protobuf.DurationR\x03ttl\"\x82\x01\n" +
"\x13RouterLeaseResponse\x12\x18\n" +
"\asuccess\x18\x01 \x01(\bR\asuccess\x12\x14\n" +
"\x05error\x18\x02 \x01(\tR\x05error\x12;\n" +
@@ -5846,85 +5860,86 @@ var file_api_sam_proto_depIdxs = []int32{
1, // 11: sam.v1.ServiceAnnounce.type:type_name -> sam.v1.ServiceType
75, // 12: sam.v1.ServiceAnnounce.labels:type_name -> sam.v1.ServiceAnnounce.LabelsEntry
80, // 13: sam.v1.ServiceAnnounce.announce_time:type_name -> google.protobuf.Timestamp
- 80, // 14: sam.v1.RouterLeaseResponse.expire_time:type_name -> google.protobuf.Timestamp
- 23, // 15: sam.v1.PolicyRole.http:type_name -> sam.v1.HTTPGrant
- 30, // 16: sam.v1.EgressDestination.broker:type_name -> sam.v1.CredentialBroker
- 25, // 17: sam.v1.EgressDestination.inspection:type_name -> sam.v1.Inspection
- 2, // 18: sam.v1.EgressDestination.mode:type_name -> sam.v1.EgressMode
- 26, // 19: sam.v1.Inspection.inspectors:type_name -> sam.v1.Inspector
- 27, // 20: sam.v1.Inspector.model_armor:type_name -> sam.v1.ModelArmor
- 28, // 21: sam.v1.Inspector.ext_proc:type_name -> sam.v1.ExtProc
- 3, // 22: sam.v1.ModelArmor.response:type_name -> sam.v1.ResponseInspection
- 81, // 23: sam.v1.ModelArmor.timeout:type_name -> google.protobuf.Duration
- 29, // 24: sam.v1.ExtProc.processing_mode:type_name -> sam.v1.ExtProcProcessingMode
- 81, // 25: sam.v1.ExtProc.message_timeout:type_name -> google.protobuf.Duration
- 5, // 26: sam.v1.ExtProcProcessingMode.request_header_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
- 5, // 27: sam.v1.ExtProcProcessingMode.response_header_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
- 6, // 28: sam.v1.ExtProcProcessingMode.request_body_mode:type_name -> sam.v1.ExtProcProcessingMode.BodyMode
- 6, // 29: sam.v1.ExtProcProcessingMode.response_body_mode:type_name -> sam.v1.ExtProcProcessingMode.BodyMode
- 5, // 30: sam.v1.ExtProcProcessingMode.request_trailer_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
- 5, // 31: sam.v1.ExtProcProcessingMode.response_trailer_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
- 31, // 32: sam.v1.CredentialBroker.oidc_federation:type_name -> sam.v1.OIDCFederation
- 32, // 33: sam.v1.CredentialBroker.aws_assume_role:type_name -> sam.v1.AWSAssumeRole
- 33, // 34: sam.v1.CredentialBroker.platform_identity:type_name -> sam.v1.PlatformIdentity
- 22, // 35: sam.v1.PolicyConfig.roles:type_name -> sam.v1.PolicyRole
- 34, // 36: sam.v1.PolicyConfig.bindings:type_name -> sam.v1.PolicyBinding
- 24, // 37: sam.v1.PolicyConfig.egress:type_name -> sam.v1.EgressDestination
- 24, // 38: sam.v1.EgressAssignmentsResponse.egress:type_name -> sam.v1.EgressDestination
- 80, // 39: sam.v1.KeysResponse.sign_time:type_name -> google.protobuf.Timestamp
- 80, // 40: sam.v1.TokenRefreshResponse.expire_time:type_name -> google.protobuf.Timestamp
- 14, // 41: sam.v1.NodeCatalogReport.services:type_name -> sam.v1.ServiceInfo
- 80, // 42: sam.v1.BootstrapTokenCreateResponse.expire_time:type_name -> google.protobuf.Timestamp
- 80, // 43: sam.v1.BootstrapToken.create_time:type_name -> google.protobuf.Timestamp
- 80, // 44: sam.v1.BootstrapToken.expire_time:type_name -> google.protobuf.Timestamp
- 80, // 45: sam.v1.BootstrapToken.revoke_time:type_name -> google.protobuf.Timestamp
- 49, // 46: sam.v1.BootstrapTokenListResponse.tokens:type_name -> sam.v1.BootstrapToken
- 0, // 47: sam.v1.EnrollmentRequest.status:type_name -> sam.v1.EnrollmentStatus
- 76, // 48: sam.v1.EnrollmentRequest.labels:type_name -> sam.v1.EnrollmentRequest.LabelsEntry
- 80, // 49: sam.v1.EnrollmentRequest.create_time:type_name -> google.protobuf.Timestamp
- 80, // 50: sam.v1.EnrollmentRequest.resolve_time:type_name -> google.protobuf.Timestamp
- 51, // 51: sam.v1.EnrollmentRequestListResponse.requests:type_name -> sam.v1.EnrollmentRequest
- 80, // 52: sam.v1.User.create_time:type_name -> google.protobuf.Timestamp
- 77, // 53: sam.v1.EnrolledNode.labels:type_name -> sam.v1.EnrolledNode.LabelsEntry
- 80, // 54: sam.v1.EnrolledNode.enroll_time:type_name -> google.protobuf.Timestamp
- 80, // 55: sam.v1.EnrolledNode.expire_time:type_name -> google.protobuf.Timestamp
- 80, // 56: sam.v1.RouterLease.last_renewal_time:type_name -> google.protobuf.Timestamp
- 80, // 57: sam.v1.RouterLease.expire_time:type_name -> google.protobuf.Timestamp
- 14, // 58: sam.v1.NodeServices.services:type_name -> sam.v1.ServiceInfo
- 80, // 59: sam.v1.NodeServices.report_time:type_name -> google.protobuf.Timestamp
- 53, // 60: sam.v1.AdminStatusResponse.users:type_name -> sam.v1.User
- 55, // 61: sam.v1.AdminStatusResponse.active_routers:type_name -> sam.v1.RouterLease
- 54, // 62: sam.v1.AdminStatusResponse.enrolled_nodes:type_name -> sam.v1.EnrolledNode
- 51, // 63: sam.v1.AdminStatusResponse.enrollment_requests:type_name -> sam.v1.EnrollmentRequest
- 49, // 64: sam.v1.AdminStatusResponse.bootstrap_tokens:type_name -> sam.v1.BootstrapToken
- 35, // 65: sam.v1.AdminStatusResponse.policy:type_name -> sam.v1.PolicyConfig
- 78, // 66: sam.v1.AdminStatusResponse.node_catalog:type_name -> sam.v1.AdminStatusResponse.NodeCatalogEntry
- 53, // 67: sam.v1.UserStatusResponse.user:type_name -> sam.v1.User
- 54, // 68: sam.v1.UserStatusResponse.enrolled_nodes:type_name -> sam.v1.EnrolledNode
- 49, // 69: sam.v1.UserStatusResponse.bootstrap_tokens:type_name -> sam.v1.BootstrapToken
- 55, // 70: sam.v1.UserStatusResponse.active_routers:type_name -> sam.v1.RouterLease
- 35, // 71: sam.v1.UserStatusResponse.policy:type_name -> sam.v1.PolicyConfig
- 80, // 72: sam.v1.IdentityEvidenceResponse.biscuit_expire_time:type_name -> google.protobuf.Timestamp
- 80, // 73: sam.v1.IdentityEvidenceResponse.check_time:type_name -> google.protobuf.Timestamp
- 79, // 74: sam.v1.PeerEvidenceResponse.labels:type_name -> sam.v1.PeerEvidenceResponse.LabelsEntry
- 80, // 75: sam.v1.PeerEvidenceResponse.expire_time:type_name -> google.protobuf.Timestamp
- 80, // 76: sam.v1.PeerEvidenceResponse.check_time:type_name -> google.protobuf.Timestamp
- 80, // 77: sam.v1.MemberCredential.expire_time:type_name -> google.protobuf.Timestamp
- 62, // 78: sam.v1.MemberCredential.trusted_keys:type_name -> sam.v1.TrustedSigningKey
- 63, // 79: sam.v1.MemberCredential.oidc_session:type_name -> sam.v1.OIDCSession
- 80, // 80: sam.v1.TrustedSigningKey.receive_time:type_name -> google.protobuf.Timestamp
- 65, // 81: sam.v1.TaskAuthorizationRule.rules:type_name -> sam.v1.TaskRule
- 80, // 82: sam.v1.TaskAuthorizationRule.expire_time:type_name -> google.protobuf.Timestamp
- 66, // 83: sam.v1.TaskRule.operation:type_name -> sam.v1.TaskOperation
- 64, // 84: sam.v1.TokenExchangeRequest.task_rule:type_name -> sam.v1.TaskAuthorizationRule
- 80, // 85: sam.v1.TokenExchangeResponse.expire_time:type_name -> google.protobuf.Timestamp
- 80, // 86: sam.v1.STSTokenResponse.expire_time:type_name -> google.protobuf.Timestamp
- 56, // 87: sam.v1.AdminStatusResponse.NodeCatalogEntry.value:type_name -> sam.v1.NodeServices
- 88, // [88:88] is the sub-list for method output_type
- 88, // [88:88] is the sub-list for method input_type
- 88, // [88:88] is the sub-list for extension type_name
- 88, // [88:88] is the sub-list for extension extendee
- 0, // [0:88] is the sub-list for field type_name
+ 81, // 14: sam.v1.RouterLeaseRequest.ttl:type_name -> google.protobuf.Duration
+ 80, // 15: sam.v1.RouterLeaseResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 23, // 16: sam.v1.PolicyRole.http:type_name -> sam.v1.HTTPGrant
+ 30, // 17: sam.v1.EgressDestination.broker:type_name -> sam.v1.CredentialBroker
+ 25, // 18: sam.v1.EgressDestination.inspection:type_name -> sam.v1.Inspection
+ 2, // 19: sam.v1.EgressDestination.mode:type_name -> sam.v1.EgressMode
+ 26, // 20: sam.v1.Inspection.inspectors:type_name -> sam.v1.Inspector
+ 27, // 21: sam.v1.Inspector.model_armor:type_name -> sam.v1.ModelArmor
+ 28, // 22: sam.v1.Inspector.ext_proc:type_name -> sam.v1.ExtProc
+ 3, // 23: sam.v1.ModelArmor.response:type_name -> sam.v1.ResponseInspection
+ 81, // 24: sam.v1.ModelArmor.timeout:type_name -> google.protobuf.Duration
+ 29, // 25: sam.v1.ExtProc.processing_mode:type_name -> sam.v1.ExtProcProcessingMode
+ 81, // 26: sam.v1.ExtProc.message_timeout:type_name -> google.protobuf.Duration
+ 5, // 27: sam.v1.ExtProcProcessingMode.request_header_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
+ 5, // 28: sam.v1.ExtProcProcessingMode.response_header_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
+ 6, // 29: sam.v1.ExtProcProcessingMode.request_body_mode:type_name -> sam.v1.ExtProcProcessingMode.BodyMode
+ 6, // 30: sam.v1.ExtProcProcessingMode.response_body_mode:type_name -> sam.v1.ExtProcProcessingMode.BodyMode
+ 5, // 31: sam.v1.ExtProcProcessingMode.request_trailer_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
+ 5, // 32: sam.v1.ExtProcProcessingMode.response_trailer_mode:type_name -> sam.v1.ExtProcProcessingMode.HeaderMode
+ 31, // 33: sam.v1.CredentialBroker.oidc_federation:type_name -> sam.v1.OIDCFederation
+ 32, // 34: sam.v1.CredentialBroker.aws_assume_role:type_name -> sam.v1.AWSAssumeRole
+ 33, // 35: sam.v1.CredentialBroker.platform_identity:type_name -> sam.v1.PlatformIdentity
+ 22, // 36: sam.v1.PolicyConfig.roles:type_name -> sam.v1.PolicyRole
+ 34, // 37: sam.v1.PolicyConfig.bindings:type_name -> sam.v1.PolicyBinding
+ 24, // 38: sam.v1.PolicyConfig.egress:type_name -> sam.v1.EgressDestination
+ 24, // 39: sam.v1.EgressAssignmentsResponse.egress:type_name -> sam.v1.EgressDestination
+ 80, // 40: sam.v1.KeysResponse.sign_time:type_name -> google.protobuf.Timestamp
+ 80, // 41: sam.v1.TokenRefreshResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 14, // 42: sam.v1.NodeCatalogReport.services:type_name -> sam.v1.ServiceInfo
+ 80, // 43: sam.v1.BootstrapTokenCreateResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 44: sam.v1.BootstrapToken.create_time:type_name -> google.protobuf.Timestamp
+ 80, // 45: sam.v1.BootstrapToken.expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 46: sam.v1.BootstrapToken.revoke_time:type_name -> google.protobuf.Timestamp
+ 49, // 47: sam.v1.BootstrapTokenListResponse.tokens:type_name -> sam.v1.BootstrapToken
+ 0, // 48: sam.v1.EnrollmentRequest.status:type_name -> sam.v1.EnrollmentStatus
+ 76, // 49: sam.v1.EnrollmentRequest.labels:type_name -> sam.v1.EnrollmentRequest.LabelsEntry
+ 80, // 50: sam.v1.EnrollmentRequest.create_time:type_name -> google.protobuf.Timestamp
+ 80, // 51: sam.v1.EnrollmentRequest.resolve_time:type_name -> google.protobuf.Timestamp
+ 51, // 52: sam.v1.EnrollmentRequestListResponse.requests:type_name -> sam.v1.EnrollmentRequest
+ 80, // 53: sam.v1.User.create_time:type_name -> google.protobuf.Timestamp
+ 77, // 54: sam.v1.EnrolledNode.labels:type_name -> sam.v1.EnrolledNode.LabelsEntry
+ 80, // 55: sam.v1.EnrolledNode.enroll_time:type_name -> google.protobuf.Timestamp
+ 80, // 56: sam.v1.EnrolledNode.expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 57: sam.v1.RouterLease.last_renewal_time:type_name -> google.protobuf.Timestamp
+ 80, // 58: sam.v1.RouterLease.expire_time:type_name -> google.protobuf.Timestamp
+ 14, // 59: sam.v1.NodeServices.services:type_name -> sam.v1.ServiceInfo
+ 80, // 60: sam.v1.NodeServices.report_time:type_name -> google.protobuf.Timestamp
+ 53, // 61: sam.v1.AdminStatusResponse.users:type_name -> sam.v1.User
+ 55, // 62: sam.v1.AdminStatusResponse.active_routers:type_name -> sam.v1.RouterLease
+ 54, // 63: sam.v1.AdminStatusResponse.enrolled_nodes:type_name -> sam.v1.EnrolledNode
+ 51, // 64: sam.v1.AdminStatusResponse.enrollment_requests:type_name -> sam.v1.EnrollmentRequest
+ 49, // 65: sam.v1.AdminStatusResponse.bootstrap_tokens:type_name -> sam.v1.BootstrapToken
+ 35, // 66: sam.v1.AdminStatusResponse.policy:type_name -> sam.v1.PolicyConfig
+ 78, // 67: sam.v1.AdminStatusResponse.node_catalog:type_name -> sam.v1.AdminStatusResponse.NodeCatalogEntry
+ 53, // 68: sam.v1.UserStatusResponse.user:type_name -> sam.v1.User
+ 54, // 69: sam.v1.UserStatusResponse.enrolled_nodes:type_name -> sam.v1.EnrolledNode
+ 49, // 70: sam.v1.UserStatusResponse.bootstrap_tokens:type_name -> sam.v1.BootstrapToken
+ 55, // 71: sam.v1.UserStatusResponse.active_routers:type_name -> sam.v1.RouterLease
+ 35, // 72: sam.v1.UserStatusResponse.policy:type_name -> sam.v1.PolicyConfig
+ 80, // 73: sam.v1.IdentityEvidenceResponse.biscuit_expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 74: sam.v1.IdentityEvidenceResponse.check_time:type_name -> google.protobuf.Timestamp
+ 79, // 75: sam.v1.PeerEvidenceResponse.labels:type_name -> sam.v1.PeerEvidenceResponse.LabelsEntry
+ 80, // 76: sam.v1.PeerEvidenceResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 77: sam.v1.PeerEvidenceResponse.check_time:type_name -> google.protobuf.Timestamp
+ 80, // 78: sam.v1.MemberCredential.expire_time:type_name -> google.protobuf.Timestamp
+ 62, // 79: sam.v1.MemberCredential.trusted_keys:type_name -> sam.v1.TrustedSigningKey
+ 63, // 80: sam.v1.MemberCredential.oidc_session:type_name -> sam.v1.OIDCSession
+ 80, // 81: sam.v1.TrustedSigningKey.receive_time:type_name -> google.protobuf.Timestamp
+ 65, // 82: sam.v1.TaskAuthorizationRule.rules:type_name -> sam.v1.TaskRule
+ 80, // 83: sam.v1.TaskAuthorizationRule.expire_time:type_name -> google.protobuf.Timestamp
+ 66, // 84: sam.v1.TaskRule.operation:type_name -> sam.v1.TaskOperation
+ 64, // 85: sam.v1.TokenExchangeRequest.task_rule:type_name -> sam.v1.TaskAuthorizationRule
+ 80, // 86: sam.v1.TokenExchangeResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 80, // 87: sam.v1.STSTokenResponse.expire_time:type_name -> google.protobuf.Timestamp
+ 56, // 88: sam.v1.AdminStatusResponse.NodeCatalogEntry.value:type_name -> sam.v1.NodeServices
+ 89, // [89:89] is the sub-list for method output_type
+ 89, // [89:89] is the sub-list for method input_type
+ 89, // [89:89] is the sub-list for extension type_name
+ 89, // [89:89] is the sub-list for extension extendee
+ 0, // [0:89] is the sub-list for field type_name
}
func init() { file_api_sam_proto_init() }
diff --git a/api/sam.proto b/api/sam.proto
index cc9d4ed1..a0761cd8 100644
--- a/api/sam.proto
+++ b/api/sam.proto
@@ -208,6 +208,12 @@ message RouterLeaseRequest {
// not proof: routers hand theirs to every peer they authenticate.
int64 challenge_unix_ms = 6;
bytes challenge_signature = 7;
+ // How long this lease stays valid. Unset means the control plane's lease
+ // duration. A router may shorten its lease, never lengthen it: on its last
+ // renewal before stopping it sets the time it expects to be away, zero to
+ // be withdrawn at once, so a joiner is not handed a router that is gone
+ // and a router back within that time is still listed.
+ google.protobuf.Duration ttl = 8;
}
message RouterLeaseResponse {
diff --git a/cmd/sam-one/main.go b/cmd/sam-one/main.go
index db7253fe..0751ec5b 100644
--- a/cmd/sam-one/main.go
+++ b/cmd/sam-one/main.go
@@ -29,6 +29,7 @@ import (
"syscall"
"github.com/google/sam/api"
+ "github.com/google/sam/internal/router"
"github.com/google/sam/internal/standalone"
"github.com/google/sam/internal/tunnel"
"github.com/google/sam/internal/version"
@@ -254,6 +255,7 @@ func main() {
rootCmd.Flags().DurationVar(&routerTunables.DHTMaxRecordAge, "router-dht-max-record-age", 0, "DHT record max age (0 keeps the library default)")
rootCmd.Flags().DurationVar(&routerTunables.RelayLimitDuration, "router-relay-limit-duration", 0, "Relayed connection lifetime (0 keeps the component default of 1h; use e.g. 24h for longer)")
rootCmd.Flags().Var(&routerTunables.RelayLimitData, "router-relay-limit-data", "Bytes relayed per direction per connection, e.g. 512MiB (0 keeps the component default: no limit)")
+ rootCmd.Flags().DurationVar(&routerTunables.ShutdownLeaseTTL, "router-shutdown-lease-ttl", router.DefaultShutdownLeaseTTL, "Sent in the embedded router's last lease when it stops: how long it expects to be away, which is how long the control plane keeps listing it (0 sends nothing)")
rootCmd.Flags().BoolVar(&routerAllowLoopback, "router-allow-loopback", true, "Advertise loopback addresses (disable on public deployments)")
rootCmd.AddCommand(newAdminSubcommands()...)
diff --git a/cmd/sam-router/main.go b/cmd/sam-router/main.go
index 4d578aad..7f2cd1cf 100644
--- a/cmd/sam-router/main.go
+++ b/cmd/sam-router/main.go
@@ -49,6 +49,7 @@ var (
metricsAddr string
relayLimitDuration time.Duration
relayLimitData router.ByteSize
+ shutdownLeaseTTL time.Duration
)
var logger = golog.Logger("sam-router-cli")
@@ -92,6 +93,7 @@ func main() {
MetricsAddr: metricsAddr,
RelayLimitDuration: relayLimitDuration,
RelayLimitData: int64(relayLimitData),
+ ShutdownLeaseTTL: shutdownLeaseTTL,
}
r, err := router.NewRouter(cmd.Context(), opts)
@@ -134,6 +136,7 @@ func main() {
rootCmd.Flags().StringVar(&metricsAddr, "metrics-addr", "", "Serve Prometheus /metrics, /healthz and /readyz on this address (e.g. 0.0.0.0:9090); unauthenticated, off by default")
rootCmd.Flags().DurationVar(&relayLimitDuration, "relay-limit-duration", router.DefaultRelayLimitDuration, "Lifetime of each relayed connection (0 = no limit)")
rootCmd.Flags().Var(&relayLimitData, "relay-limit-data", "Bytes relayed per direction on each relayed connection, e.g. 512MiB (0 = no limit)")
+ rootCmd.Flags().DurationVar(&shutdownLeaseTTL, "shutdown-lease-ttl", router.DefaultShutdownLeaseTTL, "Sent in this router's last lease when it stops: how long it expects to be away, which is how long the control plane keeps listing it. 0 sends nothing and the lease expires on the control plane's schedule")
ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
defer cancel()
diff --git a/internal/controlplane/server.go b/internal/controlplane/server.go
index 528da42a..6c162036 100644
--- a/internal/controlplane/server.go
+++ b/internal/controlplane/server.go
@@ -1399,12 +1399,31 @@ func (s *Server) HandleRouterLease(w http.ResponseWriter, r *http.Request) {
}
}
- // Expose lease renewal
- expiresAt := time.Now().Add(s.config.LeaseDuration)
+ // The lease lasts the control plane's duration unless the router asked
+ // for less: a router that is stopping says how long it expects to be
+ // away, and zero takes it out of /info with this very request.
+ ttl := s.config.LeaseDuration
+ if req.Ttl != nil {
+ requested := req.Ttl.AsDuration()
+ if requested < 0 {
+ http.Error(w, "Invalid ttl: must not be negative", http.StatusBadRequest)
+ return
+ }
+ if requested < ttl {
+ ttl = requested
+ }
+ if requested == 0 {
+ logger.Infow("Router withdrew its lease", "peer_id", canonical)
+ } else if requested < s.config.LeaseDuration {
+ logger.Infow("Router shortened its lease", "peer_id", canonical, "ttl", requested)
+ }
+ }
+ now := time.Now()
+ expiresAt := now.Add(ttl)
lease := &storage.RouterLease{
PeerID: canonical,
Addresses: req.Addresses,
- LastRenewal: time.Now(),
+ LastRenewal: now,
ExpiresAt: expiresAt,
ConnectedPeers: req.ConnectedPeers,
DHTSize: int(req.DhtSize),
diff --git a/internal/controlplane/server_test.go b/internal/controlplane/server_test.go
index bb917958..a48e145a 100644
--- a/internal/controlplane/server_test.go
+++ b/internal/controlplane/server_test.go
@@ -48,6 +48,7 @@ import (
"github.com/libp2p/go-libp2p/core/peer"
"google.golang.org/protobuf/encoding/protojson"
"google.golang.org/protobuf/proto"
+ "google.golang.org/protobuf/types/known/durationpb"
)
func startCustomMockOIDC(t *testing.T) (string, func(claims map[string]interface{}) string) {
@@ -1648,6 +1649,136 @@ func TestRouterLeaseRevocation(t *testing.T) {
}
}
+// TestRouterLeaseTTL covers the ttl a router sends on its way down: it may
+// shorten its lease to the time it expects to be away, zero takes it out of
+// the active set with that request, and it can never lengthen the lease.
+func TestRouterLeaseTTL(t *testing.T) {
+ issuer, _ := startCustomMockOIDC(t)
+ srv, store, baseURL := setupTestServer(t, issuer)
+ defer func() {
+ _ = srv.Close()
+ _ = store.Close()
+ }()
+ srv.config.LeaseDuration = 15 * time.Minute
+
+ ctx := context.Background()
+ cpPriv, _, err := store.GetCurrentKey(ctx)
+ if err != nil {
+ t.Fatal(err)
+ }
+ priv, pub, err := crypto.GenerateKeyPair(crypto.Ed25519, -1)
+ if err != nil {
+ t.Fatal(err)
+ }
+ routerPeer, _ := peer.IDFromPrivateKey(priv)
+ pubBytes, _ := crypto.MarshalPublicKey(pub)
+ routerBiscuit, err := identity.MintBootstrapBiscuitToken(cpPriv, routerPeer, api.RoleRouter, time.Now().Add(time.Hour), nil, nil)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if err := store.EnrollNode(ctx, &storage.EnrolledNode{
+ PeerID: routerPeer.String(),
+ PublicKey: pubBytes,
+ Biscuit: routerBiscuit,
+ Role: api.RoleRouter,
+ EnrollmentType: "BOOTSTRAP",
+ EnrolledAt: time.Now(),
+ }); err != nil {
+ t.Fatal(err)
+ }
+
+ client := &http.Client{Timeout: 5 * time.Second}
+ postLease := func(ttl *time.Duration) (int, time.Time) {
+ t.Helper()
+ ts, sig := leasePoP(t, priv, routerPeer.String())
+ req := &api.RouterLeaseRequest{
+ PeerId: routerPeer.String(),
+ Addresses: []string{"/ip4/127.0.0.1/tcp/4001/p2p/" + routerPeer.String()},
+ Biscuit: routerBiscuit,
+ ChallengeUnixMs: ts,
+ ChallengeSignature: sig,
+ }
+ if ttl != nil {
+ req.Ttl = durationpb.New(*ttl)
+ }
+ leaseData, _ := proto.Marshal(req)
+ resp, err := client.Post(baseURL+"/routers/lease", "application/x-protobuf", bytes.NewReader(leaseData))
+ if err != nil {
+ t.Fatal(err)
+ }
+ defer func() { _ = resp.Body.Close() }()
+ if resp.StatusCode != http.StatusOK {
+ return resp.StatusCode, time.Time{}
+ }
+ body, _ := io.ReadAll(resp.Body)
+ var leaseResp api.RouterLeaseResponse
+ if err := proto.Unmarshal(body, &leaseResp); err != nil {
+ t.Fatal(err)
+ }
+ return resp.StatusCode, leaseResp.ExpireTime.AsTime()
+ }
+ activeRouters := func() int {
+ t.Helper()
+ active, err := store.GetActiveRouters(ctx)
+ if err != nil {
+ t.Fatal(err)
+ }
+ return len(active)
+ }
+ within := func(got time.Time, want time.Duration) bool {
+ d := time.Until(got)
+ return d > want-10*time.Second && d <= want
+ }
+
+ // No ttl: the control plane's duration.
+ status, expires := postLease(nil)
+ if status != http.StatusOK || !within(expires, 15*time.Minute) {
+ t.Fatalf("plain lease: status %d, expires in %s, want 200 and ~15m", status, time.Until(expires))
+ }
+ if got := activeRouters(); got != 1 {
+ t.Fatalf("active routers after plain lease: got %d, want 1", got)
+ }
+
+ // Shorter than the control plane's duration is honoured as sent.
+ ttl := 2 * time.Minute
+ if status, expires = postLease(&ttl); status != http.StatusOK || !within(expires, 2*time.Minute) {
+ t.Fatalf("shortened lease: status %d, expires in %s, want 200 and ~2m", status, time.Until(expires))
+ }
+
+ // Longer is capped: a router cannot hold its slot past the control plane's
+ // own expiry.
+ ttl = 3 * time.Hour
+ if status, expires = postLease(&ttl); status != http.StatusOK || !within(expires, 15*time.Minute) {
+ t.Fatalf("lengthened lease: status %d, expires in %s, want 200 and ~15m", status, time.Until(expires))
+ }
+
+ // Negative is a malformed request.
+ ttl = -time.Second
+ if status, _ = postLease(&ttl); status != http.StatusBadRequest {
+ t.Fatalf("negative ttl: got %d, want 400", status)
+ }
+ if got := activeRouters(); got != 1 {
+ t.Fatalf("active routers after rejected ttl: got %d, want 1", got)
+ }
+
+ // Zero withdraws the router at once.
+ ttl = 0
+ if status, _ = postLease(&ttl); status != http.StatusOK {
+ t.Fatalf("withdrawal: got %d, want 200", status)
+ }
+ if got := activeRouters(); got != 0 {
+ t.Fatalf("active routers after withdrawal: got %d, want 0", got)
+ }
+
+ // The router comes back with a plain renewal.
+ if status, _ = postLease(nil); status != http.StatusOK {
+ t.Fatalf("lease after withdrawal: got %d, want 200", status)
+ }
+ if got := activeRouters(); got != 1 {
+ t.Fatalf("active routers after return: got %d, want 1", got)
+ }
+}
+
// TestRouterLeaseUnderRotatedKey covers the rotation grace window on
// /routers/lease: both keys are valid, the retiring one is listed first, and
// the biscuit is signed by the new one, so the role check has to run under the
diff --git a/internal/router/config.go b/internal/router/config.go
index 1b3c93ad..3a539471 100644
--- a/internal/router/config.go
+++ b/internal/router/config.go
@@ -23,6 +23,11 @@ import (
"github.com/google/sam/internal/identity"
)
+// DefaultShutdownLeaseTTL is the CLI default for Options.ShutdownLeaseTTL:
+// about the time a pod takes to come back in place, and a pod's default
+// termination grace period.
+const DefaultShutdownLeaseTTL = 30 * time.Second
+
// Options holds configuration details for the sam-router.
type Options struct {
ControlPlaneURL string
@@ -49,6 +54,12 @@ type Options struct {
// no limit, so Default() leaves them alone.
RelayLimitDuration time.Duration
RelayLimitData int64
+ // ShutdownLeaseTTL is the lease the router asks for as it stops: how
+ // long the control plane keeps listing it, which is the time the router
+ // expects to be away. Zero sends no last lease and the entry expires on
+ // the control plane's schedule. The CLIs default to
+ // DefaultShutdownLeaseTTL.
+ ShutdownLeaseTTL time.Duration
// RequiredRole restricts enrollment and startup to only accept tokens containing this role.
RequiredRole string
// HTTPFallbackHandler, when set, serves ordinary (non-WebSocket-upgrade)
@@ -114,5 +125,8 @@ func (o *Options) Validate() error {
if o.ControlPlaneURL == "" {
return fmt.Errorf("ControlPlaneURL must be specified")
}
+ if o.ShutdownLeaseTTL < 0 {
+ return fmt.Errorf("ShutdownLeaseTTL must not be negative, got %s", o.ShutdownLeaseTTL)
+ }
return api.ValidateControlPlaneTransport(o.ControlPlaneURL, o.AllowInsecureControlPlane)
}
diff --git a/internal/router/router.go b/internal/router/router.go
index 86ac4c10..4d672284 100644
--- a/internal/router/router.go
+++ b/internal/router/router.go
@@ -63,6 +63,7 @@ import (
"github.com/multiformats/go-multiaddr"
madns "github.com/multiformats/go-multiaddr-dns"
"google.golang.org/protobuf/proto"
+ "google.golang.org/protobuf/types/known/durationpb"
"google.golang.org/protobuf/types/known/timestamppb"
)
@@ -1022,8 +1023,39 @@ func (r *Router) runLeaseRenewalLoop() {
}
}
+// renewLease extends the lease for the control plane's duration. Once the
+// router is shutting down it does nothing: the withdrawal sent by Close is
+// the last word, and a renewal racing it would re-advertise a router that
+// is leaving.
func (r *Router) renewLease() {
- for attempt := 0; attempt < 2; attempt++ {
+ if r.shutdown.Load() {
+ return
+ }
+ r.sendLease(r.ctx, nil, 2)
+}
+
+// withdrawLease is the router's last lease before it stops: one with the
+// ttl the operator set for a shutdown, so the control plane keeps the
+// router listed for as long as it expects to be away and no longer. Off
+// when the ttl is zero. Its own context, since Close cancels the router's;
+// a failure only means the lease expires as it always did.
+func (r *Router) withdrawLease() {
+ if r.config.ShutdownLeaseTTL <= 0 || r.Host == nil {
+ return
+ }
+ ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
+ defer cancel()
+ ttl := r.config.ShutdownLeaseTTL
+ logger.Infof("Withdrawing router lease (ttl %s)", ttl)
+ r.sendLease(ctx, &ttl, 1)
+}
+
+// sendLease posts one lease to the control plane: the router's addresses
+// and telemetry under proof of possession of its key, and the ttl it asks
+// for when ttl is not nil. attempts allows one retry after a 401 for the
+// credential recovery the renewal loop relies on.
+func (r *Router) sendLease(ctx context.Context, ttl *time.Duration, attempts int) {
+ for attempt := 0; attempt < attempts; attempt++ {
r.keysMu.RLock()
biscuit := r.credential.biscuit
r.keysMu.RUnlock()
@@ -1072,11 +1104,14 @@ func (r *Router) renewLease() {
ChallengeUnixMs: ts,
ChallengeSignature: sig,
}
+ if ttl != nil {
+ req.Ttl = durationpb.New(*ttl)
+ }
data, err := proto.Marshal(req)
if err != nil {
return nil, err
}
- httpReq, err := http.NewRequestWithContext(r.ctx, http.MethodPost, r.config.ControlPlaneURL+"/routers/lease", bytes.NewReader(data))
+ httpReq, err := http.NewRequestWithContext(ctx, http.MethodPost, r.config.ControlPlaneURL+"/routers/lease", bytes.NewReader(data))
if err != nil {
return nil, err
}
@@ -1097,7 +1132,7 @@ func (r *Router) renewLease() {
return
}
- if resp.StatusCode == http.StatusUnauthorized && attempt == 0 {
+ if resp.StatusCode == http.StatusUnauthorized && attempt == 0 && attempts > 1 {
logger.Warnf("Control plane lease renewal rejected (401 Unauthorized: %s), attempting recovery...", string(body))
leaseRenewalsTotal.WithLabelValues(leaseUnauthorized).Inc()
if err := r.recoverAfterLease401(); err != nil {
@@ -1447,7 +1482,10 @@ func (r *Router) performMutualAuth(s network.Stream) error {
// Close closes the underlying p2p host and keyring db.
func (r *Router) Close() error {
r.isReady.Store(false)
+ // Draining: no renewal may extend the lease past the withdrawal below,
+ // which goes out while the host and the credential are still there.
r.shutdown.Store(true)
+ r.withdrawLease()
r.cancel()
var errs []error
diff --git a/internal/router/router_test.go b/internal/router/router_test.go
index 6d25bdfd..0edbdfeb 100644
--- a/internal/router/router_test.go
+++ b/internal/router/router_test.go
@@ -29,6 +29,7 @@ import (
"os"
"path/filepath"
"strings"
+ "sync"
"testing"
"time"
@@ -561,6 +562,95 @@ func TestRouterLeaseRenewalRepeated401Terminates(t *testing.T) {
}
}
+// TestRouterCloseWithdrawsLease covers graceful shutdown: Close sends one
+// last lease carrying ShutdownLeaseTTL, a renewal that races the shutdown
+// sends nothing, and a zero ShutdownLeaseTTL leaves the lease to expire.
+func TestRouterCloseWithdrawsLease(t *testing.T) {
+ for _, tc := range []struct {
+ name string
+ ttl time.Duration
+ wantTTL *time.Duration
+ }{
+ {name: "default", ttl: DefaultShutdownLeaseTTL, wantTTL: ptrDuration(30 * time.Second)},
+ {name: "announce time away", ttl: 90 * time.Second, wantTTL: ptrDuration(90 * time.Second)},
+ {name: "off", ttl: 0, wantTTL: nil},
+ } {
+ t.Run(tc.name, func(t *testing.T) {
+ var mu sync.Mutex
+ var leases []*api.RouterLeaseRequest
+ ts := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
+ body, _ := io.ReadAll(req.Body)
+ var lease api.RouterLeaseRequest
+ if err := proto.Unmarshal(body, &lease); err != nil {
+ http.Error(w, err.Error(), http.StatusBadRequest)
+ return
+ }
+ mu.Lock()
+ leases = append(leases, &lease)
+ mu.Unlock()
+ out, _ := proto.Marshal(&api.RouterLeaseResponse{Success: true})
+ w.Header().Set("Content-Type", "application/x-protobuf")
+ _, _ = w.Write(out)
+ }))
+ defer ts.Close()
+
+ h, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
+ if err != nil {
+ t.Fatalf("failed to create libp2p host: %v", err)
+ }
+ ctx, cancel := context.WithCancel(context.Background())
+ r := &Router{
+ Host: h,
+ ctx: ctx,
+ cancel: cancel,
+ privKey: h.Peerstore().PrivKey(h.ID()),
+ credential: credential{biscuit: []byte("dummy-biscuit")},
+ config: Options{
+ ControlPlaneURL: ts.URL,
+ ShutdownLeaseTTL: tc.ttl,
+ },
+ }
+
+ if err := r.Close(); err != nil {
+ t.Fatalf("close: %v", err)
+ }
+ // A renewal tick that lost the race with Close must not
+ // re-advertise the router.
+ r.renewLease()
+
+ mu.Lock()
+ defer mu.Unlock()
+ if tc.wantTTL == nil {
+ if len(leases) != 0 {
+ t.Fatalf("got %d leases on close, want none", len(leases))
+ }
+ return
+ }
+ if len(leases) != 1 {
+ t.Fatalf("got %d leases on close, want 1", len(leases))
+ }
+ if leases[0].Ttl == nil {
+ t.Fatal("lease on close carries no ttl")
+ }
+ if got := leases[0].Ttl.AsDuration(); got != *tc.wantTTL {
+ t.Fatalf("lease ttl on close: got %s, want %s", got, *tc.wantTTL)
+ }
+ if leases[0].PeerId != h.ID().String() {
+ t.Fatalf("lease peer id: got %s, want %s", leases[0].PeerId, h.ID())
+ }
+ })
+ }
+}
+
+func ptrDuration(d time.Duration) *time.Duration { return &d }
+
+func TestOptionsRejectNegativeShutdownLeaseTTL(t *testing.T) {
+ o := Options{ControlPlaneURL: "http://127.0.0.1:8080", ShutdownLeaseTTL: -time.Second}
+ if err := o.Validate(); err == nil || !strings.Contains(err.Error(), "ShutdownLeaseTTL") {
+ t.Fatalf("negative ShutdownLeaseTTL: err = %v, want rejection", err)
+ }
+}
+
func TestRouterReEnrollUninitializedHostGuard(t *testing.T) {
r := &Router{}
err := r.reEnroll()
diff --git a/internal/standalone/standalone.go b/internal/standalone/standalone.go
index 1c11cb82..0da47752 100644
--- a/internal/standalone/standalone.go
+++ b/internal/standalone/standalone.go
@@ -157,6 +157,9 @@ type RouterTunables struct {
// RelayLimitDuration / RelayLimitData cap each relayed connection.
RelayLimitDuration time.Duration
RelayLimitData router.ByteSize
+ // ShutdownLeaseTTL is the lease the embedded router asks for as it stops;
+ // see router.Options.ShutdownLeaseTTL.
+ ShutdownLeaseTTL time.Duration
// DisallowLoopback stops advertising loopback addresses (useful on
// public deployments; the default keeps local development working).
DisallowLoopback bool
@@ -372,6 +375,7 @@ func (s *Server) Start(ctx context.Context) (retErr error) {
DHTMaxRecordAge: s.opts.Router.DHTMaxRecordAge,
RelayLimitDuration: s.opts.Router.RelayLimitDuration,
RelayLimitData: int64(s.opts.Router.RelayLimitData),
+ ShutdownLeaseTTL: s.opts.Router.ShutdownLeaseTTL,
// Single-port deployments typically sit behind a TLS-terminating
// proxy (Cloud Run, L7 LBs) or NAT where every peer shares a few
// source IPs; libp2p's default 8-conns-per-IP cap would throttle
diff --git a/sdk/js/src/gen/sam_pb.ts b/sdk/js/src/gen/sam_pb.ts
index 93e02c31..29f30ffc 100644
--- a/sdk/js/src/gen/sam_pb.ts
+++ b/sdk/js/src/gen/sam_pb.ts
@@ -26,7 +26,7 @@ import type { Message } from "@bufbuild/protobuf";
* Describes the file sam.proto.
*/
export const file_sam: GenFile = /*@__PURE__*/
- fileDesc("CglzYW0ucHJvdG8SBnNhbS52MSI0CglBdXRoRnJhbWUSDwoHYmlzY3VpdBgBIAEoDBIWCg50YXJnZXRfc2VydmljZRgCIAEoCSI/CgxBdXRoUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBINCgVlcnJvchgCIAEoCRIPCgdiaXNjdWl0GAMgASgMItYBCglNZXNoRXZlbnQSJAoEdHlwZRgBIAEoDjIWLnNhbS52MS5NZXNoRXZlbnQuVHlwZRIPCgdwZWVyX2lkGAIgASgJEi4KCmV2ZW50X3RpbWUYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhYKDm5ld19wdWJsaWNfa2V5GAQgASgMEhEKCXNpZ25hdHVyZRgFIAEoDCI3CgRUeXBlEgoKBkJBTk5FRBAAEhAKDEtFWV9ST1RBVElPThABEhEKDVBPTElDWV9VUERBVEUQAiLzAQoNRW5yb2xsUmVxdWVzdBILCgNqd3QYASABKAkSDwoHcGVlcl9pZBgCIAEoCRISCgpwdWJsaWNfa2V5GAMgASgMEhYKDnJlcXVlc3RlZF9yb2xlGAQgASgJEjEKBmxhYmVscxgFIAMoCzIhLnNhbS52MS5FbnJvbGxSZXF1ZXN0LkxhYmVsc0VudHJ5EhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASKrAQoORW5yb2xsUmVzcG9uc2USFQoNYmlzY3VpdF90b2tlbhgBIAEoDBIVCg1lcnJvcl9tZXNzYWdlGAIgASgJEiAKGGNvbnRyb2xfcGxhbmVfcHVibGljX2tleRgDIAEoDBIYChByb3V0ZXJfYWRkcmVzc2VzGAQgAygJEi8KC2V4cGlyZV90aW1lGAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCKRAgoWQm9vdHN0cmFwRW5yb2xsUmVxdWVzdBIXCg9ib290c3RyYXBfdG9rZW4YASABKAkSDwoHcGVlcl9pZBgCIAEoCRISCgpwdWJsaWNfa2V5GAMgASgMEhYKDnJlcXVlc3RlZF9yb2xlGAQgASgJEjoKBmxhYmVscxgFIAMoCzIqLnNhbS52MS5Cb290c3RyYXBFbnJvbGxSZXF1ZXN0LkxhYmVsc0VudHJ5EhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASL9AQoXQm9vdHN0cmFwRW5yb2xsUmVzcG9uc2USKAoGc3RhdHVzGAEgASgOMhguc2FtLnYxLkVucm9sbG1lbnRTdGF0dXMSFQoNYmlzY3VpdF90b2tlbhgCIAEoDBIdChVwb2xsX2ludGVydmFsX3NlY29uZHMYAyABKAUSFQoNZXJyb3JfbWVzc2FnZRgEIAEoCRIgChhjb250cm9sX3BsYW5lX3B1YmxpY19rZXkYBSABKAwSGAoQcm91dGVyX2FkZHJlc3NlcxgGIAMoCRIvCgtleHBpcmVfdGltZRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiUwoLU2VydmljZUluZm8SIQoEdHlwZRgBIAEoDjITLnNhbS52MS5TZXJ2aWNlVHlwZRIMCgRuYW1lGAIgASgJEhMKC2Rlc2NyaXB0aW9uGAMgASgJInsKDkNvbW1hbmRCYWNrZW5kEg8KB2NvbW1hbmQYASADKAkSLAoDZW52GAIgAygLMh8uc2FtLnYxLkNvbW1hbmRCYWNrZW5kLkVudkVudHJ5GioKCEVudkVudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEiigEKFlJlZ2lzdGVyU2VydmljZVJlcXVlc3QSJAoHc2VydmljZRgBIAEoCzITLnNhbS52MS5TZXJ2aWNlSW5mbxIUCgp0YXJnZXRfdXJsGAIgASgJSAASKQoHY29tbWFuZBgDIAEoCzIWLnNhbS52MS5Db21tYW5kQmFja2VuZEgAQgkKB2JhY2tlbmQiaQoSRGlzY292ZXJlZFByb3ZpZGVyEg8KB3BlZXJfaWQYASABKAkSFwoPbG9jYWxfcHJveHlfdXJsGAIgASgJEhAKCHNydl9uYW1lGAMgASgJEhcKD3Nydl9kZXNjcmlwdGlvbhgEIAEoCSKyAgoPU2VydmljZUFubm91bmNlEg8KB3BlZXJfaWQYASABKAkSIQoEdHlwZRgCIAEoDjITLnNhbS52MS5TZXJ2aWNlVHlwZRIUCgxzZXJ2aWNlX25hbWUYAyABKAkSDAoEa2V5cxgEIAMoCRIzCgZsYWJlbHMYBSADKAsyIy5zYW0udjEuU2VydmljZUFubm91bmNlLkxhYmVsc0VudHJ5EhcKD2FjdGl2ZV9yZXF1ZXN0cxgGIAEoDRIXCg9sYXRlbmN5X2V3bWFfbXMYByABKAESMQoNYW5ub3VuY2VfdGltZRgIIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASKHAQoYQ29udHJvbFBsYW5lSW5mb1Jlc3BvbnNlEhMKC29pZGNfaXNzdWVyGAEgASgJEhEKCWNsaWVudF9pZBgCIAEoCRIQCghhdWRpZW5jZRgDIAEoCRIYChByb3V0ZXJfYWRkcmVzc2VzGAQgAygJEhcKD2Jhbm5lZF9wZWVyX2lkcxgFIAMoCSKsAQoSUm91dGVyTGVhc2VSZXF1ZXN0Eg8KB3BlZXJfaWQYASABKAkSEQoJYWRkcmVzc2VzGAIgAygJEg8KB2Jpc2N1aXQYAyABKAwSFwoPY29ubmVjdGVkX3BlZXJzGAQgAygJEhAKCGRodF9zaXplGAUgASgFEhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwiZgoTUm91dGVyTGVhc2VSZXNwb25zZRIPCgdzdWNjZXNzGAEgASgIEg0KBWVycm9yGAIgASgJEi8KC2V4cGlyZV90aW1lGAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCKeAQoKUG9saWN5Um9sZRIMCgRuYW1lGAEgASgJEhcKD2FsbG93ZWRfdGFyZ2V0cxgCIAMoCRIYChBhbGxvd2VkX3NlcnZpY2VzGAMgAygJEhYKDmN1c3RvbV9kYXRhbG9nGAQgAygJEhYKDmFsbG93ZWRfbGFiZWxzGAUgAygJEh8KBGh0dHAYBiADKAsyES5zYW0udjEuSFRUUEdyYW50IjwKCUhUVFBHcmFudBIPCgdzZXJ2aWNlGAEgASgJEg8KB21ldGhvZHMYAiADKAkSDQoFcGF0aHMYAyADKAkijwIKEUVncmVzc0Rlc3RpbmF0aW9uEgwKBG5hbWUYASABKAkSEgoKdGFyZ2V0X3VybBgCIAEoCRISCgpjcmVkZW50aWFsGAMgASgJEhEKCXNlcnZlZF9ieRgEIAMoCRIoCgZicm9rZXIYBSABKAsyGC5zYW0udjEuQ3JlZGVudGlhbEJyb2tlchImCgppbnNwZWN0aW9uGAYgASgLMhIuc2FtLnYxLkluc3BlY3Rpb24SIAoEbW9kZRgHIAEoDjISLnNhbS52MS5FZ3Jlc3NNb2RlEg0KBXBvcnRzGAggAygNEhUKDXByZXNlcnZlX2hvc3QYCSABKAgSFwoPZm9yd2FyZF9jb250ZXh0GAogASgIIjMKCkluc3BlY3Rpb24SJQoKaW5zcGVjdG9ycxgBIAMoCzIRLnNhbS52MS5JbnNwZWN0b3IiYwoJSW5zcGVjdG9yEikKC21vZGVsX2FybW9yGAEgASgLMhIuc2FtLnYxLk1vZGVsQXJtb3JIABIjCghleHRfcHJvYxgCIAEoCzIPLnNhbS52MS5FeHRQcm9jSABCBgoEa2luZCKLAQoKTW9kZWxBcm1vchIQCgh0ZW1wbGF0ZRgBIAEoCRIsCghyZXNwb25zZRgCIAEoDjIaLnNhbS52MS5SZXNwb25zZUluc3BlY3Rpb24SEQoJZmFpbF9vcGVuGAMgASgIEioKB3RpbWVvdXQYBCABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24iggIKB0V4dFByb2MSDgoGdGFyZ2V0GAEgASgJEgoKAmNhGAIgASgJEhoKEmNsaWVudF9jZXJ0aWZpY2F0ZRgDIAEoCRI2Cg9wcm9jZXNzaW5nX21vZGUYBCABKAsyHS5zYW0udjEuRXh0UHJvY1Byb2Nlc3NpbmdNb2RlEhsKE2FsbG93X21vZGVfb3ZlcnJpZGUYBSABKAgSMgoPbWVzc2FnZV90aW1lb3V0GAYgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEhoKEmZhaWx1cmVfbW9kZV9hbGxvdxgHIAEoCBIaChJtYXhfYnVmZmVyZWRfYnl0ZXMYCCABKA0i2wQKFUV4dFByb2NQcm9jZXNzaW5nTW9kZRJFChNyZXF1ZXN0X2hlYWRlcl9tb2RlGAEgASgOMiguc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZS5IZWFkZXJNb2RlEkYKFHJlc3BvbnNlX2hlYWRlcl9tb2RlGAIgASgOMiguc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZS5IZWFkZXJNb2RlEkEKEXJlcXVlc3RfYm9keV9tb2RlGAMgASgOMiYuc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZS5Cb2R5TW9kZRJCChJyZXNwb25zZV9ib2R5X21vZGUYBCABKA4yJi5zYW0udjEuRXh0UHJvY1Byb2Nlc3NpbmdNb2RlLkJvZHlNb2RlEkYKFHJlcXVlc3RfdHJhaWxlcl9tb2RlGAUgASgOMiguc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZS5IZWFkZXJNb2RlEkcKFXJlc3BvbnNlX3RyYWlsZXJfbW9kZRgGIAEoDjIoLnNhbS52MS5FeHRQcm9jUHJvY2Vzc2luZ01vZGUuSGVhZGVyTW9kZSI5CgpIZWFkZXJNb2RlEhcKE0hFQURFUl9NT0RFX0RFRkFVTFQQABIICgRTRU5EEAESCAoEU0tJUBACImAKCEJvZHlNb2RlEggKBE5PTkUQABIMCghTVFJFQU1FRBABEgwKCEJVRkZFUkVEEAISFAoQQlVGRkVSRURfUEFSVElBTBADEhgKFEZVTExfRFVQTEVYX1NUUkVBTUVEEAQizwEKEENyZWRlbnRpYWxCcm9rZXISFwoNc3RhdGljX3NlY3JldBgBIAEoCUgAEjEKD29pZGNfZmVkZXJhdGlvbhgCIAEoCzIWLnNhbS52MS5PSURDRmVkZXJhdGlvbkgAEjAKD2F3c19hc3N1bWVfcm9sZRgDIAEoCzIVLnNhbS52MS5BV1NBc3N1bWVSb2xlSAASNQoRcGxhdGZvcm1faWRlbnRpdHkYBCABKAsyGC5zYW0udjEuUGxhdGZvcm1JZGVudGl0eUgAQgYKBGtpbmQiXwoOT0lEQ0ZlZGVyYXRpb24SFgoOdG9rZW5fZW5kcG9pbnQYASABKAkSEAoIYXVkaWVuY2UYAiABKAkSEwoLaW1wZXJzb25hdGUYAyABKAkSDgoGc2NvcGVzGAQgAygJIjkKDUFXU0Fzc3VtZVJvbGUSEAoIcm9sZV9hcm4YASABKAkSFgoOc2Vzc2lvbl9wb2xpY3kYAiABKAkiIgoQUGxhdGZvcm1JZGVudGl0eRIOCgZzY29wZXMYASADKAkiLgoNUG9saWN5QmluZGluZxIMCgRyb2xlGAEgASgJEg8KB21lbWJlcnMYAiADKAkihQEKDFBvbGljeUNvbmZpZxIhCgVyb2xlcxgBIAMoCzISLnNhbS52MS5Qb2xpY3lSb2xlEicKCGJpbmRpbmdzGAIgAygLMhUuc2FtLnYxLlBvbGljeUJpbmRpbmcSKQoGZWdyZXNzGAMgAygLMhkuc2FtLnYxLkVncmVzc0Rlc3RpbmF0aW9uIhgKFlBvbGljeUNvbmZpZ0dldFJlcXVlc3QiMAoXUG9saWN5Q29uZmlnR2V0UmVzcG9uc2USFQoNZGF0YWxvZ19ydWxlcxgBIAMoCSI8ChpQb2xpY3lDb25maWdVcGRhdGVSZXNwb25zZRIPCgdzdWNjZXNzGAEgASgIEg0KBWVycm9yGAIgASgJIhoKGEVncmVzc0Fzc2lnbm1lbnRzUmVxdWVzdCJGChlFZ3Jlc3NBc3NpZ25tZW50c1Jlc3BvbnNlEikKBmVncmVzcxgBIAMoCzIZLnNhbS52MS5FZ3Jlc3NEZXN0aW5hdGlvbiJmCgxLZXlzUmVzcG9uc2USEwoLcHVibGljX2tleXMYASADKAwSLQoJc2lnbl90aW1lGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBISCgpzaWduYXR1cmVzGAMgAygMImsKE1Rva2VuUmVmcmVzaFJlcXVlc3QSGwoTY2hhbGxlbmdlX3NpZ25hdHVyZRgBIAEoDBIZChFjaGFsbGVuZ2VfdW5peF9tcxgCIAEoAxIPCgdwZWVyX2lkGAMgASgJEgsKA2p3dBgEIAEoCSJ1ChRUb2tlblJlZnJlc2hSZXNwb25zZRIVCg1iaXNjdWl0X3Rva2VuGAEgASgMEi8KC2V4cGlyZV90aW1lGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIVCg1lcnJvcl9tZXNzYWdlGAMgASgJIjoKEU5vZGVDYXRhbG9nUmVwb3J0EiUKCHNlcnZpY2VzGAEgAygLMhMuc2FtLnYxLlNlcnZpY2VJbmZvIiUKElRva2VuUmV2b2tlUmVxdWVzdBIPCgdwZWVyX2lkGAEgASgJIjUKE1Rva2VuUmV2b2tlUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBINCgVlcnJvchgCIAEoCSKWAQobQm9vdHN0cmFwVG9rZW5DcmVhdGVSZXF1ZXN0EgwKBHJvbGUYASABKAkSEAoIb3duZXJfaWQYAiABKAkSEQoJdHRsX2hvdXJzGAMgASgFEhIKCm1heF91c2FnZXMYBCABKAUSEwoLZGVzY3JpcHRpb24YBSABKAkSGwoTYXV0b25vbW91c19yZWNvdmVyeRgGIAEoCCKKAQocQm9vdHN0cmFwVG9rZW5DcmVhdGVSZXNwb25zZRIKCgJpZBgBIAEoCRINCgV0b2tlbhgCIAEoCRIMCgRyb2xlGAMgASgJEhAKCG93bmVyX2lkGAQgASgJEi8KC2V4cGlyZV90aW1lGAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCKrAgoOQm9vdHN0cmFwVG9rZW4SCgoCaWQYASABKAkSDAoEcm9sZRgCIAEoCRIQCghvd25lcl9pZBgDIAEoCRISCgptYXhfdXNhZ2VzGAQgASgFEhQKDHVzYWdlc19jb3VudBgFIAEoBRITCgtkZXNjcmlwdGlvbhgGIAEoCRIvCgtjcmVhdGVfdGltZRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoLZXhwaXJlX3RpbWUYCCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEi8KC3Jldm9rZV90aW1lGAkgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIbChNhdXRvbm9tb3VzX3JlY292ZXJ5GAogASgIIkQKGkJvb3RzdHJhcFRva2VuTGlzdFJlc3BvbnNlEiYKBnRva2VucxgBIAMoCzIWLnNhbS52MS5Cb290c3RyYXBUb2tlbiLKAgoRRW5yb2xsbWVudFJlcXVlc3QSCgoCaWQYASABKAkSDwoHcGVlcl9pZBgCIAEoCRIQCgh0b2tlbl9pZBgDIAEoCRIoCgZzdGF0dXMYBCABKA4yGC5zYW0udjEuRW5yb2xsbWVudFN0YXR1cxI1CgZsYWJlbHMYBSADKAsyJS5zYW0udjEuRW5yb2xsbWVudFJlcXVlc3QuTGFiZWxzRW50cnkSLwoLY3JlYXRlX3RpbWUYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjAKDHJlc29sdmVfdGltZRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASEwoLcmVzb2x2ZWRfYnkYCCABKAkaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASJMCh1FbnJvbGxtZW50UmVxdWVzdExpc3RSZXNwb25zZRIrCghyZXF1ZXN0cxgBIAMoCzIZLnNhbS52MS5FbnJvbGxtZW50UmVxdWVzdCJwCgRVc2VyEgoKAmlkGAEgASgJEg4KBmlzc3VlchgCIAEoCRINCgVlbWFpbBgDIAEoCRIMCgRyb2xlGAQgASgJEi8KC2NyZWF0ZV90aW1lGAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCLdAgoMRW5yb2xsZWROb2RlEg8KB3BlZXJfaWQYASABKAkSDAoEcm9sZRgCIAEoCRIXCg9lbnJvbGxtZW50X3R5cGUYAyABKAkSEwoLY2xhaW1zX2pzb24YBCABKAkSEAoIb3duZXJfaWQYBSABKAkSMAoGbGFiZWxzGAYgAygLMiAuc2FtLnYxLkVucm9sbGVkTm9kZS5MYWJlbHNFbnRyeRIvCgtlbnJvbGxfdGltZRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoLZXhwaXJlX3RpbWUYCCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEg4KBmJhbm5lZBgJIAEoCBIbChNhdXRvbm9tb3VzX3JlY292ZXJ5GAogASgIGi0KC0xhYmVsc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEixAEKC1JvdXRlckxlYXNlEg8KB3BlZXJfaWQYASABKAkSEQoJYWRkcmVzc2VzGAIgAygJEjUKEWxhc3RfcmVuZXdhbF90aW1lGAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIvCgtleHBpcmVfdGltZRgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASFwoPY29ubmVjdGVkX3BlZXJzGAUgAygJEhAKCGRodF9zaXplGAYgASgFImYKDE5vZGVTZXJ2aWNlcxIlCghzZXJ2aWNlcxgBIAMoCzITLnNhbS52MS5TZXJ2aWNlSW5mbxIvCgtyZXBvcnRfdGltZRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiqwMKE0FkbWluU3RhdHVzUmVzcG9uc2USGwoFdXNlcnMYASADKAsyDC5zYW0udjEuVXNlchIrCg5hY3RpdmVfcm91dGVycxgCIAMoCzITLnNhbS52MS5Sb3V0ZXJMZWFzZRIsCg5lbnJvbGxlZF9ub2RlcxgDIAMoCzIULnNhbS52MS5FbnJvbGxlZE5vZGUSNgoTZW5yb2xsbWVudF9yZXF1ZXN0cxgEIAMoCzIZLnNhbS52MS5FbnJvbGxtZW50UmVxdWVzdBIwChBib290c3RyYXBfdG9rZW5zGAUgAygLMhYuc2FtLnYxLkJvb3RzdHJhcFRva2VuEiQKBnBvbGljeRgGIAEoCzIULnNhbS52MS5Qb2xpY3lDb25maWcSQgoMbm9kZV9jYXRhbG9nGAcgAygLMiwuc2FtLnYxLkFkbWluU3RhdHVzUmVzcG9uc2UuTm9kZUNhdGFsb2dFbnRyeRpIChBOb2RlQ2F0YWxvZ0VudHJ5EgsKA2tleRgBIAEoCRIjCgV2YWx1ZRgCIAEoCzIULnNhbS52MS5Ob2RlU2VydmljZXM6AjgBIuMBChJVc2VyU3RhdHVzUmVzcG9uc2USGgoEdXNlchgBIAEoCzIMLnNhbS52MS5Vc2VyEiwKDmVucm9sbGVkX25vZGVzGAIgAygLMhQuc2FtLnYxLkVucm9sbGVkTm9kZRIwChBib290c3RyYXBfdG9rZW5zGAMgAygLMhYuc2FtLnYxLkJvb3RzdHJhcFRva2VuEisKDmFjdGl2ZV9yb3V0ZXJzGAQgAygLMhMuc2FtLnYxLlJvdXRlckxlYXNlEiQKBnBvbGljeRgFIAEoCzIULnNhbS52MS5Qb2xpY3lDb25maWci5AEKGElkZW50aXR5RXZpZGVuY2VSZXNwb25zZRIPCgdwZWVyX2lkGAEgASgJEg8KB2Jpc2N1aXQYAiABKAwSNwoTYmlzY3VpdF9leHBpcmVfdGltZRgDIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASGQoRY29udHJvbF9wbGFuZV91cmwYBCABKAkSIgoadHJ1c3RlZF9jb250cm9sX3BsYW5lX2tleXMYBSADKAwSLgoKY2hlY2tfdGltZRgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiwAIKFFBlZXJFdmlkZW5jZVJlc3BvbnNlEg8KB3BlZXJfaWQYASABKAkSDwoHYmlzY3VpdBgCIAEoDBIVCg12ZXJpZnlpbmdfa2V5GAMgASgMEg0KBXJvbGVzGAQgAygJEjgKBmxhYmVscxgFIAMoCzIoLnNhbS52MS5QZWVyRXZpZGVuY2VSZXNwb25zZS5MYWJlbHNFbnRyeRIvCgtleHBpcmVfdGltZRgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASFgoOcmV2b2NhdGlvbl9pZHMYByADKAkSLgoKY2hlY2tfdGltZRgIIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASKAAgoQTWVtYmVyQ3JlZGVudGlhbBIZChFjb250cm9sX3BsYW5lX3VybBgBIAEoCRIPCgdiaXNjdWl0GAIgASgMEi8KC2V4cGlyZV90aW1lGAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIvCgx0cnVzdGVkX2tleXMYBCADKAsyGS5zYW0udjEuVHJ1c3RlZFNpZ25pbmdLZXkSGQoRaXNzdWVkX3VuZGVyX2tleXMYBSADKAwSGAoQcm91dGVyX2FkZHJlc3NlcxgGIAMoCRIpCgxvaWRjX3Nlc3Npb24YByABKAsyEy5zYW0udjEuT0lEQ1Nlc3Npb24iWQoRVHJ1c3RlZFNpZ25pbmdLZXkSEgoKcHVibGljX2tleRgBIAEoDBIwCgxyZWNlaXZlX3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIlkKC09JRENTZXNzaW9uEg4KBmlzc3VlchgBIAEoCRIRCgljbGllbnRfaWQYAiABKAkSEAoIYXVkaWVuY2UYAyABKAkSFQoNcmVmcmVzaF90b2tlbhgEIAEoCSKNAQoVVGFza0F1dGhvcml6YXRpb25SdWxlEgwKBG5hbWUYASABKAkSFAoMZGlzcGxheV9uYW1lGAIgASgJEh8KBXJ1bGVzGAMgAygLMhAuc2FtLnYxLlRhc2tSdWxlEi8KC2V4cGlyZV90aW1lGAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCJ+CghUYXNrUnVsZRITCgtkZXNjcmlwdGlvbhgBIAEoCRIYChBhbGxvd2VkX3NlcnZpY2VzGAIgAygJEigKCW9wZXJhdGlvbhgDIAEoCzIVLnNhbS52MS5UYXNrT3BlcmF0aW9uEhkKEWFsbG93ZWRfcmVzb3VyY2VzGAQgAygJInMKDVRhc2tPcGVyYXRpb24SFQoNYWxsb3dlZF90b29scxgBIAMoCRIXCg9hbGxvd2VkX21ldGhvZHMYAiADKAkSFQoNYWxsb3dlZF9wYXRocxgDIAMoCRIbChNhbGxvd2VkX3Blcm1pc3Npb25zGAQgAygJIqUBChRUb2tlbkV4Y2hhbmdlUmVxdWVzdBIVCg1zdWJqZWN0X3Rva2VuGAEgASgJEjAKCXRhc2tfcnVsZRgCIAEoCzIdLnNhbS52MS5UYXNrQXV0aG9yaXphdGlvblJ1bGUSDAoEc2VhbBgDIAEoCBIZChFjaGFsbGVuZ2VfdW5peF9tcxgEIAEoAxIbChNjaGFsbGVuZ2Vfc2lnbmF0dXJlGAUgASgMIn8KFVRva2VuRXhjaGFuZ2VSZXNwb25zZRIVCg1iaXNjdWl0X3Rva2VuGAEgASgMEi8KC2V4cGlyZV90aW1lGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBINCgVyb2xlcxgDIAMoCRIPCgdzdWJqZWN0GAQgASgJIoEBCg9TVFNUb2tlblJlcXVlc3QSDwoHYmlzY3VpdBgBIAEoDBITCgtkZXN0aW5hdGlvbhgCIAEoCRIQCghhdWRpZW5jZRgDIAEoCRIZChFjaGFsbGVuZ2VfdW5peF9tcxgEIAEoAxIbChNjaGFsbGVuZ2Vfc2lnbmF0dXJlGAUgASgMIoMBChBTVFNUb2tlblJlc3BvbnNlEgsKA2p3dBgBIAEoCRIvCgtleHBpcmVfdGltZRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASDwoHc3ViamVjdBgDIAEoCRINCgVyb2xlcxgEIAMoCRIRCgl0YXNrX25hbWUYBSABKAkiRgoTUmV2b2NhdGlvbnNSZXNwb25zZRIWCg5yZXZvY2F0aW9uX2lkcxgBIAMoCRIXCg9iYW5uZWRfcGVlcl9pZHMYAiADKAkqlAEKEEVucm9sbG1lbnRTdGF0dXMSIQodRU5ST0xMTUVOVF9TVEFUVVNfVU5TUEVDSUZJRUQQABIdChlFTlJPTExNRU5UX1NUQVRVU19QRU5ESU5HEAESHgoaRU5ST0xMTUVOVF9TVEFUVVNfQVBQUk9WRUQQAhIeChpFTlJPTExNRU5UX1NUQVRVU19SRUpFQ1RFRBADKowBCgtTZXJ2aWNlVHlwZRIcChhTRVJWSUNFX1RZUEVfVU5TUEVDSUZJRUQQABIUChBTRVJWSUNFX1RZUEVfTUNQEAESGgoWU0VSVklDRV9UWVBFX0lORkVSRU5DRRACEhQKEFNFUlZJQ0VfVFlQRV9BMkEQAxIXChNTRVJWSUNFX1RZUEVfRUdSRVNTEAQqNwoKRWdyZXNzTW9kZRIUChBFR1JFU1NfTU9ERV9IVFRQEAASEwoPRUdSRVNTX01PREVfVENQEAEqXAoSUmVzcG9uc2VJbnNwZWN0aW9uEiAKHFJFU1BPTlNFX0lOU1BFQ1RJT05fQlVGRkVSRUQQABIkCiBSRVNQT05TRV9JTlNQRUNUSU9OX1JFUVVFU1RfT05MWRABQhtaGWdpdGh1Yi5jb20vZ29vZ2xlL3NhbS9hcGliBnByb3RvMw", [file_google_protobuf_duration, file_google_protobuf_timestamp]);
+ fileDesc("CglzYW0ucHJvdG8SBnNhbS52MSI0CglBdXRoRnJhbWUSDwoHYmlzY3VpdBgBIAEoDBIWCg50YXJnZXRfc2VydmljZRgCIAEoCSI/CgxBdXRoUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBINCgVlcnJvchgCIAEoCRIPCgdiaXNjdWl0GAMgASgMItYBCglNZXNoRXZlbnQSJAoEdHlwZRgBIAEoDjIWLnNhbS52MS5NZXNoRXZlbnQuVHlwZRIPCgdwZWVyX2lkGAIgASgJEi4KCmV2ZW50X3RpbWUYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhYKDm5ld19wdWJsaWNfa2V5GAQgASgMEhEKCXNpZ25hdHVyZRgFIAEoDCI3CgRUeXBlEgoKBkJBTk5FRBAAEhAKDEtFWV9ST1RBVElPThABEhEKDVBPTElDWV9VUERBVEUQAiLzAQoNRW5yb2xsUmVxdWVzdBILCgNqd3QYASABKAkSDwoHcGVlcl9pZBgCIAEoCRISCgpwdWJsaWNfa2V5GAMgASgMEhYKDnJlcXVlc3RlZF9yb2xlGAQgASgJEjEKBmxhYmVscxgFIAMoCzIhLnNhbS52MS5FbnJvbGxSZXF1ZXN0LkxhYmVsc0VudHJ5EhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASKrAQoORW5yb2xsUmVzcG9uc2USFQoNYmlzY3VpdF90b2tlbhgBIAEoDBIVCg1lcnJvcl9tZXNzYWdlGAIgASgJEiAKGGNvbnRyb2xfcGxhbmVfcHVibGljX2tleRgDIAEoDBIYChByb3V0ZXJfYWRkcmVzc2VzGAQgAygJEi8KC2V4cGlyZV90aW1lGAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCKRAgoWQm9vdHN0cmFwRW5yb2xsUmVxdWVzdBIXCg9ib290c3RyYXBfdG9rZW4YASABKAkSDwoHcGVlcl9pZBgCIAEoCRISCgpwdWJsaWNfa2V5GAMgASgMEhYKDnJlcXVlc3RlZF9yb2xlGAQgASgJEjoKBmxhYmVscxgFIAMoCzIqLnNhbS52MS5Cb290c3RyYXBFbnJvbGxSZXF1ZXN0LkxhYmVsc0VudHJ5EhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASL9AQoXQm9vdHN0cmFwRW5yb2xsUmVzcG9uc2USKAoGc3RhdHVzGAEgASgOMhguc2FtLnYxLkVucm9sbG1lbnRTdGF0dXMSFQoNYmlzY3VpdF90b2tlbhgCIAEoDBIdChVwb2xsX2ludGVydmFsX3NlY29uZHMYAyABKAUSFQoNZXJyb3JfbWVzc2FnZRgEIAEoCRIgChhjb250cm9sX3BsYW5lX3B1YmxpY19rZXkYBSABKAwSGAoQcm91dGVyX2FkZHJlc3NlcxgGIAMoCRIvCgtleHBpcmVfdGltZRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiUwoLU2VydmljZUluZm8SIQoEdHlwZRgBIAEoDjITLnNhbS52MS5TZXJ2aWNlVHlwZRIMCgRuYW1lGAIgASgJEhMKC2Rlc2NyaXB0aW9uGAMgASgJInsKDkNvbW1hbmRCYWNrZW5kEg8KB2NvbW1hbmQYASADKAkSLAoDZW52GAIgAygLMh8uc2FtLnYxLkNvbW1hbmRCYWNrZW5kLkVudkVudHJ5GioKCEVudkVudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEiigEKFlJlZ2lzdGVyU2VydmljZVJlcXVlc3QSJAoHc2VydmljZRgBIAEoCzITLnNhbS52MS5TZXJ2aWNlSW5mbxIUCgp0YXJnZXRfdXJsGAIgASgJSAASKQoHY29tbWFuZBgDIAEoCzIWLnNhbS52MS5Db21tYW5kQmFja2VuZEgAQgkKB2JhY2tlbmQiaQoSRGlzY292ZXJlZFByb3ZpZGVyEg8KB3BlZXJfaWQYASABKAkSFwoPbG9jYWxfcHJveHlfdXJsGAIgASgJEhAKCHNydl9uYW1lGAMgASgJEhcKD3Nydl9kZXNjcmlwdGlvbhgEIAEoCSKyAgoPU2VydmljZUFubm91bmNlEg8KB3BlZXJfaWQYASABKAkSIQoEdHlwZRgCIAEoDjITLnNhbS52MS5TZXJ2aWNlVHlwZRIUCgxzZXJ2aWNlX25hbWUYAyABKAkSDAoEa2V5cxgEIAMoCRIzCgZsYWJlbHMYBSADKAsyIy5zYW0udjEuU2VydmljZUFubm91bmNlLkxhYmVsc0VudHJ5EhcKD2FjdGl2ZV9yZXF1ZXN0cxgGIAEoDRIXCg9sYXRlbmN5X2V3bWFfbXMYByABKAESMQoNYW5ub3VuY2VfdGltZRgIIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAaLQoLTGFiZWxzRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASKHAQoYQ29udHJvbFBsYW5lSW5mb1Jlc3BvbnNlEhMKC29pZGNfaXNzdWVyGAEgASgJEhEKCWNsaWVudF9pZBgCIAEoCRIQCghhdWRpZW5jZRgDIAEoCRIYChByb3V0ZXJfYWRkcmVzc2VzGAQgAygJEhcKD2Jhbm5lZF9wZWVyX2lkcxgFIAMoCSLUAQoSUm91dGVyTGVhc2VSZXF1ZXN0Eg8KB3BlZXJfaWQYASABKAkSEQoJYWRkcmVzc2VzGAIgAygJEg8KB2Jpc2N1aXQYAyABKAwSFwoPY29ubmVjdGVkX3BlZXJzGAQgAygJEhAKCGRodF9zaXplGAUgASgFEhkKEWNoYWxsZW5nZV91bml4X21zGAYgASgDEhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYByABKAwSJgoDdHRsGAggASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uImYKE1JvdXRlckxlYXNlUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBINCgVlcnJvchgCIAEoCRIvCgtleHBpcmVfdGltZRgDIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAingEKClBvbGljeVJvbGUSDAoEbmFtZRgBIAEoCRIXCg9hbGxvd2VkX3RhcmdldHMYAiADKAkSGAoQYWxsb3dlZF9zZXJ2aWNlcxgDIAMoCRIWCg5jdXN0b21fZGF0YWxvZxgEIAMoCRIWCg5hbGxvd2VkX2xhYmVscxgFIAMoCRIfCgRodHRwGAYgAygLMhEuc2FtLnYxLkhUVFBHcmFudCI8CglIVFRQR3JhbnQSDwoHc2VydmljZRgBIAEoCRIPCgdtZXRob2RzGAIgAygJEg0KBXBhdGhzGAMgAygJIo8CChFFZ3Jlc3NEZXN0aW5hdGlvbhIMCgRuYW1lGAEgASgJEhIKCnRhcmdldF91cmwYAiABKAkSEgoKY3JlZGVudGlhbBgDIAEoCRIRCglzZXJ2ZWRfYnkYBCADKAkSKAoGYnJva2VyGAUgASgLMhguc2FtLnYxLkNyZWRlbnRpYWxCcm9rZXISJgoKaW5zcGVjdGlvbhgGIAEoCzISLnNhbS52MS5JbnNwZWN0aW9uEiAKBG1vZGUYByABKA4yEi5zYW0udjEuRWdyZXNzTW9kZRINCgVwb3J0cxgIIAMoDRIVCg1wcmVzZXJ2ZV9ob3N0GAkgASgIEhcKD2ZvcndhcmRfY29udGV4dBgKIAEoCCIzCgpJbnNwZWN0aW9uEiUKCmluc3BlY3RvcnMYASADKAsyES5zYW0udjEuSW5zcGVjdG9yImMKCUluc3BlY3RvchIpCgttb2RlbF9hcm1vchgBIAEoCzISLnNhbS52MS5Nb2RlbEFybW9ySAASIwoIZXh0X3Byb2MYAiABKAsyDy5zYW0udjEuRXh0UHJvY0gAQgYKBGtpbmQiiwEKCk1vZGVsQXJtb3ISEAoIdGVtcGxhdGUYASABKAkSLAoIcmVzcG9uc2UYAiABKA4yGi5zYW0udjEuUmVzcG9uc2VJbnNwZWN0aW9uEhEKCWZhaWxfb3BlbhgDIAEoCBIqCgd0aW1lb3V0GAQgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uIoICCgdFeHRQcm9jEg4KBnRhcmdldBgBIAEoCRIKCgJjYRgCIAEoCRIaChJjbGllbnRfY2VydGlmaWNhdGUYAyABKAkSNgoPcHJvY2Vzc2luZ19tb2RlGAQgASgLMh0uc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZRIbChNhbGxvd19tb2RlX292ZXJyaWRlGAUgASgIEjIKD21lc3NhZ2VfdGltZW91dBgGIAEoCzIZLmdvb2dsZS5wcm90b2J1Zi5EdXJhdGlvbhIaChJmYWlsdXJlX21vZGVfYWxsb3cYByABKAgSGgoSbWF4X2J1ZmZlcmVkX2J5dGVzGAggASgNItsEChVFeHRQcm9jUHJvY2Vzc2luZ01vZGUSRQoTcmVxdWVzdF9oZWFkZXJfbW9kZRgBIAEoDjIoLnNhbS52MS5FeHRQcm9jUHJvY2Vzc2luZ01vZGUuSGVhZGVyTW9kZRJGChRyZXNwb25zZV9oZWFkZXJfbW9kZRgCIAEoDjIoLnNhbS52MS5FeHRQcm9jUHJvY2Vzc2luZ01vZGUuSGVhZGVyTW9kZRJBChFyZXF1ZXN0X2JvZHlfbW9kZRgDIAEoDjImLnNhbS52MS5FeHRQcm9jUHJvY2Vzc2luZ01vZGUuQm9keU1vZGUSQgoScmVzcG9uc2VfYm9keV9tb2RlGAQgASgOMiYuc2FtLnYxLkV4dFByb2NQcm9jZXNzaW5nTW9kZS5Cb2R5TW9kZRJGChRyZXF1ZXN0X3RyYWlsZXJfbW9kZRgFIAEoDjIoLnNhbS52MS5FeHRQcm9jUHJvY2Vzc2luZ01vZGUuSGVhZGVyTW9kZRJHChVyZXNwb25zZV90cmFpbGVyX21vZGUYBiABKA4yKC5zYW0udjEuRXh0UHJvY1Byb2Nlc3NpbmdNb2RlLkhlYWRlck1vZGUiOQoKSGVhZGVyTW9kZRIXChNIRUFERVJfTU9ERV9ERUZBVUxUEAASCAoEU0VORBABEggKBFNLSVAQAiJgCghCb2R5TW9kZRIICgROT05FEAASDAoIU1RSRUFNRUQQARIMCghCVUZGRVJFRBACEhQKEEJVRkZFUkVEX1BBUlRJQUwQAxIYChRGVUxMX0RVUExFWF9TVFJFQU1FRBAEIs8BChBDcmVkZW50aWFsQnJva2VyEhcKDXN0YXRpY19zZWNyZXQYASABKAlIABIxCg9vaWRjX2ZlZGVyYXRpb24YAiABKAsyFi5zYW0udjEuT0lEQ0ZlZGVyYXRpb25IABIwCg9hd3NfYXNzdW1lX3JvbGUYAyABKAsyFS5zYW0udjEuQVdTQXNzdW1lUm9sZUgAEjUKEXBsYXRmb3JtX2lkZW50aXR5GAQgASgLMhguc2FtLnYxLlBsYXRmb3JtSWRlbnRpdHlIAEIGCgRraW5kIl8KDk9JRENGZWRlcmF0aW9uEhYKDnRva2VuX2VuZHBvaW50GAEgASgJEhAKCGF1ZGllbmNlGAIgASgJEhMKC2ltcGVyc29uYXRlGAMgASgJEg4KBnNjb3BlcxgEIAMoCSI5Cg1BV1NBc3N1bWVSb2xlEhAKCHJvbGVfYXJuGAEgASgJEhYKDnNlc3Npb25fcG9saWN5GAIgASgJIiIKEFBsYXRmb3JtSWRlbnRpdHkSDgoGc2NvcGVzGAEgAygJIi4KDVBvbGljeUJpbmRpbmcSDAoEcm9sZRgBIAEoCRIPCgdtZW1iZXJzGAIgAygJIoUBCgxQb2xpY3lDb25maWcSIQoFcm9sZXMYASADKAsyEi5zYW0udjEuUG9saWN5Um9sZRInCghiaW5kaW5ncxgCIAMoCzIVLnNhbS52MS5Qb2xpY3lCaW5kaW5nEikKBmVncmVzcxgDIAMoCzIZLnNhbS52MS5FZ3Jlc3NEZXN0aW5hdGlvbiIYChZQb2xpY3lDb25maWdHZXRSZXF1ZXN0IjAKF1BvbGljeUNvbmZpZ0dldFJlc3BvbnNlEhUKDWRhdGFsb2dfcnVsZXMYASADKAkiPAoaUG9saWN5Q29uZmlnVXBkYXRlUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBINCgVlcnJvchgCIAEoCSIaChhFZ3Jlc3NBc3NpZ25tZW50c1JlcXVlc3QiRgoZRWdyZXNzQXNzaWdubWVudHNSZXNwb25zZRIpCgZlZ3Jlc3MYASADKAsyGS5zYW0udjEuRWdyZXNzRGVzdGluYXRpb24iZgoMS2V5c1Jlc3BvbnNlEhMKC3B1YmxpY19rZXlzGAEgAygMEi0KCXNpZ25fdGltZRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASEgoKc2lnbmF0dXJlcxgDIAMoDCJrChNUb2tlblJlZnJlc2hSZXF1ZXN0EhsKE2NoYWxsZW5nZV9zaWduYXR1cmUYASABKAwSGQoRY2hhbGxlbmdlX3VuaXhfbXMYAiABKAMSDwoHcGVlcl9pZBgDIAEoCRILCgNqd3QYBCABKAkidQoUVG9rZW5SZWZyZXNoUmVzcG9uc2USFQoNYmlzY3VpdF90b2tlbhgBIAEoDBIvCgtleHBpcmVfdGltZRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASFQoNZXJyb3JfbWVzc2FnZRgDIAEoCSI6ChFOb2RlQ2F0YWxvZ1JlcG9ydBIlCghzZXJ2aWNlcxgBIAMoCzITLnNhbS52MS5TZXJ2aWNlSW5mbyIlChJUb2tlblJldm9rZVJlcXVlc3QSDwoHcGVlcl9pZBgBIAEoCSI1ChNUb2tlblJldm9rZVJlc3BvbnNlEg8KB3N1Y2Nlc3MYASABKAgSDQoFZXJyb3IYAiABKAkilgEKG0Jvb3RzdHJhcFRva2VuQ3JlYXRlUmVxdWVzdBIMCgRyb2xlGAEgASgJEhAKCG93bmVyX2lkGAIgASgJEhEKCXR0bF9ob3VycxgDIAEoBRISCgptYXhfdXNhZ2VzGAQgASgFEhMKC2Rlc2NyaXB0aW9uGAUgASgJEhsKE2F1dG9ub21vdXNfcmVjb3ZlcnkYBiABKAgiigEKHEJvb3RzdHJhcFRva2VuQ3JlYXRlUmVzcG9uc2USCgoCaWQYASABKAkSDQoFdG9rZW4YAiABKAkSDAoEcm9sZRgDIAEoCRIQCghvd25lcl9pZBgEIAEoCRIvCgtleHBpcmVfdGltZRgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiqwIKDkJvb3RzdHJhcFRva2VuEgoKAmlkGAEgASgJEgwKBHJvbGUYAiABKAkSEAoIb3duZXJfaWQYAyABKAkSEgoKbWF4X3VzYWdlcxgEIAEoBRIUCgx1c2FnZXNfY291bnQYBSABKAUSEwoLZGVzY3JpcHRpb24YBiABKAkSLwoLY3JlYXRlX3RpbWUYByABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEi8KC2V4cGlyZV90aW1lGAggASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIvCgtyZXZva2VfdGltZRgJIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASGwoTYXV0b25vbW91c19yZWNvdmVyeRgKIAEoCCJEChpCb290c3RyYXBUb2tlbkxpc3RSZXNwb25zZRImCgZ0b2tlbnMYASADKAsyFi5zYW0udjEuQm9vdHN0cmFwVG9rZW4iygIKEUVucm9sbG1lbnRSZXF1ZXN0EgoKAmlkGAEgASgJEg8KB3BlZXJfaWQYAiABKAkSEAoIdG9rZW5faWQYAyABKAkSKAoGc3RhdHVzGAQgASgOMhguc2FtLnYxLkVucm9sbG1lbnRTdGF0dXMSNQoGbGFiZWxzGAUgAygLMiUuc2FtLnYxLkVucm9sbG1lbnRSZXF1ZXN0LkxhYmVsc0VudHJ5Ei8KC2NyZWF0ZV90aW1lGAYgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIwCgxyZXNvbHZlX3RpbWUYByABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhMKC3Jlc29sdmVkX2J5GAggASgJGi0KC0xhYmVsc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEiTAodRW5yb2xsbWVudFJlcXVlc3RMaXN0UmVzcG9uc2USKwoIcmVxdWVzdHMYASADKAsyGS5zYW0udjEuRW5yb2xsbWVudFJlcXVlc3QicAoEVXNlchIKCgJpZBgBIAEoCRIOCgZpc3N1ZXIYAiABKAkSDQoFZW1haWwYAyABKAkSDAoEcm9sZRgEIAEoCRIvCgtjcmVhdGVfdGltZRgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAi3QIKDEVucm9sbGVkTm9kZRIPCgdwZWVyX2lkGAEgASgJEgwKBHJvbGUYAiABKAkSFwoPZW5yb2xsbWVudF90eXBlGAMgASgJEhMKC2NsYWltc19qc29uGAQgASgJEhAKCG93bmVyX2lkGAUgASgJEjAKBmxhYmVscxgGIAMoCzIgLnNhbS52MS5FbnJvbGxlZE5vZGUuTGFiZWxzRW50cnkSLwoLZW5yb2xsX3RpbWUYByABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEi8KC2V4cGlyZV90aW1lGAggASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIOCgZiYW5uZWQYCSABKAgSGwoTYXV0b25vbW91c19yZWNvdmVyeRgKIAEoCBotCgtMYWJlbHNFbnRyeRILCgNrZXkYASABKAkSDQoFdmFsdWUYAiABKAk6AjgBIsQBCgtSb3V0ZXJMZWFzZRIPCgdwZWVyX2lkGAEgASgJEhEKCWFkZHJlc3NlcxgCIAMoCRI1ChFsYXN0X3JlbmV3YWxfdGltZRgDIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoLZXhwaXJlX3RpbWUYBCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhcKD2Nvbm5lY3RlZF9wZWVycxgFIAMoCRIQCghkaHRfc2l6ZRgGIAEoBSJmCgxOb2RlU2VydmljZXMSJQoIc2VydmljZXMYASADKAsyEy5zYW0udjEuU2VydmljZUluZm8SLwoLcmVwb3J0X3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIqsDChNBZG1pblN0YXR1c1Jlc3BvbnNlEhsKBXVzZXJzGAEgAygLMgwuc2FtLnYxLlVzZXISKwoOYWN0aXZlX3JvdXRlcnMYAiADKAsyEy5zYW0udjEuUm91dGVyTGVhc2USLAoOZW5yb2xsZWRfbm9kZXMYAyADKAsyFC5zYW0udjEuRW5yb2xsZWROb2RlEjYKE2Vucm9sbG1lbnRfcmVxdWVzdHMYBCADKAsyGS5zYW0udjEuRW5yb2xsbWVudFJlcXVlc3QSMAoQYm9vdHN0cmFwX3Rva2VucxgFIAMoCzIWLnNhbS52MS5Cb290c3RyYXBUb2tlbhIkCgZwb2xpY3kYBiABKAsyFC5zYW0udjEuUG9saWN5Q29uZmlnEkIKDG5vZGVfY2F0YWxvZxgHIAMoCzIsLnNhbS52MS5BZG1pblN0YXR1c1Jlc3BvbnNlLk5vZGVDYXRhbG9nRW50cnkaSAoQTm9kZUNhdGFsb2dFbnRyeRILCgNrZXkYASABKAkSIwoFdmFsdWUYAiABKAsyFC5zYW0udjEuTm9kZVNlcnZpY2VzOgI4ASLjAQoSVXNlclN0YXR1c1Jlc3BvbnNlEhoKBHVzZXIYASABKAsyDC5zYW0udjEuVXNlchIsCg5lbnJvbGxlZF9ub2RlcxgCIAMoCzIULnNhbS52MS5FbnJvbGxlZE5vZGUSMAoQYm9vdHN0cmFwX3Rva2VucxgDIAMoCzIWLnNhbS52MS5Cb290c3RyYXBUb2tlbhIrCg5hY3RpdmVfcm91dGVycxgEIAMoCzITLnNhbS52MS5Sb3V0ZXJMZWFzZRIkCgZwb2xpY3kYBSABKAsyFC5zYW0udjEuUG9saWN5Q29uZmlnIuQBChhJZGVudGl0eUV2aWRlbmNlUmVzcG9uc2USDwoHcGVlcl9pZBgBIAEoCRIPCgdiaXNjdWl0GAIgASgMEjcKE2Jpc2N1aXRfZXhwaXJlX3RpbWUYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhkKEWNvbnRyb2xfcGxhbmVfdXJsGAQgASgJEiIKGnRydXN0ZWRfY29udHJvbF9wbGFuZV9rZXlzGAUgAygMEi4KCmNoZWNrX3RpbWUYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIsACChRQZWVyRXZpZGVuY2VSZXNwb25zZRIPCgdwZWVyX2lkGAEgASgJEg8KB2Jpc2N1aXQYAiABKAwSFQoNdmVyaWZ5aW5nX2tleRgDIAEoDBINCgVyb2xlcxgEIAMoCRI4CgZsYWJlbHMYBSADKAsyKC5zYW0udjEuUGVlckV2aWRlbmNlUmVzcG9uc2UuTGFiZWxzRW50cnkSLwoLZXhwaXJlX3RpbWUYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhYKDnJldm9jYXRpb25faWRzGAcgAygJEi4KCmNoZWNrX3RpbWUYCCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wGi0KC0xhYmVsc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEigAIKEE1lbWJlckNyZWRlbnRpYWwSGQoRY29udHJvbF9wbGFuZV91cmwYASABKAkSDwoHYmlzY3VpdBgCIAEoDBIvCgtleHBpcmVfdGltZRgDIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoMdHJ1c3RlZF9rZXlzGAQgAygLMhkuc2FtLnYxLlRydXN0ZWRTaWduaW5nS2V5EhkKEWlzc3VlZF91bmRlcl9rZXlzGAUgAygMEhgKEHJvdXRlcl9hZGRyZXNzZXMYBiADKAkSKQoMb2lkY19zZXNzaW9uGAcgASgLMhMuc2FtLnYxLk9JRENTZXNzaW9uIlkKEVRydXN0ZWRTaWduaW5nS2V5EhIKCnB1YmxpY19rZXkYASABKAwSMAoMcmVjZWl2ZV90aW1lGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCJZCgtPSURDU2Vzc2lvbhIOCgZpc3N1ZXIYASABKAkSEQoJY2xpZW50X2lkGAIgASgJEhAKCGF1ZGllbmNlGAMgASgJEhUKDXJlZnJlc2hfdG9rZW4YBCABKAkijQEKFVRhc2tBdXRob3JpemF0aW9uUnVsZRIMCgRuYW1lGAEgASgJEhQKDGRpc3BsYXlfbmFtZRgCIAEoCRIfCgVydWxlcxgDIAMoCzIQLnNhbS52MS5UYXNrUnVsZRIvCgtleHBpcmVfdGltZRgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAifgoIVGFza1J1bGUSEwoLZGVzY3JpcHRpb24YASABKAkSGAoQYWxsb3dlZF9zZXJ2aWNlcxgCIAMoCRIoCglvcGVyYXRpb24YAyABKAsyFS5zYW0udjEuVGFza09wZXJhdGlvbhIZChFhbGxvd2VkX3Jlc291cmNlcxgEIAMoCSJzCg1UYXNrT3BlcmF0aW9uEhUKDWFsbG93ZWRfdG9vbHMYASADKAkSFwoPYWxsb3dlZF9tZXRob2RzGAIgAygJEhUKDWFsbG93ZWRfcGF0aHMYAyADKAkSGwoTYWxsb3dlZF9wZXJtaXNzaW9ucxgEIAMoCSKlAQoUVG9rZW5FeGNoYW5nZVJlcXVlc3QSFQoNc3ViamVjdF90b2tlbhgBIAEoCRIwCgl0YXNrX3J1bGUYAiABKAsyHS5zYW0udjEuVGFza0F1dGhvcml6YXRpb25SdWxlEgwKBHNlYWwYAyABKAgSGQoRY2hhbGxlbmdlX3VuaXhfbXMYBCABKAMSGwoTY2hhbGxlbmdlX3NpZ25hdHVyZRgFIAEoDCJ/ChVUb2tlbkV4Y2hhbmdlUmVzcG9uc2USFQoNYmlzY3VpdF90b2tlbhgBIAEoDBIvCgtleHBpcmVfdGltZRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASDQoFcm9sZXMYAyADKAkSDwoHc3ViamVjdBgEIAEoCSKBAQoPU1RTVG9rZW5SZXF1ZXN0Eg8KB2Jpc2N1aXQYASABKAwSEwoLZGVzdGluYXRpb24YAiABKAkSEAoIYXVkaWVuY2UYAyABKAkSGQoRY2hhbGxlbmdlX3VuaXhfbXMYBCABKAMSGwoTY2hhbGxlbmdlX3NpZ25hdHVyZRgFIAEoDCKDAQoQU1RTVG9rZW5SZXNwb25zZRILCgNqd3QYASABKAkSLwoLZXhwaXJlX3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEg8KB3N1YmplY3QYAyABKAkSDQoFcm9sZXMYBCADKAkSEQoJdGFza19uYW1lGAUgASgJIkYKE1Jldm9jYXRpb25zUmVzcG9uc2USFgoOcmV2b2NhdGlvbl9pZHMYASADKAkSFwoPYmFubmVkX3BlZXJfaWRzGAIgAygJKpQBChBFbnJvbGxtZW50U3RhdHVzEiEKHUVOUk9MTE1FTlRfU1RBVFVTX1VOU1BFQ0lGSUVEEAASHQoZRU5ST0xMTUVOVF9TVEFUVVNfUEVORElORxABEh4KGkVOUk9MTE1FTlRfU1RBVFVTX0FQUFJPVkVEEAISHgoaRU5ST0xMTUVOVF9TVEFUVVNfUkVKRUNURUQQAyqMAQoLU2VydmljZVR5cGUSHAoYU0VSVklDRV9UWVBFX1VOU1BFQ0lGSUVEEAASFAoQU0VSVklDRV9UWVBFX01DUBABEhoKFlNFUlZJQ0VfVFlQRV9JTkZFUkVOQ0UQAhIUChBTRVJWSUNFX1RZUEVfQTJBEAMSFwoTU0VSVklDRV9UWVBFX0VHUkVTUxAEKjcKCkVncmVzc01vZGUSFAoQRUdSRVNTX01PREVfSFRUUBAAEhMKD0VHUkVTU19NT0RFX1RDUBABKlwKElJlc3BvbnNlSW5zcGVjdGlvbhIgChxSRVNQT05TRV9JTlNQRUNUSU9OX0JVRkZFUkVEEAASJAogUkVTUE9OU0VfSU5TUEVDVElPTl9SRVFVRVNUX09OTFkQAUIbWhlnaXRodWIuY29tL2dvb2dsZS9zYW0vYXBpYgZwcm90bzM", [file_google_protobuf_duration, file_google_protobuf_timestamp]);
/**
* @generated from message sam.v1.AuthFrame
@@ -637,6 +637,17 @@ export type RouterLeaseRequest = Message<"sam.v1.RouterLeaseRequest"> & {
* @generated from field: bytes challenge_signature = 7;
*/
challengeSignature: Uint8Array;
+
+ /**
+ * How long this lease stays valid. Unset means the control plane's lease
+ * duration. A router may shorten its lease, never lengthen it: on its last
+ * renewal before stopping it sets the time it expects to be away, zero to
+ * be withdrawn at once, so a joiner is not handed a router that is gone
+ * and a router back within that time is still listed.
+ *
+ * @generated from field: google.protobuf.Duration ttl = 8;
+ */
+ ttl?: Duration | undefined;
};
/**
diff --git a/sdk/python/src/agent_mesh/_proto/sam_pb2.py b/sdk/python/src/agent_mesh/_proto/sam_pb2.py
index c8261ab2..e9bec2a8 100644
--- a/sdk/python/src/agent_mesh/_proto/sam_pb2.py
+++ b/sdk/python/src/agent_mesh/_proto/sam_pb2.py
@@ -15,7 +15,7 @@ from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb
from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\tsam.proto\x12\x06sam.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"4\n\tAuthFrame\x12\x0f\n\x07\x62iscuit\x18\x01 \x01(\x0c\x12\x16\n\x0etarget_service\x18\x02 \x01(\t\"?\n\x0c\x41uthResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x03 \x01(\x0c\"\xd6\x01\n\tMeshEvent\x12$\n\x04type\x18\x01 \x01(\x0e\x32\x16.sam.v1.MeshEvent.Type\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12.\n\nevent_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x16\n\x0enew_public_key\x18\x04 \x01(\x0c\x12\x11\n\tsignature\x18\x05 \x01(\x0c\"7\n\x04Type\x12\n\n\x06\x42\x41NNED\x10\x00\x12\x10\n\x0cKEY_ROTATION\x10\x01\x12\x11\n\rPOLICY_UPDATE\x10\x02\"\xf3\x01\n\rEnrollRequest\x12\x0b\n\x03jwt\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x12\n\npublic_key\x18\x03 \x01(\x0c\x12\x16\n\x0erequested_role\x18\x04 \x01(\t\x12\x31\n\x06labels\x18\x05 \x03(\x0b\x32!.sam.v1.EnrollRequest.LabelsEntry\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xab\x01\n\x0e\x45nrollResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12\x15\n\rerror_message\x18\x02 \x01(\t\x12 \n\x18\x63ontrol_plane_public_key\x18\x03 \x01(\x0c\x12\x18\n\x10router_addresses\x18\x04 \x03(\t\x12/\n\x0b\x65xpire_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x91\x02\n\x16\x42ootstrapEnrollRequest\x12\x17\n\x0f\x62ootstrap_token\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x12\n\npublic_key\x18\x03 \x01(\x0c\x12\x16\n\x0erequested_role\x18\x04 \x01(\t\x12:\n\x06labels\x18\x05 \x03(\x0b\x32*.sam.v1.BootstrapEnrollRequest.LabelsEntry\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xfd\x01\n\x17\x42ootstrapEnrollResponse\x12(\n\x06status\x18\x01 \x01(\x0e\x32\x18.sam.v1.EnrollmentStatus\x12\x15\n\rbiscuit_token\x18\x02 \x01(\x0c\x12\x1d\n\x15poll_interval_seconds\x18\x03 \x01(\x05\x12\x15\n\rerror_message\x18\x04 \x01(\t\x12 \n\x18\x63ontrol_plane_public_key\x18\x05 \x01(\x0c\x12\x18\n\x10router_addresses\x18\x06 \x03(\t\x12/\n\x0b\x65xpire_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"S\n\x0bServiceInfo\x12!\n\x04type\x18\x01 \x01(\x0e\x32\x13.sam.v1.ServiceType\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\"{\n\x0e\x43ommandBackend\x12\x0f\n\x07\x63ommand\x18\x01 \x03(\t\x12,\n\x03\x65nv\x18\x02 \x03(\x0b\x32\x1f.sam.v1.CommandBackend.EnvEntry\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x8a\x01\n\x16RegisterServiceRequest\x12$\n\x07service\x18\x01 \x01(\x0b\x32\x13.sam.v1.ServiceInfo\x12\x14\n\ntarget_url\x18\x02 \x01(\tH\x00\x12)\n\x07\x63ommand\x18\x03 \x01(\x0b\x32\x16.sam.v1.CommandBackendH\x00\x42\t\n\x07\x62\x61\x63kend\"i\n\x12\x44iscoveredProvider\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x17\n\x0flocal_proxy_url\x18\x02 \x01(\t\x12\x10\n\x08srv_name\x18\x03 \x01(\t\x12\x17\n\x0fsrv_description\x18\x04 \x01(\t\"\xb2\x02\n\x0fServiceAnnounce\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12!\n\x04type\x18\x02 \x01(\x0e\x32\x13.sam.v1.ServiceType\x12\x14\n\x0cservice_name\x18\x03 \x01(\t\x12\x0c\n\x04keys\x18\x04 \x03(\t\x12\x33\n\x06labels\x18\x05 \x03(\x0b\x32#.sam.v1.ServiceAnnounce.LabelsEntry\x12\x17\n\x0f\x61\x63tive_requests\x18\x06 \x01(\r\x12\x17\n\x0flatency_ewma_ms\x18\x07 \x01(\x01\x12\x31\n\rannounce_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x87\x01\n\x18\x43ontrolPlaneInfoResponse\x12\x13\n\x0boidc_issuer\x18\x01 \x01(\t\x12\x11\n\tclient_id\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x18\n\x10router_addresses\x18\x04 \x03(\t\x12\x17\n\x0f\x62\x61nned_peer_ids\x18\x05 \x03(\t\"\xac\x01\n\x12RouterLeaseRequest\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x11\n\taddresses\x18\x02 \x03(\t\x12\x0f\n\x07\x62iscuit\x18\x03 \x01(\x0c\x12\x17\n\x0f\x63onnected_peers\x18\x04 \x03(\t\x12\x10\n\x08\x64ht_size\x18\x05 \x01(\x05\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\"f\n\x13RouterLeaseResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x9e\x01\n\nPolicyRole\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0f\x61llowed_targets\x18\x02 \x03(\t\x12\x18\n\x10\x61llowed_services\x18\x03 \x03(\t\x12\x16\n\x0e\x63ustom_datalog\x18\x04 \x03(\t\x12\x16\n\x0e\x61llowed_labels\x18\x05 \x03(\t\x12\x1f\n\x04http\x18\x06 \x03(\x0b\x32\x11.sam.v1.HTTPGrant\"<\n\tHTTPGrant\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07methods\x18\x02 \x03(\t\x12\r\n\x05paths\x18\x03 \x03(\t\"\x8f\x02\n\x11\x45gressDestination\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\ntarget_url\x18\x02 \x01(\t\x12\x12\n\ncredential\x18\x03 \x01(\t\x12\x11\n\tserved_by\x18\x04 \x03(\t\x12(\n\x06\x62roker\x18\x05 \x01(\x0b\x32\x18.sam.v1.CredentialBroker\x12&\n\ninspection\x18\x06 \x01(\x0b\x32\x12.sam.v1.Inspection\x12 \n\x04mode\x18\x07 \x01(\x0e\x32\x12.sam.v1.EgressMode\x12\r\n\x05ports\x18\x08 \x03(\r\x12\x15\n\rpreserve_host\x18\t \x01(\x08\x12\x17\n\x0f\x66orward_context\x18\n \x01(\x08\"3\n\nInspection\x12%\n\ninspectors\x18\x01 \x03(\x0b\x32\x11.sam.v1.Inspector\"c\n\tInspector\x12)\n\x0bmodel_armor\x18\x01 \x01(\x0b\x32\x12.sam.v1.ModelArmorH\x00\x12#\n\x08\x65xt_proc\x18\x02 \x01(\x0b\x32\x0f.sam.v1.ExtProcH\x00\x42\x06\n\x04kind\"\x8b\x01\n\nModelArmor\x12\x10\n\x08template\x18\x01 \x01(\t\x12,\n\x08response\x18\x02 \x01(\x0e\x32\x1a.sam.v1.ResponseInspection\x12\x11\n\tfail_open\x18\x03 \x01(\x08\x12*\n\x07timeout\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\"\x82\x02\n\x07\x45xtProc\x12\x0e\n\x06target\x18\x01 \x01(\t\x12\n\n\x02\x63\x61\x18\x02 \x01(\t\x12\x1a\n\x12\x63lient_certificate\x18\x03 \x01(\t\x12\x36\n\x0fprocessing_mode\x18\x04 \x01(\x0b\x32\x1d.sam.v1.ExtProcProcessingMode\x12\x1b\n\x13\x61llow_mode_override\x18\x05 \x01(\x08\x12\x32\n\x0fmessage_timeout\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x1a\n\x12\x66\x61ilure_mode_allow\x18\x07 \x01(\x08\x12\x1a\n\x12max_buffered_bytes\x18\x08 \x01(\r\"\xdb\x04\n\x15\x45xtProcProcessingMode\x12\x45\n\x13request_header_mode\x18\x01 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12\x46\n\x14response_header_mode\x18\x02 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12\x41\n\x11request_body_mode\x18\x03 \x01(\x0e\x32&.sam.v1.ExtProcProcessingMode.BodyMode\x12\x42\n\x12response_body_mode\x18\x04 \x01(\x0e\x32&.sam.v1.ExtProcProcessingMode.BodyMode\x12\x46\n\x14request_trailer_mode\x18\x05 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12G\n\x15response_trailer_mode\x18\x06 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\"9\n\nHeaderMode\x12\x17\n\x13HEADER_MODE_DEFAULT\x10\x00\x12\x08\n\x04SEND\x10\x01\x12\x08\n\x04SKIP\x10\x02\"`\n\x08\x42odyMode\x12\x08\n\x04NONE\x10\x00\x12\x0c\n\x08STREAMED\x10\x01\x12\x0c\n\x08\x42UFFERED\x10\x02\x12\x14\n\x10\x42UFFERED_PARTIAL\x10\x03\x12\x18\n\x14\x46ULL_DUPLEX_STREAMED\x10\x04\"\xcf\x01\n\x10\x43redentialBroker\x12\x17\n\rstatic_secret\x18\x01 \x01(\tH\x00\x12\x31\n\x0foidc_federation\x18\x02 \x01(\x0b\x32\x16.sam.v1.OIDCFederationH\x00\x12\x30\n\x0f\x61ws_assume_role\x18\x03 \x01(\x0b\x32\x15.sam.v1.AWSAssumeRoleH\x00\x12\x35\n\x11platform_identity\x18\x04 \x01(\x0b\x32\x18.sam.v1.PlatformIdentityH\x00\x42\x06\n\x04kind\"_\n\x0eOIDCFederation\x12\x16\n\x0etoken_endpoint\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t\x12\x13\n\x0bimpersonate\x18\x03 \x01(\t\x12\x0e\n\x06scopes\x18\x04 \x03(\t\"9\n\rAWSAssumeRole\x12\x10\n\x08role_arn\x18\x01 \x01(\t\x12\x16\n\x0esession_policy\x18\x02 \x01(\t\"\"\n\x10PlatformIdentity\x12\x0e\n\x06scopes\x18\x01 \x03(\t\".\n\rPolicyBinding\x12\x0c\n\x04role\x18\x01 \x01(\t\x12\x0f\n\x07members\x18\x02 \x03(\t\"\x85\x01\n\x0cPolicyConfig\x12!\n\x05roles\x18\x01 \x03(\x0b\x32\x12.sam.v1.PolicyRole\x12\'\n\x08\x62indings\x18\x02 \x03(\x0b\x32\x15.sam.v1.PolicyBinding\x12)\n\x06\x65gress\x18\x03 \x03(\x0b\x32\x19.sam.v1.EgressDestination\"\x18\n\x16PolicyConfigGetRequest\"0\n\x17PolicyConfigGetResponse\x12\x15\n\rdatalog_rules\x18\x01 \x03(\t\"<\n\x1aPolicyConfigUpdateResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x1a\n\x18\x45gressAssignmentsRequest\"F\n\x19\x45gressAssignmentsResponse\x12)\n\x06\x65gress\x18\x01 \x03(\x0b\x32\x19.sam.v1.EgressDestination\"f\n\x0cKeysResponse\x12\x13\n\x0bpublic_keys\x18\x01 \x03(\x0c\x12-\n\tsign_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nsignatures\x18\x03 \x03(\x0c\"k\n\x13TokenRefreshRequest\x12\x1b\n\x13\x63hallenge_signature\x18\x01 \x01(\x0c\x12\x19\n\x11\x63hallenge_unix_ms\x18\x02 \x01(\x03\x12\x0f\n\x07peer_id\x18\x03 \x01(\t\x12\x0b\n\x03jwt\x18\x04 \x01(\t\"u\n\x14TokenRefreshResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x15\n\rerror_message\x18\x03 \x01(\t\":\n\x11NodeCatalogReport\x12%\n\x08services\x18\x01 \x03(\x0b\x32\x13.sam.v1.ServiceInfo\"%\n\x12TokenRevokeRequest\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\"5\n\x13TokenRevokeResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x96\x01\n\x1b\x42ootstrapTokenCreateRequest\x12\x0c\n\x04role\x18\x01 \x01(\t\x12\x10\n\x08owner_id\x18\x02 \x01(\t\x12\x11\n\tttl_hours\x18\x03 \x01(\x05\x12\x12\n\nmax_usages\x18\x04 \x01(\x05\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12\x1b\n\x13\x61utonomous_recovery\x18\x06 \x01(\x08\"\x8a\x01\n\x1c\x42ootstrapTokenCreateResponse\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05token\x18\x02 \x01(\t\x12\x0c\n\x04role\x18\x03 \x01(\t\x12\x10\n\x08owner_id\x18\x04 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xab\x02\n\x0e\x42ootstrapToken\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04role\x18\x02 \x01(\t\x12\x10\n\x08owner_id\x18\x03 \x01(\t\x12\x12\n\nmax_usages\x18\x04 \x01(\x05\x12\x14\n\x0cusages_count\x18\x05 \x01(\x05\x12\x13\n\x0b\x64\x65scription\x18\x06 \x01(\t\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0brevoke_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1b\n\x13\x61utonomous_recovery\x18\n \x01(\x08\"D\n\x1a\x42ootstrapTokenListResponse\x12&\n\x06tokens\x18\x01 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\"\xca\x02\n\x11\x45nrollmentRequest\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x10\n\x08token_id\x18\x03 \x01(\t\x12(\n\x06status\x18\x04 \x01(\x0e\x32\x18.sam.v1.EnrollmentStatus\x12\x35\n\x06labels\x18\x05 \x03(\x0b\x32%.sam.v1.EnrollmentRequest.LabelsEntry\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0cresolve_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0bresolved_by\x18\x08 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"L\n\x1d\x45nrollmentRequestListResponse\x12+\n\x08requests\x18\x01 \x03(\x0b\x32\x19.sam.v1.EnrollmentRequest\"p\n\x04User\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0e\n\x06issuer\x18\x02 \x01(\t\x12\r\n\x05\x65mail\x18\x03 \x01(\t\x12\x0c\n\x04role\x18\x04 \x01(\t\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdd\x02\n\x0c\x45nrolledNode\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0c\n\x04role\x18\x02 \x01(\t\x12\x17\n\x0f\x65nrollment_type\x18\x03 \x01(\t\x12\x13\n\x0b\x63laims_json\x18\x04 \x01(\t\x12\x10\n\x08owner_id\x18\x05 \x01(\t\x12\x30\n\x06labels\x18\x06 \x03(\x0b\x32 .sam.v1.EnrolledNode.LabelsEntry\x12/\n\x0b\x65nroll_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06\x62\x61nned\x18\t \x01(\x08\x12\x1b\n\x13\x61utonomous_recovery\x18\n \x01(\x08\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xc4\x01\n\x0bRouterLease\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x11\n\taddresses\x18\x02 \x03(\t\x12\x35\n\x11last_renewal_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0f\x63onnected_peers\x18\x05 \x03(\t\x12\x10\n\x08\x64ht_size\x18\x06 \x01(\x05\"f\n\x0cNodeServices\x12%\n\x08services\x18\x01 \x03(\x0b\x32\x13.sam.v1.ServiceInfo\x12/\n\x0breport_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xab\x03\n\x13\x41\x64minStatusResponse\x12\x1b\n\x05users\x18\x01 \x03(\x0b\x32\x0c.sam.v1.User\x12+\n\x0e\x61\x63tive_routers\x18\x02 \x03(\x0b\x32\x13.sam.v1.RouterLease\x12,\n\x0e\x65nrolled_nodes\x18\x03 \x03(\x0b\x32\x14.sam.v1.EnrolledNode\x12\x36\n\x13\x65nrollment_requests\x18\x04 \x03(\x0b\x32\x19.sam.v1.EnrollmentRequest\x12\x30\n\x10\x62ootstrap_tokens\x18\x05 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\x12$\n\x06policy\x18\x06 \x01(\x0b\x32\x14.sam.v1.PolicyConfig\x12\x42\n\x0cnode_catalog\x18\x07 \x03(\x0b\x32,.sam.v1.AdminStatusResponse.NodeCatalogEntry\x1aH\n\x10NodeCatalogEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12#\n\x05value\x18\x02 \x01(\x0b\x32\x14.sam.v1.NodeServices:\x02\x38\x01\"\xe3\x01\n\x12UserStatusResponse\x12\x1a\n\x04user\x18\x01 \x01(\x0b\x32\x0c.sam.v1.User\x12,\n\x0e\x65nrolled_nodes\x18\x02 \x03(\x0b\x32\x14.sam.v1.EnrolledNode\x12\x30\n\x10\x62ootstrap_tokens\x18\x03 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\x12+\n\x0e\x61\x63tive_routers\x18\x04 \x03(\x0b\x32\x13.sam.v1.RouterLease\x12$\n\x06policy\x18\x05 \x01(\x0b\x32\x14.sam.v1.PolicyConfig\"\xe4\x01\n\x18IdentityEvidenceResponse\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12\x37\n\x13\x62iscuit_expire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63ontrol_plane_url\x18\x04 \x01(\t\x12\"\n\x1atrusted_control_plane_keys\x18\x05 \x03(\x0c\x12.\n\ncheck_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xc0\x02\n\x14PeerEvidenceResponse\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12\x15\n\rverifying_key\x18\x03 \x01(\x0c\x12\r\n\x05roles\x18\x04 \x03(\t\x12\x38\n\x06labels\x18\x05 \x03(\x0b\x32(.sam.v1.PeerEvidenceResponse.LabelsEntry\x12/\n\x0b\x65xpire_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x16\n\x0erevocation_ids\x18\x07 \x03(\t\x12.\n\ncheck_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x80\x02\n\x10MemberCredential\x12\x19\n\x11\x63ontrol_plane_url\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0ctrusted_keys\x18\x04 \x03(\x0b\x32\x19.sam.v1.TrustedSigningKey\x12\x19\n\x11issued_under_keys\x18\x05 \x03(\x0c\x12\x18\n\x10router_addresses\x18\x06 \x03(\t\x12)\n\x0coidc_session\x18\x07 \x01(\x0b\x32\x13.sam.v1.OIDCSession\"Y\n\x11TrustedSigningKey\x12\x12\n\npublic_key\x18\x01 \x01(\x0c\x12\x30\n\x0creceive_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"Y\n\x0bOIDCSession\x12\x0e\n\x06issuer\x18\x01 \x01(\t\x12\x11\n\tclient_id\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x15\n\rrefresh_token\x18\x04 \x01(\t\"\x8d\x01\n\x15TaskAuthorizationRule\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x1f\n\x05rules\x18\x03 \x03(\x0b\x32\x10.sam.v1.TaskRule\x12/\n\x0b\x65xpire_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"~\n\x08TaskRule\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12\x18\n\x10\x61llowed_services\x18\x02 \x03(\t\x12(\n\toperation\x18\x03 \x01(\x0b\x32\x15.sam.v1.TaskOperation\x12\x19\n\x11\x61llowed_resources\x18\x04 \x03(\t\"s\n\rTaskOperation\x12\x15\n\rallowed_tools\x18\x01 \x03(\t\x12\x17\n\x0f\x61llowed_methods\x18\x02 \x03(\t\x12\x15\n\rallowed_paths\x18\x03 \x03(\t\x12\x1b\n\x13\x61llowed_permissions\x18\x04 \x03(\t\"\xa5\x01\n\x14TokenExchangeRequest\x12\x15\n\rsubject_token\x18\x01 \x01(\t\x12\x30\n\ttask_rule\x18\x02 \x01(\x0b\x32\x1d.sam.v1.TaskAuthorizationRule\x12\x0c\n\x04seal\x18\x03 \x01(\x08\x12\x19\n\x11\x63hallenge_unix_ms\x18\x04 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x05 \x01(\x0c\"\x7f\n\x15TokenExchangeResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05roles\x18\x03 \x03(\t\x12\x0f\n\x07subject\x18\x04 \x01(\t\"\x81\x01\n\x0fSTSTokenRequest\x12\x0f\n\x07\x62iscuit\x18\x01 \x01(\x0c\x12\x13\n\x0b\x64\x65stination\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x19\n\x11\x63hallenge_unix_ms\x18\x04 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x05 \x01(\x0c\"\x83\x01\n\x10STSTokenResponse\x12\x0b\n\x03jwt\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07subject\x18\x03 \x01(\t\x12\r\n\x05roles\x18\x04 \x03(\t\x12\x11\n\ttask_name\x18\x05 \x01(\t\"F\n\x13RevocationsResponse\x12\x16\n\x0erevocation_ids\x18\x01 \x03(\t\x12\x17\n\x0f\x62\x61nned_peer_ids\x18\x02 \x03(\t*\x94\x01\n\x10\x45nrollmentStatus\x12!\n\x1d\x45NROLLMENT_STATUS_UNSPECIFIED\x10\x00\x12\x1d\n\x19\x45NROLLMENT_STATUS_PENDING\x10\x01\x12\x1e\n\x1a\x45NROLLMENT_STATUS_APPROVED\x10\x02\x12\x1e\n\x1a\x45NROLLMENT_STATUS_REJECTED\x10\x03*\x8c\x01\n\x0bServiceType\x12\x1c\n\x18SERVICE_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10SERVICE_TYPE_MCP\x10\x01\x12\x1a\n\x16SERVICE_TYPE_INFERENCE\x10\x02\x12\x14\n\x10SERVICE_TYPE_A2A\x10\x03\x12\x17\n\x13SERVICE_TYPE_EGRESS\x10\x04*7\n\nEgressMode\x12\x14\n\x10\x45GRESS_MODE_HTTP\x10\x00\x12\x13\n\x0f\x45GRESS_MODE_TCP\x10\x01*\\\n\x12ResponseInspection\x12 \n\x1cRESPONSE_INSPECTION_BUFFERED\x10\x00\x12$\n RESPONSE_INSPECTION_REQUEST_ONLY\x10\x01\x42\x1bZ\x19github.com/google/sam/apib\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\tsam.proto\x12\x06sam.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"4\n\tAuthFrame\x12\x0f\n\x07\x62iscuit\x18\x01 \x01(\x0c\x12\x16\n\x0etarget_service\x18\x02 \x01(\t\"?\n\x0c\x41uthResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x03 \x01(\x0c\"\xd6\x01\n\tMeshEvent\x12$\n\x04type\x18\x01 \x01(\x0e\x32\x16.sam.v1.MeshEvent.Type\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12.\n\nevent_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x16\n\x0enew_public_key\x18\x04 \x01(\x0c\x12\x11\n\tsignature\x18\x05 \x01(\x0c\"7\n\x04Type\x12\n\n\x06\x42\x41NNED\x10\x00\x12\x10\n\x0cKEY_ROTATION\x10\x01\x12\x11\n\rPOLICY_UPDATE\x10\x02\"\xf3\x01\n\rEnrollRequest\x12\x0b\n\x03jwt\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x12\n\npublic_key\x18\x03 \x01(\x0c\x12\x16\n\x0erequested_role\x18\x04 \x01(\t\x12\x31\n\x06labels\x18\x05 \x03(\x0b\x32!.sam.v1.EnrollRequest.LabelsEntry\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xab\x01\n\x0e\x45nrollResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12\x15\n\rerror_message\x18\x02 \x01(\t\x12 \n\x18\x63ontrol_plane_public_key\x18\x03 \x01(\x0c\x12\x18\n\x10router_addresses\x18\x04 \x03(\t\x12/\n\x0b\x65xpire_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x91\x02\n\x16\x42ootstrapEnrollRequest\x12\x17\n\x0f\x62ootstrap_token\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x12\n\npublic_key\x18\x03 \x01(\x0c\x12\x16\n\x0erequested_role\x18\x04 \x01(\t\x12:\n\x06labels\x18\x05 \x03(\x0b\x32*.sam.v1.BootstrapEnrollRequest.LabelsEntry\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xfd\x01\n\x17\x42ootstrapEnrollResponse\x12(\n\x06status\x18\x01 \x01(\x0e\x32\x18.sam.v1.EnrollmentStatus\x12\x15\n\rbiscuit_token\x18\x02 \x01(\x0c\x12\x1d\n\x15poll_interval_seconds\x18\x03 \x01(\x05\x12\x15\n\rerror_message\x18\x04 \x01(\t\x12 \n\x18\x63ontrol_plane_public_key\x18\x05 \x01(\x0c\x12\x18\n\x10router_addresses\x18\x06 \x03(\t\x12/\n\x0b\x65xpire_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"S\n\x0bServiceInfo\x12!\n\x04type\x18\x01 \x01(\x0e\x32\x13.sam.v1.ServiceType\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\"{\n\x0e\x43ommandBackend\x12\x0f\n\x07\x63ommand\x18\x01 \x03(\t\x12,\n\x03\x65nv\x18\x02 \x03(\x0b\x32\x1f.sam.v1.CommandBackend.EnvEntry\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x8a\x01\n\x16RegisterServiceRequest\x12$\n\x07service\x18\x01 \x01(\x0b\x32\x13.sam.v1.ServiceInfo\x12\x14\n\ntarget_url\x18\x02 \x01(\tH\x00\x12)\n\x07\x63ommand\x18\x03 \x01(\x0b\x32\x16.sam.v1.CommandBackendH\x00\x42\t\n\x07\x62\x61\x63kend\"i\n\x12\x44iscoveredProvider\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x17\n\x0flocal_proxy_url\x18\x02 \x01(\t\x12\x10\n\x08srv_name\x18\x03 \x01(\t\x12\x17\n\x0fsrv_description\x18\x04 \x01(\t\"\xb2\x02\n\x0fServiceAnnounce\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12!\n\x04type\x18\x02 \x01(\x0e\x32\x13.sam.v1.ServiceType\x12\x14\n\x0cservice_name\x18\x03 \x01(\t\x12\x0c\n\x04keys\x18\x04 \x03(\t\x12\x33\n\x06labels\x18\x05 \x03(\x0b\x32#.sam.v1.ServiceAnnounce.LabelsEntry\x12\x17\n\x0f\x61\x63tive_requests\x18\x06 \x01(\r\x12\x17\n\x0flatency_ewma_ms\x18\x07 \x01(\x01\x12\x31\n\rannounce_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x87\x01\n\x18\x43ontrolPlaneInfoResponse\x12\x13\n\x0boidc_issuer\x18\x01 \x01(\t\x12\x11\n\tclient_id\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x18\n\x10router_addresses\x18\x04 \x03(\t\x12\x17\n\x0f\x62\x61nned_peer_ids\x18\x05 \x03(\t\"\xd4\x01\n\x12RouterLeaseRequest\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x11\n\taddresses\x18\x02 \x03(\t\x12\x0f\n\x07\x62iscuit\x18\x03 \x01(\x0c\x12\x17\n\x0f\x63onnected_peers\x18\x04 \x03(\t\x12\x10\n\x08\x64ht_size\x18\x05 \x01(\x05\x12\x19\n\x11\x63hallenge_unix_ms\x18\x06 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x07 \x01(\x0c\x12&\n\x03ttl\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\"f\n\x13RouterLeaseResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x9e\x01\n\nPolicyRole\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0f\x61llowed_targets\x18\x02 \x03(\t\x12\x18\n\x10\x61llowed_services\x18\x03 \x03(\t\x12\x16\n\x0e\x63ustom_datalog\x18\x04 \x03(\t\x12\x16\n\x0e\x61llowed_labels\x18\x05 \x03(\t\x12\x1f\n\x04http\x18\x06 \x03(\x0b\x32\x11.sam.v1.HTTPGrant\"<\n\tHTTPGrant\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07methods\x18\x02 \x03(\t\x12\r\n\x05paths\x18\x03 \x03(\t\"\x8f\x02\n\x11\x45gressDestination\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\ntarget_url\x18\x02 \x01(\t\x12\x12\n\ncredential\x18\x03 \x01(\t\x12\x11\n\tserved_by\x18\x04 \x03(\t\x12(\n\x06\x62roker\x18\x05 \x01(\x0b\x32\x18.sam.v1.CredentialBroker\x12&\n\ninspection\x18\x06 \x01(\x0b\x32\x12.sam.v1.Inspection\x12 \n\x04mode\x18\x07 \x01(\x0e\x32\x12.sam.v1.EgressMode\x12\r\n\x05ports\x18\x08 \x03(\r\x12\x15\n\rpreserve_host\x18\t \x01(\x08\x12\x17\n\x0f\x66orward_context\x18\n \x01(\x08\"3\n\nInspection\x12%\n\ninspectors\x18\x01 \x03(\x0b\x32\x11.sam.v1.Inspector\"c\n\tInspector\x12)\n\x0bmodel_armor\x18\x01 \x01(\x0b\x32\x12.sam.v1.ModelArmorH\x00\x12#\n\x08\x65xt_proc\x18\x02 \x01(\x0b\x32\x0f.sam.v1.ExtProcH\x00\x42\x06\n\x04kind\"\x8b\x01\n\nModelArmor\x12\x10\n\x08template\x18\x01 \x01(\t\x12,\n\x08response\x18\x02 \x01(\x0e\x32\x1a.sam.v1.ResponseInspection\x12\x11\n\tfail_open\x18\x03 \x01(\x08\x12*\n\x07timeout\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\"\x82\x02\n\x07\x45xtProc\x12\x0e\n\x06target\x18\x01 \x01(\t\x12\n\n\x02\x63\x61\x18\x02 \x01(\t\x12\x1a\n\x12\x63lient_certificate\x18\x03 \x01(\t\x12\x36\n\x0fprocessing_mode\x18\x04 \x01(\x0b\x32\x1d.sam.v1.ExtProcProcessingMode\x12\x1b\n\x13\x61llow_mode_override\x18\x05 \x01(\x08\x12\x32\n\x0fmessage_timeout\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x1a\n\x12\x66\x61ilure_mode_allow\x18\x07 \x01(\x08\x12\x1a\n\x12max_buffered_bytes\x18\x08 \x01(\r\"\xdb\x04\n\x15\x45xtProcProcessingMode\x12\x45\n\x13request_header_mode\x18\x01 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12\x46\n\x14response_header_mode\x18\x02 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12\x41\n\x11request_body_mode\x18\x03 \x01(\x0e\x32&.sam.v1.ExtProcProcessingMode.BodyMode\x12\x42\n\x12response_body_mode\x18\x04 \x01(\x0e\x32&.sam.v1.ExtProcProcessingMode.BodyMode\x12\x46\n\x14request_trailer_mode\x18\x05 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\x12G\n\x15response_trailer_mode\x18\x06 \x01(\x0e\x32(.sam.v1.ExtProcProcessingMode.HeaderMode\"9\n\nHeaderMode\x12\x17\n\x13HEADER_MODE_DEFAULT\x10\x00\x12\x08\n\x04SEND\x10\x01\x12\x08\n\x04SKIP\x10\x02\"`\n\x08\x42odyMode\x12\x08\n\x04NONE\x10\x00\x12\x0c\n\x08STREAMED\x10\x01\x12\x0c\n\x08\x42UFFERED\x10\x02\x12\x14\n\x10\x42UFFERED_PARTIAL\x10\x03\x12\x18\n\x14\x46ULL_DUPLEX_STREAMED\x10\x04\"\xcf\x01\n\x10\x43redentialBroker\x12\x17\n\rstatic_secret\x18\x01 \x01(\tH\x00\x12\x31\n\x0foidc_federation\x18\x02 \x01(\x0b\x32\x16.sam.v1.OIDCFederationH\x00\x12\x30\n\x0f\x61ws_assume_role\x18\x03 \x01(\x0b\x32\x15.sam.v1.AWSAssumeRoleH\x00\x12\x35\n\x11platform_identity\x18\x04 \x01(\x0b\x32\x18.sam.v1.PlatformIdentityH\x00\x42\x06\n\x04kind\"_\n\x0eOIDCFederation\x12\x16\n\x0etoken_endpoint\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t\x12\x13\n\x0bimpersonate\x18\x03 \x01(\t\x12\x0e\n\x06scopes\x18\x04 \x03(\t\"9\n\rAWSAssumeRole\x12\x10\n\x08role_arn\x18\x01 \x01(\t\x12\x16\n\x0esession_policy\x18\x02 \x01(\t\"\"\n\x10PlatformIdentity\x12\x0e\n\x06scopes\x18\x01 \x03(\t\".\n\rPolicyBinding\x12\x0c\n\x04role\x18\x01 \x01(\t\x12\x0f\n\x07members\x18\x02 \x03(\t\"\x85\x01\n\x0cPolicyConfig\x12!\n\x05roles\x18\x01 \x03(\x0b\x32\x12.sam.v1.PolicyRole\x12\'\n\x08\x62indings\x18\x02 \x03(\x0b\x32\x15.sam.v1.PolicyBinding\x12)\n\x06\x65gress\x18\x03 \x03(\x0b\x32\x19.sam.v1.EgressDestination\"\x18\n\x16PolicyConfigGetRequest\"0\n\x17PolicyConfigGetResponse\x12\x15\n\rdatalog_rules\x18\x01 \x03(\t\"<\n\x1aPolicyConfigUpdateResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x1a\n\x18\x45gressAssignmentsRequest\"F\n\x19\x45gressAssignmentsResponse\x12)\n\x06\x65gress\x18\x01 \x03(\x0b\x32\x19.sam.v1.EgressDestination\"f\n\x0cKeysResponse\x12\x13\n\x0bpublic_keys\x18\x01 \x03(\x0c\x12-\n\tsign_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nsignatures\x18\x03 \x03(\x0c\"k\n\x13TokenRefreshRequest\x12\x1b\n\x13\x63hallenge_signature\x18\x01 \x01(\x0c\x12\x19\n\x11\x63hallenge_unix_ms\x18\x02 \x01(\x03\x12\x0f\n\x07peer_id\x18\x03 \x01(\t\x12\x0b\n\x03jwt\x18\x04 \x01(\t\"u\n\x14TokenRefreshResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x15\n\rerror_message\x18\x03 \x01(\t\":\n\x11NodeCatalogReport\x12%\n\x08services\x18\x01 \x03(\x0b\x32\x13.sam.v1.ServiceInfo\"%\n\x12TokenRevokeRequest\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\"5\n\x13TokenRevokeResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05\x65rror\x18\x02 \x01(\t\"\x96\x01\n\x1b\x42ootstrapTokenCreateRequest\x12\x0c\n\x04role\x18\x01 \x01(\t\x12\x10\n\x08owner_id\x18\x02 \x01(\t\x12\x11\n\tttl_hours\x18\x03 \x01(\x05\x12\x12\n\nmax_usages\x18\x04 \x01(\x05\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12\x1b\n\x13\x61utonomous_recovery\x18\x06 \x01(\x08\"\x8a\x01\n\x1c\x42ootstrapTokenCreateResponse\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05token\x18\x02 \x01(\t\x12\x0c\n\x04role\x18\x03 \x01(\t\x12\x10\n\x08owner_id\x18\x04 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xab\x02\n\x0e\x42ootstrapToken\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04role\x18\x02 \x01(\t\x12\x10\n\x08owner_id\x18\x03 \x01(\t\x12\x12\n\nmax_usages\x18\x04 \x01(\x05\x12\x14\n\x0cusages_count\x18\x05 \x01(\x05\x12\x13\n\x0b\x64\x65scription\x18\x06 \x01(\t\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0brevoke_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1b\n\x13\x61utonomous_recovery\x18\n \x01(\x08\"D\n\x1a\x42ootstrapTokenListResponse\x12&\n\x06tokens\x18\x01 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\"\xca\x02\n\x11\x45nrollmentRequest\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0f\n\x07peer_id\x18\x02 \x01(\t\x12\x10\n\x08token_id\x18\x03 \x01(\t\x12(\n\x06status\x18\x04 \x01(\x0e\x32\x18.sam.v1.EnrollmentStatus\x12\x35\n\x06labels\x18\x05 \x03(\x0b\x32%.sam.v1.EnrollmentRequest.LabelsEntry\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0cresolve_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0bresolved_by\x18\x08 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"L\n\x1d\x45nrollmentRequestListResponse\x12+\n\x08requests\x18\x01 \x03(\x0b\x32\x19.sam.v1.EnrollmentRequest\"p\n\x04User\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0e\n\x06issuer\x18\x02 \x01(\t\x12\r\n\x05\x65mail\x18\x03 \x01(\t\x12\x0c\n\x04role\x18\x04 \x01(\t\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xdd\x02\n\x0c\x45nrolledNode\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0c\n\x04role\x18\x02 \x01(\t\x12\x17\n\x0f\x65nrollment_type\x18\x03 \x01(\t\x12\x13\n\x0b\x63laims_json\x18\x04 \x01(\t\x12\x10\n\x08owner_id\x18\x05 \x01(\t\x12\x30\n\x06labels\x18\x06 \x03(\x0b\x32 .sam.v1.EnrolledNode.LabelsEntry\x12/\n\x0b\x65nroll_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06\x62\x61nned\x18\t \x01(\x08\x12\x1b\n\x13\x61utonomous_recovery\x18\n \x01(\x08\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xc4\x01\n\x0bRouterLease\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x11\n\taddresses\x18\x02 \x03(\t\x12\x35\n\x11last_renewal_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0f\x63onnected_peers\x18\x05 \x03(\t\x12\x10\n\x08\x64ht_size\x18\x06 \x01(\x05\"f\n\x0cNodeServices\x12%\n\x08services\x18\x01 \x03(\x0b\x32\x13.sam.v1.ServiceInfo\x12/\n\x0breport_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xab\x03\n\x13\x41\x64minStatusResponse\x12\x1b\n\x05users\x18\x01 \x03(\x0b\x32\x0c.sam.v1.User\x12+\n\x0e\x61\x63tive_routers\x18\x02 \x03(\x0b\x32\x13.sam.v1.RouterLease\x12,\n\x0e\x65nrolled_nodes\x18\x03 \x03(\x0b\x32\x14.sam.v1.EnrolledNode\x12\x36\n\x13\x65nrollment_requests\x18\x04 \x03(\x0b\x32\x19.sam.v1.EnrollmentRequest\x12\x30\n\x10\x62ootstrap_tokens\x18\x05 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\x12$\n\x06policy\x18\x06 \x01(\x0b\x32\x14.sam.v1.PolicyConfig\x12\x42\n\x0cnode_catalog\x18\x07 \x03(\x0b\x32,.sam.v1.AdminStatusResponse.NodeCatalogEntry\x1aH\n\x10NodeCatalogEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12#\n\x05value\x18\x02 \x01(\x0b\x32\x14.sam.v1.NodeServices:\x02\x38\x01\"\xe3\x01\n\x12UserStatusResponse\x12\x1a\n\x04user\x18\x01 \x01(\x0b\x32\x0c.sam.v1.User\x12,\n\x0e\x65nrolled_nodes\x18\x02 \x03(\x0b\x32\x14.sam.v1.EnrolledNode\x12\x30\n\x10\x62ootstrap_tokens\x18\x03 \x03(\x0b\x32\x16.sam.v1.BootstrapToken\x12+\n\x0e\x61\x63tive_routers\x18\x04 \x03(\x0b\x32\x13.sam.v1.RouterLease\x12$\n\x06policy\x18\x05 \x01(\x0b\x32\x14.sam.v1.PolicyConfig\"\xe4\x01\n\x18IdentityEvidenceResponse\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12\x37\n\x13\x62iscuit_expire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63ontrol_plane_url\x18\x04 \x01(\t\x12\"\n\x1atrusted_control_plane_keys\x18\x05 \x03(\x0c\x12.\n\ncheck_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xc0\x02\n\x14PeerEvidenceResponse\x12\x0f\n\x07peer_id\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12\x15\n\rverifying_key\x18\x03 \x01(\x0c\x12\r\n\x05roles\x18\x04 \x03(\t\x12\x38\n\x06labels\x18\x05 \x03(\x0b\x32(.sam.v1.PeerEvidenceResponse.LabelsEntry\x12/\n\x0b\x65xpire_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x16\n\x0erevocation_ids\x18\x07 \x03(\t\x12.\n\ncheck_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x80\x02\n\x10MemberCredential\x12\x19\n\x11\x63ontrol_plane_url\x18\x01 \x01(\t\x12\x0f\n\x07\x62iscuit\x18\x02 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0ctrusted_keys\x18\x04 \x03(\x0b\x32\x19.sam.v1.TrustedSigningKey\x12\x19\n\x11issued_under_keys\x18\x05 \x03(\x0c\x12\x18\n\x10router_addresses\x18\x06 \x03(\t\x12)\n\x0coidc_session\x18\x07 \x01(\x0b\x32\x13.sam.v1.OIDCSession\"Y\n\x11TrustedSigningKey\x12\x12\n\npublic_key\x18\x01 \x01(\x0c\x12\x30\n\x0creceive_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"Y\n\x0bOIDCSession\x12\x0e\n\x06issuer\x18\x01 \x01(\t\x12\x11\n\tclient_id\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x15\n\rrefresh_token\x18\x04 \x01(\t\"\x8d\x01\n\x15TaskAuthorizationRule\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x1f\n\x05rules\x18\x03 \x03(\x0b\x32\x10.sam.v1.TaskRule\x12/\n\x0b\x65xpire_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"~\n\x08TaskRule\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12\x18\n\x10\x61llowed_services\x18\x02 \x03(\t\x12(\n\toperation\x18\x03 \x01(\x0b\x32\x15.sam.v1.TaskOperation\x12\x19\n\x11\x61llowed_resources\x18\x04 \x03(\t\"s\n\rTaskOperation\x12\x15\n\rallowed_tools\x18\x01 \x03(\t\x12\x17\n\x0f\x61llowed_methods\x18\x02 \x03(\t\x12\x15\n\rallowed_paths\x18\x03 \x03(\t\x12\x1b\n\x13\x61llowed_permissions\x18\x04 \x03(\t\"\xa5\x01\n\x14TokenExchangeRequest\x12\x15\n\rsubject_token\x18\x01 \x01(\t\x12\x30\n\ttask_rule\x18\x02 \x01(\x0b\x32\x1d.sam.v1.TaskAuthorizationRule\x12\x0c\n\x04seal\x18\x03 \x01(\x08\x12\x19\n\x11\x63hallenge_unix_ms\x18\x04 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x05 \x01(\x0c\"\x7f\n\x15TokenExchangeResponse\x12\x15\n\rbiscuit_token\x18\x01 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05roles\x18\x03 \x03(\t\x12\x0f\n\x07subject\x18\x04 \x01(\t\"\x81\x01\n\x0fSTSTokenRequest\x12\x0f\n\x07\x62iscuit\x18\x01 \x01(\x0c\x12\x13\n\x0b\x64\x65stination\x18\x02 \x01(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x19\n\x11\x63hallenge_unix_ms\x18\x04 \x01(\x03\x12\x1b\n\x13\x63hallenge_signature\x18\x05 \x01(\x0c\"\x83\x01\n\x10STSTokenResponse\x12\x0b\n\x03jwt\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07subject\x18\x03 \x01(\t\x12\r\n\x05roles\x18\x04 \x03(\t\x12\x11\n\ttask_name\x18\x05 \x01(\t\"F\n\x13RevocationsResponse\x12\x16\n\x0erevocation_ids\x18\x01 \x03(\t\x12\x17\n\x0f\x62\x61nned_peer_ids\x18\x02 \x03(\t*\x94\x01\n\x10\x45nrollmentStatus\x12!\n\x1d\x45NROLLMENT_STATUS_UNSPECIFIED\x10\x00\x12\x1d\n\x19\x45NROLLMENT_STATUS_PENDING\x10\x01\x12\x1e\n\x1a\x45NROLLMENT_STATUS_APPROVED\x10\x02\x12\x1e\n\x1a\x45NROLLMENT_STATUS_REJECTED\x10\x03*\x8c\x01\n\x0bServiceType\x12\x1c\n\x18SERVICE_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10SERVICE_TYPE_MCP\x10\x01\x12\x1a\n\x16SERVICE_TYPE_INFERENCE\x10\x02\x12\x14\n\x10SERVICE_TYPE_A2A\x10\x03\x12\x17\n\x13SERVICE_TYPE_EGRESS\x10\x04*7\n\nEgressMode\x12\x14\n\x10\x45GRESS_MODE_HTTP\x10\x00\x12\x13\n\x0f\x45GRESS_MODE_TCP\x10\x01*\\\n\x12ResponseInspection\x12 \n\x1cRESPONSE_INSPECTION_BUFFERED\x10\x00\x12$\n RESPONSE_INSPECTION_REQUEST_ONLY\x10\x01\x42\x1bZ\x19github.com/google/sam/apib\x06proto3')
_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'sam_pb2', globals())
@@ -39,14 +39,14 @@ if _descriptor._USE_C_DESCRIPTORS == False:
_ADMINSTATUSRESPONSE_NODECATALOGENTRY._serialized_options = b'8\001'
_PEEREVIDENCERESPONSE_LABELSENTRY._options = None
_PEEREVIDENCERESPONSE_LABELSENTRY._serialized_options = b'8\001'
- _ENROLLMENTSTATUS._serialized_start=10054
- _ENROLLMENTSTATUS._serialized_end=10202
- _SERVICETYPE._serialized_start=10205
- _SERVICETYPE._serialized_end=10345
- _EGRESSMODE._serialized_start=10347
- _EGRESSMODE._serialized_end=10402
- _RESPONSEINSPECTION._serialized_start=10404
- _RESPONSEINSPECTION._serialized_end=10496
+ _ENROLLMENTSTATUS._serialized_start=10094
+ _ENROLLMENTSTATUS._serialized_end=10242
+ _SERVICETYPE._serialized_start=10245
+ _SERVICETYPE._serialized_end=10385
+ _EGRESSMODE._serialized_start=10387
+ _EGRESSMODE._serialized_end=10442
+ _RESPONSEINSPECTION._serialized_start=10444
+ _RESPONSEINSPECTION._serialized_end=10536
_AUTHFRAME._serialized_start=86
_AUTHFRAME._serialized_end=138
_AUTHRESPONSE._serialized_start=140
@@ -84,119 +84,119 @@ if _descriptor._USE_C_DESCRIPTORS == False:
_CONTROLPLANEINFORESPONSE._serialized_start=2142
_CONTROLPLANEINFORESPONSE._serialized_end=2277
_ROUTERLEASEREQUEST._serialized_start=2280
- _ROUTERLEASEREQUEST._serialized_end=2452
- _ROUTERLEASERESPONSE._serialized_start=2454
- _ROUTERLEASERESPONSE._serialized_end=2556
- _POLICYROLE._serialized_start=2559
- _POLICYROLE._serialized_end=2717
- _HTTPGRANT._serialized_start=2719
- _HTTPGRANT._serialized_end=2779
- _EGRESSDESTINATION._serialized_start=2782
- _EGRESSDESTINATION._serialized_end=3053
- _INSPECTION._serialized_start=3055
- _INSPECTION._serialized_end=3106
- _INSPECTOR._serialized_start=3108
- _INSPECTOR._serialized_end=3207
- _MODELARMOR._serialized_start=3210
- _MODELARMOR._serialized_end=3349
- _EXTPROC._serialized_start=3352
- _EXTPROC._serialized_end=3610
- _EXTPROCPROCESSINGMODE._serialized_start=3613
- _EXTPROCPROCESSINGMODE._serialized_end=4216
- _EXTPROCPROCESSINGMODE_HEADERMODE._serialized_start=4061
- _EXTPROCPROCESSINGMODE_HEADERMODE._serialized_end=4118
- _EXTPROCPROCESSINGMODE_BODYMODE._serialized_start=4120
- _EXTPROCPROCESSINGMODE_BODYMODE._serialized_end=4216
- _CREDENTIALBROKER._serialized_start=4219
- _CREDENTIALBROKER._serialized_end=4426
- _OIDCFEDERATION._serialized_start=4428
- _OIDCFEDERATION._serialized_end=4523
- _AWSASSUMEROLE._serialized_start=4525
- _AWSASSUMEROLE._serialized_end=4582
- _PLATFORMIDENTITY._serialized_start=4584
- _PLATFORMIDENTITY._serialized_end=4618
- _POLICYBINDING._serialized_start=4620
- _POLICYBINDING._serialized_end=4666
- _POLICYCONFIG._serialized_start=4669
- _POLICYCONFIG._serialized_end=4802
- _POLICYCONFIGGETREQUEST._serialized_start=4804
- _POLICYCONFIGGETREQUEST._serialized_end=4828
- _POLICYCONFIGGETRESPONSE._serialized_start=4830
- _POLICYCONFIGGETRESPONSE._serialized_end=4878
- _POLICYCONFIGUPDATERESPONSE._serialized_start=4880
- _POLICYCONFIGUPDATERESPONSE._serialized_end=4940
- _EGRESSASSIGNMENTSREQUEST._serialized_start=4942
- _EGRESSASSIGNMENTSREQUEST._serialized_end=4968
- _EGRESSASSIGNMENTSRESPONSE._serialized_start=4970
- _EGRESSASSIGNMENTSRESPONSE._serialized_end=5040
- _KEYSRESPONSE._serialized_start=5042
- _KEYSRESPONSE._serialized_end=5144
- _TOKENREFRESHREQUEST._serialized_start=5146
- _TOKENREFRESHREQUEST._serialized_end=5253
- _TOKENREFRESHRESPONSE._serialized_start=5255
- _TOKENREFRESHRESPONSE._serialized_end=5372
- _NODECATALOGREPORT._serialized_start=5374
- _NODECATALOGREPORT._serialized_end=5432
- _TOKENREVOKEREQUEST._serialized_start=5434
- _TOKENREVOKEREQUEST._serialized_end=5471
- _TOKENREVOKERESPONSE._serialized_start=5473
- _TOKENREVOKERESPONSE._serialized_end=5526
- _BOOTSTRAPTOKENCREATEREQUEST._serialized_start=5529
- _BOOTSTRAPTOKENCREATEREQUEST._serialized_end=5679
- _BOOTSTRAPTOKENCREATERESPONSE._serialized_start=5682
- _BOOTSTRAPTOKENCREATERESPONSE._serialized_end=5820
- _BOOTSTRAPTOKEN._serialized_start=5823
- _BOOTSTRAPTOKEN._serialized_end=6122
- _BOOTSTRAPTOKENLISTRESPONSE._serialized_start=6124
- _BOOTSTRAPTOKENLISTRESPONSE._serialized_end=6192
- _ENROLLMENTREQUEST._serialized_start=6195
- _ENROLLMENTREQUEST._serialized_end=6525
+ _ROUTERLEASEREQUEST._serialized_end=2492
+ _ROUTERLEASERESPONSE._serialized_start=2494
+ _ROUTERLEASERESPONSE._serialized_end=2596
+ _POLICYROLE._serialized_start=2599
+ _POLICYROLE._serialized_end=2757
+ _HTTPGRANT._serialized_start=2759
+ _HTTPGRANT._serialized_end=2819
+ _EGRESSDESTINATION._serialized_start=2822
+ _EGRESSDESTINATION._serialized_end=3093
+ _INSPECTION._serialized_start=3095
+ _INSPECTION._serialized_end=3146
+ _INSPECTOR._serialized_start=3148
+ _INSPECTOR._serialized_end=3247
+ _MODELARMOR._serialized_start=3250
+ _MODELARMOR._serialized_end=3389
+ _EXTPROC._serialized_start=3392
+ _EXTPROC._serialized_end=3650
+ _EXTPROCPROCESSINGMODE._serialized_start=3653
+ _EXTPROCPROCESSINGMODE._serialized_end=4256
+ _EXTPROCPROCESSINGMODE_HEADERMODE._serialized_start=4101
+ _EXTPROCPROCESSINGMODE_HEADERMODE._serialized_end=4158
+ _EXTPROCPROCESSINGMODE_BODYMODE._serialized_start=4160
+ _EXTPROCPROCESSINGMODE_BODYMODE._serialized_end=4256
+ _CREDENTIALBROKER._serialized_start=4259
+ _CREDENTIALBROKER._serialized_end=4466
+ _OIDCFEDERATION._serialized_start=4468
+ _OIDCFEDERATION._serialized_end=4563
+ _AWSASSUMEROLE._serialized_start=4565
+ _AWSASSUMEROLE._serialized_end=4622
+ _PLATFORMIDENTITY._serialized_start=4624
+ _PLATFORMIDENTITY._serialized_end=4658
+ _POLICYBINDING._serialized_start=4660
+ _POLICYBINDING._serialized_end=4706
+ _POLICYCONFIG._serialized_start=4709
+ _POLICYCONFIG._serialized_end=4842
+ _POLICYCONFIGGETREQUEST._serialized_start=4844
+ _POLICYCONFIGGETREQUEST._serialized_end=4868
+ _POLICYCONFIGGETRESPONSE._serialized_start=4870
+ _POLICYCONFIGGETRESPONSE._serialized_end=4918
+ _POLICYCONFIGUPDATERESPONSE._serialized_start=4920
+ _POLICYCONFIGUPDATERESPONSE._serialized_end=4980
+ _EGRESSASSIGNMENTSREQUEST._serialized_start=4982
+ _EGRESSASSIGNMENTSREQUEST._serialized_end=5008
+ _EGRESSASSIGNMENTSRESPONSE._serialized_start=5010
+ _EGRESSASSIGNMENTSRESPONSE._serialized_end=5080
+ _KEYSRESPONSE._serialized_start=5082
+ _KEYSRESPONSE._serialized_end=5184
+ _TOKENREFRESHREQUEST._serialized_start=5186
+ _TOKENREFRESHREQUEST._serialized_end=5293
+ _TOKENREFRESHRESPONSE._serialized_start=5295
+ _TOKENREFRESHRESPONSE._serialized_end=5412
+ _NODECATALOGREPORT._serialized_start=5414
+ _NODECATALOGREPORT._serialized_end=5472
+ _TOKENREVOKEREQUEST._serialized_start=5474
+ _TOKENREVOKEREQUEST._serialized_end=5511
+ _TOKENREVOKERESPONSE._serialized_start=5513
+ _TOKENREVOKERESPONSE._serialized_end=5566
+ _BOOTSTRAPTOKENCREATEREQUEST._serialized_start=5569
+ _BOOTSTRAPTOKENCREATEREQUEST._serialized_end=5719
+ _BOOTSTRAPTOKENCREATERESPONSE._serialized_start=5722
+ _BOOTSTRAPTOKENCREATERESPONSE._serialized_end=5860
+ _BOOTSTRAPTOKEN._serialized_start=5863
+ _BOOTSTRAPTOKEN._serialized_end=6162
+ _BOOTSTRAPTOKENLISTRESPONSE._serialized_start=6164
+ _BOOTSTRAPTOKENLISTRESPONSE._serialized_end=6232
+ _ENROLLMENTREQUEST._serialized_start=6235
+ _ENROLLMENTREQUEST._serialized_end=6565
_ENROLLMENTREQUEST_LABELSENTRY._serialized_start=621
_ENROLLMENTREQUEST_LABELSENTRY._serialized_end=666
- _ENROLLMENTREQUESTLISTRESPONSE._serialized_start=6527
- _ENROLLMENTREQUESTLISTRESPONSE._serialized_end=6603
- _USER._serialized_start=6605
- _USER._serialized_end=6717
- _ENROLLEDNODE._serialized_start=6720
- _ENROLLEDNODE._serialized_end=7069
+ _ENROLLMENTREQUESTLISTRESPONSE._serialized_start=6567
+ _ENROLLMENTREQUESTLISTRESPONSE._serialized_end=6643
+ _USER._serialized_start=6645
+ _USER._serialized_end=6757
+ _ENROLLEDNODE._serialized_start=6760
+ _ENROLLEDNODE._serialized_end=7109
_ENROLLEDNODE_LABELSENTRY._serialized_start=621
_ENROLLEDNODE_LABELSENTRY._serialized_end=666
- _ROUTERLEASE._serialized_start=7072
- _ROUTERLEASE._serialized_end=7268
- _NODESERVICES._serialized_start=7270
- _NODESERVICES._serialized_end=7372
- _ADMINSTATUSRESPONSE._serialized_start=7375
- _ADMINSTATUSRESPONSE._serialized_end=7802
- _ADMINSTATUSRESPONSE_NODECATALOGENTRY._serialized_start=7730
- _ADMINSTATUSRESPONSE_NODECATALOGENTRY._serialized_end=7802
- _USERSTATUSRESPONSE._serialized_start=7805
- _USERSTATUSRESPONSE._serialized_end=8032
- _IDENTITYEVIDENCERESPONSE._serialized_start=8035
- _IDENTITYEVIDENCERESPONSE._serialized_end=8263
- _PEEREVIDENCERESPONSE._serialized_start=8266
- _PEEREVIDENCERESPONSE._serialized_end=8586
+ _ROUTERLEASE._serialized_start=7112
+ _ROUTERLEASE._serialized_end=7308
+ _NODESERVICES._serialized_start=7310
+ _NODESERVICES._serialized_end=7412
+ _ADMINSTATUSRESPONSE._serialized_start=7415
+ _ADMINSTATUSRESPONSE._serialized_end=7842
+ _ADMINSTATUSRESPONSE_NODECATALOGENTRY._serialized_start=7770
+ _ADMINSTATUSRESPONSE_NODECATALOGENTRY._serialized_end=7842
+ _USERSTATUSRESPONSE._serialized_start=7845
+ _USERSTATUSRESPONSE._serialized_end=8072
+ _IDENTITYEVIDENCERESPONSE._serialized_start=8075
+ _IDENTITYEVIDENCERESPONSE._serialized_end=8303
+ _PEEREVIDENCERESPONSE._serialized_start=8306
+ _PEEREVIDENCERESPONSE._serialized_end=8626
_PEEREVIDENCERESPONSE_LABELSENTRY._serialized_start=621
_PEEREVIDENCERESPONSE_LABELSENTRY._serialized_end=666
- _MEMBERCREDENTIAL._serialized_start=8589
- _MEMBERCREDENTIAL._serialized_end=8845
- _TRUSTEDSIGNINGKEY._serialized_start=8847
- _TRUSTEDSIGNINGKEY._serialized_end=8936
- _OIDCSESSION._serialized_start=8938
- _OIDCSESSION._serialized_end=9027
- _TASKAUTHORIZATIONRULE._serialized_start=9030
- _TASKAUTHORIZATIONRULE._serialized_end=9171
- _TASKRULE._serialized_start=9173
- _TASKRULE._serialized_end=9299
- _TASKOPERATION._serialized_start=9301
- _TASKOPERATION._serialized_end=9416
- _TOKENEXCHANGEREQUEST._serialized_start=9419
- _TOKENEXCHANGEREQUEST._serialized_end=9584
- _TOKENEXCHANGERESPONSE._serialized_start=9586
- _TOKENEXCHANGERESPONSE._serialized_end=9713
- _STSTOKENREQUEST._serialized_start=9716
- _STSTOKENREQUEST._serialized_end=9845
- _STSTOKENRESPONSE._serialized_start=9848
- _STSTOKENRESPONSE._serialized_end=9979
- _REVOCATIONSRESPONSE._serialized_start=9981
- _REVOCATIONSRESPONSE._serialized_end=10051
+ _MEMBERCREDENTIAL._serialized_start=8629
+ _MEMBERCREDENTIAL._serialized_end=8885
+ _TRUSTEDSIGNINGKEY._serialized_start=8887
+ _TRUSTEDSIGNINGKEY._serialized_end=8976
+ _OIDCSESSION._serialized_start=8978
+ _OIDCSESSION._serialized_end=9067
+ _TASKAUTHORIZATIONRULE._serialized_start=9070
+ _TASKAUTHORIZATIONRULE._serialized_end=9211
+ _TASKRULE._serialized_start=9213
+ _TASKRULE._serialized_end=9339
+ _TASKOPERATION._serialized_start=9341
+ _TASKOPERATION._serialized_end=9456
+ _TOKENEXCHANGEREQUEST._serialized_start=9459
+ _TOKENEXCHANGEREQUEST._serialized_end=9624
+ _TOKENEXCHANGERESPONSE._serialized_start=9626
+ _TOKENEXCHANGERESPONSE._serialized_end=9753
+ _STSTOKENREQUEST._serialized_start=9756
+ _STSTOKENREQUEST._serialized_end=9885
+ _STSTOKENRESPONSE._serialized_start=9888
+ _STSTOKENRESPONSE._serialized_end=10019
+ _REVOCATIONSRESPONSE._serialized_start=10021
+ _REVOCATIONSRESPONSE._serialized_end=10091
# @@protoc_insertion_point(module_scope)
diff --git a/sdk/python/src/agent_mesh/_proto/sam_pb2.pyi b/sdk/python/src/agent_mesh/_proto/sam_pb2.pyi
index 728b0e17..b68db0c7 100644
--- a/sdk/python/src/agent_mesh/_proto/sam_pb2.pyi
+++ b/sdk/python/src/agent_mesh/_proto/sam_pb2.pyi
@@ -670,7 +670,7 @@ class RouterLease(_message.Message):
def __init__(self, peer_id: _Optional[str] = ..., addresses: _Optional[_Iterable[str]] = ..., last_renewal_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., expire_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., connected_peers: _Optional[_Iterable[str]] = ..., dht_size: _Optional[int] = ...) -> None: ...
class RouterLeaseRequest(_message.Message):
- __slots__ = ["addresses", "biscuit", "challenge_signature", "challenge_unix_ms", "connected_peers", "dht_size", "peer_id"]
+ __slots__ = ["addresses", "biscuit", "challenge_signature", "challenge_unix_ms", "connected_peers", "dht_size", "peer_id", "ttl"]
ADDRESSES_FIELD_NUMBER: _ClassVar[int]
BISCUIT_FIELD_NUMBER: _ClassVar[int]
CHALLENGE_SIGNATURE_FIELD_NUMBER: _ClassVar[int]
@@ -678,6 +678,7 @@ class RouterLeaseRequest(_message.Message):
CONNECTED_PEERS_FIELD_NUMBER: _ClassVar[int]
DHT_SIZE_FIELD_NUMBER: _ClassVar[int]
PEER_ID_FIELD_NUMBER: _ClassVar[int]
+ TTL_FIELD_NUMBER: _ClassVar[int]
addresses: _containers.RepeatedScalarFieldContainer[str]
biscuit: bytes
challenge_signature: bytes
@@ -685,7 +686,8 @@ class RouterLeaseRequest(_message.Message):
connected_peers: _containers.RepeatedScalarFieldContainer[str]
dht_size: int
peer_id: str
- def __init__(self, peer_id: _Optional[str] = ..., addresses: _Optional[_Iterable[str]] = ..., biscuit: _Optional[bytes] = ..., connected_peers: _Optional[_Iterable[str]] = ..., dht_size: _Optional[int] = ..., challenge_unix_ms: _Optional[int] = ..., challenge_signature: _Optional[bytes] = ...) -> None: ...
+ ttl: _duration_pb2.Duration
+ def __init__(self, peer_id: _Optional[str] = ..., addresses: _Optional[_Iterable[str]] = ..., biscuit: _Optional[bytes] = ..., connected_peers: _Optional[_Iterable[str]] = ..., dht_size: _Optional[int] = ..., challenge_unix_ms: _Optional[int] = ..., challenge_signature: _Optional[bytes] = ..., ttl: _Optional[_Union[_duration_pb2.Duration, _Mapping]] = ...) -> None: ...
class RouterLeaseResponse(_message.Message):
__slots__ = ["error", "expire_time", "success"]
diff --git a/site/content/docs/reference/router.md b/site/content/docs/reference/router.md
index 70add597..67ed70d0 100644
--- a/site/content/docs/reference/router.md
+++ b/site/content/docs/reference/router.md
@@ -45,6 +45,7 @@ replica count.
| `--dht-provider-addr-ttl` | `15m` | How long a service announcement lives after a node last made it. Nodes re-announce every 5 minutes, so a node that is gone drops out of discovery within this time. `0` keeps the default. |
| `--dht-max-record-age` | library default | DHT value record lifetime. |
| `--relay-limit-duration`, `--relay-limit-data` | `1h`, `0` | Caps on each relayed connection: lifetime, and bytes per direction (`512MiB`, `1GB`). The relay cuts the connection when either is reached. `0` means no limit. |
+| `--shutdown-lease-ttl` | `30s` | Sent in the router's last lease when it stops: how long it expects to be away, which is how long the control plane keeps listing it. The default covers a pod that restarts in place. A router that is being removed for good can send `1s`. `0` sends nothing and the lease expires on the control plane's schedule. |
| `--metrics-addr` | off | Serve `/metrics`, `/healthz` and `/readyz` without authentication on this address. `/readyz` returns `200` once the router is enrolled and the libp2p host is up. Keep this address separate from the libp2p ports and inside the cluster. |
| `--log-level` | `info` | `debug`, `info`, `warn`, `error`. `LOG_FORMAT=json` selects JSON output. |
@@ -60,6 +61,13 @@ replica count.
4. Runs the mutual credential handshake on every inbound connection and
refuses peers whose credential does not verify and peers on the ban list.
5. Refreshes its own credential before it expires, like a node.
+6. On `SIGTERM` or `SIGINT`, sends a last lease with `--shutdown-lease-ttl`
+ and then closes its connections. The control plane lists the router for
+ that long and no longer, so a router that restarts in place is still
+ there when its members redial it, and joiners are sent to the routers
+ that remain once the time has passed. The operator states the time the
+ router will be down, the way BGP graceful shutdown announces a
+ maintenance window.
A router stores nothing except its key. Restarting a router loses no
important state. Nodes reconnect and publish their services again.
diff --git a/site/content/docs/reference/sam-one.md b/site/content/docs/reference/sam-one.md
index 0986dbf8..7f70aee8 100644
--- a/site/content/docs/reference/sam-one.md
+++ b/site/content/docs/reference/sam-one.md
@@ -67,6 +67,7 @@ of zero leaves the default of that component unchanged.
| `--router-conns-per-source-ip` | `--conns-per-source-ip`. `0` follows the high watermark, because peers behind a proxy share source IPs. |
| `--router-dht-provider-addr-ttl`, `--router-dht-max-record-age` | `--dht-provider-addr-ttl`, `--dht-max-record-age`. `0` keeps `15m` and the library default. |
| `--router-relay-limit-duration`, `--router-relay-limit-data` | `--relay-limit-duration`, `--relay-limit-data`. `0` keeps `1h` and no data limit, so set a long duration such as `24h` instead of an unlimited one. |
+| `--router-shutdown-lease-ttl` | `--shutdown-lease-ttl`, default `30s`. |
| `--router-allow-loopback` | `--allow-loopback`. Defaults to `true` here, for a laptop. Disable it on a public deployment. |
## The banner
diff --git a/tests/integration/router_shutdown_test.go b/tests/integration/router_shutdown_test.go
new file mode 100644
index 00000000..a01540ad
--- /dev/null
+++ b/tests/integration/router_shutdown_test.go
@@ -0,0 +1,119 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package integration_test
+
+import (
+ "fmt"
+ "os"
+ "os/exec"
+ "path/filepath"
+ "slices"
+ "testing"
+ "time"
+
+ "github.com/google/sam/api"
+)
+
+// TestRouterGracefulShutdownWithdrawsLease covers a router stopping on
+// SIGTERM: its last lease carries --shutdown-lease-ttl, so the control plane
+// stops handing it to joiners once that time has passed instead of when the
+// lease expires. A router with the ttl off sends nothing and stays listed,
+// as does a router that keeps running.
+func TestRouterGracefulShutdownWithdrawsLease(t *testing.T) {
+ cpBin := buildBinary(t, "./cmd/sam-control-plane")
+ routerBin := buildBinary(t, "./cmd/sam-router")
+
+ tmpDir := t.TempDir()
+ policyFile := filepath.Join(tmpDir, "policies.yaml")
+ writePolicyWithRouter(t, policyFile, "bindings: []\nroles: []\n")
+
+ oidcURL, mintToken := startCustomMockOIDC(t)
+ routerJWT := mintToken(map[string]interface{}{
+ "sub": "router-shutdown-test",
+ "groups": []string{"routers"},
+ "roles": []string{api.RoleRouter},
+ })
+
+ cpPort := getFreePort(t)
+ cpCmd := exec.Command(cpBin,
+ "--bind-address", fmt.Sprintf("127.0.0.1:%d", cpPort),
+ "--admin-token-path", tokenPath(t, testAdminToken),
+ "--db-dsn", filepath.Join(tmpDir, "cp.db"),
+ "--issuer", oidcURL,
+ "--insecure-skip-tls-verify",
+ )
+ if err := cpCmd.Start(); err != nil {
+ t.Fatalf("failed to start control plane: %v", err)
+ }
+ defer func() { _ = cpCmd.Process.Kill(); _ = cpCmd.Wait() }()
+ waitForControlPlane(t, cpPort)
+ injectPolicyYAML(t, cpPort, testAdminToken, policyFile)
+
+ // startRouter returns the router's process and peer ID, read from the
+ // control plane's listing once the router holds a lease.
+ startRouter := func(name, shutdownTTL string, listed []string) (*exec.Cmd, string) {
+ t.Helper()
+ cmd := exec.Command(routerBin,
+ "--control-plane", fmt.Sprintf("http://127.0.0.1:%d", cpPort),
+ "--listen", fmt.Sprintf("/ip4/127.0.0.1/tcp/%d", getFreePort(t)),
+ "--keys-path", filepath.Join(tmpDir, name+".db"),
+ "--allow-loopback",
+ "--oidc-token", routerJWT,
+ // Long enough that only a withdrawal, never a renewal, changes
+ // the active set during the test.
+ "--lease-renew-interval", "1m",
+ "--shutdown-lease-ttl", shutdownTTL,
+ )
+ if err := cmd.Start(); err != nil {
+ t.Fatalf("failed to start %s: %v", name, err)
+ }
+ t.Cleanup(func() { _ = cmd.Process.Kill(); _ = cmd.Wait() })
+ for _, id := range waitForActiveRouters(t, cpPort, len(listed)+1, 10*time.Second) {
+ if !slices.Contains(listed, id) {
+ return cmd, id
+ }
+ }
+ t.Fatalf("%s holds no lease of its own", name)
+ return nil, ""
+ }
+ withdrawing, withdrawingID := startRouter("router-withdrawing", "1s", nil)
+ silent, silentID := startRouter("router-silent", "0", []string{withdrawingID})
+ _, stayingID := startRouter("router-staying", "1s", []string{withdrawingID, silentID})
+
+ // The control plane's lease lasts minutes; the withdrawing router's last
+ // lease of one second is what takes it out within the poll below, while
+ // the silent router's lease is left as it was.
+ for _, cmd := range []*exec.Cmd{withdrawing, silent} {
+ if err := cmd.Process.Signal(os.Interrupt); err != nil {
+ t.Fatal(err)
+ }
+ _ = cmd.Wait()
+ }
+
+ want := []string{silentID, stayingID}
+ slices.Sort(want)
+ deadline := time.Now().Add(5 * time.Second)
+ for {
+ routers := fetchActiveRouters(t, cpPort)
+ slices.Sort(routers)
+ if slices.Equal(routers, want) {
+ return
+ }
+ if time.Now().After(deadline) {
+ t.Fatalf("active routers after graceful shutdown: got %v, want %v", routers, want)
+ }
+ time.Sleep(100 * time.Millisecond)
+ }
+}