Aller au contenu principal

DNS Providers

Connectez votre fournisseur DNS pour la vérification automatique des domaines et la gestion des certificats.

Paramètres du Projet

Vue d'Ensemble​

L'intégration des fournisseurs DNS permet :

  • Vérification automatique des domaines - Challenges DNS-01 pour les certificats SSL
  • Certificats wildcard - Sécurisez tous les sous-domaines
  • Vérification plus rapide - Pas de création manuelle d'enregistrements DNS
  • Surveillance du statut en temps réel - Suivez la synchronisation et détectez les problèmes instantanément

Fournisseurs Supportés​

FournisseurSupport APICertificats Wildcard
Cloudflare✓✓
AWS Route 53✓✓
DigitalOcean✓✓
OVH✓✓
Gandi✓✓
GoDaddy✓✓
Azure DNS✓✓
IONOS✓✓
Scaleway✓✓

Ajouter un Fournisseur DNS​

Étapes​

  1. Allez dans votre projet
  2. Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet dans la barre latérale
  3. Sélectionnez l'onglet Fournisseurs DNS
  4. Cliquez sur Ajouter un Fournisseur
  5. Sélectionnez votre fournisseur
  6. Entrez les identifiants API
  7. Cliquez sur Enregistrer

Configuration des Fournisseurs​

Cloudflare​

Identifiants requis :

  • Token API (recommandé) ou
  • Clé API Globale + Email

Créer un Token API :

  1. Allez sur le Tableau de bord Cloudflare
  2. Cliquez sur Créer un Token
  3. Utilisez le modèle : Modifier le DNS de la zone
  4. Sélectionnez votre zone
  5. Créez et copiez le token
Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Permissions nécessaires :

  • Zone → DNS → Modifier
  • Zone → Zone → Lire

Paramètres optionnels :

  • Activer le Proxy Cloudflare - Achemine le trafic via le CDN et les fonctionnalités de sécurité de Cloudflare

AWS Route 53​

Identifiants requis :

  • Access Key ID
  • Secret Access Key

Politique IAM :

{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"route53:GetChange",
"route53:ChangeResourceRecordSets",
"route53:ListResourceRecordSets"
],
"Resource": [
"arn:aws:route53:::hostedzone/ZONE_ID",
"arn:aws:route53:::change/*"
]
},
{
"Effect": "Allow",
"Action": "route53:ListHostedZones",
"Resource": "*"
}
]
}

DigitalOcean​

Identifiants requis :

  • Personal Access Token

Créer un Token :

  1. Allez sur DigitalOcean API
  2. Générez un nouveau token
  3. Accordez : Lecture et Écriture
Token: dop_v1_xxxxxxxxxxxxxxxxxxxx

OVH​

Identifiants requis :

  • Application Key
  • Application Secret
  • Consumer Key

Créer un Token API OVH :

  1. Allez sur OVH API Token Creation
  2. Remplissez les informations de l'application :
    • Nom de l'application : SailOps DNS Management (ou le nom de votre choix)
    • Description de l'application : Gestion DNS pour les domaines personnalisés SailOps
  3. Définissez les permissions API requises (droits) :
MéthodeCheminDescription
GET/domain/zoneLister les zones disponibles
GET/domain/zone/*/recordLister les enregistrements DNS d'une zone
GET/domain/zone/*/record/*Obtenir les détails d'un enregistrement spécifique
PUT/domain/zone/*/record/*Mettre à jour les enregistrements DNS existants
POST/domain/zone/*/recordCréer de nouveaux enregistrements DNS
DELETE/domain/zone/*/record/*Supprimer des enregistrements DNS
GET/domain/zone/*/soaObtenir les informations de l'enregistrement SOA
POST/domain/zone/*/refreshAppliquer les changements DNS

Format copier-coller pour créer facilement un token API OVH :

GET    /domain/zone
GET /domain/zone/*/record
GET /domain/zone/*/record/*
PUT /domain/zone/*/record/*
POST /domain/zone/*/record
DELETE /domain/zone/*/record/*
GET /domain/zone/*/soa
POST /domain/zone/*/refresh
  1. Définissez la Validité : Choisissez la durée souhaitée (ex: "Illimité" pour un accès permanent)
  2. Cliquez sur Créer les clés
  3. Copiez les identifiants générés :
    • Application Key (AK)
    • Application Secret (AS)
    • Consumer Key (CK)

Notes importantes :

  • Ces permissions sont le minimum requis pour que SailOps puisse gérer les enregistrements DNS
  • Le wildcard * permet l'accès à toutes vos zones de domaine
  • Vous pouvez restreindre l'accès à des zones spécifiques en remplaçant * par votre nom de domaine (ex: /domain/zone/exemple.com/record)
  • Gardez vos identifiants en sécurité et ne les partagez jamais publiquement

Gandi​

Identifiants requis :

  • Clé API (Personal Access Token)

Créer un Token :

  1. Allez sur Compte Gandi
  2. Sécurité → Personal Access Tokens
  3. Créez avec les permissions DNS

Azure DNS​

Identifiants requis :

  • Subscription ID
  • Tenant ID
  • Client ID
  • Client Secret
  • Nom du Groupe de Ressources

Créer un Service Principal :

az ad sp create-for-rbac \
--name "SailOps-DNS" \
--role "DNS Zone Contributor" \
--scopes /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Network/dnszones/{zone}

Obtenir le Nom du Groupe de Ressources :

Le nom du groupe de ressources est le nom du Azure Resource Group contenant votre zone DNS. Vous pouvez le trouver dans le portail Azure sous la page de présentation de votre zone DNS.

GoDaddy​

Identifiants requis :

  • Clé API
  • Secret API

Obtenir les Identifiants :

  1. Allez sur le Portail Développeur GoDaddy
  2. Créez une clé API
  3. Sélectionnez l'environnement Production
  4. Copiez la clé API et le secret

IONOS​

Identifiants requis :

  • Clé API

Obtenir les Identifiants :

  1. Allez sur le Portail Développeur IONOS
  2. Naviguez vers la section Clés API
  3. Créez une nouvelle clé API avec les permissions DNS
  4. Copiez la clé API

Scaleway​

Identifiants requis :

  • Access Key
  • Secret Key
  • Organization ID

Obtenir les Identifiants :

  1. Allez sur la Console Scaleway
  2. Naviguez vers IAM → Clés API
  3. Créez une nouvelle clé API
  4. Copiez l'Access Key, le Secret Key et votre Organization ID

Utilisation des Fournisseurs DNS​

Vérification de Domaine​

Lors de l'ajout d'un domaine personnalisé :

  1. SailOps détecte le fournisseur DNS correspondant
  2. Crée automatiquement les enregistrements de vérification
  3. Demande le certificat SSL
  4. Nettoie les enregistrements temporaires

Sans Fournisseur DNS​

Si aucun fournisseur n'est configuré :

  1. Création manuelle des enregistrements DNS requise
  2. Challenge HTTP-01 utilisé (pas de wildcards)
  3. Temps de vérification plus long

Gérer les Fournisseurs​

Voir les Fournisseurs​

  1. Cliquez sur l'icône Paramètres (engrenage) à côté du nom de votre projet
  2. Sélectionnez l'onglet Fournisseurs DNS
  3. Voir tous les fournisseurs configurés et les zones gérées

Tester la Connexion​

  1. Cliquez sur Tester sur un fournisseur
  2. SailOps vérifie l'accès API
  3. Liste les zones accessibles

Mettre à Jour les Identifiants​

  1. Cliquez sur le fournisseur
  2. Mettez à jour les identifiants API
  3. Cliquez sur Enregistrer

Supprimer un Fournisseur​

  1. Cliquez sur Supprimer
  2. Confirmez la suppression
attention

Supprimer un fournisseur n'affecte pas les certificats existants mais empêche le renouvellement automatique.

Surveillance du Statut des Fournisseurs​

SailOps fournit une surveillance en temps réel du statut de vos fournisseurs DNS, vous aidant à identifier et résoudre rapidement les problèmes de configuration.

Indicateurs de Statut​

Chaque fournisseur DNS affiche un badge de statut indiquant son état actuel :

StatutBadgeDescription
Sain🟢 VertLe fournisseur fonctionne correctement. Les enregistrements DNS sont synchronisés.
Synchronisation🔵 BleuLe fournisseur démarre ou synchronise actuellement les enregistrements.
Erreur🔴 RougeLe fournisseur a rencontré une erreur. Consultez les détails de l'erreur pour plus d'informations.

Informations de Statut​

Lorsque vous consultez un fournisseur DNS, vous verrez :

  • Badge de Statut - État de synchronisation actuel
  • Dernière Synchronisation - Quand le fournisseur a tenté de se synchroniser pour la dernière fois
  • Dernière Synchronisation Réussie - Quand les enregistrements ont été mis à jour avec succès pour la dernière fois
  • Nombre d'Enregistrements Gérés - Nombre d'enregistrements DNS actuellement gérés

Types d'Erreurs​

Lorsqu'un fournisseur rencontre une erreur, SailOps la catégorise pour vous aider à résoudre le problème :

Code d'ErreurDescriptionCauses Courantes
Échec d'AuthentificationLes identifiants API sont invalides ou expirésClé API invalide, token expiré, accès révoqué
Permission RefuséeLes identifiants n'ont pas les permissions requisesPermissions d'édition DNS manquantes, accès à la zone restreint
Limite de TauxTrop de requêtes APIFréquence élevée de changements DNS, limites du fournisseur
Erreur RéseauImpossible de se connecter à l'API du fournisseurPanne du fournisseur, problèmes de connectivité, erreurs TLS/certificat
Erreur APIL'API du fournisseur a retourné une erreurProblèmes de service du fournisseur (erreurs 500, 502, 503, 504)
Erreur de ConfigurationLa configuration du fournisseur est invalideZone non trouvée, configuration de zone invalide, incompatibilité de domaine

Résolution des Problèmes de Statut​

Échec d'Authentification​

  1. Vérifiez que vos identifiants API sont corrects
  2. Vérifiez si les identifiants ont expiré ou ont été révoqués
  3. Régénérez les identifiants depuis le tableau de bord de votre fournisseur DNS
  4. Mettez à jour les identifiants dans SailOps

Permission Refusée​

  1. Consultez les permissions requises pour votre fournisseur (voir Configuration des Fournisseurs)
  2. Mettez à jour vos identifiants API pour inclure les permissions nécessaires
  3. Pour les identifiants à portée limitée, assurez-vous qu'ils ont accès aux bonnes zones

Limite de Taux​

  1. Attendez que la fenêtre de limite de taux se réinitialise (généralement 1-5 minutes)
  2. Si le problème persiste, réduisez la fréquence des changements de domaine
  3. Envisagez de consolider les domaines sous des certificats wildcard

Erreur Réseau​

  1. Vérifiez si votre fournisseur DNS connaît une panne
  2. Vérifiez que l'endpoint API du fournisseur est accessible
  3. Si vous utilisez TLS/certificats, assurez-vous qu'ils sont valides

Erreur de Configuration​

  1. Vérifiez que la zone de domaine existe chez votre fournisseur DNS
  2. Vérifiez que le nom de zone correspond exactement
  3. Assurez-vous que vos identifiants API ont accès à la zone spécifique

Récupération Automatique​

SailOps tente automatiquement de récupérer des erreurs transitoires :

  • Erreurs réseau : Réessayées automatiquement avec backoff exponentiel
  • Limites de taux : Les requêtes sont limitées et réessayées après la réinitialisation de la limite
  • Erreurs API : Réessayées pour les problèmes de serveur temporaires (erreurs 5xx)

Pour les erreurs persistantes (authentification, permissions, configuration), une intervention manuelle est requise.

Gestion des Zones​

Détection Automatique des Zones​

SailOps détecte automatiquement les zones quand :

  • Le domaine correspond à la zone du fournisseur
  • L'API a accès à la zone

Zones Multiples​

Un fournisseur peut gérer plusieurs zones :

Fournisseur Cloudflare :
├── exemple.com
├── exemple.org
└── monapp.io

Conflits de Zone​

Si plusieurs fournisseurs gèrent la même zone :

  • Le premier fournisseur correspondant est utilisé
  • L'ordre dans les paramètres détermine la priorité

Bonnes Pratiques de Sécurité​

1. Permissions Minimales​

Créez des identifiants dédiés avec une portée limitée :

✓ Accès DNS lecture/écriture uniquement
✓ Zones spécifiques uniquement
✓ Compte de service dédié

✗ Accès Admin/Propriétaire
✗ Accès à toutes les zones
✗ Identifiants partagés

2. Rotation des Identifiants​

Faites tourner les identifiants API régulièrement :

  • Tous les 90 jours recommandé
  • Après les changements d'équipe
  • Après les incidents de sécurité

3. Journalisation d'Audit​

Surveillez les changements DNS :

  • Examinez les logs d'audit du fournisseur
  • Configurez des alertes pour les changements inattendus
  • Suivez l'émission des certificats

Dépannage​

astuce

Vérifiez d'abord l'indicateur de statut du fournisseur ! Le badge de statut et les détails de l'erreur fournissent souvent un aperçu immédiat du problème. Voir Surveillance du Statut des Fournisseurs pour plus de détails.

Échec de Vérification​

Erreur : DNS verification timeout

  1. Vérifiez que les identifiants du fournisseur sont valides
  2. Vérifiez que la zone est accessible
  3. Attendez la propagation DNS (5-10 minutes)

Erreur : Zone not found

  1. Vérifiez que le domaine correspond exactement à la zone
  2. Vérifiez que l'API a accès à la zone
  3. Assurez-vous que la zone existe chez le fournisseur

Erreur : Permission denied

  1. Vérifiez les permissions API
  2. Ajoutez les scopes manquants
  3. Recréez les identifiants si nécessaire

Problèmes de Certificat​

Erreur : CAA record prevents issuance

Ajoutez un enregistrement CAA pour Let's Encrypt :

exemple.com. CAA 0 issue "letsencrypt.org"

Erreur : Rate limit exceeded

Limites Let's Encrypt :

  • 50 certificats par domaine par semaine
  • 5 certificats dupliqués par semaine

Solutions :

  1. Attendez la réinitialisation de la limite
  2. Utilisez des certificats wildcard
  3. Consolidez les sous-domaines

Problèmes Spécifiques aux Fournisseurs​

Cloudflare : Conflit de proxy

Désactivez le proxy Cloudflare (nuage orange) pour la vérification :

  1. SailOps crée les enregistrements avec le proxy désactivé
  2. Après vérification, vous pouvez activer le proxy

AWS : Incompatibilité de région

Route 53 est global, mais assurez-vous :

  1. Que la région AWS est correcte dans les identifiants
  2. Que l'ID de zone hébergée correspond au domaine

Sujets Connexes​