:_mod-docs-content-type: ASSEMBLY
[id="controlling-incoming-traffic-gateway-listeners"]
= Control incoming traffic with gateway listeners
include::_attributes/common-attributes.adoc[]
:context: controlling-incoming-traffic-gateway-listeners

toc::[]

[role="_abstract"]
To control network traffic flow, you can configure Gateway API listeners to define the designated port, protocol, and hostname for your gateway. By configuring listeners, you can specify secure TLS connections, dictate how traffic is terminated, and restrict which application routes are permitted to attach to the gateway.

To successfully manage your incoming traffic with gateway listeners, complete the following tasks:

* Configure listener routing and security settings to define the ports, protocols, hostnames, and TLS certificates for your incoming traffic.
* Understand listener routing conflicts by applying conflict management rules to ensure overlapping hostnames or ports are routed correctly.
* Troubleshoot listener connections by monitoring listener status conditions to identify and resolve configuration errors.

include::modules/configuring-listener-routing-security.adoc[leveloffset=+1]

include::modules/gateway-listener-configuration-reference.adoc[leveloffset=+2]

include::modules/resolving-listener-routing-conflicts.adoc[leveloffset=+1]

include::modules/troubleshooting-listener-conditions.adoc[leveloffset=+1]

include::modules/gateway-listener-troubleshooting-reference.adoc[leveloffset=+2]

[role="_additional-resources"]
[id="additional-resources_{context}"]
== Additional resources

* link:https://gateway-api.sigs.k8s.io/concepts/api-overview/#distinctiveness[Gateway API documentation: Protocol-specific distinctiveness rules]
* link:https://gateway-api.sigs.k8s.io/concepts/hostnames/[Gateway API documentation: Hostnames]