Skip to content

Script that allows OpenVPN to update DNS servers via RFC2136

License

Notifications You must be signed in to change notification settings

noahajac/openvpn-learn-address

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

OpenVPN Learn Address Script

Script that allows OpenVPN to update DNS servers via RFC2136.

The script requires the following to be configured:

  • server: The hostname of the DNS server.
  • keyName: The name of the HMAC-MD5 TSIG key.
  • key: The HMAC-MD5 TSIG key.
  • forwardZone: The zone to update.
  • ttl: The TTL to set for records. Defaults to 60.

The script will add forward and reverse DNS records for clients when they connect to OpenVPN. It will remove these records when the client disconnects. The FQDN is based off of the common name and configured forward zone. So if you have forwardZone set to example.local and the client's common name is device1, the record would be for device1.example.local. Both IPv4 and IPv6 is supported.

The script is stateless and expects that the records made by it are not modified. The only file operations performed are temporary files for nslookup.

The script should be added to OpenVPN's learn-address property, as described here.

This program was made for use with pfSense. Modification may be required for other platforms.

OpenVPN is a licensed under the GPLv2 license.
pfSense is licensed under the Apache License v2.0.

About

Script that allows OpenVPN to update DNS servers via RFC2136

Topics

Resources

License

Stars

Watchers

Forks

Languages