No description
Find a file
2023-07-28 11:40:55 -05:00
contrib Updates and things 2023-07-28 11:40:02 -05:00
lib/App Updates and things 2023-07-28 11:40:02 -05:00
script More renaming 2015-06-08 13:35:18 -05:00
t More renaming 2015-06-08 13:19:30 -05:00
app_dynip.conf Be able to run a script when an IP changes 2021-06-06 20:31:42 -05:00
app_dynip.psgi More renaming 2015-06-08 13:19:30 -05:00
Changes initial checkin 2015-05-25 14:31:53 -05:00
Makefile.PL Updates and things 2023-07-28 11:40:02 -05:00
README Updated README 2015-06-08 13:35:39 -05:00

App::DynIP - A simple Catalyst application to dynamically update a BIND
             server using nsupdate for clients with dynamically allocated IPs.

You will need to have your name server configured to allow updates via
the 'nsupdate' command.  See tutorials online for this.

Clients connect to the /client/update endpoint of this app to request an update.
See contrib/client for an example script

A client must authenticate itself by setting the X-Auth-Token header.
This token is used to determine if a client is allowed to update the server
and what record the client updates.

It is highly recommended you use SSL with this service, otherwise these tokens
will be in the clear!


There is also an /admin service for admin access.  Again, the X-Auth-Toekn
header must be set correctly to gain access to the /admin service.

There are the following endpoints under /admin:
  /admin/update
  /admin/delete

  /admin/update takes two parameters, a hostname and an IP for that hostname
  ex: /admin/update/darkstar/10.0.0.1

  /admin/delete takes one parameter, a hostname to delete:
  ex: /admin/delete/darkstar

Run script/dynip_server.pl to test the application.

Configuration for the application is done in the dynip.conf file in the root
of this distribution.  See that file for further details.