This commit is contained in:
Corentin Mercier 2022-07-14 10:59:27 -04:00 committed by GitHub
commit eea8270d12
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 58 additions and 2 deletions

BIN
images/ovh-keys-ask.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

BIN
images/ovh-keys.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

29
orphaned/ovh.md Normal file
View file

@ -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)

View file

@ -28,11 +28,21 @@ YunoHost fournit une configuration DNS recommandée, accessible via :
- la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ; - la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ;
- ou la ligne de commande, `yunohost domain dns-conf votre.domaine.tld` - 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 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 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 ```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) 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 ### IP Dynamique
Si votre adresse IP publique change constamment, suivez ce [tutoriel](/dns_dynamicip). Si votre adresse IP publique change constamment, suivez ce [tutoriel](/dns_dynamicip).