Maybe you were looking for the Enterprise Documentation instead?
Careful! You are browsing documentation for an outdated version of Kong. Go here to browse the documentation for the latest version.

Table of Contents

kong.ip

Trusted IPs module

This module can be used to determine whether or not a given IP address is in the range of trusted IP addresses defined by the trusted_ips configuration property.

Trusted IP addresses are those that are known to send correct replacement addresses for clients (as per the chosen header field, e.g. X-Forwarded-*).

See docs.konghq.com/latest/configuration/#trusted_ips

kong.ip.is_trusted(address)

Depending on the trusted_ips configuration property, this function will return whether a given ip is trusted or not Both ipv4 and ipv6 are supported.

Phases

  • init_worker, certificate, rewrite, access, header_filter, body_filter, log

Parameters

  • address (string): A string representing an IP address

Returns

  • boolean true if the IP is trusted, false otherwise

Usage

if kong.ip.is_trusted("1.1.1.1") then
  kong.log("The IP is trusted")
end

Back to TOC