nrdcg / goinwx

INWX Go API client

INWX Go API client

This go library implements some parts of the official INWX XML-RPC API.

API

package main

import (
	"log"

	"github.com/nrdcg/goinwx"
)

func main() {
	client := goinwx.NewClient("username", "password", &goinwx.ClientOptions{Sandbox: true})

	_, err := client.Account.Login()
	if err != nil {
		log.Fatal(err)
	}

	defer func() {
		if err := client.Account.Logout(); err != nil {
			log.Printf("inwx: failed to logout: %v", err)
		}
	}()

	var request = &goinwx.NameserverRecordRequest{
		Domain:  "domain.com",
		Name:    "foo.domain.com.",
		Type:    "TXT",
		Content: "aaa",
		TTL:     300,
	}

	_, err = client.Nameservers.CreateRecord(request)
	if err != nil {
		log.Fatal(err)
	}
}

Using 2FA

If it is desired to use 2FA without manual entering the TOTP every time, you must set the parameter otp-key to the secret that is shown during the setup of 2FA for you INWX account. Otherwise, you can skip totp.GenerateCode step and enter the verification code of the Google Authenticator app every time manually.

The otp-key looks something like EELTWFL55ESIHPTJAAHBCY7LXBZARUOJ.

package main

import (
	"log"
	"time"

	"github.com/nrdcg/goinwx"
	"github.com/pquerna/otp/totp"
)

func main() {
	client := goinwx.NewClient("username", "password", &goinwx.ClientOptions{Sandbox: true})

	resp, err := client.Account.Login()
	if err != nil {
		log.Fatal(err)
	}

	if resp.TFA != "GOOGLE-AUTH" {
		log.Fatal("unsupported 2 Factor Authentication")
	}

	tan, err := totp.GenerateCode("otp-key", time.Now())
	if err != nil {
		log.Fatal(err)
	}

	err = client.Account.Unlock(tan)
	if err != nil {
		log.Fatal(err)
	}

	defer func() {
		if err := client.Account.Logout(); err != nil {
			log.Printf("inwx: failed to logout: %v", err)
		}
	}()

	request := &goinwx.NameserverRecordRequest{
		Domain:  "domain.com",
		Name:    "foo.domain.com.",
		Type:    "TXT",
		Content: "aaa",
		TTL:     300,
	}

	_, err = client.Nameservers.CreateRecord(request)
	if err != nil {
		log.Fatal(err)
	}
}

Supported Features

Full API documentation can be found here.

The following parts are implemented:

• Account
  • Login
  • Logout
  • Lock
  • Unlock (with mobile TAN)
• Domains
  • Check
  • Register
  • Delete
  • Info
  • GetPrices
  • List
  • Whois
  • Update
• Nameservers
  • Check
  • Create
  • Info
  • List
  • CreateRecord
  • UpdateRecord
  • DeleteRecord
  • FindRecordById
• Contacts
  • List
  • Info
  • Create
  • Update
  • Delete

Contributions

Your contributions are very appreciated.

goinwx's Issues

transferLock type problem

I'm using goinwx through the dnscontrol INWX, and I've been getting an error when trying to manage my domains

'transferLock' expected type 'int', got unconvertible type 'bool', value: 'true'`

Based on the (current) documentation, the API data type is actually a boolean.
https://www.inwx.com/en/help/apidoc/f/ch02s09.html#domain.info

Cannot get Two-Factor-Authentication working

Originally I wanted to use containous/traefik with Let's Encrypt and the DNS challenge provided by go-acme/lego which in turn uses this project.

My problem is that go-acme/lego does not seem to support a shared secret for TFA, so I tried (with my very very rusty go knowledge) to see whether I can get it running in principle.
From the docs and the example (and how a corresponding python version works) it should look something like this:

import "github.com/pquerna/otp/totp"

func main() {
    client := goinwx.NewClient("user", "pass", &goinwx.ClientOptions{Sandbox: true})
    client.Account.Login()
    str, _ := totp.GenerateCode("SHARED_SECRET", time.Now())
    client.Account.Unlock(str)
    // ...
}

Sadly already the Account.Login returns (2200) Authentication error and trying to ignore it and running Account.Unlock it returns (2002) Command use error.

I don't really understand what is the problem and sadly my go knowledge is to old and rusty that I can see through the code.

I'd be super glad if you could provide some help!