openapi client
openapi client
The openapi client binding
openapi_client:
type: openapi
kind: client
options:
tcp:
host: localhost
port: 8080
specs:
petstore:
servers:
- url: http://localhost:9090
catalog:
my_catalog:
subject: petstore
version: latest
Configuration (* required)
options
object
openapi
-specific options.
options:
specs:
petstore:
servers:
- url: http://localhost:9090
catalog:
my_catalog:
subject: petstore
version: latest
options.specs
object
as map of named:object
specs
specific options
specs.catalog
object
as map of named:object
catalog specific options.
catalog.subject*
string
Subject name used when storing the catalog artifact.
catalog.version
string
| Default:latest
Catalog artifact version to use.
specs.servers
array
ofobject
The servers to match from the schema that are used when defining endpoints.
servers[].url
string
| Pattern:^([a-zA-Z0-9\\\\.-]+)(:(\\\\{[a-zA-Z_]+\\\\}|[0-9]+))?$
The server url to match in openapi spec
options.http
object
http specific options.
http.authorization
object
as map of named:object
Authorization by guard for the HTTP/1.1
and HTTP/2
protocols.
authorization:
my_jwt_guard:
credentials:
headers:
authorization: Bearer {credentials}
authorization.credentials*
object
Defines how to extract credentials from the HTTP request.
credentials.cookies
object
as map of named:string
properties
Named cookie value pattern with {credentials}
.
credentials.headers
object
as map of named:string
properties
Named header value pattern with {credentials}
, e.g. "Bearer
{credentials}"
.
credentials.query*
object
as map of named:string
properties
Named query parameter value pattern with {credentials}
.
options.tcp
object
TCP options to connect to an external client.
tcp.host
string
Hostname or IP address.
tcp.port
integer
,string
,array
Port number(s), including port number ranges.
options.tls
object
tls
specific options.
tls.version
string
Protocol version.
tls.keys
array
ofstring
A list of reference names for the Vault key.
tls.trust
array
ofstring
A list of reference names for the Vault certificate.
tls.signers
array
ofstring
A list of reference names for the Vault signer certificate.
tls.trustcacerts
boolean
Trust CA certificates. This property will be considered set to true
when tls.trust is null
.
tls.sni
array
ofstring
A list of the Server Name Indications.
tls.alpn
array
ofstring
Application protocols.
tls.mutual
enum
[required
,requested
,none
] | Default:none
Mutual authentication.
vault
string
Vault name.
telemetry
object
Defines the desired telemetry for the binding.
telemetry.metrics
array
Telemetry metrics to track
telemetry:
metrics:
- stream.*