Class HttpListenerBuilder

Restriction placed on the origin of incoming connections to the edge to only allow these CIDR ranges. Call multiple times to add additional CIDR ranges. See IP restrictions in the ngrok docs for additional details.

A set of regular expressions used to match User-Agents that will be allowed. On request, the User Agent Filter module will check the incoming User-Agent header value against the list of defined allow and deny regular expression rules. See [User Agent Filter] in the ngrok docs for additional details.

.. [User Agent Filter]: https://ngrok.com/docs/cloud-edge/modules/user-agent-filter/

The L7 application protocol to use for this edge, e.g. "http2" or "http1".

Credentials for basic authentication. If not called, basic authentication is disabled.

Reject requests when 5XX responses exceed this ratio. Disabled when 0. See Circuit Breaker in the ngrok docs for additional details.

Enable gzip compression for HTTP responses. See Compression in the ngrok docs for additional details.

Restriction placed on the origin of incoming connections to the edge to deny these CIDR ranges. Call multiple times to add additional CIDR ranges. See IP restrictions in the ngrok docs for additional details.

A set of regular expressions used to match User-Agents that will be denied. On request, the User Agent Filter module will check the incoming User-Agent header value against the list of defined allow and deny regular expression rules. See [User Agent Filter] in the ngrok docs for additional details.

.. [User Agent Filter]: https://ngrok.com/docs/cloud-edge/modules/user-agent-filter/

The domain to request for this edge, any valid domain or hostname that you have previously registered with ngrok. If using a custom domain, this requires registering in the ngrok dashboard and setting a DNS CNAME value.

Listener backend metadata. Viewable via the dashboard and API, but has no bearing on listener behavior.

To automatically forward connections, you can use listenAndForward, or listenAndServe on the Listener Builder. These methods will also set this forwardsTo value.

Begin listening for new connections on this listener.

Begin listening for new connections on this listener and forwarding them to the given url. This method will also set the forwardsTo value.

Begin listening for new connections on this listener and forwarding them to the given server. This method will also set the forwardsTo value.

Listener-specific opaque metadata. Viewable via the API.

Certificates to use for client authentication at the ngrok edge. See Mutual TLS in the ngrok docs for additional details.

OAuth configuration. If not called, OAuth is disabled. See OAuth in the ngrok docs for additional details.

OIDC configuration. If not called, OIDC is disabled. See OpenID Connect in the ngrok docs for additional details.

Enable endpoint pooling for this listener.

The version of PROXY protocol to use with this listener "1", "2", or "" if not using.

Removes a header from requests to this edge. See Request Headers in the ngrok docs for additional details.

Removes a header from responses from this edge. See Response Headers in the ngrok docs for additional details.

Adds a header to all requests to this edge. See Request Headers in the ngrok docs for additional details.

Adds a header to all responses coming from this edge. See Response Headers in the ngrok docs for additional details.

The scheme that this edge should use. "HTTPS" or "HTTP", defaults to "HTTPS".

Whether to disable certificate verification for this listener.

WebhookVerification configuration. If not called, WebhookVerification is disabled. See Webhook Verification in the ngrok docs for additional details.

Convert incoming websocket connections to TCP-like streams.