2023-12-24 10:18:08 +00:00
|
|
|
// This file is part of the happyDomain (R) project.
|
|
|
|
// Copyright (c) 2020-2024 happyDomain
|
|
|
|
// Authors: Pierre-Olivier Mercier, et al.
|
2021-07-05 15:11:17 +00:00
|
|
|
//
|
2023-12-24 10:18:08 +00:00
|
|
|
// This program is offered under a commercial and under the AGPL license.
|
|
|
|
// For commercial licensing, contact us at <contact@happydomain.org>.
|
2021-07-05 15:11:17 +00:00
|
|
|
//
|
2023-12-24 10:18:08 +00:00
|
|
|
// For AGPL licensing:
|
|
|
|
// This program is free software: you can redistribute it and/or modify
|
|
|
|
// it under the terms of the GNU Affero General Public License as published by
|
|
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
|
|
// (at your option) any later version.
|
2021-07-05 15:11:17 +00:00
|
|
|
//
|
2023-12-24 10:18:08 +00:00
|
|
|
// This program is distributed in the hope that it will be useful,
|
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
// GNU Affero General Public License for more details.
|
2021-07-05 15:11:17 +00:00
|
|
|
//
|
2023-12-24 10:18:08 +00:00
|
|
|
// You should have received a copy of the GNU Affero General Public License
|
|
|
|
// along with this program. If not, see <https://www.gnu.org/licenses/>.
|
2021-07-05 15:11:17 +00:00
|
|
|
|
2023-09-07 10:04:55 +00:00
|
|
|
package providers // import "git.happydns.org/happyDomain/providers"
|
2021-07-05 15:11:17 +00:00
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"log"
|
|
|
|
"reflect"
|
2023-01-18 17:16:31 +00:00
|
|
|
"strings"
|
2021-07-05 15:11:17 +00:00
|
|
|
|
2023-05-20 10:24:37 +00:00
|
|
|
"github.com/StackExchange/dnscontrol/v4/providers"
|
2021-07-05 20:24:36 +00:00
|
|
|
"github.com/miekg/dns"
|
2021-05-21 23:06:23 +00:00
|
|
|
|
2023-09-07 09:37:18 +00:00
|
|
|
"git.happydns.org/happyDomain/model"
|
2021-07-05 15:11:17 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
// ProviderInfos describes the purpose of a user usable provider.
|
|
|
|
type ProviderInfos struct {
|
|
|
|
// Name is the name displayed.
|
|
|
|
Name string `json:"name"`
|
|
|
|
|
|
|
|
// Description is a brief description of what the provider is.
|
|
|
|
Description string `json:"description"`
|
|
|
|
|
|
|
|
// Capabilites is a list of special ability of the provider (automatically filled).
|
|
|
|
Capabilities []string `json:"capabilities,omitempty"`
|
2023-01-18 17:16:31 +00:00
|
|
|
|
|
|
|
// HelpLink is the link to the documentation of the provider configuration.
|
|
|
|
HelpLink string `json:"helplink,omitempty"`
|
2021-07-05 15:11:17 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// ProviderCreator abstract the instanciation of a Provider
|
|
|
|
type ProviderCreator func() happydns.Provider
|
|
|
|
|
|
|
|
// Provider aggregates way of create a Provider and information about it.
|
|
|
|
type Provider struct {
|
|
|
|
Creator ProviderCreator
|
|
|
|
Infos ProviderInfos
|
|
|
|
}
|
|
|
|
|
|
|
|
// providers stores all existing Provider in happyDNS.
|
|
|
|
var providersList map[string]Provider = map[string]Provider{}
|
|
|
|
|
|
|
|
// RegisterProvider declares the existence of the given Provider.
|
|
|
|
func RegisterProvider(creator ProviderCreator, infos ProviderInfos) {
|
2023-01-18 17:16:31 +00:00
|
|
|
prvInstance := creator()
|
|
|
|
baseType := reflect.Indirect(reflect.ValueOf(prvInstance)).Type()
|
2021-05-20 06:07:05 +00:00
|
|
|
name := baseType.Name()
|
2021-07-05 15:11:17 +00:00
|
|
|
log.Println("Registering new provider:", name)
|
|
|
|
|
2023-01-18 17:16:31 +00:00
|
|
|
infos.Capabilities = GetProviderCapabilities(prvInstance)
|
2023-01-20 14:07:13 +00:00
|
|
|
infos.HelpLink = "https://docs.dnscontrol.org/service-providers/providers/" + strings.ToLower(prvInstance.DNSControlName())
|
2021-05-21 23:06:23 +00:00
|
|
|
|
2021-07-05 15:11:17 +00:00
|
|
|
providersList[name] = Provider{
|
|
|
|
creator,
|
|
|
|
infos,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetProviders retrieves the list of all existing Providers.
|
|
|
|
func GetProviders() *map[string]Provider {
|
|
|
|
return &providersList
|
|
|
|
}
|
|
|
|
|
|
|
|
// FindProvider returns the Provider corresponding to the given name, or an error if it doesn't exist.
|
|
|
|
func FindProvider(name string) (happydns.Provider, error) {
|
|
|
|
src, ok := providersList[name]
|
|
|
|
if !ok {
|
|
|
|
return nil, fmt.Errorf("Unable to find corresponding provider for `%s`.", name)
|
|
|
|
}
|
|
|
|
|
|
|
|
return src.Creator(), nil
|
|
|
|
}
|
2021-05-21 23:06:23 +00:00
|
|
|
|
|
|
|
// GetProviderCapabilities lists available capabilities for the given Provider.
|
|
|
|
func GetProviderCapabilities(prvd happydns.Provider) (caps []string) {
|
2021-07-05 20:24:36 +00:00
|
|
|
// Features
|
2021-05-21 23:06:23 +00:00
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanGetZones) {
|
|
|
|
caps = append(caps, "ListDomains")
|
|
|
|
}
|
|
|
|
|
2021-07-05 20:24:36 +00:00
|
|
|
// Compatible RR
|
2022-07-26 13:27:43 +00:00
|
|
|
for _, v := range []uint16{dns.TypeA, dns.TypeAAAA, dns.TypeCNAME, dns.TypeMX, dns.TypeNS, dns.TypeTXT} {
|
2021-07-05 20:24:36 +00:00
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", v, dns.TypeToString[v]))
|
|
|
|
}
|
2022-07-26 13:27:43 +00:00
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseSOA) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeSOA, dns.TypeToString[dns.TypeSOA]))
|
|
|
|
}
|
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseCAA) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeCAA, dns.TypeToString[dns.TypeCAA]))
|
|
|
|
}
|
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseDS) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeDS, dns.TypeToString[dns.TypeDS]))
|
|
|
|
}
|
2023-12-11 19:13:25 +00:00
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseNAPTR) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeNAPTR, dns.TypeToString[dns.TypeNAPTR]))
|
|
|
|
}
|
2021-07-05 20:24:36 +00:00
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseOPENPGPKEY) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeOPENPGPKEY, dns.TypeToString[dns.TypeOPENPGPKEY]))
|
|
|
|
}
|
2022-07-26 13:27:43 +00:00
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUsePTR) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypePTR, dns.TypeToString[dns.TypePTR]))
|
2021-07-05 20:24:36 +00:00
|
|
|
}
|
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseSRV) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeSRV, dns.TypeToString[dns.TypeSRV]))
|
|
|
|
}
|
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseSSHFP) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeSSHFP, dns.TypeToString[dns.TypeSSHFP]))
|
|
|
|
}
|
|
|
|
if providers.ProviderHasCapability(prvd.DNSControlName(), providers.CanUseTLSA) {
|
|
|
|
caps = append(caps, fmt.Sprintf("rr-%d-%s", dns.TypeTLSA, dns.TypeToString[dns.TypeTLSA]))
|
|
|
|
}
|
|
|
|
|
2021-05-21 23:06:23 +00:00
|
|
|
return
|
|
|
|
}
|