Merge d77a43b840 into 2ec19bf817

orphaned/ovh.md

@@ -0,0 +1,29 @@
+# Configuration DNS automatique
+
+Pour configurer la gestion automatique de la configuration DNS lorsque vous avez acheté votre nom de domaine chez OVH, votre instance Yunohost a besoin de 4 informations à entrer lorsque vous utiliserez la commande `yunohost domain registrar set domain.tld ovh`: 
+- `auth_entrypoint`
+- `auth_application_key`
+- `auth_application_secret`
+- `auth_consumer_key`
+
+La première, `auth_entrypoint`, vaut `ovh-eu`.
+
+Pour les trois autres informations, elles sont à récupérer en suivant les instructions ci-dessous:
+- Aller sur https://eu.api.ovh.com/createToken/
+- Vous arrivez ensuite sur un formulaire à remplir comme indiqué ci-dessous :
+    - Account ID or email address : Entrer votre adresse e-mail ou votre identifiant client OVH
+    - Password : Mot de passe
+    - Script Name: Entrer `Yunohost`
+    - Script description: Entrer `My self-hosting   solution`
+    - Validity : Sélectrionner `Unlimited`
+    - Rights : Entrer les quatre lignes suivantes   (Appuyer sur le bouton `+` pour ajouter des   lignes ) :
+        - GET : /domain/zone/\*
+        - POST : /domain/zone/\*
+        - PUT : /domain/zone/\*
+        - DELETE : /domain/zone/\*/record/\*
+    - Vous arrivez sur une page qui vous donne les information recherchés
+
+![Formulaire à remplir](image://ovh-keys-ask.png)
+
+![Clés recherchées](image://ovh-keys.png)
+

pages/01.administrate/05.install/04.dns/dns_config.fr.md

@@ -28,11 +28,21 @@ YunoHost fournit une configuration DNS recommandée, accessible via :
 - la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ;
 - ou la ligne de commande, `yunohost domain dns-conf votre.domaine.tld`
 
+Cette configuration est générée à partir des paramètres d'un nom de domaine. Ceux-ci sont modifiables via la commande `yunohost domain setting votre.domaine.tld cle -v valeur`
+Pour avoir la liste des paramètres actuels d'un nom de domain, vous pouvez utiliser la commande `yunohost domain info votre.domaine.tld`
+
+Voici la liste des clés et de leur signification:
+- mail: (True, False, Défaut : True) Activer le mail sur ce nom de domaine
+- xmpp: (True, False, Défaut : True) Activer le XMPP pour ce nom de domaine
+- dns_zone: (Chaîne de caractères) Nom du domaine de niveau supérieur ou égal qui est une zone DNS. Configuré automatiquement.
+- ttl: (Nombre, Défaut: 3600) Taille du cache DNS
+
+
 Pour certains besoins ou installations particulières, et si vous savez ce que
 vous faites, il vous faudra peut-être modifier cette recommandation ou ajouter
-d'autres enregistrements (e.g. pour gérer des sous-domaines).
+d'autres enregistrements.
 
-La configuration recommandée ressemble typiquement à :
+La configuration recommandée par défaut ressemble typiquement à :
 
 ```bash
 #
@@ -114,6 +124,23 @@ $ nslookup 111.222.333.444
 
 Le système de diagnostic présent dans l'interface d'administration fait cette vérification automatiquement (dans la section Email)
 
+## Uploader la configuration DNS automatiquement
+
+Il est possible de permettre à Yunohost d'envoyer votre configuration DNS chez votre registrar de manière automatique. 
+
+Pour ce faire, il faut donner à yunohost quelques informations qui dépendent du registrar. Ceci est possible à l'aide de la commande suivante :
+```
+root@ynh:~# yunohost domain registrar set {domain} {registrar}
+Enter value for 'auth_entrypoint':: 
+```
+
+Pour obtenir la liste des registrars disponibles, il est possible d'utiliser la commande `yunohost domain registrar catalog`. Ajouter l'options `-f` ou `--full` pour avoir également la liste des clés à entrer par registrar.
+Il faut ensuite donner les bonnes informations pour chaque paramètre de connexion à renseigner. Une documentation spécifique, au moins pour les plus grands registrars, est prévue pour vous aider à récupérer ces informations.
+
+Si tout s'est bien passé, la commande `yunohost domain registrar info votre.domaine.tld` vous retournera les informations que vous avez entrées. 
+
+Il suffit ensuite de lancer la commande `yunohost domain push_config votre.domaine.tld` pour envoyer la configuration chez le registrar.
+
 ### IP Dynamique
 
 Si votre adresse IP publique change constamment, suivez ce [tutoriel](/dns_dynamicip).