2020-09-08 04:00:21 +12:00
DNSControl's CSC Global provider supports being a Registrar. Support for being a DNS Provider is not included, although CSC Global's API does provide for this so it could be implemented in the future.
2023-01-20 13:56:20 +01:00
{% hint style="info" %}
**NOTE ** : Experimental support for being a DNS Provider is available.
2022-06-12 16:01:08 -04:00
However it is not recommended as updates take 5-7 minutes, and the
next update is not permitted until the previous update is complete.
Use it at your own risk. Consider it experimental and undocumented.
2023-01-20 13:56:20 +01:00
{% endhint %}
2022-06-12 16:01:08 -04:00
2020-09-08 04:00:21 +12:00
## Configuration
2022-05-08 14:41:33 -04:00
To use this provider, add an entry to `creds.json` with `TYPE` set to `CSCGLOBAL` .
2020-09-08 04:00:21 +12:00
In your `creds.json` file, you must provide your API key and user/client token. You can optionally provide an comma separated list of email addresses to have CSC Global send updates to.
2022-05-08 14:41:33 -04:00
Example:
2023-03-02 22:17:27 +01:00
{% code title="creds.json" %}
2022-02-17 18:22:31 +01:00
``` json
2020-09-08 04:00:21 +12:00
{
"cscglobal" : {
2022-05-08 14:41:33 -04:00
"TYPE" : "CSCGLOBAL" ,
2020-09-08 04:00:21 +12:00
"api-key" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ,
"user-token" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" ,
2022-11-03 09:12:08 -04:00
"notification_emails" : "test@example.tld,hostmaster@example.tld"
2020-09-08 04:00:21 +12:00
}
}
2022-02-17 18:22:31 +01:00
```
2023-03-02 22:17:27 +01:00
{% endcode %}
2020-09-08 04:00:21 +12:00
## Usage
2023-03-11 14:42:01 +01:00
An example configuration:
2020-09-08 04:00:21 +12:00
2023-03-11 14:42:01 +01:00
{% code title="dnsconfig.js" %}
2023-01-20 13:56:20 +01:00
``` javascript
2022-05-08 14:41:33 -04:00
var REG _CSCGLOBAL = NewRegistrar ( "cscglobal" ) ;
var DSP _BIND = NewDnsProvider ( "bind" ) ;
2020-09-08 04:00:21 +12:00
2022-05-08 14:41:33 -04:00
D ( "example.tld" , REG _CSCGLOBAL , DnsProvider ( DSP _BIND ) ,
A ( "test" , "1.2.3.4" )
2020-09-08 04:00:21 +12:00
) ;
2022-02-17 18:22:31 +01:00
```
2023-03-11 14:42:01 +01:00
{% endcode %}
2020-09-08 04:00:21 +12:00
## Activation
To get access to the [CSC Global API ](https://www.cscglobal.com/cscglobal/docs/dbs/domainmanager/api-v2/ ) contact your account manager.