Skip to content
libdnsPublic

About

servercow DNS libdns implementation

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

20 Commits

Folders and files

Repository files navigation

libdns/servercow

Go Reference

This package implements the libdns interfaces for Servercow, allowing DNS records to be managed via the Servercow DNS API.

Authentication

The Servercow DNS API uses username/password authentication passed in request headers. See Servercow docs for more info.

Usage

import "github.com/libdns/servercow"

provider := servercow.Provider{
    Username: "your-username",
    Password: "your-password",
}

Supported record types

A, AAAA, CNAME, TXT, MX, CAA, TLSA, SRV, SSHFP, SMIMEA, HTTPS, SVCB

Notes

  • AppendRecords for multi-value types (TXT, CAA, TLSA, HTTPS, SVCB) performs a read-modify-write to preserve existing values. For single-value types, it behaves like SetRecords because the Servercow API stores only one value set per (name, type) pair.
  • All other types, including SRV, SSHFP and SMIMEA, are single-value: the Servercow API stores only one content value per (name, type) pair. SetRecords and AppendRecords both return an error when more than one value is supplied for such a pair instead of letting the API reject the request.
  • The Servercow API currently restricts the owner names and content it accepts for some types: owner names containing _ are rejected for SRV, SSHFP, SMIMEA and CAA, and SRV content is only accepted with the target . (a real target name is rejected). Conventional SRV records such as _sip._tcp therefore cannot currently be created through the API.
  • Zone listing is not supported (no API endpoint).

About

servercow DNS libdns implementation

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages