From df1a5cf9ef0a7e4b7fb216dcefaf9105cc1f0581 Mon Sep 17 00:00:00 2001 From: OniriCorpe Date: Sat, 18 May 2024 19:27:26 +0200 Subject: [PATCH] adding precisions to a sentence --- doc/APPS.md | 2 +- doc/APPS_fr.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 doc/APPS_fr.md diff --git a/doc/APPS.md b/doc/APPS.md index 4229937..d16e771 100644 --- a/doc/APPS.md +++ b/doc/APPS.md @@ -30,7 +30,7 @@ To use your AGH instance as the DNS server on your Apple device, you can generat **Note:** as a more tech-savvy alternative to this tutorial, you can use [Secure DNS profile creator](https://dns.notjakob.com/index.html). To do so, you first need to activate the DNS over HTTP/TLS/QUIC functionnality using the YunoHost Webadmin. -If you're reading this you should already be in the right page: just click the "AdGuard Home configuration" option at the top of this text, toggle on "Activate DNS over HTTP/TLS/QUIC?" then "Save". +If you're reading this using the YunoHost interface, you should already be in the right page: just click the "AdGuard Home configuration" option at the top of this text, toggle on "Activate DNS over HTTP/TLS/QUIC?" then "Save". Else, open The YunoHost Webadmin and follow this path: `Applications → AdGuard Home → AdGuard Home configuration` Now that it's done, go to the [Setup Guide](https://__DOMAIN____PATH__#guide) page of your AdGuard Home instance, click the "DNS Privacy" option and scroll to the bottom. diff --git a/doc/APPS_fr.md b/doc/APPS_fr.md new file mode 100644 index 0000000..f23a14b --- /dev/null +++ b/doc/APPS_fr.md @@ -0,0 +1,55 @@ +# Documentation des applications + +## Android + +Doit être complété par quelqu'un qui utilise Android + +## Appareils Apple + +### AdGuard Home Remote + +[AdGuard Home Remote](https://apps.apple.com/app/id1543143740) par [RocketScience IT](https://rocketscience-it.nl/) est compatible avec les Mac, iPhone, iPad et Watch. +Elle est gratuite and un achat in-app de 6 € pour débloquer des fonctionnalités supplémentaires. Aucune publicité ni tracking. + +Cette app sert à monitorer ou configurer votre instance AGH, et non pas utiliser cette dernière comme serveur DNS pour votre appareil Apple. + +Vous pouvez facilement configurer l'app : + +- Ajouter une instance +- Choisir un nom d'affichage +- Écrire le nom de domaine de votre instance AdGuard Home, par exemple `adguard.example.com` +- Choisir `https`, cela va automatiquement remplir le champ du port avec `443` +- Renseigner vos identifiants AdGuard Home dans les champs "Authentification" +- Tester la connexion, si une coche verte apparaît, tout est bon! + +[Votre configuration devrait ressemblr à ceci.](https://raw.githubusercontent.com/YunoHost-Apps/adguardhome_ynh/master/doc/screenshots/apps/AGH-remote.PNG) + +### Profil DNS sécurisé + +Afin d'utiliser votre instance AGH en tant que serveur DNS de votre appareil Apple, vous pouvez générer un "Profil DNS sécurisé". +**Note :** en alternative pour utilisateurice expérimenté•e à ce tutoriel, vous pouvez également utiliser l'outil [Secure DNS profile creator](https://dns.notjakob.com/index.html). + +Pour ce faire, vous devez au préalable activer la fonctionnalité DNS sur HTTP/TLS/QUIC en utilisant l'interface d'administration Web de YunoHost. +Si vous lisez ceci via l'interface YunoHost', vous devriez déjà être au bon endroit: cliquez simplement sur l'option "AdGuard Home configuration" au dessus de ce texte, activez "Activate DNS over HTTP/TLS/QUIC?" puis cliquez sur "Save". +Sinon, ouvrez l'interface d'administration Web et suivez ce chemin : `Applications → AdGuard Home → AdGuard Home configuration` + +Désormais, rendez-vous sur la page [Setup Guide](https://__DOMAIN____PATH__#guide) de votre instance AdGuard Home, cliquez sur "DNS privacy" et déscendez tout en bas. + +- Hostname: laisser comme tel +- HTTPS port: laisser aussi comme tel +- Protocol: vous devez désormais faire un choix entre DNS-over-HTTPS et DNS-over-TLS + - Si vous désirez utiliser la fonctionnalité [ClientID](https://github.com/AdguardTeam/AdGuardHome/wiki/Clients#clientid) afin de mettre vos appareils sur liste blanche, vous ne pouvez pas choisir DNS-over-TLS car YunoHost ne peut pas gérer les noms de domaines "wildcard", l'usage du DNS-over-HTTPS sera donc obligatoire pour vous + - Si vous ne savez pas lequel choisir, voici un peu d'aide : + - Comme expliqué ci-dessus, choisissez DNS-over-HTTPS si vous souhaitez utiliser la fonctionnalité ClientID pour authentifier vos requêtes + - Choisissez DNS-over-HTTPS si vous devez fréquemment utiliser des réseaux succeptibles de filtrer le port du DNS-over-TLS, tels que ceux des entreprises, des écoles, etc. + - Sinon, choisissez le DNS-over-TLS pour sa rapidité légèrement suppérieure, comme il utilise une [couche réseau OSI](https://fr.wikipedia.org/wiki/Mod%C3%A8le_OSI) de moins +- ClientID: renseigner un ClientID, `iphone-123456` par exemple + - N'oubliez pas d'ajouter un ClientID identique dans votre liste blanche : `Settings → DNS settings → Access settings → Allowed clients` + +Vous pouvez maintenant cliquer sur le bouton "Download configuration file" et accepter le téléchargement. + +Pour finir, ouvrez les réglages système, cliquez sur le message "Profil téléchargé" et installez-le en entrant le mot de passe de l'appareil et en tapant "Installer" quelques fois. + +Votre appareil devrait maintenant utiliser votre instance AdGuard Home en tant que serveur DNS. Super ! + +**Note :** Les profils installés peuvent être gérés dans les Réglages, dans "Général" puis "VPN et gestion de l'appareil".