API Reference
Packages:
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | Cluster | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | A Kubernetes cluster managing both pods and VMs.
| false |
status | object |
| false |
↩ Parent
A Kubernetes cluster managing both pods and VMs.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
labels | map[string]string |
| false |
locality | object | Location information about the cluster which can be used for routing.
| false |
namespaceScope | object | Configure the default scoping of namespaces in this cluster.
| false |
namespaces | []object |
| false |
network | string | The network (e.g., VPC) where this cluster is present.
| false |
state | object |
| false |
tier1Cluster | boolean | Indicates whether this cluster is hosting a tier1 gateway or not.
| false |
tokenTtl | string | Lifetime of the tokens.
| false |
trustDomain | string | Trust domain for this cluster, used for multi-cluster routing.
| false |
↩ Parent
Location information about the cluster which can be used for routing.
Name | Type | Description | Required |
---|
region | string | The geographic location of the cluster.
| false |
↩ Parent
Configure the default scoping of namespaces in this cluster.
Name | Type | Description | Required |
---|
exceptions | []string | Namespaces to be excluded form the default scope.
| false |
scope | enum |
Enum: GLOBAL, LOCAL
| false |
↩ Parent
Name | Type | Description | Required |
---|
name | string |
| false |
services | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
canonicalName | string |
| false |
gatewayHost | boolean |
| false |
hostname | string | The hostname by which this service is accessed.
| false |
kubernetesExternalAddresses | []string |
| false |
kubernetesServiceFqdn | string |
| false |
kubernetesServiceIp | string |
| false |
meshExternal | boolean |
| false |
name | string |
| false |
namespace | string | namespace associated with the service.
| false |
numHops | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
numKubernetesEndpoints | integer | The number of kubernetes pods providing this service.
Minimum: 0 Maximum: 4.294967295e+09
| false |
numVmEndpoints | integer | The number of VMs providing this service.
Minimum: 0 Maximum: 4.294967295e+09
| false |
ports | []object | The set of ports on which this service is exposed.
| false |
selector | map[string]string | label selectors associated with the service.
| false |
spiffeIds | []string | List of SPIFFE identities used by the workloads of the service.
| false |
subsets | []string |
| false |
tier1GatewayHost | boolean |
| false |
workloads | []object | Workloads implementing the Service.
| false |
↩ Parent
Name | Type | Description | Required |
---|
kubernetesNodePort | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
name | string | Name assigned to the port.
| false |
number | integer | A valid non-negative integer port number.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
address | string | Routable address of the workload.
| false |
isVm | boolean | Indicates whether the workload is kubernetes endpoint or vm.
| false |
name | string | Instance name of the workload.
| false |
proxy | object | Proxy details.
| false |
↩ Parent
Proxy details.
Name | Type | Description | Required |
---|
controlPlaneAddress | string |
| false |
envoyVersion | string | Envoy version of the proxy.
| false |
istioVersion | string | Istio version of the proxy.
| false |
status | map[string]string | Sync status for each xDS component.
| false |
↩ Parent
Name | Type | Description | Required |
---|
istioVersions | []string | This shows currently running istio versions in the cluster.
| false |
lastSyncTime | string |
Format: date-time
| false |
provider | string | cluster provider.
| false |
xcpVersion | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | Organization | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `Organization` is the root of the Service Bridge object hierarchy.
| false |
status | object |
| false |
↩ Parent
Organization
is the root of the Service Bridge object hierarchy.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | OrganizationSetting | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | Settings that apply globally to the entire organization.
| false |
status | object |
| false |
↩ Parent
Settings that apply globally to the entire organization.
Name | Type | Description | Required |
---|
defaultSecuritySetting | object | Security settings for all proxy workloads in this organization.
| false |
defaultTrafficSetting | object | Traffic settings for all proxy workloads in this organization.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
networkSettings | object | Reachability between clusters on various networks.
| false |
regionalFailover | []object | Default locality routing settings for all gateways.
| false |
↩ Parent
Security settings for all proxy workloads in this organization.
Name | Type | Description | Required |
---|
authentication | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
authenticationSettings | object |
| false |
authorization | object |
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
propagationStrategy | enum |
Enum: REPLACE, STRICTER
| false |
wafSettings | object | NOTICE: this feature is in alpha stage and under active development.
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object |
| false |
trafficMode | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object | This is for configuring HTTP request authorization.
| false |
mode | enum | A short cut for specifying the set of allowed callers.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
| false |
rules | object |
| false |
serviceAccounts | []string |
| false |
↩ Parent
This is for configuring HTTP request authorization.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
allow | []object | Allow specifies a list of rules.
| false |
deny | []object | Deny specifies a list of rules.
| false |
denyAll | boolean | Deny all specifies whether all requests should be rejected.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
NOTICE: this feature is in alpha stage and under active development.
Name | Type | Description | Required |
---|
ruleEngineMode | enum | Ad-hoc settings to switch ModSecurity engine mode.
Enum: OFF, ON, DETECTION_ONLY
| false |
ruleSets | []string | Rulesets to enable.
| false |
↩ Parent
Traffic settings for all proxy workloads in this organization.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
egress | object |
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
reachability | object |
| false |
resilience | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
host | string | Specifies the egress gateway hostname.
| false |
port | integer | Deprecated.
Format: int32
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Name | Type | Description | Required |
---|
hosts | []string |
| false |
mode | enum | A short cut for specifying the set of services accessed by the workload.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
| false |
↩ Parent
Name | Type | Description | Required |
---|
circuitBreakerSensitivity | enum |
Enum: UNSET, LOW, MEDIUM, HIGH
| false |
httpRequestTimeout | string | Timeout for HTTP requests.
| false |
httpRetries | object | Retry policy for HTTP requests.
| false |
keepAlive | object | Keep Alive Settings.
| false |
tcpKeepalive | boolean | Deprecated.
| false |
↩ Parent
Retry policy for HTTP requests.
Name | Type | Description | Required |
---|
attempts | integer | Number of retries for a given request.
Format: int32
| false |
perTryTimeout | string | Timeout per retry attempt for a given request.
| false |
retryOn | string | Specifies the conditions under which retry takes place.
| false |
↩ Parent
Keep Alive Settings.
Name | Type | Description | Required |
---|
tcp | object | TCP Keep Alive settings associated with the upstream and downstream TCP connections.
| false |
↩ Parent
TCP Keep Alive settings associated with the upstream and downstream TCP connections.
Name | Type | Description | Required |
---|
downstream | object | TCP Keep Alive Settings associated with the downstream (client) connection.
| false |
upstream | object | TCP Keep Alive Settings associated with the upstream (backend) connection.
| false |
↩ Parent
TCP Keep Alive Settings associated with the downstream (client) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TCP Keep Alive Settings associated with the upstream (backend) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Reachability between clusters on various networks.
Name | Type | Description | Required |
---|
networkReachability | map[string]string | Reachability between clusters on various networks.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | string | Originating region.
| false |
to | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | ServiceAccount | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `ServiceAccount` represents a service account that can be used to access the TSB platform.
| false |
status | object |
| false |
↩ Parent
ServiceAccount
represents a service account that can be used to access the TSB platform.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
keys | []object | Keys associated with the service account.
| false |
↩ Parent
Name | Type | Description | Required |
---|
defaultToken | string |
| false |
encoding | enum | Format in which the public and private keys are encoded.
Enum: PEM, JWK
| false |
id | string | Unique identifier for this key-pair.
| false |
privateKey | string | The encoded private key associated with the service account.
| false |
publicKey | string | The encoded public key associated with the service account.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | Team | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `Team` is a named collection of users under a tenant.
| false |
status | object |
| false |
↩ Parent
Team
is a named collection of users under a tenant.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
members | []string | List of members under the team.
| false |
sourceType | enum | Where the team comes from.
Enum: INVALID, LDAP, LOCAL, AZURE, MANUAL
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | Tenant | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `Tenant` is a self-contained entity within an organization in the Service Bridge hierarchy.
| false |
status | object |
| false |
↩ Parent
Tenant
is a self-contained entity within an organization in the Service Bridge hierarchy.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | TenantSetting | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | Default settings that apply to all workspaces under a tenant.
| false |
status | object |
| false |
↩ Parent
Default settings that apply to all workspaces under a tenant.
Name | Type | Description | Required |
---|
defaultSecuritySetting | object | Security settings for all proxy workloads in this tenant.
| false |
defaultTrafficSetting | object | Traffic settings for all proxy workloads in this tenant.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Security settings for all proxy workloads in this tenant.
Name | Type | Description | Required |
---|
authentication | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
authenticationSettings | object |
| false |
authorization | object |
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
propagationStrategy | enum |
Enum: REPLACE, STRICTER
| false |
wafSettings | object | NOTICE: this feature is in alpha stage and under active development.
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object |
| false |
trafficMode | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object | This is for configuring HTTP request authorization.
| false |
mode | enum | A short cut for specifying the set of allowed callers.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
| false |
rules | object |
| false |
serviceAccounts | []string |
| false |
↩ Parent
This is for configuring HTTP request authorization.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
allow | []object | Allow specifies a list of rules.
| false |
deny | []object | Deny specifies a list of rules.
| false |
denyAll | boolean | Deny all specifies whether all requests should be rejected.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
NOTICE: this feature is in alpha stage and under active development.
Name | Type | Description | Required |
---|
ruleEngineMode | enum | Ad-hoc settings to switch ModSecurity engine mode.
Enum: OFF, ON, DETECTION_ONLY
| false |
ruleSets | []string | Rulesets to enable.
| false |
↩ Parent
Traffic settings for all proxy workloads in this tenant.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
egress | object |
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
reachability | object |
| false |
resilience | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
host | string | Specifies the egress gateway hostname.
| false |
port | integer | Deprecated.
Format: int32
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Name | Type | Description | Required |
---|
hosts | []string |
| false |
mode | enum | A short cut for specifying the set of services accessed by the workload.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
| false |
↩ Parent
Name | Type | Description | Required |
---|
circuitBreakerSensitivity | enum |
Enum: UNSET, LOW, MEDIUM, HIGH
| false |
httpRequestTimeout | string | Timeout for HTTP requests.
| false |
httpRetries | object | Retry policy for HTTP requests.
| false |
keepAlive | object | Keep Alive Settings.
| false |
tcpKeepalive | boolean | Deprecated.
| false |
↩ Parent
Retry policy for HTTP requests.
Name | Type | Description | Required |
---|
attempts | integer | Number of retries for a given request.
Format: int32
| false |
perTryTimeout | string | Timeout per retry attempt for a given request.
| false |
retryOn | string | Specifies the conditions under which retry takes place.
| false |
↩ Parent
Keep Alive Settings.
Name | Type | Description | Required |
---|
tcp | object | TCP Keep Alive settings associated with the upstream and downstream TCP connections.
| false |
↩ Parent
TCP Keep Alive settings associated with the upstream and downstream TCP connections.
Name | Type | Description | Required |
---|
downstream | object | TCP Keep Alive Settings associated with the downstream (client) connection.
| false |
upstream | object | TCP Keep Alive Settings associated with the upstream (backend) connection.
| false |
↩ Parent
TCP Keep Alive Settings associated with the downstream (client) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TCP Keep Alive Settings associated with the upstream (backend) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | Workspace | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | A Workspace is a collection of related namespaces in one or more clusters.
| false |
status | object |
| false |
↩ Parent
A Workspace is a collection of related namespaces in one or more clusters.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
namespaceSelector | object | Set of namespaces owned exclusively by this workspace.
| false |
privileged | boolean |
| false |
↩ Parent
Set of namespaces owned exclusively by this workspace.
Name | Type | Description | Required |
---|
names | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | tsb.tetrate.io/v2 | true |
kind | string | WorkspaceSetting | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | Default security and traffic settings for all proxy workloads in the workspace.
| false |
status | object |
| false |
↩ Parent
Default security and traffic settings for all proxy workloads in the workspace.
Name | Type | Description | Required |
---|
defaultSecuritySetting | object | Security settings for all proxy workloads in this workspace.
| false |
defaultTrafficSetting | object | Traffic settings for all proxy workloads in this workspace.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
regionalFailover | []object | Locality routing settings for all gateways in the workspace.
| false |
↩ Parent
Security settings for all proxy workloads in this workspace.
Name | Type | Description | Required |
---|
authentication | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
authenticationSettings | object |
| false |
authorization | object |
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
propagationStrategy | enum |
Enum: REPLACE, STRICTER
| false |
wafSettings | object | NOTICE: this feature is in alpha stage and under active development.
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object |
| false |
trafficMode | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object | This is for configuring HTTP request authorization.
| false |
mode | enum | A short cut for specifying the set of allowed callers.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
| false |
rules | object |
| false |
serviceAccounts | []string |
| false |
↩ Parent
This is for configuring HTTP request authorization.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
allow | []object | Allow specifies a list of rules.
| false |
deny | []object | Deny specifies a list of rules.
| false |
denyAll | boolean | Deny all specifies whether all requests should be rejected.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
NOTICE: this feature is in alpha stage and under active development.
Name | Type | Description | Required |
---|
ruleEngineMode | enum | Ad-hoc settings to switch ModSecurity engine mode.
Enum: OFF, ON, DETECTION_ONLY
| false |
ruleSets | []string | Rulesets to enable.
| false |
↩ Parent
Traffic settings for all proxy workloads in this workspace.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
egress | object |
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
reachability | object |
| false |
resilience | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
host | string | Specifies the egress gateway hostname.
| false |
port | integer | Deprecated.
Format: int32
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Name | Type | Description | Required |
---|
hosts | []string |
| false |
mode | enum | A short cut for specifying the set of services accessed by the workload.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
| false |
↩ Parent
Name | Type | Description | Required |
---|
circuitBreakerSensitivity | enum |
Enum: UNSET, LOW, MEDIUM, HIGH
| false |
httpRequestTimeout | string | Timeout for HTTP requests.
| false |
httpRetries | object | Retry policy for HTTP requests.
| false |
keepAlive | object | Keep Alive Settings.
| false |
tcpKeepalive | boolean | Deprecated.
| false |
↩ Parent
Retry policy for HTTP requests.
Name | Type | Description | Required |
---|
attempts | integer | Number of retries for a given request.
Format: int32
| false |
perTryTimeout | string | Timeout per retry attempt for a given request.
| false |
retryOn | string | Specifies the conditions under which retry takes place.
| false |
↩ Parent
Keep Alive Settings.
Name | Type | Description | Required |
---|
tcp | object | TCP Keep Alive settings associated with the upstream and downstream TCP connections.
| false |
↩ Parent
TCP Keep Alive settings associated with the upstream and downstream TCP connections.
Name | Type | Description | Required |
---|
downstream | object | TCP Keep Alive Settings associated with the downstream (client) connection.
| false |
upstream | object | TCP Keep Alive Settings associated with the upstream (backend) connection.
| false |
↩ Parent
TCP Keep Alive Settings associated with the downstream (client) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TCP Keep Alive Settings associated with the upstream (backend) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | string | Originating region.
| false |
to | string |
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | application.tsb.tetrate.io/v2 | true |
kind | string | API | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | An API configuring a set of servers and endpoints that expose the Application business logic.
| false |
status | object |
| false |
↩ Parent
An API configuring a set of servers and endpoints that expose the Application business logic.
Name | Type | Description | Required |
---|
configResources | []object | The configuration resources that are related to this API object.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
endpoints | []object | List of endpoints exposed by this API.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
openapi | string | The raw OpenAPI spec for this API.
| false |
servers | []object | List of servers that expose the API.
| false |
workloadSelector | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exclusivelyOwned | boolean |
| false |
expectedEtag | string |
| false |
fqn | string | The FQN of the resource this status is computed for.
| false |
↩ Parent
Name | Type | Description | Required |
---|
hostnames | []string | The list of hostnames where this endpoint is exposed.
| false |
methods | []string | The list of HTTP methods this endpoint supports.
| false |
path | string | The HTTP path of the endpoint, relative to the hostnames exposed by the API.
| false |
service | string | The FQN of the service in the service registry that is exposing this endpoint.
| false |
↩ Parent
Name | Type | Description | Required |
---|
authentication | object | Configuration to authenticate clients.
| false |
authorization | object | Configuration to authorize a request.
| false |
hostname | string | Hostname with which the service can be expected to be accessed by clients.
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
routing | object | Routing rules associated with HTTP traffic to this service.
| false |
tls | object | TLS certificate info.
| false |
xxxOldAuthentication | object |
| false |
xxxOldAuthorization | object |
| false |
↩ Parent
Configuration to authenticate clients.
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Configuration to authorize a request.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Routing rules associated with HTTP traffic to this service.
Name | Type | Description | Required |
---|
corsPolicy | object | Cross origin resource request policy settings for all routes.
| false |
rules | []object | HTTP routes.
| false |
↩ Parent
Cross origin resource request policy settings for all routes.
Name | Type | Description | Required |
---|
allowCredentials | boolean |
| false |
allowHeaders | []string | List of HTTP headers that can be used when requesting the resource.
| false |
allowMethods | []string | List of HTTP methods allowed to access the resource.
| false |
allowOrigin | []string | The list of origins that are allowed to perform CORS requests.
| false |
exposeHeaders | []string | A white list of HTTP headers that the browsers are allowed to access.
| false |
maxAge | string | Specifies how long the results of a preflight request can be cached.
| false |
↩ Parent
Name | Type | Description | Required |
---|
match | []object | One or more match conditions (OR-ed).
| false |
modify | object | One or more mutations to be performed before forwarding.
| false |
redirect | object | Redirect the request to a different host or URL or both.
| false |
route | object | Forward the request to the specified destination(s).
| false |
↩ Parent
Name | Type | Description | Required |
---|
headers | map[string]object | The header keys must be lowercase and use hyphen as the separator, e.g.
| false |
uri | object | URI to match.
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
URI to match.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
One or more mutations to be performed before forwarding.
Name | Type | Description | Required |
---|
headers | object | Add/remove/overwrite one or more HTTP headers in a request or response.
| false |
rewrite | object | Rewrite the HTTP Host or URL or both.
| false |
↩ Parent
Add/remove/overwrite one or more HTTP headers in a request or response.
Name | Type | Description | Required |
---|
request | object | Header manipulation rules to apply before forwarding a request to the destination service.
| false |
response | object | Header manipulation rules to apply before returning a response to the caller.
| false |
↩ Parent
Header manipulation rules to apply before forwarding a request to the destination service.
Name | Type | Description | Required |
---|
add | map[string]string |
| false |
remove | []string | Remove a the specified headers.
| false |
set | map[string]string | Overwrite the headers specified by key with the given values.
| false |
↩ Parent
Header manipulation rules to apply before returning a response to the caller.
Name | Type | Description | Required |
---|
add | map[string]string |
| false |
remove | []string | Remove a the specified headers.
| false |
set | map[string]string | Overwrite the headers specified by key with the given values.
| false |
↩ Parent
Rewrite the HTTP Host or URL or both.
Name | Type | Description | Required |
---|
authority | string | Rewrite the Authority/Host header with this value.
| false |
uri | string | Rewrite the path (or the prefix) portion of the URI with this value.
| false |
↩ Parent
Redirect the request to a different host or URL or both.
Name | Type | Description | Required |
---|
authority | string | On a redirect, overwrite the Authority/Host portion of the URL with this value.
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
redirectCode | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
scheme | string | On a redirect, overwrite the scheme with this one.
| false |
uri | string | On a redirect, overwrite the Path portion of the URL with this value.
| false |
↩ Parent
Forward the request to the specified destination(s).
Name | Type | Description | Required |
---|
host | string |
| false |
port | integer | The port on the service to forward the request to.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TLS certificate info.
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
secretName | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
privateKey | string |
| false |
serverCertificate | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string |
| false |
namespace | string | The namespace where the workload resides.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | application.tsb.tetrate.io/v2 | true |
kind | string | Application | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
configResources | []object | The configuration resources that are related to this Application.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
gatewayGroup | string | Optional FQN of the Gateway Group to be used by the application.
| false |
namespaceSelector | object | Optional set of namespaces this application can configure.
| false |
services | []string | Optional list of services that are part of the application.
| false |
workspace | string | FQN of the workspace this application is part of.
| false |
↩ Parent
Name | Type | Description | Required |
---|
exclusivelyOwned | boolean |
| false |
expectedEtag | string |
| false |
fqn | string | The FQN of the resource this status is computed for.
| false |
↩ Parent
Optional set of namespaces this application can configure.
Name | Type | Description | Required |
---|
names | []string |
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | gateway.tsb.tetrate.io/v2 | true |
kind | string | EgressGateway | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `EgressGateway` configures a workload to act as an egress gateway in the mesh.
| false |
status | object |
| false |
↩ Parent
EgressGateway
configures a workload to act as an egress gateway in the mesh.
Name | Type | Description | Required |
---|
authorization | []object | The description of which service accounts can access which hosts.
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
workloadSelector | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | The workloads or service accounts this authorization rule applies to.
| false |
to | []string | The external hostnames the workload(s) described in this rule can access.
| false |
↩ Parent
The workloads or service accounts this authorization rule applies to.
Name | Type | Description | Required |
---|
http | object | This is for configuring HTTP request authorization.
| false |
mode | enum | A short cut for specifying the set of allowed callers.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
| false |
rules | object |
| false |
serviceAccounts | []string |
| false |
↩ Parent
This is for configuring HTTP request authorization.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
allow | []object | Allow specifies a list of rules.
| false |
deny | []object | Deny specifies a list of rules.
| false |
denyAll | boolean | Deny all specifies whether all requests should be rejected.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string |
| false |
namespace | string | The namespace where the workload resides.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | gateway.tsb.tetrate.io/v2 | true |
kind | string | Group | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
configMode | enum |
Enum: BRIDGED, DIRECT
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
namespaceSelector | object | Set of namespaces owned exclusively by this group.
| false |
↩ Parent
Set of namespaces owned exclusively by this group.
Name | Type | Description | Required |
---|
names | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | gateway.tsb.tetrate.io/v2 | true |
kind | string | IngressGateway | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `IngressGateway` configures a workload to act as an ingress gateway into the mesh.
| false |
status | object |
| false |
↩ Parent
IngressGateway
configures a workload to act as an ingress gateway into the mesh.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
http | []object | One or more HTTP or HTTPS servers exposed by the gateway.
| false |
tcp | []object |
| false |
tlsPassthrough | []object | One or more TLS servers exposed by the gateway.
| false |
workloadSelector | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
authentication | object | Configuration to authenticate clients.
| false |
authorization | object | Configuration to authorize a request.
| false |
hostname | string | Hostname with which the service can be expected to be accessed by clients.
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
routing | object | Routing rules associated with HTTP traffic to this service.
| false |
tls | object | TLS certificate info.
| false |
xxxOldAuthentication | object |
| false |
xxxOldAuthorization | object |
| false |
↩ Parent
Configuration to authenticate clients.
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Configuration to authorize a request.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Routing rules associated with HTTP traffic to this service.
Name | Type | Description | Required |
---|
corsPolicy | object | Cross origin resource request policy settings for all routes.
| false |
rules | []object | HTTP routes.
| false |
↩ Parent
Cross origin resource request policy settings for all routes.
Name | Type | Description | Required |
---|
allowCredentials | boolean |
| false |
allowHeaders | []string | List of HTTP headers that can be used when requesting the resource.
| false |
allowMethods | []string | List of HTTP methods allowed to access the resource.
| false |
allowOrigin | []string | The list of origins that are allowed to perform CORS requests.
| false |
exposeHeaders | []string | A white list of HTTP headers that the browsers are allowed to access.
| false |
maxAge | string | Specifies how long the results of a preflight request can be cached.
| false |
↩ Parent
Name | Type | Description | Required |
---|
match | []object | One or more match conditions (OR-ed).
| false |
modify | object | One or more mutations to be performed before forwarding.
| false |
redirect | object | Redirect the request to a different host or URL or both.
| false |
route | object | Forward the request to the specified destination(s).
| false |
↩ Parent
Name | Type | Description | Required |
---|
headers | map[string]object | The header keys must be lowercase and use hyphen as the separator, e.g.
| false |
uri | object | URI to match.
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
URI to match.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
One or more mutations to be performed before forwarding.
Name | Type | Description | Required |
---|
headers | object | Add/remove/overwrite one or more HTTP headers in a request or response.
| false |
rewrite | object | Rewrite the HTTP Host or URL or both.
| false |
↩ Parent
Add/remove/overwrite one or more HTTP headers in a request or response.
Name | Type | Description | Required |
---|
request | object | Header manipulation rules to apply before forwarding a request to the destination service.
| false |
response | object | Header manipulation rules to apply before returning a response to the caller.
| false |
↩ Parent
Header manipulation rules to apply before forwarding a request to the destination service.
Name | Type | Description | Required |
---|
add | map[string]string |
| false |
remove | []string | Remove a the specified headers.
| false |
set | map[string]string | Overwrite the headers specified by key with the given values.
| false |
↩ Parent
Header manipulation rules to apply before returning a response to the caller.
Name | Type | Description | Required |
---|
add | map[string]string |
| false |
remove | []string | Remove a the specified headers.
| false |
set | map[string]string | Overwrite the headers specified by key with the given values.
| false |
↩ Parent
Rewrite the HTTP Host or URL or both.
Name | Type | Description | Required |
---|
authority | string | Rewrite the Authority/Host header with this value.
| false |
uri | string | Rewrite the path (or the prefix) portion of the URI with this value.
| false |
↩ Parent
Redirect the request to a different host or URL or both.
Name | Type | Description | Required |
---|
authority | string | On a redirect, overwrite the Authority/Host portion of the URL with this value.
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
redirectCode | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
scheme | string | On a redirect, overwrite the scheme with this one.
| false |
uri | string | On a redirect, overwrite the Path portion of the URL with this value.
| false |
↩ Parent
Forward the request to the specified destination(s).
Name | Type | Description | Required |
---|
host | string |
| false |
port | integer | The port on the service to forward the request to.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TLS certificate info.
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
secretName | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
privateKey | string |
| false |
serverCertificate | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
hostname | string | Hostname to identify the service.
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
route | object | Forward the connection to the specified destination.
| false |
tls | object |
| false |
↩ Parent
Forward the connection to the specified destination.
Name | Type | Description | Required |
---|
host | string |
| false |
port | integer | The port on the service to forward the request to.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
secretName | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
privateKey | string |
| false |
serverCertificate | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
hostname | string | Hostname with which the service can be expected to be accessed by clients.
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
route | object | Forward the connection to the specified destination.
| false |
↩ Parent
Forward the connection to the specified destination.
Name | Type | Description | Required |
---|
host | string |
| false |
port | integer | The port on the service to forward the request to.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string |
| false |
namespace | string | The namespace where the workload resides.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | gateway.tsb.tetrate.io/v2 | true |
kind | string | Tier1Gateway | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `Tier1Gateway` configures a workload to act as a tier1 gateway into the mesh.
| false |
status | object |
| false |
↩ Parent
Tier1Gateway
configures a workload to act as a tier1 gateway into the mesh.
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
externalServers | []object | One or more servers exposed by the gateway externally.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
internalServers | []object | One or more servers exposed by the gateway internally for cross cluster forwarding.
| false |
passthroughServers | []object | One or more tls passthrough servers exposed by the gateway externally.
| false |
tcpExternalServers | []object | One or more tcp servers exposed by the gateway externally.
| false |
tcpInternalServers | []object | One or more tcp servers exposed by the gateway for mesh internal traffic.
| false |
workloadSelector | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
authentication | object |
| false |
authorization | object | Authorization is used to configure authorization of end users.
| false |
clusters | []object |
| false |
hostname | string |
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
redirect | object | Redirect allows configuring HTTP redirect.
| false |
tls | object | TLS certificate info.
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Authorization is used to configure authorization of end users.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels associated with the cluster.
| false |
name | string | The name of the destination cluster.
| false |
network | string | The network associated with the destination clusters.
| false |
weight | integer | The weight for traffic to a given destination.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Redirect allows configuring HTTP redirect.
Name | Type | Description | Required |
---|
authority | string | On a redirect, overwrite the Authority/Host portion of the URL with this value.
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
redirectCode | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
scheme | string | On a redirect, overwrite the scheme with this one.
| false |
uri | string | On a redirect, overwrite the Path portion of the URL with this value.
| false |
↩ Parent
TLS certificate info.
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
secretName | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
privateKey | string |
| false |
serverCertificate | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
authentication | object |
| false |
authorization | object | Authorization is used to configure authorization of end user and traffic.
| false |
clusters | []object |
| false |
hostname | string |
| false |
name | string | A name assigned to the server.
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Authorization is used to configure authorization of end user and traffic.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels associated with the cluster.
| false |
name | string | The name of the destination cluster.
| false |
network | string | The network associated with the destination clusters.
| false |
weight | integer | The weight for traffic to a given destination.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
clusters | []object |
| false |
hostname | string |
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels associated with the cluster.
| false |
name | string | The name of the destination cluster.
| false |
network | string | The network associated with the destination clusters.
| false |
weight | integer | The weight for traffic to a given destination.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
clusters | []object | The destination clusters contain ingress gateways exposing the service.
| false |
hostname | string |
| false |
name | string | A name assigned to the server.
| false |
port | integer | The port where the server is exposed.
Minimum: 0 Maximum: 4.294967295e+09
| false |
tls | object | TLS certificate information to terminate TLS.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels associated with the cluster.
| false |
name | string | The name of the destination cluster.
| false |
network | string | The network associated with the destination clusters.
| false |
weight | integer | The weight for traffic to a given destination.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TLS certificate information to terminate TLS.
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
secretName | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
privateKey | string |
| false |
serverCertificate | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
clusters | []object | The destination clusters contain ingress gateways exposing the service.
| false |
hostname | string | The name of the service used.
| false |
name | string | A name assigned to the server.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels associated with the cluster.
| false |
name | string | The name of the destination cluster.
| false |
network | string | The network associated with the destination clusters.
| false |
weight | integer | The weight for traffic to a given destination.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string |
| false |
namespace | string | The namespace where the workload resides.
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | istiointernal.tsb.tetrate.io/v2 | true |
kind | string | Group | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
namespaceSelector | object | Set of namespaces owned exclusively by this group.
| false |
↩ Parent
Set of namespaces owned exclusively by this group.
Name | Type | Description | Required |
---|
names | []string |
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | APInAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `APInAccessBindings` assigns permissions to users of APIs.
| false |
status | object |
| false |
↩ Parent
APInAccessBindings
assigns permissions to users of APIs.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | AccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `AccessBindings` assigns permissions to users of any TSB resource.
| false |
status | object |
| false |
↩ Parent
AccessBindings
assigns permissions to users of any TSB resource.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | ApplicationAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `ApplicationAccessBindings` assigns permissions to users of applications.
| false |
status | object |
| false |
↩ Parent
ApplicationAccessBindings
assigns permissions to users of applications.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | GatewayAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `GatewayAccessBindings` assigns permissions to users of gateway groups.
| false |
status | object |
| false |
↩ Parent
GatewayAccessBindings
assigns permissions to users of gateway groups.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | IstioInternalAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `IstioInternalAccessBindings` assigns permissions to users of istio internal groups.
| false |
status | object |
| false |
↩ Parent
IstioInternalAccessBindings
assigns permissions to users of istio internal groups.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | OrganizationAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `OrganizationAccessBindings` assigns permissions to users of organizations.
| false |
status | object |
| false |
↩ Parent
OrganizationAccessBindings
assigns permissions to users of organizations.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | Role | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
rules | []object | A set of rules that define the permissions associated with each API group.
| false |
↩ Parent
Name | Type | Description | Required |
---|
permissions | []enum | The set of actions allowed for these APIs.
| false |
types | []object | The set of API groups and the api Kinds within the group on which this rule is applicable.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiGroup | string | A specific API group such as traffic.tsb.tetrate.io/v2.
| false |
kinds | []string | Specific kinds of APIs under the API group.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | SecurityAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `SecurityAccessBindings` assigns permissions to users of security groups.
| false |
status | object |
| false |
↩ Parent
SecurityAccessBindings
assigns permissions to users of security groups.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | TenantAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `TenantAccessBindings` assigns permissions to users of tenants.
| false |
status | object |
| false |
↩ Parent
TenantAccessBindings
assigns permissions to users of tenants.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | TrafficAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `TrafficAccessBindings` assigns permissions to users of traffic groups.
| false |
status | object |
| false |
↩ Parent
TrafficAccessBindings
assigns permissions to users of traffic groups.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | rbac.tsb.tetrate.io/v2 | true |
kind | string | WorkspaceAccessBindings | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object | `WorkspaceAccessBindings` assigns permissions to users of workspaces.
| false |
status | object |
| false |
↩ Parent
WorkspaceAccessBindings
assigns permissions to users of workspaces.
Name | Type | Description | Required |
---|
allow | []object |
| false |
description | string | A description of the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
↩ Parent
Name | Type | Description | Required |
---|
role | string |
| false |
subjects | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
serviceAccount | string | A service account in TSB.
| false |
team | string | A team in TSB, created through LDAP sync or API.
| false |
user | string | A user in TSB, created through LDAP sync or API.
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | security.tsb.tetrate.io/v2 | true |
kind | string | Group | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
configMode | enum |
Enum: BRIDGED, DIRECT
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
namespaceSelector | object | Set of namespaces owned exclusively by this group.
| false |
↩ Parent
Set of namespaces owned exclusively by this group.
Name | Type | Description | Required |
---|
names | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | security.tsb.tetrate.io/v2 | true |
kind | string | SecuritySetting | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
authentication | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
authenticationSettings | object |
| false |
authorization | object |
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
propagationStrategy | enum |
Enum: REPLACE, STRICTER
| false |
wafSettings | object | NOTICE: this feature is in alpha stage and under active development.
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object |
| false |
trafficMode | enum |
Enum: UNSET, OPTIONAL, REQUIRED
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
audiences | []string |
| false |
issuer | string | Identifies the issuer that issued the JWT.
| false |
jwks | string | JSON Web Key Set of public keys to validate signature of the JWT.
| false |
jwksUri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
http | object | This is for configuring HTTP request authorization.
| false |
mode | enum | A short cut for specifying the set of allowed callers.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, DISABLED, CUSTOM, RULES
| false |
rules | object |
| false |
serviceAccounts | []string |
| false |
↩ Parent
This is for configuring HTTP request authorization.
↩ Parent
Name | Type | Description | Required |
---|
includeRequestHeaders | []string |
| false |
tls | object |
| false |
uri | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
rules | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | []object |
| false |
name | string | A friendly name to identify the binding.
| false |
to | []object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
jwt | object | JWT configuration to identity the subject.
| false |
↩ Parent
JWT configuration to identity the subject.
Name | Type | Description | Required |
---|
iss | string |
| false |
other | map[string]string | A set of arbitrary claims that are required to qualify the subject.
| false |
sub | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
methods | []string | The HTTP methods that are allowed by this rule.
| false |
paths | []string | The request path where the request is made against.
| false |
↩ Parent
Name | Type | Description | Required |
---|
allow | []object | Allow specifies a list of rules.
| false |
deny | []object | Deny specifies a list of rules.
| false |
denyAll | boolean | Deny all specifies whether all requests should be rejected.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
Name | Type | Description | Required |
---|
from | object | From specifies the source of a request.
| false |
to | object | To specifies the destination of a request.
| false |
↩ Parent
From specifies the source of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the source of a request.
| false |
↩ Parent
To specifies the destination of a request.
Name | Type | Description | Required |
---|
fqn | string | The target resource identified by FQN which will be the destination of a request.
| false |
↩ Parent
NOTICE: this feature is in alpha stage and under active development.
Name | Type | Description | Required |
---|
ruleEngineMode | enum | Ad-hoc settings to switch ModSecurity engine mode.
Enum: OFF, ON, DETECTION_ONLY
| false |
ruleSets | []string | Rulesets to enable.
| false |
Resource Types:
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | traffic.tsb.tetrate.io/v2 | true |
kind | string | Group | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
configMode | enum |
Enum: BRIDGED, DIRECT
| false |
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
namespaceSelector | object | Set of namespaces owned exclusively by this group.
| false |
↩ Parent
Set of namespaces owned exclusively by this group.
Name | Type | Description | Required |
---|
names | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | traffic.tsb.tetrate.io/v2 | true |
kind | string | ServiceRoute | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
httpRoutes | []object |
| false |
portLevelSettings | []object | In order to support multi-protocol routing, a list of all port/protocol combinations is needed.
| false |
service | string | The service on which the configuration is being applied.
| false |
stickySession | object |
| false |
subsets | []object |
| false |
tcpRoutes | []object | TCPRoutes match TCP traffic based on port number.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destination | []object |
| false |
match | []object |
| false |
name | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationHost | string | Service host where traffic should be routed to.
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
subset | string |
| false |
weight | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
headers | map[string]object |
| false |
name | string |
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
uri | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Name | Type | Description | Required |
---|
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
stickySession | object |
| false |
trafficType | enum |
Enum: HTTP, TCP, TLS_PASSTHROUGH
| false |
↩ Parent
Name | Type | Description | Required |
---|
cookie | object | Hash based on HTTP cookie.
| false |
header | string | Hash based on a specific HTTP header.
| false |
useSourceIp | boolean | Hash based on the source IP address.
| false |
↩ Parent
Hash based on HTTP cookie.
Name | Type | Description | Required |
---|
name | string | Name of the cookie.
| false |
path | string | Path to set for the cookie.
| false |
ttl | string | Lifetime of the cookie.
| false |
↩ Parent
Name | Type | Description | Required |
---|
cookie | object | Hash based on HTTP cookie.
| false |
header | string | Hash based on a specific HTTP header.
| false |
useSourceIp | boolean | Hash based on the source IP address.
| false |
↩ Parent
Hash based on HTTP cookie.
Name | Type | Description | Required |
---|
name | string | Name of the cookie.
| false |
path | string | Path to set for the cookie.
| false |
ttl | string | Lifetime of the cookie.
| false |
↩ Parent
Name | Type | Description | Required |
---|
labels | map[string]string | Labels apply a filter over the endpoints of a service in the service registry.
| false |
name | string | Name used to refer to the subset.
| false |
portLevelSettings | []object |
| false |
weight | integer | Percentage of traffic to be sent to this subset.
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
stickySession | object |
| false |
trafficType | enum |
Enum: HTTP, TCP, TLS_PASSTHROUGH
| false |
↩ Parent
Name | Type | Description | Required |
---|
cookie | object | Hash based on HTTP cookie.
| false |
header | string | Hash based on a specific HTTP header.
| false |
useSourceIp | boolean | Hash based on the source IP address.
| false |
↩ Parent
Hash based on HTTP cookie.
Name | Type | Description | Required |
---|
name | string | Name of the cookie.
| false |
path | string | Path to set for the cookie.
| false |
ttl | string | Lifetime of the cookie.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destination | []object |
| false |
match | []object |
| false |
name | string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationHost | string | Service host where traffic should be routed to.
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
subset | string |
| false |
weight | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
name | string |
| false |
port | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
Name | Type | Description | Required |
---|
apiVersion | string | traffic.tsb.tetrate.io/v2 | true |
kind | string | TrafficSetting | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
| false |
status | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
description | string | A description of the resource.
| false |
displayName | string | User friendly name for the resource.
| false |
egress | object |
| false |
etag | string | The etag for the resource.
| false |
fqn | string | Fully-qualified name of the resource.
| false |
rateLimiting | object | Configuration for rate limiting requests.
| false |
reachability | object |
| false |
resilience | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
host | string | Specifies the egress gateway hostname.
| false |
port | integer | Deprecated.
Format: int32
| false |
↩ Parent
Configuration for rate limiting requests.
Name | Type | Description | Required |
---|
externalService | object | Configure ratelimiting using an external ratelimit server.
| false |
settings | object |
| false |
↩ Parent
Configure ratelimiting using an external ratelimit server.
Name | Type | Description | Required |
---|
domain | string | The rate limit domain to use when calling the rate limit service.
| false |
failClosed | boolean |
| false |
rateLimitServerUri | string | The URI at which the external rate limit server can be reached.
| false |
rules | []object | A set of rate limit rules.
| false |
timeout | string | The timeout in seconds for the external rate limit server RPC.
| false |
tls | object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions that are to be applied for this rate limit configuration.
| false |
↩ Parent
Name | Type | Description | Required |
---|
destinationCluster | object | Rate limit on destination envoy cluster.
| false |
headerValueMatch | object | Rate limit on the existence of certain request headers.
| false |
remoteAddress | object | Rate limit on remote address of client.
| false |
requestHeaders | object | Rate limit on the value of certain request headers.
| false |
sourceCluster | object | Rate limit on source envoy cluster.
| false |
↩ Parent
Rate limit on the existence of certain request headers.
Name | Type | Description | Required |
---|
descriptorValue | string | The value to use in the descriptor entry.
| false |
headers | map[string]object |
| false |
↩ Parent
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the value of certain request headers.
Name | Type | Description | Required |
---|
descriptorKey | string | The key to use in the descriptor entry.
| false |
headerName | string | The header name to be queried from the request headers.
| false |
↩ Parent
Name | Type | Description | Required |
---|
files | object |
| false |
mode | enum |
Enum: DISABLED, SIMPLE, MUTUAL
| false |
subjectAltNames | []string |
| false |
↩ Parent
Name | Type | Description | Required |
---|
caCertificates | string |
| false |
clientCertificate | string | Certificate file to authenticate the client.
| false |
privateKey | string | Private key file associated with the client certificate.
| false |
↩ Parent
Name | Type | Description | Required |
---|
failClosed | boolean |
| false |
rules | []object | A list of rules for ratelimiting.
| false |
timeout | string | The timeout in seconds for the rate limit server RPC.
| false |
↩ Parent
Name | Type | Description | Required |
---|
dimensions | []object | A list of dimensions to define each ratelimit rule.
| false |
limit | object | The ratelimit value that will be configured for the above rules.
| false |
↩ Parent
Name | Type | Description | Required |
---|
header | object | Rate limit on certain HTTP headers.
| false |
remoteAddress | object | Rate limit on the remote address of client.
| false |
↩ Parent
Rate limit on certain HTTP headers.
Name | Type | Description | Required |
---|
name | string | Name of the header to match on.
| false |
value | object | Value of the header to match on if matching on a specific value.
| false |
↩ Parent
Value of the header to match on if matching on a specific value.
Name | Type | Description | Required |
---|
exact | string | Exact string match.
| false |
prefix | string | Prefix-based match.
| false |
regex | string | ECMAscript style regex-based match.
| false |
↩ Parent
Rate limit on the remote address of client.
Name | Type | Description | Required |
---|
value | string | Ratelimit on a specific remote address.
| false |
↩ Parent
The ratelimit value that will be configured for the above rules.
Name | Type | Description | Required |
---|
requestsPerUnit | integer | Specifies the value of the rate limit.
Minimum: 0 Maximum: 4.294967295e+09
| false |
unit | enum | Specifies the unit of time for rate limit.
Enum: UNKNOWN, SECOND, MINUTE, HOUR, DAY
| false |
↩ Parent
Name | Type | Description | Required |
---|
hosts | []string |
| false |
mode | enum | A short cut for specifying the set of services accessed by the workload.
Enum: UNSET, NAMESPACE, GROUP, WORKSPACE, CLUSTER, CUSTOM
| false |
↩ Parent
Name | Type | Description | Required |
---|
circuitBreakerSensitivity | enum |
Enum: UNSET, LOW, MEDIUM, HIGH
| false |
httpRequestTimeout | string | Timeout for HTTP requests.
| false |
httpRetries | object | Retry policy for HTTP requests.
| false |
keepAlive | object | Keep Alive Settings.
| false |
tcpKeepalive | boolean | Deprecated.
| false |
↩ Parent
Retry policy for HTTP requests.
Name | Type | Description | Required |
---|
attempts | integer | Number of retries for a given request.
Format: int32
| false |
perTryTimeout | string | Timeout per retry attempt for a given request.
| false |
retryOn | string | Specifies the conditions under which retry takes place.
| false |
↩ Parent
Keep Alive Settings.
Name | Type | Description | Required |
---|
tcp | object | TCP Keep Alive settings associated with the upstream and downstream TCP connections.
| false |
↩ Parent
TCP Keep Alive settings associated with the upstream and downstream TCP connections.
Name | Type | Description | Required |
---|
downstream | object | TCP Keep Alive Settings associated with the downstream (client) connection.
| false |
upstream | object | TCP Keep Alive Settings associated with the upstream (backend) connection.
| false |
↩ Parent
TCP Keep Alive Settings associated with the downstream (client) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
↩ Parent
TCP Keep Alive Settings associated with the upstream (backend) connection.
Name | Type | Description | Required |
---|
idleTime | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |
interval | integer | The number of seconds between keep-alive probes.
Minimum: 0 Maximum: 4.294967295e+09
| false |
probes | integer |
Minimum: 0 Maximum: 4.294967295e+09
| false |