Features | Pricing | Documentation | Contact | Blog

Listeners

Listeners are the entry points to your UDP Gateway system. Think of a Listener as a virtual UDP server that receives packets from clients on the internet and forwards them to your AWS resources for processing. Each Listener provides you with a domain name and port number that your clients can connect to.

How Listeners Work

When you create a Listener, Proxylity automatically assigns it:

Once created, your Listener is immediately ready to receive UDP traffic from anywhere on the internet. Packets sent to your Listener's domain and port are automatically forwarded to the Destinations you've configured.

Listeners and Destinations

Listeners are typically connected to one or more Destinations, which define where incoming packets should be delivered in your AWS account. While a Listener without destinations won't process packets, you might keep such Listeners to preserve their assigned port numbers or for staging purposes. Destinations can be AWS services like:

You can add multiple Destinations to a single Listener, and you can change which Destinations are connected at any time without affecting your clients.

Client Restrictions

For security, each Listener includes Client Restrictions that control which IP addresses or networks are allowed to send packets to your Listener. This helps protect your AWS resources from unwanted traffic and potential abuse.

Client Restrictions can be configured to:

Managing Listeners

Listeners can be created and managed in two ways:

Infrastructure as Code (Recommended)

The preferred way to manage Listeners is through AWS CloudFormation using Proxylity's custom resource types. This approach provides:

To get started with CloudFormation, see our Getting Started guide and explore the working examples in our examples repository.

Dashboard

For quick testing, prototyping, or one-off configurations, you can also manage Listeners through the Proxylity Dashboard. From the web interface you can:

Important Considerations

When working with Listeners, keep these points in mind: