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",
2023-06-17 14:58:17 +02:00
"notification_emails": "test@example .com,hostmaster@example .com"
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
2023-06-17 14:58:17 +02:00
D("example.com", REG_CSCGLOBAL, DnsProvider(DSP_BIND),
2022-05-08 14:41:33 -04:00
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.