# CocoNetworks DNS™

# Présentation

CocoNetworks peut héberger votre zone DNS à prix libre, sur 2 serveurs distincts répartis géographiquement en France sur des connexions domestiques (pas de VPS ou serveur loué)

- Interface web
- Authentification 2 facteurs
- Tous types d'enregistrements
- Wildcards
- Serveurs IPv6/IPv4
- DNSSEC
- [API](https://coconetworks.org/books/services/page/api "API")

# Mise en place des NS

<p class="callout success">[Contactez-moi](https://letterbird.co/coconetworks) pour l'ouverture d'un compte sur l'interface de gestion DNS et l'ajout d'un domaine (à chaque ajout)</p>

Une fois le compte ouvert et le(s) domaine(s) ajouté(s), il faut se connecter à **[dns.coconetworks.org](https://dns.coconetworks.org)** et activer l'authentification 2 facteurs. Sur cette interface, il est possible de modifier la zone.

**Du côté de votre registrar, il faut déclarer les NS suivants :**

- `ns1.coconetworks.org`
- `ns2.coconetworks.org`

<p class="callout success">[Contactez-moi](https://letterbird.co/coconetworks) également en cas de difficultés</p>

# API

#### Générer des clés d'API

Les utilisateurs peuvent générer **jusqu'à 5 clés d'API par compte**

- Se rendre sur **[dns.coconetworks.org](https://dns.coconetworks.org)**
- En haut à droite, dans *Tools*, cliquer sur *API Keys*
- Cliquer *Add new API key*
- Remplir les informations et enregistrer
- La clé s'affiche et **elle ne s'affichera qu'une fois**

#### Exemple : utiliser l'API pour obtenir des certificats SSL avec `acme.sh`

Après avoir installé `acme.sh`, éditer `~/.acme.sh/account.conf` et ajouter ces variables :

```
POWERADMIN_URL='https://dns.coconetworks.org'
POWERADMIN_API_KEY='votre clé d'API générée dans l'étape précédente'
```

Il est ensuite possible, après avoir `cd ~/.acme.sh`, de lancer l'obtention du certificat par API DNS :

```
./acme.sh --issue --dns dns_poweradmin -d example.com
```

CocoNetworks DNS™ prend également en charge les wildcards :

```
./acme.sh --issue --dns dns_poweradmin -d example.com -d *.example.com
```

<p class="callout success">Pour d'autres utilisations de l'API, la documentation est disponible sur [dns.coconetworks.org/api/docs](https://dns.coconetworks.org/api/docs)</p>