2020-09-08 00:00:21 +08: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 20:56:20 +08:00
{% hint style="info" %}
**NOTE**: Experimental support for being a DNS Provider is available.
2022-06-13 04:01:08 +08: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 20:56:20 +08:00
{% endhint %}
2022-06-13 04:01:08 +08:00
2020-09-08 00:00:21 +08:00
## Configuration
2022-05-09 02:41:33 +08:00
To use this provider, add an entry to `creds.json` with `TYPE` set to `CSCGLOBAL` .
2020-09-08 00:00:21 +08: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-09 02:41:33 +08:00
Example:
2023-03-03 05:17:27 +08:00
{% code title="creds.json" %}
2022-02-18 01:22:31 +08:00
```json
2020-09-08 00:00:21 +08:00
{
"cscglobal": {
2022-05-09 02:41:33 +08:00
"TYPE": "CSCGLOBAL",
2020-09-08 00:00:21 +08:00
"api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"user-token": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
2022-11-03 21:12:08 +08:00
"notification_emails": "test@example.tld,hostmaster@example.tld"
2020-09-08 00:00:21 +08:00
}
}
2022-02-18 01:22:31 +08:00
```
2023-03-03 05:17:27 +08:00
{% endcode %}
2020-09-08 00:00:21 +08:00
## Usage
2022-05-09 02:41:33 +08:00
An example `dnsconfig.js` configuration:
2020-09-08 00:00:21 +08:00
2023-01-20 20:56:20 +08:00
```javascript
2022-05-09 02:41:33 +08:00
var REG_CSCGLOBAL = NewRegistrar("cscglobal");
var DSP_BIND = NewDnsProvider("bind");
2020-09-08 00:00:21 +08:00
2022-05-09 02:41:33 +08:00
D("example.tld", REG_CSCGLOBAL, DnsProvider(DSP_BIND),
A("test", "1.2.3.4")
2020-09-08 00:00:21 +08:00
);
2022-02-18 01:22:31 +08:00
```
2020-09-08 00:00:21 +08:00
## Activation
To get access to the [CSC Global API ](https://www.cscglobal.com/cscglobal/docs/dbs/domainmanager/api-v2/ ) contact your account manager.