diff --git a/images/ovh-keys-ask.png b/images/ovh-keys-ask.png new file mode 100644 index 00000000..6f1d191e Binary files /dev/null and b/images/ovh-keys-ask.png differ diff --git a/images/ovh-keys.png b/images/ovh-keys.png new file mode 100644 index 00000000..6d183f0a Binary files /dev/null and b/images/ovh-keys.png differ diff --git a/orphaned/ovh.md b/orphaned/ovh.md new file mode 100644 index 00000000..32424be0 --- /dev/null +++ b/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) + diff --git a/pages/01.administrate/05.install/04.dns/dns_config.fr.md b/pages/01.administrate/05.install/04.dns/dns_config.fr.md index 7e725afe..cdff541d 100644 --- a/pages/01.administrate/05.install/04.dns/dns_config.fr.md +++ b/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).