docs: update configuration example
This commit is contained in:
@@ -119,7 +119,7 @@ Create a config file in this format
|
|||||||
|
|
||||||
Example of a configuration file
|
Example of a configuration file
|
||||||
```yaml
|
```yaml
|
||||||
# Goma Gateway configurations
|
## Goma Gateway configurations
|
||||||
gateway:
|
gateway:
|
||||||
# Proxy write timeout
|
# Proxy write timeout
|
||||||
writeTimeout: 15
|
writeTimeout: 15
|
||||||
@@ -132,7 +132,6 @@ gateway:
|
|||||||
## SSL Private Key file
|
## SSL Private Key file
|
||||||
sslKeyFile: ''#key.pem
|
sslKeyFile: ''#key.pem
|
||||||
# Proxy rate limit, it's In-Memory IP based
|
# Proxy rate limit, it's In-Memory IP based
|
||||||
# Distributed Rate Limiting for Token based across multiple instances is not yet integrated
|
|
||||||
rateLimiter: 0
|
rateLimiter: 0
|
||||||
accessLog: "/dev/Stdout"
|
accessLog: "/dev/Stdout"
|
||||||
errorLog: "/dev/stderr"
|
errorLog: "/dev/stderr"
|
||||||
|
|||||||
@@ -68,7 +68,6 @@ gateway:
|
|||||||
## SSL Private Key file
|
## SSL Private Key file
|
||||||
sslKeyFile: ''#key.pem
|
sslKeyFile: ''#key.pem
|
||||||
# Proxy rate limit, it's In-Memory IP based
|
# Proxy rate limit, it's In-Memory IP based
|
||||||
# Distributed Rate Limiting for Token based across multiple instances is not yet integrated
|
|
||||||
rateLimiter: 0
|
rateLimiter: 0
|
||||||
accessLog: "/dev/Stdout"
|
accessLog: "/dev/Stdout"
|
||||||
errorLog: "/dev/stderr"
|
errorLog: "/dev/stderr"
|
||||||
|
|||||||
@@ -13,48 +13,7 @@ The Route allows you to match on HTTP traffic and direct it to the backend.
|
|||||||
### Create a route
|
### Create a route
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
##### Define routes
|
# Goma Gateway configurations
|
||||||
routes:
|
|
||||||
# Example of a route | 1
|
|
||||||
- name: Public
|
|
||||||
# host Domain/host based request routing
|
|
||||||
host: "" # Host is optional
|
|
||||||
path: /public
|
|
||||||
## Rewrite a request path
|
|
||||||
# e.g rewrite: /store to /
|
|
||||||
rewrite: /
|
|
||||||
destination: https://example.com
|
|
||||||
#DisableHeaderXForward Disable X-forwarded header.
|
|
||||||
# [X-Forwarded-Host, X-Forwarded-For, Host, Scheme ]
|
|
||||||
# It will not match the backend route, by default, it's disabled
|
|
||||||
disableHeaderXForward: false
|
|
||||||
# Internal health check
|
|
||||||
healthCheck: '' #/internal/health/ready
|
|
||||||
# Route Cors, global cors will be overridden by route
|
|
||||||
cors:
|
|
||||||
# Route Origins Cors, global cors will be overridden by route
|
|
||||||
origins:
|
|
||||||
- https://dev.example.com
|
|
||||||
- http://localhost:3000
|
|
||||||
- https://example.com
|
|
||||||
# Route Cors headers, route will override global cors
|
|
||||||
headers:
|
|
||||||
Access-Control-Allow-Methods: 'GET'
|
|
||||||
Access-Control-Allow-Headers: 'Origin, Authorization, Accept, Content-Type, Access-Control-Allow-Headers, X-Client-Id, X-Session-Id'
|
|
||||||
Access-Control-Allow-Credentials: 'true'
|
|
||||||
Access-Control-Max-Age: 1728000
|
|
||||||
##### Define route middlewares from middlewares names
|
|
||||||
## The name must be unique
|
|
||||||
## List of middleware name
|
|
||||||
middlewares:
|
|
||||||
- api-forbidden-paths
|
|
||||||
- basic-auth
|
|
||||||
```
|
|
||||||
|
|
||||||
### Full example of route
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
# Goma Gateway configurations
|
|
||||||
gateway:
|
gateway:
|
||||||
# Proxy write timeout
|
# Proxy write timeout
|
||||||
writeTimeout: 15
|
writeTimeout: 15
|
||||||
@@ -67,7 +26,6 @@ gateway:
|
|||||||
## SSL Private Key file
|
## SSL Private Key file
|
||||||
sslKeyFile: ''#key.pem
|
sslKeyFile: ''#key.pem
|
||||||
# Proxy rate limit, it's In-Memory IP based
|
# Proxy rate limit, it's In-Memory IP based
|
||||||
# Distributed Rate Limiting for Token based across multiple instances is not yet integrated
|
|
||||||
rateLimiter: 0
|
rateLimiter: 0
|
||||||
accessLog: "/dev/Stdout"
|
accessLog: "/dev/Stdout"
|
||||||
errorLog: "/dev/stderr"
|
errorLog: "/dev/stderr"
|
||||||
@@ -183,7 +141,7 @@ middlewares:
|
|||||||
#Key is authentication request response header Key. Value is the next Request parameter Key.
|
#Key is authentication request response header Key. Value is the next Request parameter Key.
|
||||||
params:
|
params:
|
||||||
userCountryId: countryId
|
userCountryId: countryId
|
||||||
# The server will return 403
|
# The server will return 403
|
||||||
- name: api-forbidden-paths
|
- name: api-forbidden-paths
|
||||||
type: access
|
type: access
|
||||||
## prevents access paths
|
## prevents access paths
|
||||||
|
|||||||
@@ -4,20 +4,24 @@ metadata:
|
|||||||
name: goma-config
|
name: goma-config
|
||||||
data:
|
data:
|
||||||
goma.yml: |
|
goma.yml: |
|
||||||
|
# Goma Gateway configurations
|
||||||
gateway:
|
gateway:
|
||||||
########## Global settings
|
|
||||||
listenAddr: 0.0.0.0:80
|
|
||||||
# Proxy write timeout
|
# Proxy write timeout
|
||||||
writeTimeout: 15
|
writeTimeout: 15
|
||||||
# Proxy read timeout
|
# Proxy read timeout
|
||||||
readTimeout: 15
|
readTimeout: 15
|
||||||
# Proxy idle timeout
|
# Proxy idle timeout
|
||||||
idleTimeout: 60
|
idleTimeout: 60
|
||||||
|
## SSL Certificate file
|
||||||
|
sslCertFile: '' #cert.pem
|
||||||
|
## SSL Private Key file
|
||||||
|
sslKeyFile: ''#key.pem
|
||||||
# Proxy rate limit, it's In-Memory IP based
|
# Proxy rate limit, it's In-Memory IP based
|
||||||
# Distributed Rate Limiting for Token based across multiple instances is not yet integrated
|
|
||||||
rateLimiter: 0
|
rateLimiter: 0
|
||||||
accessLog: "/dev/Stdout"
|
accessLog: "/dev/Stdout"
|
||||||
errorLog: "/dev/stderr"
|
errorLog: "/dev/stderr"
|
||||||
|
## Enable, disable routes health check
|
||||||
|
disableHealthCheckStatus: false
|
||||||
## Returns backend route healthcheck errors
|
## Returns backend route healthcheck errors
|
||||||
disableRouteHealthCheckError: false
|
disableRouteHealthCheckError: false
|
||||||
# Disable display routes on start
|
# Disable display routes on start
|
||||||
@@ -59,23 +63,23 @@ data:
|
|||||||
healthCheck: '' #/internal/health/ready
|
healthCheck: '' #/internal/health/ready
|
||||||
# Route Cors, global cors will be overridden by route
|
# Route Cors, global cors will be overridden by route
|
||||||
cors:
|
cors:
|
||||||
# Route Origins Cors, global cors will be overridden by route
|
# Route Origins Cors, route will override global cors origins
|
||||||
origins:
|
origins:
|
||||||
- https://dev.example.com
|
- https://dev.example.com
|
||||||
- http://localhost:3000
|
- http://localhost:3000
|
||||||
- https://example.com
|
- https://example.com
|
||||||
# Route Cors headers, route will override global cors
|
# Route Cors headers, route will override global cors headers
|
||||||
headers:
|
headers:
|
||||||
Access-Control-Allow-Methods: 'GET'
|
Access-Control-Allow-Methods: 'GET'
|
||||||
Access-Control-Allow-Headers: 'Origin, Authorization, Accept, Content-Type, Access-Control-Allow-Headers, X-Client-Id, X-Session-Id'
|
Access-Control-Allow-Headers: 'Origin, Authorization, Accept, Content-Type, Access-Control-Allow-Headers, X-Client-Id, X-Session-Id'
|
||||||
Access-Control-Allow-Credentials: 'true'
|
Access-Control-Allow-Credentials: 'true'
|
||||||
Access-Control-Max-Age: 1728000
|
Access-Control-Max-Age: 1728000
|
||||||
##### Define route middlewares from middlewares names
|
##### Apply middlewares to the route
|
||||||
## The name must be unique
|
## The name must be unique
|
||||||
## List of middleware name
|
## List of middleware name
|
||||||
middlewares:
|
middlewares:
|
||||||
- api-forbidden-paths
|
- api-forbidden-paths
|
||||||
# Example of a route | 3
|
# Example of a route | 2
|
||||||
- name: Basic auth
|
- name: Basic auth
|
||||||
path: /protected
|
path: /protected
|
||||||
rewrite: /
|
rewrite: /
|
||||||
@@ -116,20 +120,16 @@ data:
|
|||||||
# Required headers, if not present in the request, the proxy will return 403
|
# Required headers, if not present in the request, the proxy will return 403
|
||||||
requiredHeaders:
|
requiredHeaders:
|
||||||
- Authorization
|
- Authorization
|
||||||
#Sets the request variable to the given value after the authorization request completes.
|
# You can also get headers from the authentication request result and inject them into the next request header or params.
|
||||||
#
|
|
||||||
# Add header to the next request from AuthRequest header, depending on your requirements
|
|
||||||
# Key is AuthRequest's response header Key, and value is Request's header Key
|
|
||||||
# In case you want to get headers from the Authentication service and inject them into the next request's headers
|
|
||||||
#Sets the request variable to the given value after the authorization request completes.
|
|
||||||
#
|
|
||||||
# Add header to the next request from AuthRequest header, depending on your requirements
|
|
||||||
# Key is AuthRequest's response header Key, and value is Request's header Key
|
|
||||||
# In case you want to get headers from the authentication service and inject them into the next request headers.
|
# In case you want to get headers from the authentication service and inject them into the next request headers.
|
||||||
|
# Set the request variable to the given value after the authorization request completes.
|
||||||
|
# In case you want to get headers from the authentication service and inject them into the next request headers.
|
||||||
|
# Key is authentication request response header Key. Value is the next Request header Key.
|
||||||
headers:
|
headers:
|
||||||
userId: X-Auth-UserId
|
userId: Auth-UserId
|
||||||
userCountryId: X-Auth-UserCountryId
|
userCountryId: Auth-UserCountryId
|
||||||
# In case you want to get headers from the Authentication service and inject them to the next request params.
|
# In case you want to get headers from the Authentication service and inject them to the next request params.
|
||||||
|
#Key is authentication request response header Key. Value is the next Request parameter Key.
|
||||||
params:
|
params:
|
||||||
userCountryId: countryId
|
userCountryId: countryId
|
||||||
# The server will return 403
|
# The server will return 403
|
||||||
|
|||||||
1
goma.yml
1
goma.yml
@@ -11,7 +11,6 @@ gateway:
|
|||||||
## SSL Private Key file
|
## SSL Private Key file
|
||||||
sslKeyFile: ''#key.pem
|
sslKeyFile: ''#key.pem
|
||||||
# Proxy rate limit, it's In-Memory IP based
|
# Proxy rate limit, it's In-Memory IP based
|
||||||
# Distributed Rate Limiting for Token based across multiple instances is not yet integrated
|
|
||||||
rateLimiter: 0
|
rateLimiter: 0
|
||||||
accessLog: "/dev/Stdout"
|
accessLog: "/dev/Stdout"
|
||||||
errorLog: "/dev/stderr"
|
errorLog: "/dev/stderr"
|
||||||
|
|||||||
Reference in New Issue
Block a user