4 releases
0.1.0 | Apr 27, 2019 |
---|---|
0.0.3 | Jun 13, 2018 |
0.0.2 | May 18, 2018 |
0.0.1 | May 17, 2018 |
#18 in #records
18KB
274 lines
inwx
This is an unofficial Rust binding for the inwx domrobot API. Currently it only has the following features:
- Login and retrieve account information (
account.login
via methodinwx.account.login
) - Logout (
account.logout
via methodinwx.account.logout
) - Retrieve information and all records for a specific domain (
nameserver.info
via methodinwx.nameserver.info
) - Update records (
nameserver.updateRecord
via methodinwx.nameserver.update_record
)
If you need a certain function implemented, just ask in an issue and I will probably add it.
Usage
Add the following to your Cargo.toml
:
[dependencies]
inwx = "0.1.0"
See the example simple_query
for information about connecting to the domrobot API and retrieving all records for a given domain. See the dyndns
example for some more complex operations.
Examples
Currently there are two examples: simple_query
retrieves all records for a specific domain and lists them. dyndns
is more interesting, it loads a configuration file which contains inwx credentials, then retrieves the current IP address of the network gateway via igd and then updates a specified DNS record to point to that address.
Using the client for dynamic DNS
The dyndns
example is a fully-featured dyndns client which retrieves your current routers public IP address and updates a record on your inwx-hosted domain. To use it, you first have to write a little configuration file:
[inwx]
user = "foo"
pass = "bar"
domain = "foo.bar"
record = "home.foo.bar"
[gateway]
search_iface = "192.168.1.1"
Set search_iface
to the IP address of your network interface. The program will search a router on this interface using the Internet Gateway Protocol, retrieve it's public IP address and then update the specified record of the specified domain to that IP address (it will only update A
records).
To run it, save your configuration as foobar.toml
and then invoke:
cargo run --example=dyndns --release -- foobar.toml
License
This project is licensed under the GNU AGPL version 3 or later, see the LICENSE
file for more information.
Dependencies
~21MB
~453K SLoC