Skip to main content
logoTetrate Service BridgeVersion: 1.5.x

API Reference

Packages:

tsb.tetrate.io/v2

Resource Types:

Cluster

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringClustertrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectA Kubernetes cluster managing both pods and VMs.
false
statusobject
false

Cluster.spec

↩ Parent

A Kubernetes cluster managing both pods and VMs.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
labelsmap[string]string
false
localityobjectLocation information about the cluster which can be used for routing.
false
namespaceScopeobjectConfigure the default scoping of namespaces in this cluster.
false
namespaces[]object
false
networkstringThe network (e.g., VPC) where this cluster is present.
false
stateobject
false
tier1ClusterbooleanIndicates whether this cluster is hosting a tier1 gateway or not.
false
tokenTtlstringLifetime of the tokens.
false
trustDomainstringTrust domain for this cluster, used for multi-cluster routing.
false

Cluster.spec.locality

↩ Parent

Location information about the cluster which can be used for routing.

NameTypeDescriptionRequired
regionstringThe geographic location of the cluster.
false

Cluster.spec.namespaceScope

↩ Parent

Configure the default scoping of namespaces in this cluster.

NameTypeDescriptionRequired
exceptions[]stringNamespaces to be excluded form the default scope.
false
scopeenum

Enum: GLOBAL, LOCAL
false

Cluster.spec.namespaces[index]

↩ Parent

NameTypeDescriptionRequired
namestring
false
services[]object
false

Cluster.spec.namespaces[index].services[index]

↩ Parent

NameTypeDescriptionRequired
canonicalNamestring
false
gatewayHostboolean
false
hostnamestringThe hostname by which this service is accessed.
false
kubernetesExternalAddresses[]string
false
kubernetesServiceFqdnstring
false
kubernetesServiceIpstring
false
meshExternalboolean
false
namestring
false
namespacestringnamespace associated with the service.
false
numHopsinteger

Minimum: 0
Maximum: 4.294967295e+09
false
numKubernetesEndpointsintegerThe number of kubernetes pods providing this service.

Minimum: 0
Maximum: 4.294967295e+09
false
numVmEndpointsintegerThe number of VMs providing this service.

Minimum: 0
Maximum: 4.294967295e+09
false
ports[]objectThe set of ports on which this service is exposed.
false
selectormap[string]stringlabel selectors associated with the service.
false
spiffeIds[]stringList of SPIFFE identities used by the workloads of the service.
false
subsets[]string
false
tier1GatewayHostboolean
false
workloads[]objectWorkloads implementing the Service.
false

Cluster.spec.namespaces[index].services[index].ports[index]

↩ Parent

NameTypeDescriptionRequired
kubernetesNodePortinteger

Minimum: 0
Maximum: 4.294967295e+09
false
namestringName assigned to the port.
false
numberintegerA valid non-negative integer port number.

Minimum: 0
Maximum: 4.294967295e+09
false

Cluster.spec.namespaces[index].services[index].workloads[index]

↩ Parent

NameTypeDescriptionRequired
addressstringRoutable address of the workload.
false
isVmbooleanIndicates whether the workload is kubernetes endpoint or vm.
false
namestringInstance name of the workload.
false
proxyobjectProxy details.
false

Cluster.spec.namespaces[index].services[index].workloads[index].proxy

↩ Parent

Proxy details.

NameTypeDescriptionRequired
controlPlaneAddressstring
false
envoyVersionstringEnvoy version of the proxy.
false
istioVersionstringIstio version of the proxy.
false
statusmap[string]stringSync status for each xDS component.
false

Cluster.spec.state

↩ Parent

NameTypeDescriptionRequired
istioVersions[]stringThis shows currently running istio versions in the cluster.
false
lastSyncTimestring

Format: date-time
false
providerstringcluster provider.
false
xcpVersionstring
false

Organization

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringOrganizationtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`Organization` is the root of the Service Bridge object hierarchy.
false
statusobject
false

Organization.spec

↩ Parent

Organization is the root of the Service Bridge object hierarchy.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

OrganizationSetting

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringOrganizationSettingtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectSettings that apply globally to the entire organization.
false
statusobject
false

OrganizationSetting.spec

↩ Parent

Settings that apply globally to the entire organization.

NameTypeDescriptionRequired
defaultSecuritySettingobjectSecurity settings for all proxy workloads in this organization.
false
defaultTrafficSettingobjectTraffic settings for all proxy workloads in this organization.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
networkSettingsobjectReachability between clusters on various networks.
false
regionalFailover[]objectDefault locality routing settings for all gateways.
false

OrganizationSetting.spec.defaultSecuritySetting

↩ Parent

Security settings for all proxy workloads in this organization.

NameTypeDescriptionRequired
authenticationenum

Enum: UNSET, OPTIONAL, REQUIRED
false
authenticationSettingsobject
false
authorizationobject
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
propagationStrategyenum

Enum: REPLACE, STRICTER
false
wafSettingsobjectNOTICE: this feature is in alpha stage and under active development.
false

OrganizationSetting.spec.defaultSecuritySetting.authenticationSettings

↩ Parent

NameTypeDescriptionRequired
httpobject
false
trafficModeenum

Enum: UNSET, OPTIONAL, REQUIRED
false

OrganizationSetting.spec.defaultSecuritySetting.authenticationSettings.http

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

OrganizationSetting.spec.defaultSecuritySetting.authenticationSettings.http.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

OrganizationSetting.spec.defaultSecuritySetting.authorization

↩ Parent

NameTypeDescriptionRequired
httpobjectThis is for configuring HTTP request authorization.
false
modeenumA short cut for specifying the set of allowed callers.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
false
rulesobject
false
serviceAccounts[]string
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http

↩ Parent

This is for configuring HTTP request authorization.

NameTypeDescriptionRequired
externalobject
false
localobject
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules

↩ Parent

NameTypeDescriptionRequired
allow[]objectAllow specifies a list of rules.
false
deny[]objectDeny specifies a list of rules.
false
denyAllbooleanDeny all specifies whether all requests should be rejected.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.allow[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.deny[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

OrganizationSetting.spec.defaultSecuritySetting.wafSettings

↩ Parent

NOTICE: this feature is in alpha stage and under active development.

NameTypeDescriptionRequired
ruleEngineModeenumAd-hoc settings to switch ModSecurity engine mode.

Enum: OFF, ON, DETECTION_ONLY
false
ruleSets[]stringRulesets to enable.
false

OrganizationSetting.spec.defaultTrafficSetting

↩ Parent

Traffic settings for all proxy workloads in this organization.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
egressobject
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
rateLimitingobjectConfiguration for rate limiting requests.
false
reachabilityobject
false
resilienceobject
false

OrganizationSetting.spec.defaultTrafficSetting.egress

↩ Parent

NameTypeDescriptionRequired
hoststringSpecifies the egress gateway hostname.
false
portintegerDeprecated.

Format: int32
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

OrganizationSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

OrganizationSetting.spec.defaultTrafficSetting.reachability

↩ Parent

NameTypeDescriptionRequired
hosts[]string
false
modeenumA short cut for specifying the set of services accessed by the workload.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
false

OrganizationSetting.spec.defaultTrafficSetting.resilience

↩ Parent

NameTypeDescriptionRequired
circuitBreakerSensitivityenum

Enum: UNSET, LOW, MEDIUM, HIGH
false
httpRequestTimeoutstringTimeout for HTTP requests.
false
httpRetriesobjectRetry policy for HTTP requests.
false
keepAliveobjectKeep Alive Settings.
false
tcpKeepalivebooleanDeprecated.
false

OrganizationSetting.spec.defaultTrafficSetting.resilience.httpRetries

↩ Parent

Retry policy for HTTP requests.

NameTypeDescriptionRequired
attemptsintegerNumber of retries for a given request.

Format: int32
false
perTryTimeoutstringTimeout per retry attempt for a given request.
false
retryOnstringSpecifies the conditions under which retry takes place.
false

OrganizationSetting.spec.defaultTrafficSetting.resilience.keepAlive

↩ Parent

Keep Alive Settings.

NameTypeDescriptionRequired
tcpobjectTCP Keep Alive settings associated with the upstream and downstream TCP connections.
false

OrganizationSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp

↩ Parent

TCP Keep Alive settings associated with the upstream and downstream TCP connections.

NameTypeDescriptionRequired
downstreamobjectTCP Keep Alive Settings associated with the downstream (client) connection.
false
upstreamobjectTCP Keep Alive Settings associated with the upstream (backend) connection.
false

OrganizationSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.downstream

↩ Parent

TCP Keep Alive Settings associated with the downstream (client) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

OrganizationSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.upstream

↩ Parent

TCP Keep Alive Settings associated with the upstream (backend) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

OrganizationSetting.spec.networkSettings

↩ Parent

Reachability between clusters on various networks.

NameTypeDescriptionRequired
networkReachabilitymap[string]stringReachability between clusters on various networks.
false

OrganizationSetting.spec.regionalFailover[index]

↩ Parent

NameTypeDescriptionRequired
fromstringOriginating region.
false
tostring
false

ServiceAccount

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringServiceAccounttrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`ServiceAccount` represents a service account that can be used to access the TSB platform.
false
statusobject
false

ServiceAccount.spec

↩ Parent

ServiceAccount represents a service account that can be used to access the TSB platform.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
keys[]objectKeys associated with the service account.
false

ServiceAccount.spec.keys[index]

↩ Parent

NameTypeDescriptionRequired
defaultTokenstring
false
encodingenumFormat in which the public and private keys are encoded.

Enum: PEM, JWK
false
idstringUnique identifier for this key-pair.
false
privateKeystringThe encoded private key associated with the service account.
false
publicKeystringThe encoded public key associated with the service account.
false

Team

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringTeamtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`Team` is a named collection of users under a tenant.
false
statusobject
false

Team.spec

↩ Parent

Team is a named collection of users under a tenant.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
members[]stringList of members under the team.
false
sourceTypeenumWhere the team comes from.

Enum: INVALID, LDAP, LOCAL, AZURE, MANUAL
false

Tenant

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringTenanttrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`Tenant` is a self-contained entity within an organization in the Service Bridge hierarchy.
false
statusobject
false

Tenant.spec

↩ Parent

Tenant is a self-contained entity within an organization in the Service Bridge hierarchy.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

TenantSetting

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringTenantSettingtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectDefault settings that apply to all workspaces under a tenant.
false
statusobject
false

TenantSetting.spec

↩ Parent

Default settings that apply to all workspaces under a tenant.

NameTypeDescriptionRequired
defaultSecuritySettingobjectSecurity settings for all proxy workloads in this tenant.
false
defaultTrafficSettingobjectTraffic settings for all proxy workloads in this tenant.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

TenantSetting.spec.defaultSecuritySetting

↩ Parent

Security settings for all proxy workloads in this tenant.

NameTypeDescriptionRequired
authenticationenum

Enum: UNSET, OPTIONAL, REQUIRED
false
authenticationSettingsobject
false
authorizationobject
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
propagationStrategyenum

Enum: REPLACE, STRICTER
false
wafSettingsobjectNOTICE: this feature is in alpha stage and under active development.
false

TenantSetting.spec.defaultSecuritySetting.authenticationSettings

↩ Parent

NameTypeDescriptionRequired
httpobject
false
trafficModeenum

Enum: UNSET, OPTIONAL, REQUIRED
false

TenantSetting.spec.defaultSecuritySetting.authenticationSettings.http

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

TenantSetting.spec.defaultSecuritySetting.authenticationSettings.http.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

TenantSetting.spec.defaultSecuritySetting.authorization

↩ Parent

NameTypeDescriptionRequired
httpobjectThis is for configuring HTTP request authorization.
false
modeenumA short cut for specifying the set of allowed callers.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
false
rulesobject
false
serviceAccounts[]string
false

TenantSetting.spec.defaultSecuritySetting.authorization.http

↩ Parent

This is for configuring HTTP request authorization.

NameTypeDescriptionRequired
externalobject
false
localobject
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

TenantSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules

↩ Parent

NameTypeDescriptionRequired
allow[]objectAllow specifies a list of rules.
false
deny[]objectDeny specifies a list of rules.
false
denyAllbooleanDeny all specifies whether all requests should be rejected.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.allow[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.deny[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

TenantSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

TenantSetting.spec.defaultSecuritySetting.wafSettings

↩ Parent

NOTICE: this feature is in alpha stage and under active development.

NameTypeDescriptionRequired
ruleEngineModeenumAd-hoc settings to switch ModSecurity engine mode.

Enum: OFF, ON, DETECTION_ONLY
false
ruleSets[]stringRulesets to enable.
false

TenantSetting.spec.defaultTrafficSetting

↩ Parent

Traffic settings for all proxy workloads in this tenant.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
egressobject
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
rateLimitingobjectConfiguration for rate limiting requests.
false
reachabilityobject
false
resilienceobject
false

TenantSetting.spec.defaultTrafficSetting.egress

↩ Parent

NameTypeDescriptionRequired
hoststringSpecifies the egress gateway hostname.
false
portintegerDeprecated.

Format: int32
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

TenantSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

TenantSetting.spec.defaultTrafficSetting.reachability

↩ Parent

NameTypeDescriptionRequired
hosts[]string
false
modeenumA short cut for specifying the set of services accessed by the workload.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
false

TenantSetting.spec.defaultTrafficSetting.resilience

↩ Parent

NameTypeDescriptionRequired
circuitBreakerSensitivityenum

Enum: UNSET, LOW, MEDIUM, HIGH
false
httpRequestTimeoutstringTimeout for HTTP requests.
false
httpRetriesobjectRetry policy for HTTP requests.
false
keepAliveobjectKeep Alive Settings.
false
tcpKeepalivebooleanDeprecated.
false

TenantSetting.spec.defaultTrafficSetting.resilience.httpRetries

↩ Parent

Retry policy for HTTP requests.

NameTypeDescriptionRequired
attemptsintegerNumber of retries for a given request.

Format: int32
false
perTryTimeoutstringTimeout per retry attempt for a given request.
false
retryOnstringSpecifies the conditions under which retry takes place.
false

TenantSetting.spec.defaultTrafficSetting.resilience.keepAlive

↩ Parent

Keep Alive Settings.

NameTypeDescriptionRequired
tcpobjectTCP Keep Alive settings associated with the upstream and downstream TCP connections.
false

TenantSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp

↩ Parent

TCP Keep Alive settings associated with the upstream and downstream TCP connections.

NameTypeDescriptionRequired
downstreamobjectTCP Keep Alive Settings associated with the downstream (client) connection.
false
upstreamobjectTCP Keep Alive Settings associated with the upstream (backend) connection.
false

TenantSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.downstream

↩ Parent

TCP Keep Alive Settings associated with the downstream (client) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

TenantSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.upstream

↩ Parent

TCP Keep Alive Settings associated with the upstream (backend) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

Workspace

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringWorkspacetrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectA Workspace is a collection of related namespaces in one or more clusters.
false
statusobject
false

Workspace.spec

↩ Parent

A Workspace is a collection of related namespaces in one or more clusters.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
namespaceSelectorobjectSet of namespaces owned exclusively by this workspace.
false
privilegedboolean
false

Workspace.spec.namespaceSelector

↩ Parent

Set of namespaces owned exclusively by this workspace.

NameTypeDescriptionRequired
names[]string
false

WorkspaceSetting

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtsb.tetrate.io/v2true
kindstringWorkspaceSettingtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectDefault security and traffic settings for all proxy workloads in the workspace.
false
statusobject
false

WorkspaceSetting.spec

↩ Parent

Default security and traffic settings for all proxy workloads in the workspace.

NameTypeDescriptionRequired
defaultSecuritySettingobjectSecurity settings for all proxy workloads in this workspace.
false
defaultTrafficSettingobjectTraffic settings for all proxy workloads in this workspace.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
regionalFailover[]objectLocality routing settings for all gateways in the workspace.
false

WorkspaceSetting.spec.defaultSecuritySetting

↩ Parent

Security settings for all proxy workloads in this workspace.

NameTypeDescriptionRequired
authenticationenum

Enum: UNSET, OPTIONAL, REQUIRED
false
authenticationSettingsobject
false
authorizationobject
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
propagationStrategyenum

Enum: REPLACE, STRICTER
false
wafSettingsobjectNOTICE: this feature is in alpha stage and under active development.
false

WorkspaceSetting.spec.defaultSecuritySetting.authenticationSettings

↩ Parent

NameTypeDescriptionRequired
httpobject
false
trafficModeenum

Enum: UNSET, OPTIONAL, REQUIRED
false

WorkspaceSetting.spec.defaultSecuritySetting.authenticationSettings.http

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

WorkspaceSetting.spec.defaultSecuritySetting.authenticationSettings.http.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization

↩ Parent

NameTypeDescriptionRequired
httpobjectThis is for configuring HTTP request authorization.
false
modeenumA short cut for specifying the set of allowed callers.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
false
rulesobject
false
serviceAccounts[]string
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http

↩ Parent

This is for configuring HTTP request authorization.

NameTypeDescriptionRequired
externalobject
false
localobject
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.http.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules

↩ Parent

NameTypeDescriptionRequired
allow[]objectAllow specifies a list of rules.
false
deny[]objectDeny specifies a list of rules.
false
denyAllbooleanDeny all specifies whether all requests should be rejected.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.allow[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.allow[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.deny[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.authorization.rules.deny[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

WorkspaceSetting.spec.defaultSecuritySetting.wafSettings

↩ Parent

NOTICE: this feature is in alpha stage and under active development.

NameTypeDescriptionRequired
ruleEngineModeenumAd-hoc settings to switch ModSecurity engine mode.

Enum: OFF, ON, DETECTION_ONLY
false
ruleSets[]stringRulesets to enable.
false

WorkspaceSetting.spec.defaultTrafficSetting

↩ Parent

Traffic settings for all proxy workloads in this workspace.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
egressobject
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
rateLimitingobjectConfiguration for rate limiting requests.
false
reachabilityobject
false
resilienceobject
false

WorkspaceSetting.spec.defaultTrafficSetting.egress

↩ Parent

NameTypeDescriptionRequired
hoststringSpecifies the egress gateway hostname.
false
portintegerDeprecated.

Format: int32
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

WorkspaceSetting.spec.defaultTrafficSetting.rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

WorkspaceSetting.spec.defaultTrafficSetting.reachability

↩ Parent

NameTypeDescriptionRequired
hosts[]string
false
modeenumA short cut for specifying the set of services accessed by the workload.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience

↩ Parent

NameTypeDescriptionRequired
circuitBreakerSensitivityenum

Enum: UNSET, LOW, MEDIUM, HIGH
false
httpRequestTimeoutstringTimeout for HTTP requests.
false
httpRetriesobjectRetry policy for HTTP requests.
false
keepAliveobjectKeep Alive Settings.
false
tcpKeepalivebooleanDeprecated.
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience.httpRetries

↩ Parent

Retry policy for HTTP requests.

NameTypeDescriptionRequired
attemptsintegerNumber of retries for a given request.

Format: int32
false
perTryTimeoutstringTimeout per retry attempt for a given request.
false
retryOnstringSpecifies the conditions under which retry takes place.
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience.keepAlive

↩ Parent

Keep Alive Settings.

NameTypeDescriptionRequired
tcpobjectTCP Keep Alive settings associated with the upstream and downstream TCP connections.
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp

↩ Parent

TCP Keep Alive settings associated with the upstream and downstream TCP connections.

NameTypeDescriptionRequired
downstreamobjectTCP Keep Alive Settings associated with the downstream (client) connection.
false
upstreamobjectTCP Keep Alive Settings associated with the upstream (backend) connection.
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.downstream

↩ Parent

TCP Keep Alive Settings associated with the downstream (client) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

WorkspaceSetting.spec.defaultTrafficSetting.resilience.keepAlive.tcp.upstream

↩ Parent

TCP Keep Alive Settings associated with the upstream (backend) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

WorkspaceSetting.spec.regionalFailover[index]

↩ Parent

NameTypeDescriptionRequired
fromstringOriginating region.
false
tostring
false

application.tsb.tetrate.io/v2

Resource Types:

API

↩ Parent

NameTypeDescriptionRequired
apiVersionstringapplication.tsb.tetrate.io/v2true
kindstringAPItrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobjectAn API configuring a set of servers and endpoints that expose the Application business logic.
false
statusobject
false

API.spec

↩ Parent

An API configuring a set of servers and endpoints that expose the Application business logic.

NameTypeDescriptionRequired
configResources[]objectThe configuration resources that are related to this API object.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
endpoints[]objectList of endpoints exposed by this API.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
openapistringThe raw OpenAPI spec for this API.
false
servers[]objectList of servers that expose the API.
false
workloadSelectorobject
false

API.spec.configResources[index]

↩ Parent

NameTypeDescriptionRequired
exclusivelyOwnedboolean
false
expectedEtagstring
false
fqnstringThe FQN of the resource this status is computed for.
false

API.spec.endpoints[index]

↩ Parent

NameTypeDescriptionRequired
hostnames[]stringThe list of hostnames where this endpoint is exposed.
false
methods[]stringThe list of HTTP methods this endpoint supports.
false
pathstringThe HTTP path of the endpoint, relative to the hostnames exposed by the API.
false
servicestringThe FQN of the service in the service registry that is exposing this endpoint.
false

API.spec.servers[index]

↩ Parent

NameTypeDescriptionRequired
authenticationobjectConfiguration to authenticate clients.
false
authorizationobjectConfiguration to authorize a request.
false
hostnamestringHostname with which the service can be expected to be accessed by clients.
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
rateLimitingobjectConfiguration for rate limiting requests.
false
routingobjectRouting rules associated with HTTP traffic to this service.
false
tlsobjectTLS certificate info.
false
xxxOldAuthenticationobject
false
xxxOldAuthorizationobject
false

API.spec.servers[index].authentication

↩ Parent

Configuration to authenticate clients.

NameTypeDescriptionRequired
jwtobject
false

API.spec.servers[index].authentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

API.spec.servers[index].authorization

↩ Parent

Configuration to authorize a request.

NameTypeDescriptionRequired
externalobject
false
localobject
false

API.spec.servers[index].authorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

API.spec.servers[index].authorization.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

API.spec.servers[index].authorization.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

API.spec.servers[index].authorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

API.spec.servers[index].authorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

API.spec.servers[index].authorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

API.spec.servers[index].authorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

API.spec.servers[index].authorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

API.spec.servers[index].rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

API.spec.servers[index].rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

API.spec.servers[index].rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

API.spec.servers[index].rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

API.spec.servers[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

API.spec.servers[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

API.spec.servers[index].rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

API.spec.servers[index].rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

API.spec.servers[index].rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

API.spec.servers[index].rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

API.spec.servers[index].rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

API.spec.servers[index].rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

API.spec.servers[index].rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

API.spec.servers[index].rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

API.spec.servers[index].rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

API.spec.servers[index].rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

API.spec.servers[index].routing

↩ Parent

Routing rules associated with HTTP traffic to this service.

NameTypeDescriptionRequired
corsPolicyobjectCross origin resource request policy settings for all routes.
false
rules[]objectHTTP routes.
false

API.spec.servers[index].routing.corsPolicy

↩ Parent

Cross origin resource request policy settings for all routes.

NameTypeDescriptionRequired
allowCredentialsboolean
false
allowHeaders[]stringList of HTTP headers that can be used when requesting the resource.
false
allowMethods[]stringList of HTTP methods allowed to access the resource.
false
allowOrigin[]stringThe list of origins that are allowed to perform CORS requests.
false
exposeHeaders[]stringA white list of HTTP headers that the browsers are allowed to access.
false
maxAgestringSpecifies how long the results of a preflight request can be cached.
false

API.spec.servers[index].routing.rules[index]

↩ Parent

NameTypeDescriptionRequired
match[]objectOne or more match conditions (OR-ed).
false
modifyobjectOne or more mutations to be performed before forwarding.
false
redirectobjectRedirect the request to a different host or URL or both.
false
routeobjectForward the request to the specified destination(s).
false

API.spec.servers[index].routing.rules[index].match[index]

↩ Parent

NameTypeDescriptionRequired
headersmap[string]objectThe header keys must be lowercase and use hyphen as the separator, e.g.
false
uriobjectURI to match.
false

API.spec.servers[index].routing.rules[index].match[index].headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

API.spec.servers[index].routing.rules[index].match[index].uri

↩ Parent

URI to match.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

API.spec.servers[index].routing.rules[index].modify

↩ Parent

One or more mutations to be performed before forwarding.

NameTypeDescriptionRequired
headersobjectAdd/remove/overwrite one or more HTTP headers in a request or response.
false
rewriteobjectRewrite the HTTP Host or URL or both.
false

API.spec.servers[index].routing.rules[index].modify.headers

↩ Parent

Add/remove/overwrite one or more HTTP headers in a request or response.

NameTypeDescriptionRequired
requestobjectHeader manipulation rules to apply before forwarding a request to the destination service.
false
responseobjectHeader manipulation rules to apply before returning a response to the caller.
false

API.spec.servers[index].routing.rules[index].modify.headers.request

↩ Parent

Header manipulation rules to apply before forwarding a request to the destination service.

NameTypeDescriptionRequired
addmap[string]string
false
remove[]stringRemove a the specified headers.
false
setmap[string]stringOverwrite the headers specified by key with the given values.
false

API.spec.servers[index].routing.rules[index].modify.headers.response

↩ Parent

Header manipulation rules to apply before returning a response to the caller.

NameTypeDescriptionRequired
addmap[string]string
false
remove[]stringRemove a the specified headers.
false
setmap[string]stringOverwrite the headers specified by key with the given values.
false

API.spec.servers[index].routing.rules[index].modify.rewrite

↩ Parent

Rewrite the HTTP Host or URL or both.

NameTypeDescriptionRequired
authoritystringRewrite the Authority/Host header with this value.
false
uristringRewrite the path (or the prefix) portion of the URI with this value.
false

API.spec.servers[index].routing.rules[index].redirect

↩ Parent

Redirect the request to a different host or URL or both.

NameTypeDescriptionRequired
authoritystringOn a redirect, overwrite the Authority/Host portion of the URL with this value.
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
redirectCodeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
schemestringOn a redirect, overwrite the scheme with this one.
false
uristringOn a redirect, overwrite the Path portion of the URL with this value.
false

API.spec.servers[index].routing.rules[index].route

↩ Parent

Forward the request to the specified destination(s).

NameTypeDescriptionRequired
hoststring
false
portintegerThe port on the service to forward the request to.

Minimum: 0
Maximum: 4.294967295e+09
false

API.spec.servers[index].tls

↩ Parent

TLS certificate info.

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
secretNamestring
false

API.spec.servers[index].tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
privateKeystring
false
serverCertificatestring
false

API.spec.servers[index].xxxOldAuthentication

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

API.spec.servers[index].xxxOldAuthentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

API.spec.servers[index].xxxOldAuthorization

↩ Parent

NameTypeDescriptionRequired
externalobject
false
localobject
false

API.spec.servers[index].xxxOldAuthorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
uristring
false

API.spec.servers[index].xxxOldAuthorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

API.spec.servers[index].xxxOldAuthorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

API.spec.servers[index].xxxOldAuthorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

API.spec.servers[index].xxxOldAuthorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

API.spec.servers[index].xxxOldAuthorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

API.spec.workloadSelector

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]string
false
namespacestringThe namespace where the workload resides.
false

Application

↩ Parent

NameTypeDescriptionRequired
apiVersionstringapplication.tsb.tetrate.io/v2true
kindstringApplicationtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Application.spec

↩ Parent

NameTypeDescriptionRequired
configResources[]objectThe configuration resources that are related to this Application.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
gatewayGroupstringOptional FQN of the Gateway Group to be used by the application.
false
namespaceSelectorobjectOptional set of namespaces this application can configure.
false
services[]stringOptional list of services that are part of the application.
false
workspacestringFQN of the workspace this application is part of.
false

Application.spec.configResources[index]

↩ Parent

NameTypeDescriptionRequired
exclusivelyOwnedboolean
false
expectedEtagstring
false
fqnstringThe FQN of the resource this status is computed for.
false

Application.spec.namespaceSelector

↩ Parent

Optional set of namespaces this application can configure.

NameTypeDescriptionRequired
names[]string
false

gateway.tsb.tetrate.io/v2

Resource Types:

EgressGateway

↩ Parent

NameTypeDescriptionRequired
apiVersionstringgateway.tsb.tetrate.io/v2true
kindstringEgressGatewaytrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`EgressGateway` configures a workload to act as an egress gateway in the mesh.
false
statusobject
false

EgressGateway.spec

↩ Parent

EgressGateway configures a workload to act as an egress gateway in the mesh.

NameTypeDescriptionRequired
authorization[]objectThe description of which service accounts can access which hosts.
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
workloadSelectorobject
false

EgressGateway.spec.authorization[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectThe workloads or service accounts this authorization rule applies to.
false
to[]stringThe external hostnames the workload(s) described in this rule can access.
false

EgressGateway.spec.authorization[index].from

↩ Parent

The workloads or service accounts this authorization rule applies to.

NameTypeDescriptionRequired
httpobjectThis is for configuring HTTP request authorization.
false
modeenumA short cut for specifying the set of allowed callers.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
false
rulesobject
false
serviceAccounts[]string
false

EgressGateway.spec.authorization[index].from.http

↩ Parent

This is for configuring HTTP request authorization.

NameTypeDescriptionRequired
externalobject
false
localobject
false

EgressGateway.spec.authorization[index].from.http.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

EgressGateway.spec.authorization[index].from.http.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

EgressGateway.spec.authorization[index].from.http.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

EgressGateway.spec.authorization[index].from.http.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

EgressGateway.spec.authorization[index].from.http.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

EgressGateway.spec.authorization[index].from.http.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

EgressGateway.spec.authorization[index].from.http.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

EgressGateway.spec.authorization[index].from.http.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

EgressGateway.spec.authorization[index].from.rules

↩ Parent

NameTypeDescriptionRequired
allow[]objectAllow specifies a list of rules.
false
deny[]objectDeny specifies a list of rules.
false
denyAllbooleanDeny all specifies whether all requests should be rejected.
false

EgressGateway.spec.authorization[index].from.rules.allow[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

EgressGateway.spec.authorization[index].from.rules.allow[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

EgressGateway.spec.authorization[index].from.rules.allow[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

EgressGateway.spec.authorization[index].from.rules.deny[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

EgressGateway.spec.authorization[index].from.rules.deny[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

EgressGateway.spec.authorization[index].from.rules.deny[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

EgressGateway.spec.workloadSelector

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]string
false
namespacestringThe namespace where the workload resides.
false

Group

↩ Parent

NameTypeDescriptionRequired
apiVersionstringgateway.tsb.tetrate.io/v2true
kindstringGrouptrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Group.spec

↩ Parent

NameTypeDescriptionRequired
configModeenum

Enum: BRIDGED, DIRECT
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
namespaceSelectorobjectSet of namespaces owned exclusively by this group.
false

Group.spec.namespaceSelector

↩ Parent

Set of namespaces owned exclusively by this group.

NameTypeDescriptionRequired
names[]string
false

IngressGateway

↩ Parent

NameTypeDescriptionRequired
apiVersionstringgateway.tsb.tetrate.io/v2true
kindstringIngressGatewaytrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`IngressGateway` configures a workload to act as an ingress gateway into the mesh.
false
statusobject
false

IngressGateway.spec

↩ Parent

IngressGateway configures a workload to act as an ingress gateway into the mesh.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
http[]objectOne or more HTTP or HTTPS servers exposed by the gateway.
false
tcp[]object
false
tlsPassthrough[]objectOne or more TLS servers exposed by the gateway.
false
workloadSelectorobject
false

IngressGateway.spec.http[index]

↩ Parent

NameTypeDescriptionRequired
authenticationobjectConfiguration to authenticate clients.
false
authorizationobjectConfiguration to authorize a request.
false
hostnamestringHostname with which the service can be expected to be accessed by clients.
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
rateLimitingobjectConfiguration for rate limiting requests.
false
routingobjectRouting rules associated with HTTP traffic to this service.
false
tlsobjectTLS certificate info.
false
xxxOldAuthenticationobject
false
xxxOldAuthorizationobject
false

IngressGateway.spec.http[index].authentication

↩ Parent

Configuration to authenticate clients.

NameTypeDescriptionRequired
jwtobject
false

IngressGateway.spec.http[index].authentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

IngressGateway.spec.http[index].authorization

↩ Parent

Configuration to authorize a request.

NameTypeDescriptionRequired
externalobject
false
localobject
false

IngressGateway.spec.http[index].authorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

IngressGateway.spec.http[index].authorization.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

IngressGateway.spec.http[index].authorization.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

IngressGateway.spec.http[index].authorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

IngressGateway.spec.http[index].authorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

IngressGateway.spec.http[index].authorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

IngressGateway.spec.http[index].authorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

IngressGateway.spec.http[index].authorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

IngressGateway.spec.http[index].rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

IngressGateway.spec.http[index].rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

IngressGateway.spec.http[index].rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

IngressGateway.spec.http[index].rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

IngressGateway.spec.http[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

IngressGateway.spec.http[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

IngressGateway.spec.http[index].rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

IngressGateway.spec.http[index].rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

IngressGateway.spec.http[index].rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

IngressGateway.spec.http[index].rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

IngressGateway.spec.http[index].rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

IngressGateway.spec.http[index].routing

↩ Parent

Routing rules associated with HTTP traffic to this service.

NameTypeDescriptionRequired
corsPolicyobjectCross origin resource request policy settings for all routes.
false
rules[]objectHTTP routes.
false

IngressGateway.spec.http[index].routing.corsPolicy

↩ Parent

Cross origin resource request policy settings for all routes.

NameTypeDescriptionRequired
allowCredentialsboolean
false
allowHeaders[]stringList of HTTP headers that can be used when requesting the resource.
false
allowMethods[]stringList of HTTP methods allowed to access the resource.
false
allowOrigin[]stringThe list of origins that are allowed to perform CORS requests.
false
exposeHeaders[]stringA white list of HTTP headers that the browsers are allowed to access.
false
maxAgestringSpecifies how long the results of a preflight request can be cached.
false

IngressGateway.spec.http[index].routing.rules[index]

↩ Parent

NameTypeDescriptionRequired
match[]objectOne or more match conditions (OR-ed).
false
modifyobjectOne or more mutations to be performed before forwarding.
false
redirectobjectRedirect the request to a different host or URL or both.
false
routeobjectForward the request to the specified destination(s).
false

IngressGateway.spec.http[index].routing.rules[index].match[index]

↩ Parent

NameTypeDescriptionRequired
headersmap[string]objectThe header keys must be lowercase and use hyphen as the separator, e.g.
false
uriobjectURI to match.
false

IngressGateway.spec.http[index].routing.rules[index].match[index].headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

IngressGateway.spec.http[index].routing.rules[index].match[index].uri

↩ Parent

URI to match.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

IngressGateway.spec.http[index].routing.rules[index].modify

↩ Parent

One or more mutations to be performed before forwarding.

NameTypeDescriptionRequired
headersobjectAdd/remove/overwrite one or more HTTP headers in a request or response.
false
rewriteobjectRewrite the HTTP Host or URL or both.
false

IngressGateway.spec.http[index].routing.rules[index].modify.headers

↩ Parent

Add/remove/overwrite one or more HTTP headers in a request or response.

NameTypeDescriptionRequired
requestobjectHeader manipulation rules to apply before forwarding a request to the destination service.
false
responseobjectHeader manipulation rules to apply before returning a response to the caller.
false

IngressGateway.spec.http[index].routing.rules[index].modify.headers.request

↩ Parent

Header manipulation rules to apply before forwarding a request to the destination service.

NameTypeDescriptionRequired
addmap[string]string
false
remove[]stringRemove a the specified headers.
false
setmap[string]stringOverwrite the headers specified by key with the given values.
false

IngressGateway.spec.http[index].routing.rules[index].modify.headers.response

↩ Parent

Header manipulation rules to apply before returning a response to the caller.

NameTypeDescriptionRequired
addmap[string]string
false
remove[]stringRemove a the specified headers.
false
setmap[string]stringOverwrite the headers specified by key with the given values.
false

IngressGateway.spec.http[index].routing.rules[index].modify.rewrite

↩ Parent

Rewrite the HTTP Host or URL or both.

NameTypeDescriptionRequired
authoritystringRewrite the Authority/Host header with this value.
false
uristringRewrite the path (or the prefix) portion of the URI with this value.
false

IngressGateway.spec.http[index].routing.rules[index].redirect

↩ Parent

Redirect the request to a different host or URL or both.

NameTypeDescriptionRequired
authoritystringOn a redirect, overwrite the Authority/Host portion of the URL with this value.
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
redirectCodeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
schemestringOn a redirect, overwrite the scheme with this one.
false
uristringOn a redirect, overwrite the Path portion of the URL with this value.
false

IngressGateway.spec.http[index].routing.rules[index].route

↩ Parent

Forward the request to the specified destination(s).

NameTypeDescriptionRequired
hoststring
false
portintegerThe port on the service to forward the request to.

Minimum: 0
Maximum: 4.294967295e+09
false

IngressGateway.spec.http[index].tls

↩ Parent

TLS certificate info.

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
secretNamestring
false

IngressGateway.spec.http[index].tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
privateKeystring
false
serverCertificatestring
false

IngressGateway.spec.http[index].xxxOldAuthentication

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

IngressGateway.spec.http[index].xxxOldAuthentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

IngressGateway.spec.http[index].xxxOldAuthorization

↩ Parent

NameTypeDescriptionRequired
externalobject
false
localobject
false

IngressGateway.spec.http[index].xxxOldAuthorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
uristring
false

IngressGateway.spec.http[index].xxxOldAuthorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

IngressGateway.spec.http[index].xxxOldAuthorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

IngressGateway.spec.http[index].xxxOldAuthorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

IngressGateway.spec.http[index].xxxOldAuthorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

IngressGateway.spec.http[index].xxxOldAuthorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

IngressGateway.spec.tcp[index]

↩ Parent

NameTypeDescriptionRequired
hostnamestringHostname to identify the service.
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
routeobjectForward the connection to the specified destination.
false
tlsobject
false

IngressGateway.spec.tcp[index].route

↩ Parent

Forward the connection to the specified destination.

NameTypeDescriptionRequired
hoststring
false
portintegerThe port on the service to forward the request to.

Minimum: 0
Maximum: 4.294967295e+09
false

IngressGateway.spec.tcp[index].tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
secretNamestring
false

IngressGateway.spec.tcp[index].tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
privateKeystring
false
serverCertificatestring
false

IngressGateway.spec.tlsPassthrough[index]

↩ Parent

NameTypeDescriptionRequired
hostnamestringHostname with which the service can be expected to be accessed by clients.
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
routeobjectForward the connection to the specified destination.
false

IngressGateway.spec.tlsPassthrough[index].route

↩ Parent

Forward the connection to the specified destination.

NameTypeDescriptionRequired
hoststring
false
portintegerThe port on the service to forward the request to.

Minimum: 0
Maximum: 4.294967295e+09
false

IngressGateway.spec.workloadSelector

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]string
false
namespacestringThe namespace where the workload resides.
false

Tier1Gateway

↩ Parent

NameTypeDescriptionRequired
apiVersionstringgateway.tsb.tetrate.io/v2true
kindstringTier1Gatewaytrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`Tier1Gateway` configures a workload to act as a tier1 gateway into the mesh.
false
statusobject
false

Tier1Gateway.spec

↩ Parent

Tier1Gateway configures a workload to act as a tier1 gateway into the mesh.

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
externalServers[]objectOne or more servers exposed by the gateway externally.
false
fqnstringFully-qualified name of the resource.
false
internalServers[]objectOne or more servers exposed by the gateway internally for cross cluster forwarding.
false
passthroughServers[]objectOne or more tls passthrough servers exposed by the gateway externally.
false
tcpExternalServers[]objectOne or more tcp servers exposed by the gateway externally.
false
tcpInternalServers[]objectOne or more tcp servers exposed by the gateway for mesh internal traffic.
false
workloadSelectorobject
false

Tier1Gateway.spec.externalServers[index]

↩ Parent

NameTypeDescriptionRequired
authenticationobject
false
authorizationobjectAuthorization is used to configure authorization of end users.
false
clusters[]object
false
hostnamestring
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
rateLimitingobjectConfiguration for rate limiting requests.
false
redirectobjectRedirect allows configuring HTTP redirect.
false
tlsobjectTLS certificate info.
false

Tier1Gateway.spec.externalServers[index].authentication

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

Tier1Gateway.spec.externalServers[index].authentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

Tier1Gateway.spec.externalServers[index].authorization

↩ Parent

Authorization is used to configure authorization of end users.

NameTypeDescriptionRequired
externalobject
false
localobject
false

Tier1Gateway.spec.externalServers[index].authorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

Tier1Gateway.spec.externalServers[index].authorization.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

Tier1Gateway.spec.externalServers[index].authorization.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

Tier1Gateway.spec.externalServers[index].authorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

Tier1Gateway.spec.externalServers[index].authorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

Tier1Gateway.spec.externalServers[index].authorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

Tier1Gateway.spec.externalServers[index].authorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

Tier1Gateway.spec.externalServers[index].authorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

Tier1Gateway.spec.externalServers[index].clusters[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels associated with the cluster.
false
namestringThe name of the destination cluster.
false
networkstringThe network associated with the destination clusters.
false
weightintegerThe weight for traffic to a given destination.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.externalServers[index].rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

Tier1Gateway.spec.externalServers[index].rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

Tier1Gateway.spec.externalServers[index].rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

Tier1Gateway.spec.externalServers[index].redirect

↩ Parent

Redirect allows configuring HTTP redirect.

NameTypeDescriptionRequired
authoritystringOn a redirect, overwrite the Authority/Host portion of the URL with this value.
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
redirectCodeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
schemestringOn a redirect, overwrite the scheme with this one.
false
uristringOn a redirect, overwrite the Path portion of the URL with this value.
false

Tier1Gateway.spec.externalServers[index].tls

↩ Parent

TLS certificate info.

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
secretNamestring
false

Tier1Gateway.spec.externalServers[index].tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
privateKeystring
false
serverCertificatestring
false

Tier1Gateway.spec.internalServers[index]

↩ Parent

NameTypeDescriptionRequired
authenticationobject
false
authorizationobjectAuthorization is used to configure authorization of end user and traffic.
false
clusters[]object
false
hostnamestring
false
namestringA name assigned to the server.
false

Tier1Gateway.spec.internalServers[index].authentication

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

Tier1Gateway.spec.internalServers[index].authentication.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

Tier1Gateway.spec.internalServers[index].authorization

↩ Parent

Authorization is used to configure authorization of end user and traffic.

NameTypeDescriptionRequired
externalobject
false
localobject
false

Tier1Gateway.spec.internalServers[index].authorization.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

Tier1Gateway.spec.internalServers[index].authorization.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

Tier1Gateway.spec.internalServers[index].authorization.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

Tier1Gateway.spec.internalServers[index].authorization.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

Tier1Gateway.spec.internalServers[index].authorization.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

Tier1Gateway.spec.internalServers[index].authorization.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

Tier1Gateway.spec.internalServers[index].authorization.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

Tier1Gateway.spec.internalServers[index].authorization.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

Tier1Gateway.spec.internalServers[index].clusters[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels associated with the cluster.
false
namestringThe name of the destination cluster.
false
networkstringThe network associated with the destination clusters.
false
weightintegerThe weight for traffic to a given destination.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.passthroughServers[index]

↩ Parent

NameTypeDescriptionRequired
clusters[]object
false
hostnamestring
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.passthroughServers[index].clusters[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels associated with the cluster.
false
namestringThe name of the destination cluster.
false
networkstringThe network associated with the destination clusters.
false
weightintegerThe weight for traffic to a given destination.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.tcpExternalServers[index]

↩ Parent

NameTypeDescriptionRequired
clusters[]objectThe destination clusters contain ingress gateways exposing the service.
false
hostnamestring
false
namestringA name assigned to the server.
false
portintegerThe port where the server is exposed.

Minimum: 0
Maximum: 4.294967295e+09
false
tlsobjectTLS certificate information to terminate TLS.
false

Tier1Gateway.spec.tcpExternalServers[index].clusters[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels associated with the cluster.
false
namestringThe name of the destination cluster.
false
networkstringThe network associated with the destination clusters.
false
weightintegerThe weight for traffic to a given destination.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.tcpExternalServers[index].tls

↩ Parent

TLS certificate information to terminate TLS.

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
secretNamestring
false

Tier1Gateway.spec.tcpExternalServers[index].tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
privateKeystring
false
serverCertificatestring
false

Tier1Gateway.spec.tcpInternalServers[index]

↩ Parent

NameTypeDescriptionRequired
clusters[]objectThe destination clusters contain ingress gateways exposing the service.
false
hostnamestringThe name of the service used.
false
namestringA name assigned to the server.
false

Tier1Gateway.spec.tcpInternalServers[index].clusters[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels associated with the cluster.
false
namestringThe name of the destination cluster.
false
networkstringThe network associated with the destination clusters.
false
weightintegerThe weight for traffic to a given destination.

Minimum: 0
Maximum: 4.294967295e+09
false

Tier1Gateway.spec.workloadSelector

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]string
false
namespacestringThe namespace where the workload resides.
false

istiointernal.tsb.tetrate.io/v2

Resource Types:

Group

↩ Parent

NameTypeDescriptionRequired
apiVersionstringistiointernal.tsb.tetrate.io/v2true
kindstringGrouptrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Group.spec

↩ Parent

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
namespaceSelectorobjectSet of namespaces owned exclusively by this group.
false

Group.spec.namespaceSelector

↩ Parent

Set of namespaces owned exclusively by this group.

NameTypeDescriptionRequired
names[]string
false

rbac.tsb.tetrate.io/v2

Resource Types:

APInAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringAPInAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`APInAccessBindings` assigns permissions to users of APIs.
false
statusobject
false

APInAccessBindings.spec

↩ Parent

APInAccessBindings assigns permissions to users of APIs.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

APInAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

APInAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

AccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`AccessBindings` assigns permissions to users of any TSB resource.
false
statusobject
false

AccessBindings.spec

↩ Parent

AccessBindings assigns permissions to users of any TSB resource.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false

AccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

AccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

ApplicationAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringApplicationAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`ApplicationAccessBindings` assigns permissions to users of applications.
false
statusobject
false

ApplicationAccessBindings.spec

↩ Parent

ApplicationAccessBindings assigns permissions to users of applications.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

ApplicationAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

ApplicationAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

GatewayAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringGatewayAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`GatewayAccessBindings` assigns permissions to users of gateway groups.
false
statusobject
false

GatewayAccessBindings.spec

↩ Parent

GatewayAccessBindings assigns permissions to users of gateway groups.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

GatewayAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

GatewayAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

IstioInternalAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringIstioInternalAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`IstioInternalAccessBindings` assigns permissions to users of istio internal groups.
false
statusobject
false

IstioInternalAccessBindings.spec

↩ Parent

IstioInternalAccessBindings assigns permissions to users of istio internal groups.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

IstioInternalAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

IstioInternalAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

OrganizationAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringOrganizationAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`OrganizationAccessBindings` assigns permissions to users of organizations.
false
statusobject
false

OrganizationAccessBindings.spec

↩ Parent

OrganizationAccessBindings assigns permissions to users of organizations.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

OrganizationAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

OrganizationAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

Role

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringRoletrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Role.spec

↩ Parent

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
rules[]objectA set of rules that define the permissions associated with each API group.
false

Role.spec.rules[index]

↩ Parent

NameTypeDescriptionRequired
permissions[]enumThe set of actions allowed for these APIs.
false
types[]objectThe set of API groups and the api Kinds within the group on which this rule is applicable.
false

Role.spec.rules[index].types[index]

↩ Parent

NameTypeDescriptionRequired
apiGroupstringA specific API group such as traffic.tsb.tetrate.io/v2.
false
kinds[]stringSpecific kinds of APIs under the API group.
false

SecurityAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringSecurityAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`SecurityAccessBindings` assigns permissions to users of security groups.
false
statusobject
false

SecurityAccessBindings.spec

↩ Parent

SecurityAccessBindings assigns permissions to users of security groups.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

SecurityAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

SecurityAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

TenantAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringTenantAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`TenantAccessBindings` assigns permissions to users of tenants.
false
statusobject
false

TenantAccessBindings.spec

↩ Parent

TenantAccessBindings assigns permissions to users of tenants.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

TenantAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

TenantAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

TrafficAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringTrafficAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`TrafficAccessBindings` assigns permissions to users of traffic groups.
false
statusobject
false

TrafficAccessBindings.spec

↩ Parent

TrafficAccessBindings assigns permissions to users of traffic groups.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

TrafficAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

TrafficAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

WorkspaceAccessBindings

↩ Parent

NameTypeDescriptionRequired
apiVersionstringrbac.tsb.tetrate.io/v2true
kindstringWorkspaceAccessBindingstrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject`WorkspaceAccessBindings` assigns permissions to users of workspaces.
false
statusobject
false

WorkspaceAccessBindings.spec

↩ Parent

WorkspaceAccessBindings assigns permissions to users of workspaces.

NameTypeDescriptionRequired
allow[]object
false
descriptionstringA description of the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false

WorkspaceAccessBindings.spec.allow[index]

↩ Parent

NameTypeDescriptionRequired
rolestring
false
subjects[]object
false

WorkspaceAccessBindings.spec.allow[index].subjects[index]

↩ Parent

NameTypeDescriptionRequired
serviceAccountstringA service account in TSB.
false
teamstringA team in TSB, created through LDAP sync or API.
false
userstringA user in TSB, created through LDAP sync or API.
false

security.tsb.tetrate.io/v2

Resource Types:

Group

↩ Parent

NameTypeDescriptionRequired
apiVersionstringsecurity.tsb.tetrate.io/v2true
kindstringGrouptrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Group.spec

↩ Parent

NameTypeDescriptionRequired
configModeenum

Enum: BRIDGED, DIRECT
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
namespaceSelectorobjectSet of namespaces owned exclusively by this group.
false

Group.spec.namespaceSelector

↩ Parent

Set of namespaces owned exclusively by this group.

NameTypeDescriptionRequired
names[]string
false

SecuritySetting

↩ Parent

NameTypeDescriptionRequired
apiVersionstringsecurity.tsb.tetrate.io/v2true
kindstringSecuritySettingtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

SecuritySetting.spec

↩ Parent

NameTypeDescriptionRequired
authenticationenum

Enum: UNSET, OPTIONAL, REQUIRED
false
authenticationSettingsobject
false
authorizationobject
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
propagationStrategyenum

Enum: REPLACE, STRICTER
false
wafSettingsobjectNOTICE: this feature is in alpha stage and under active development.
false

SecuritySetting.spec.authenticationSettings

↩ Parent

NameTypeDescriptionRequired
httpobject
false
trafficModeenum

Enum: UNSET, OPTIONAL, REQUIRED
false

SecuritySetting.spec.authenticationSettings.http

↩ Parent

NameTypeDescriptionRequired
jwtobject
false

SecuritySetting.spec.authenticationSettings.http.jwt

↩ Parent

NameTypeDescriptionRequired
audiences[]string
false
issuerstringIdentifies the issuer that issued the JWT.
false
jwksstringJSON Web Key Set of public keys to validate signature of the JWT.
false
jwksUristring
false

SecuritySetting.spec.authorization

↩ Parent

NameTypeDescriptionRequired
httpobjectThis is for configuring HTTP request authorization.
false
modeenumA short cut for specifying the set of allowed callers.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
false
rulesobject
false
serviceAccounts[]string
false

SecuritySetting.spec.authorization.http

↩ Parent

This is for configuring HTTP request authorization.

NameTypeDescriptionRequired
externalobject
false
localobject
false

SecuritySetting.spec.authorization.http.external

↩ Parent

NameTypeDescriptionRequired
includeRequestHeaders[]string
false
tlsobject
false
uristring
false

SecuritySetting.spec.authorization.http.external.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

SecuritySetting.spec.authorization.http.external.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

SecuritySetting.spec.authorization.http.local

↩ Parent

NameTypeDescriptionRequired
rules[]object
false

SecuritySetting.spec.authorization.http.local.rules[index]

↩ Parent

NameTypeDescriptionRequired
from[]object
false
namestringA friendly name to identify the binding.
false
to[]object
false

SecuritySetting.spec.authorization.http.local.rules[index].from[index]

↩ Parent

NameTypeDescriptionRequired
jwtobjectJWT configuration to identity the subject.
false

SecuritySetting.spec.authorization.http.local.rules[index].from[index].jwt

↩ Parent

JWT configuration to identity the subject.

NameTypeDescriptionRequired
issstring
false
othermap[string]stringA set of arbitrary claims that are required to qualify the subject.
false
substring
false

SecuritySetting.spec.authorization.http.local.rules[index].to[index]

↩ Parent

NameTypeDescriptionRequired
methods[]stringThe HTTP methods that are allowed by this rule.
false
paths[]stringThe request path where the request is made against.
false

SecuritySetting.spec.authorization.rules

↩ Parent

NameTypeDescriptionRequired
allow[]objectAllow specifies a list of rules.
false
deny[]objectDeny specifies a list of rules.
false
denyAllbooleanDeny all specifies whether all requests should be rejected.
false

SecuritySetting.spec.authorization.rules.allow[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

SecuritySetting.spec.authorization.rules.allow[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

SecuritySetting.spec.authorization.rules.allow[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

SecuritySetting.spec.authorization.rules.deny[index]

↩ Parent

NameTypeDescriptionRequired
fromobjectFrom specifies the source of a request.
false
toobjectTo specifies the destination of a request.
false

SecuritySetting.spec.authorization.rules.deny[index].from

↩ Parent

From specifies the source of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the source of a request.
false

SecuritySetting.spec.authorization.rules.deny[index].to

↩ Parent

To specifies the destination of a request.

NameTypeDescriptionRequired
fqnstringThe target resource identified by FQN which will be the destination of a request.
false

SecuritySetting.spec.wafSettings

↩ Parent

NOTICE: this feature is in alpha stage and under active development.

NameTypeDescriptionRequired
ruleEngineModeenumAd-hoc settings to switch ModSecurity engine mode.

Enum: OFF, ON, DETECTION_ONLY
false
ruleSets[]stringRulesets to enable.
false

traffic.tsb.tetrate.io/v2

Resource Types:

Group

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtraffic.tsb.tetrate.io/v2true
kindstringGrouptrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

Group.spec

↩ Parent

NameTypeDescriptionRequired
configModeenum

Enum: BRIDGED, DIRECT
false
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
namespaceSelectorobjectSet of namespaces owned exclusively by this group.
false

Group.spec.namespaceSelector

↩ Parent

Set of namespaces owned exclusively by this group.

NameTypeDescriptionRequired
names[]string
false

ServiceRoute

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtraffic.tsb.tetrate.io/v2true
kindstringServiceRoutetrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

ServiceRoute.spec

↩ Parent

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
httpRoutes[]object
false
portLevelSettings[]objectIn order to support multi-protocol routing, a list of all port/protocol combinations is needed.
false
servicestringThe service on which the configuration is being applied.
false
stickySessionobject
false
subsets[]object
false
tcpRoutes[]objectTCPRoutes match TCP traffic based on port number.
false

ServiceRoute.spec.httpRoutes[index]

↩ Parent

NameTypeDescriptionRequired
destination[]object
false
match[]object
false
namestring
false

ServiceRoute.spec.httpRoutes[index].destination[index]

↩ Parent

NameTypeDescriptionRequired
destinationHoststringService host where traffic should be routed to.
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
subsetstring
false
weightinteger

Minimum: 0
Maximum: 4.294967295e+09
false

ServiceRoute.spec.httpRoutes[index].match[index]

↩ Parent

NameTypeDescriptionRequired
headersmap[string]object
false
namestring
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
uriobject
false

ServiceRoute.spec.httpRoutes[index].match[index].headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

ServiceRoute.spec.httpRoutes[index].match[index].uri

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

ServiceRoute.spec.portLevelSettings[index]

↩ Parent

NameTypeDescriptionRequired
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
stickySessionobject
false
trafficTypeenum

Enum: HTTP, TCP, TLS_PASSTHROUGH
false

ServiceRoute.spec.portLevelSettings[index].stickySession

↩ Parent

NameTypeDescriptionRequired
cookieobjectHash based on HTTP cookie.
false
headerstringHash based on a specific HTTP header.
false
useSourceIpbooleanHash based on the source IP address.
false

ServiceRoute.spec.portLevelSettings[index].stickySession.cookie

↩ Parent

Hash based on HTTP cookie.

NameTypeDescriptionRequired
namestringName of the cookie.
false
pathstringPath to set for the cookie.
false
ttlstringLifetime of the cookie.
false

ServiceRoute.spec.stickySession

↩ Parent

NameTypeDescriptionRequired
cookieobjectHash based on HTTP cookie.
false
headerstringHash based on a specific HTTP header.
false
useSourceIpbooleanHash based on the source IP address.
false

ServiceRoute.spec.stickySession.cookie

↩ Parent

Hash based on HTTP cookie.

NameTypeDescriptionRequired
namestringName of the cookie.
false
pathstringPath to set for the cookie.
false
ttlstringLifetime of the cookie.
false

ServiceRoute.spec.subsets[index]

↩ Parent

NameTypeDescriptionRequired
labelsmap[string]stringLabels apply a filter over the endpoints of a service in the service registry.
false
namestringName used to refer to the subset.
false
portLevelSettings[]object
false
weightintegerPercentage of traffic to be sent to this subset.

Minimum: 0
Maximum: 4.294967295e+09
false

ServiceRoute.spec.subsets[index].portLevelSettings[index]

↩ Parent

NameTypeDescriptionRequired
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
stickySessionobject
false
trafficTypeenum

Enum: HTTP, TCP, TLS_PASSTHROUGH
false

ServiceRoute.spec.subsets[index].portLevelSettings[index].stickySession

↩ Parent

NameTypeDescriptionRequired
cookieobjectHash based on HTTP cookie.
false
headerstringHash based on a specific HTTP header.
false
useSourceIpbooleanHash based on the source IP address.
false

ServiceRoute.spec.subsets[index].portLevelSettings[index].stickySession.cookie

↩ Parent

Hash based on HTTP cookie.

NameTypeDescriptionRequired
namestringName of the cookie.
false
pathstringPath to set for the cookie.
false
ttlstringLifetime of the cookie.
false

ServiceRoute.spec.tcpRoutes[index]

↩ Parent

NameTypeDescriptionRequired
destination[]object
false
match[]object
false
namestring
false

ServiceRoute.spec.tcpRoutes[index].destination[index]

↩ Parent

NameTypeDescriptionRequired
destinationHoststringService host where traffic should be routed to.
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false
subsetstring
false
weightinteger

Minimum: 0
Maximum: 4.294967295e+09
false

ServiceRoute.spec.tcpRoutes[index].match[index]

↩ Parent

NameTypeDescriptionRequired
namestring
false
portinteger

Minimum: 0
Maximum: 4.294967295e+09
false

TrafficSetting

↩ Parent

NameTypeDescriptionRequired
apiVersionstringtraffic.tsb.tetrate.io/v2true
kindstringTrafficSettingtrue
metadataobjectRefer to the Kubernetes API documentation for the fields of the `metadata` field.true
specobject
false
statusobject
false

TrafficSetting.spec

↩ Parent

NameTypeDescriptionRequired
descriptionstringA description of the resource.
false
displayNamestringUser friendly name for the resource.
false
egressobject
false
etagstringThe etag for the resource.
false
fqnstringFully-qualified name of the resource.
false
rateLimitingobjectConfiguration for rate limiting requests.
false
reachabilityobject
false
resilienceobject
false

TrafficSetting.spec.egress

↩ Parent

NameTypeDescriptionRequired
hoststringSpecifies the egress gateway hostname.
false
portintegerDeprecated.

Format: int32
false

TrafficSetting.spec.rateLimiting

↩ Parent

Configuration for rate limiting requests.

NameTypeDescriptionRequired
externalServiceobjectConfigure ratelimiting using an external ratelimit server.
false
settingsobject
false

TrafficSetting.spec.rateLimiting.externalService

↩ Parent

Configure ratelimiting using an external ratelimit server.

NameTypeDescriptionRequired
domainstringThe rate limit domain to use when calling the rate limit service.
false
failClosedboolean
false
rateLimitServerUristringThe URI at which the external rate limit server can be reached.
false
rules[]objectA set of rate limit rules.
false
timeoutstringThe timeout in seconds for the external rate limit server RPC.
false
tlsobject
false

TrafficSetting.spec.rateLimiting.externalService.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions that are to be applied for this rate limit configuration.
false

TrafficSetting.spec.rateLimiting.externalService.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
destinationClusterobjectRate limit on destination envoy cluster.
false
headerValueMatchobjectRate limit on the existence of certain request headers.
false
remoteAddressobjectRate limit on remote address of client.
false
requestHeadersobjectRate limit on the value of certain request headers.
false
sourceClusterobjectRate limit on source envoy cluster.
false

TrafficSetting.spec.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch

↩ Parent

Rate limit on the existence of certain request headers.

NameTypeDescriptionRequired
descriptorValuestringThe value to use in the descriptor entry.
false
headersmap[string]object
false

TrafficSetting.spec.rateLimiting.externalService.rules[index].dimensions[index].headerValueMatch.headers[key]

↩ Parent

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

TrafficSetting.spec.rateLimiting.externalService.rules[index].dimensions[index].requestHeaders

↩ Parent

Rate limit on the value of certain request headers.

NameTypeDescriptionRequired
descriptorKeystringThe key to use in the descriptor entry.
false
headerNamestringThe header name to be queried from the request headers.
false

TrafficSetting.spec.rateLimiting.externalService.tls

↩ Parent

NameTypeDescriptionRequired
filesobject
false
modeenum

Enum: DISABLED, SIMPLE, MUTUAL
false
subjectAltNames[]string
false

TrafficSetting.spec.rateLimiting.externalService.tls.files

↩ Parent

NameTypeDescriptionRequired
caCertificatesstring
false
clientCertificatestringCertificate file to authenticate the client.
false
privateKeystringPrivate key file associated with the client certificate.
false

TrafficSetting.spec.rateLimiting.settings

↩ Parent

NameTypeDescriptionRequired
failClosedboolean
false
rules[]objectA list of rules for ratelimiting.
false
timeoutstringThe timeout in seconds for the rate limit server RPC.
false

TrafficSetting.spec.rateLimiting.settings.rules[index]

↩ Parent

NameTypeDescriptionRequired
dimensions[]objectA list of dimensions to define each ratelimit rule.
false
limitobjectThe ratelimit value that will be configured for the above rules.
false

TrafficSetting.spec.rateLimiting.settings.rules[index].dimensions[index]

↩ Parent

NameTypeDescriptionRequired
headerobjectRate limit on certain HTTP headers.
false
remoteAddressobjectRate limit on the remote address of client.
false

TrafficSetting.spec.rateLimiting.settings.rules[index].dimensions[index].header

↩ Parent

Rate limit on certain HTTP headers.

NameTypeDescriptionRequired
namestringName of the header to match on.
false
valueobjectValue of the header to match on if matching on a specific value.
false

TrafficSetting.spec.rateLimiting.settings.rules[index].dimensions[index].header.value

↩ Parent

Value of the header to match on if matching on a specific value.

NameTypeDescriptionRequired
exactstringExact string match.
false
prefixstringPrefix-based match.
false
regexstringECMAscript style regex-based match.
false

TrafficSetting.spec.rateLimiting.settings.rules[index].dimensions[index].remoteAddress

↩ Parent

Rate limit on the remote address of client.

NameTypeDescriptionRequired
valuestringRatelimit on a specific remote address.
false

TrafficSetting.spec.rateLimiting.settings.rules[index].limit

↩ Parent

The ratelimit value that will be configured for the above rules.

NameTypeDescriptionRequired
requestsPerUnitintegerSpecifies the value of the rate limit.

Minimum: 0
Maximum: 4.294967295e+09
false
unitenumSpecifies the unit of time for rate limit.

Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
false

TrafficSetting.spec.reachability

↩ Parent

NameTypeDescriptionRequired
hosts[]string
false
modeenumA short cut for specifying the set of services accessed by the workload.

Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
false

TrafficSetting.spec.resilience

↩ Parent

NameTypeDescriptionRequired
circuitBreakerSensitivityenum

Enum: UNSET, LOW, MEDIUM, HIGH
false
httpRequestTimeoutstringTimeout for HTTP requests.
false
httpRetriesobjectRetry policy for HTTP requests.
false
keepAliveobjectKeep Alive Settings.
false
tcpKeepalivebooleanDeprecated.
false

TrafficSetting.spec.resilience.httpRetries

↩ Parent

Retry policy for HTTP requests.

NameTypeDescriptionRequired
attemptsintegerNumber of retries for a given request.

Format: int32
false
perTryTimeoutstringTimeout per retry attempt for a given request.
false
retryOnstringSpecifies the conditions under which retry takes place.
false

TrafficSetting.spec.resilience.keepAlive

↩ Parent

Keep Alive Settings.

NameTypeDescriptionRequired
tcpobjectTCP Keep Alive settings associated with the upstream and downstream TCP connections.
false

TrafficSetting.spec.resilience.keepAlive.tcp

↩ Parent

TCP Keep Alive settings associated with the upstream and downstream TCP connections.

NameTypeDescriptionRequired
downstreamobjectTCP Keep Alive Settings associated with the downstream (client) connection.
false
upstreamobjectTCP Keep Alive Settings associated with the upstream (backend) connection.
false

TrafficSetting.spec.resilience.keepAlive.tcp.downstream

↩ Parent

TCP Keep Alive Settings associated with the downstream (client) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false

TrafficSetting.spec.resilience.keepAlive.tcp.upstream

↩ Parent

TCP Keep Alive Settings associated with the upstream (backend) connection.

NameTypeDescriptionRequired
idleTimeinteger

Minimum: 0
Maximum: 4.294967295e+09
false
intervalintegerThe number of seconds between keep-alive probes.

Minimum: 0
Maximum: 4.294967295e+09
false
probesinteger

Minimum: 0
Maximum: 4.294967295e+09
false