InspIRCd v2 is coming to the end of its lifetime!
Fixes for security vulnerabilities will be provided until 2021-01-01 but after this date v2 will no longer be maintained.
InspIRCd v3 contains many new features including full support for all currently ratified IRCv3 extensions and WebSocket connections.
The "cgiirc" Module
This module adds the ability for IRC gateways to forward the real IP address of users connecting through them.
To load this module use the following
<cgiirc> tag defines settings about how the cgiirc module should behave. This tag can only be defined once.
|opernotice||Boolean||Yes||Whether to send a notice to snomask
<cgihost> tag defines a specific IRC gateway. This tag can be defined as many times as required.
|mask||Text||None||Required! The IP address or hostname of the gateway.|
|type||Text||None||Required! The type of authentication that the gateway uses.|
|password||Text||None||Required for the webirc type! The password that the WebIRC gateway will authenticate with.|
The type field should be set to one of the following values:
|ident||The IP address of the user will be sent in the username (ident) field in hexadecimal (IPv4 only).|
|pass||Deprecated! The IP address of the user will be sent with the
|identfirst||Deprecated! The ident method will be tried and if that does not work the pass method will be tried.|
|passfirst||Deprecated! The pass method will be tried and if that does not work the ident method will be tried.|
|webirc||The IP address of the user will be sent using the
Tells the cgiirc module that the "irc.example.com" gateway will encode the IPv4 address of users into their username (ident).
<cgihost type="ident" mask="irc.example.com">
Tells the cgiirc module that gateways in the "192.2/24" CIDR range will send the IPv4 address of users with the
<cgihost type="pass" mask="192.2/24">
Tells the cgiirc module that gateways with an IP matching "198.51.100.*" will send the IP address of users with the
<cgihost type="webirc" mask="198.51.100.*" password="secret">
||Allows gateways to specify the hostname and IP address of users.|
More information about the
/WEBIRC command is available on the IRCv3 website.
/WEBIRC command should generally not be executed by users. It is intended to be an entirely internal feature which is executed automatically by gateways.