# The gateway-route relation The `gateway-route` interface is implemented by the `charms.gateway_api_integrator.v1.gateway_route` library. It is a bidirectional application databag exchange: | Direction | Fields | Description | |---------------------|------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------| | Requirer → Provider | `hostname`, `additional_hostnames` | The FQDN(s) the workload should be reachable on. Used by the provider to request TLS certificates and DNS records. | | Provider → Requirer | `gateway_name`, `gateway_model`, `https_mode`, `gateway_address` | The identity of the `Gateway` resource so the requirer can build `HTTPRoute` `parentRefs`. | The `https_mode` field tells the requirer how TLS is handled. The field has three available modes: | Mode | Meaning | |------------|----------------------------------------------------------------| | `disabled` | No TLS configured; only HTTP listeners exist on the `Gateway`. | | `enabled` | TLS configured; both HTTP and HTTPS listeners exist. | | `enforced` | TLS configured and HTTP is redirected to HTTPS. |