new provider: Add Gidinet DNS provider and registrar #4004

zupolgec · 2026-01-24T22:59:24Z

Summary

Hey! This adds support for Gidinet, an Italian domain registrar. I needed it for managing my domains so figured I'd contribute it back.

It works as both DNS provider and registrar:

DNS side handles the usual records (A, AAAA, CNAME, MX, NS, TXT, SRV)
Registrar side manages nameserver delegation

The API is SOAP-based which was fun to work with... Their docs are a bit sparse but I got it working after some trial and error.

Notes

Apex NS records can't be managed via DNS API (they're read-only), so I filter them out with a warning. Nameserver changes go through the registrar instead.
TTL values get rounded to what the API accepts
No CAA support unless you have their premium service

Tested with my own domains and it's been working fine. Happy to address any feedback!

Please create the GitHub label "provider-gidinet"

Add support for Gidinet (Italian domain registrar) as both DNS provider and registrar. Features: - DNS Provider: Full CRUD operations for A, AAAA, CNAME, MX, NS, TXT, SRV records - Registrar: Nameserver delegation management at registry level - Zone listing via get-zones command - Dual host support for migration scenarios Technical details: - Uses SOAP API at api.quickservicebox.com - Record-based updates (diff2.ByRecord) - Apex NS records filtered (managed by registrar only) - TTL values automatically rounded to API-supported values Documentation and CI/CD configuration included.

tlimoncelli

Looks good so far! Just cosmetic changes. Thanks for contributing this!

tlimoncelli · 2026-01-25T12:51:04Z

providers/gidinet/gidinetProvider.go

+	// The default for unlisted capabilities is 'Cannot'.
+	// See providers/capabilities.go for the entire list of capabilities.
+	providers.CanAutoDNSSEC:          providers.Cannot(),
+	providers.CanConcur:              providers.Cannot(), // SOAP API, safer to serialize


All new providers must have providers.CanConcur: providers.Can(). The Cannot() setting is for legacy providers.

I don't see anything in the code that indicates Cannot() is justified. This setting means that the code in providers/gidinet/ can be used in a goroutine. This usually means that any caches in gidinetProvider{} are protected by mutexes. Since there aren't any caches, this should run fine.

Suggested change

providers.CanConcur: providers.Cannot(), // SOAP API, safer to serialize

providers.CanConcur: providers.Can(),

tlimoncelli · 2026-01-25T12:51:29Z

providers/gidinet/gidinetProvider.go

+	providers.CanConcur:              providers.Cannot(), // SOAP API, safer to serialize
+	providers.CanGetZones:            providers.Can(),
+	providers.CanUseAlias:            providers.Cannot(),
+	providers.CanUseCAA:              providers.Cannot(), // Only premium service


Suggested change

providers.CanUseCAA: providers.Cannot(), // Only premium service

providers.CanUseCAA: providers.Cannot("Only premium service"),

tlimoncelli · 2026-01-25T12:51:54Z

providers/gidinet/gidinetProvider.go

+	providers.CanUseSSHFP:            providers.Cannot(),
+	providers.CanUseSVCB:             providers.Cannot(),
+	providers.CanUseTLSA:             providers.Cannot(),
+	providers.DocCreateDomains:       providers.Cannot(), // Must be created via web UI


Suggested change

providers.DocCreateDomains: providers.Cannot(), // Must be created via web UI

providers.DocCreateDomains: providers.Cannot("Must be created via web UI"),

tlimoncelli · 2026-01-25T13:02:45Z

providers/gidinet/api.go

+	soapEnvelope := fmt.Sprintf(`<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+  <soap:Body>
+%s
+  </soap:Body>
+</soap:Envelope>`, string(bodyXML))


Concatenation is faster in this situation:

Suggested change

soapEnvelope := fmt.Sprintf(`<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

%s

</soap:Body>

</soap:Envelope>`, string(bodyXML))

soapEnvelope := (`<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

' + string(bodyXML) + '

</soap:Body>

</soap:Envelope>`)

I did a small benchmark:

$ go test -bench=. goos: darwin goarch: arm64 pkg: github.com/StackExchange/dnscontrol/v4/bench cpu: Apple M3 Max BenchmarkSprintf-16 4205144 267.2 ns/op BenchmarkStringConcatenation-16 12940010 92.44 ns/op BenchmarkStringsBuilder-16 6614196 179.9 ns/op PASS ok github.com/StackExchange/dnscontrol/v4/bench 4.432s

tlimoncelli · 2026-01-25T13:07:21Z

providers/gidinet/types.go

+)
+
+// AllowedTTLValues lists the TTL values supported by the Gidinet API
+var AllowedTTLValues = []uint32{


Unexport AllowedTTLValues (i.e. rename it allowedTTLValues)

tlimoncelli · 2026-01-25T13:13:23Z

providers/gidinet/api.go

+}
+
+// parseSOAPResponse extracts the response from a SOAP envelope
+func parseSOAPResponse(data []byte, response interface{}) error {


Suggested change

func parseSOAPResponse(data []byte, response interface{}) error {

func parseSOAPResponse(data []byte, response any) error {

tlimoncelli · 2026-01-25T13:13:46Z

providers/gidinet/types.go

+// SOAPBody represents the SOAP body
+type SOAPBody struct {
+	XMLName  xml.Name `xml:"http://schemas.xmlsoap.org/soap/envelope/ Body"`
+	Content  interface{}


Suggested change

Content interface{}

Content any

tlimoncelli · 2026-01-25T13:17:59Z

providers/gidinet/api.go

+	if strings.HasSuffix(hostname, ".") {
+		return strings.TrimSuffix(hostname, ".")
+	}


Suggested change

if strings.HasSuffix(hostname, ".") {

return strings.TrimSuffix(hostname, ".")

}

if before, ok := strings.CutSuffix(hostname, "."); ok {

return before

}

tlimoncelli · 2026-01-25T13:20:08Z

providers/gidinet/api.go

+	suffix := "." + domain
+	if strings.HasSuffix(fqdn, suffix) {
+		return strings.TrimSuffix(fqdn, suffix)
+	}


Suggested change

suffix := "." + domain

if strings.HasSuffix(fqdn, suffix) {

return strings.TrimSuffix(fqdn, suffix)

}

if before, ok := strings.CutSuffix(fqdn, "." + domain); ok {

return before

}

tlimoncelli · 2026-01-25T13:23:25Z

providers/gidinet/auditrecords.go

+	a.Add("MX", rejectif.MxNull) // MX priority 0 is allowed (means highest priority)
+
+	a.Add("TXT", rejectif.TxtHasDoubleQuotes) // Gidinet doesn't support quotes in TXT
+	a.Add("TXT", rejectif.TxtIsEmpty)         // Empty TXT records not allowed
+	a.Add("TXT", rejectif.TxtHasBackticks)    // Backticks not supported
+
+	a.Add("SRV", rejectif.SrvHasNullTarget) // SRV must have a target


Please include "last verified" dates for all these comments.

Suggested change

a.Add("MX", rejectif.MxNull) // MX priority 0 is allowed (means highest priority)

a.Add("TXT", rejectif.TxtHasDoubleQuotes) // Gidinet doesn't support quotes in TXT

a.Add("TXT", rejectif.TxtIsEmpty) // Empty TXT records not allowed

a.Add("TXT", rejectif.TxtHasBackticks) // Backticks not supported

a.Add("SRV", rejectif.SrvHasNullTarget) // SRV must have a target

a.Add("MX", rejectif.MxNull) // Last verified 2026-01-24

a.Add("TXT", rejectif.TxtHasDoubleQuotes) // Last verified 2026-01-24

a.Add("TXT", rejectif.TxtIsEmpty) // Last verified 2026-01-24

a.Add("TXT", rejectif.TxtHasBackticks) // Last verified 2026-01-24

a.Add("SRV", rejectif.SrvHasNullTarget) // Last verified 2026-01-24

tlimoncelli · 2026-01-25T13:27:12Z

Let me introduce you to @fm, our "liaison to maintainers". He'll reach out to you with our "welcome kit".

tlimoncelli · 2026-01-25T14:29:29Z

providers/gidinet/api.go

+	}
+
+	// Find the smallest allowed value that is >= ttl
+	for _, v := range AllowedTTLValues {


(low priority) Consider using https://pkg.go.dev/slices#example-BinarySearch instead of a loop.

…pes, fix SRV/TXT audits

zupolgec · 2026-01-25T18:09:47Z

Thank you @tlimoncelli 💪 Great review. I've addressed all your suggestions.

I'm going to reach out to the Gidinet owner to see if we can get a fix for long TXT records (more than 254 chars), SRV records and a test account with a test domain (that I can pay) to have a proper integration flow that can be tested automatically.

The GIDINET API rejects single TXT strings >250 chars but accepts multiple quoted segments like: "chunk1" "chunk2" - Add chunkTXT() to split long values into 250-char quoted chunks - Add unchunkTXT() to parse chunked format back to single string - Update toGidinetRecord to chunk TXT on create/update - Update toRecordConfig to unchunk TXT when reading - Remove TxtLongerThan(254) audit since long TXT now works - Add comprehensive unit tests for chunking functions

zupolgec · 2026-01-25T18:19:53Z

I found a way to support long TXT records (like DKIM keys >250 chars)!

The GIDINET API rejects single TXT strings longer than ~250 characters, but it accepts multiple quoted segments in the format: "chunk1" "chunk2"

I've added automatic chunking:

chunkTXT() splits long values into ≤250-char quoted chunks when creating/updating records
unchunkTXT() parses the chunked format back to a single string when reading records

This enables full DKIM support. Tested end-to-end with a 400+ char DKIM record - works perfectly with no drift on re-preview.

Unit tests included for the chunking functions.

tlimoncelli reviewed Jan 25, 2026

View reviewed changes

Address PR review: use any, optimize TTL lookup, unexport internal ty…

a44b445

…pes, fix SRV/TXT audits

	providers.CanConcur: providers.Cannot(), // SOAP API, safer to serialize
	providers.CanConcur: providers.Can(),

	providers.CanUseCAA: providers.Cannot(), // Only premium service
	providers.CanUseCAA: providers.Cannot("Only premium service"),

	providers.DocCreateDomains: providers.Cannot(), // Must be created via web UI
	providers.DocCreateDomains: providers.Cannot("Must be created via web UI"),

	func parseSOAPResponse(data []byte, response interface{}) error {
	func parseSOAPResponse(data []byte, response any) error {

new provider: Add Gidinet DNS provider and registrar #4004

Are you sure you want to change the base?

new provider: Add Gidinet DNS provider and registrar #4004

Conversation

zupolgec commented Jan 24, 2026

Summary

Notes

Uh oh!

tlimoncelli left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tlimoncelli commented Jan 25, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

zupolgec commented Jan 25, 2026

Uh oh!

zupolgec commented Jan 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants