Dans cet article, nous allons vous pr\u00e9senter le concept de Webview Android et discuter des causes de l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED. Ensuite, nous vous montrerons trois fa\u00e7ons de d\u00e9panner l’erreur. Allons-y !<\/p>\n
Qu’est-ce que Android Webview ?<\/h2>\n
Webview<\/a> est une fonctionnalit\u00e9 du syst\u00e8me d’exploitation Android qui permet aux applications d’afficher des pages web sans utiliser de navigateur. Cette fonction est courante dans les applications web, qui sont essentiellement des enveloppes permettant aux sites web d’\u00eatre install\u00e9s sur votre t\u00e9l\u00e9phone en tant qu’applications :<\/p>\n Bien que Webview vous permette d’acc\u00e9der \u00e0 des sites web via des applications, vous ne b\u00e9n\u00e9ficiez pas de la m\u00eame quantit\u00e9 de fonctionnalit\u00e9s que sur un navigateur. Si vous naviguez sur le web, un navigateur tel que Chrome<\/a> vous offrira toujours une meilleure exp\u00e9rience que Webview.<\/p>\n L’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED est unique aux applications qui utilisent Webview dans l’OS Android. Vous ne rencontrerez pas cette erreur en utilisant un navigateur tel que Chrome. Si vous essayez d’acc\u00e9der \u00e0 un site web construit avec PHP<\/a> via HTTP au lieu d’un canal s\u00e9curis\u00e9 avec un navigateur ordinaire, vous risquez de rencontrer d’autres erreurs, telles que des avertissements \u00ab Not Secure \u00bb.<\/p>\n\n Si vous configurez Webview pour charger une page qui utilise HTTP<\/a> ou contient d’autres types d’informations non crypt\u00e9es, l’application renverra l’erreur suivante (nous utilisons un outil de d\u00e9veloppement d’applications Android pour vous la montrer) :<\/p>\n L’erreur ne signifie pas que le site web est inaccessible ou qu’il souffre de probl\u00e8mes techniques. En fait, si vous essayez d’acc\u00e9der \u00e0 la m\u00eame URL<\/a> \u00e0 l’aide d’un autre navigateur, vous ne rencontrerez peut-\u00eatre aucun type d’erreur. Tout au plus, s’il s’agit d’une URL HTTP, vous verrez peut-\u00eatre une ic\u00f4ne indiquant que vous visitez un site web non s\u00e9curis\u00e9.<\/p>\n Comme l’erreur n\u2019apparait qu’\u00e0 l’int\u00e9rieur des applications Android, elle peut amener les utilisateurs \u00e0 croire qu’il y a un probl\u00e8me avec l’application elle-m\u00eame. Cependant, il existe des moyens de contourner et de r\u00e9soudre cette erreur, que vous soyez un d\u00e9veloppeur d’applications ou que vous soyez en charge du site web qui l’affiche. Si vous \u00eates un utilisateur final, vous ne pouvez pas faire grand-chose \u00e0 part essayer d’acc\u00e9der au site web \u00e0 l’aide d’un navigateur.<\/p>\n Par d\u00e9faut, Android emp\u00eache les applications d’envoyer accidentellement des donn\u00e9es non crypt\u00e9es ou \u00ab texte clair \u00bb C’est la configuration par d\u00e9faut des applications depuis Android 9.0.<\/p>\n Cette configuration s’applique aux applications qui utilisent Android Webview. C’est pourquoi l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED n\u2019apparait que dans les applications et non dans les navigateurs au sein de l’OS Android.<\/p>\n Puisque la cause principale de cette erreur est l’information non crypt\u00e9e, il existe diff\u00e9rentes fa\u00e7ons de la r\u00e9soudre. Si vous \u00eates le d\u00e9veloppeur de l’application, vous pouvez modifier les fichiers de configuration qui permettent la prise en charge du texte clair.<\/p>\n Sinon, si vous \u00eates le propri\u00e9taire du site web, vous pouvez configurer toutes les pages du site pour qu’elles soient charg\u00e9es en HTTPS. De cette fa\u00e7on, les utilisateurs n’auront pas \u00e0 g\u00e9rer des canaux non crypt\u00e9s et les applications Android qui pointent vers votre site web ne renverront pas l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED.<\/p>\n Dans cette section, nous allons vous montrer comment r\u00e9soudre l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED directement sur Android et depuis votre site web. Vous devrez avoir acc\u00e8s \u00e0 un appareil Android pour d\u00e9panner l’erreur et v\u00e9rifier si elle persiste.<\/p>\n Chaque application Android comprend un fichier AndroidManifest.xml<\/a><\/strong>. Ce fichier contient des informations sur l’application qui sont requises par le syst\u00e8me d’exploitation, le Google Play Store et certains outils de d\u00e9veloppement.<\/p>\n Le fichier AndroidManifest.xml<\/strong> comprend \u00e9galement des informations sur les autorisations des cl\u00e9s et indique si l’application peut charger du texte clair sur Webview ou non. Gardez \u00e0 l’esprit que Google d\u00e9conseille d’autoriser le texte clair en raison de probl\u00e8mes de s\u00e9curit\u00e9. Cette m\u00e9thode de d\u00e9pannage doit donc \u00eatre une solution temporaire jusqu’\u00e0 ce que le site web que vous chargez passe au trafic crypt\u00e9<\/a>.<\/p>\n Pour localiser et modifier AndroidManifest.xml<\/strong> (ce qui est similaire \u00e0 la modification d’un fichier HTML<\/a>), vous devez avoir acc\u00e8s au fichier .apk<\/strong> de l’application ou \u00e0 la source du projet. Il existe plusieurs fa\u00e7ons d’acc\u00e9der aux fichiers source du projet d’une application. L’approche recommand\u00e9e est d’utiliser Android Studio<\/a>, qui est l’environnement de d\u00e9veloppement int\u00e9gr\u00e9 (IDE) officiel pour les d\u00e9veloppeurs Android :<\/p>\n Une fois que vous ouvrez un projet dans Android Studio<\/a>, vous serez en mesure de voir tous ses fichiers connexes \u00e0 travers des r\u00e9pertoires standardis\u00e9s. Le fichier AndroidManifest.xml<\/strong> sera situ\u00e9 dans le r\u00e9pertoire manifests <\/strong>:<\/p>\n Ouvrez le fichier et recherchez le sous-\u00e9l\u00e9ment application<\/strong><\/a>, qui doit ressembler \u00e0 ceci :<\/p>\n Les variables \u00e0 l’int\u00e9rieur du sous-\u00e9l\u00e9ment application <\/strong>peuvent changer, vous devrez donc rechercher les balises d’ouverture et de fermeture de l’application <\/strong>pour les identifier. Une fois que vous avez localis\u00e9 les balises, collez la ligne de code suivante :<\/p>\n Si la variable usesCleartexTraffic <\/strong>est d\u00e9j\u00e0 d\u00e9finie sur false<\/strong>, changez-la en true. <\/strong>Lorsque vous avez termin\u00e9, enregistrez les modifications dans AndroidManifest.xml<\/strong> et fermez le fichier, puis enregistrez les modifications dans le projet.<\/p>\n \u00c0 partir d’Android 7.0, Google permet aux applications d’utiliser un fichier de configuration de s\u00e9curit\u00e9 r\u00e9seau<\/a> pour d\u00e9finir les autorisations pour des domaines et des applications sp\u00e9cifiques. En un mot, vous pouvez utiliser network_security_config.xml<\/strong> pour contourner les restrictions en clair pour un ou plusieurs domaines.<\/p>\n Cette approche est plus sure que l’activation de la prise en charge du texte clair pour l’ensemble de l’application (comme indiqu\u00e9 dans la m\u00e9thode pr\u00e9c\u00e9dente). Toutefois, l’approche la plus sure consisterait \u00e0 ne cr\u00e9er des liens vers des pages s\u00e9curis\u00e9es qu’en utilisant Webview.<\/p>\n Id\u00e9alement, vous n’utiliserez qu’une seule de ces deux approches, car l’activation de la prise en charge du texte clair dans l’ensemble de l’application signifie que vous n’avez pas \u00e0 autoriser des domaines sp\u00e9cifiques. Si vous souhaitez opter pour l’approche la plus s\u00e9curis\u00e9e, suivez cette m\u00e9thode.<\/p>\n Avec cela en t\u00eate, allons-y et cr\u00e9ons un fichier network_security_config.xml<\/strong> pour votre application. Pour ce faire, ouvrez le projet d’application \u00e0 l’aide d’Android Studio (comme indiqu\u00e9 dans la section pr\u00e9c\u00e9dente) et acc\u00e9dez au r\u00e9pertoire res<\/strong>.<\/p>\n Ce r\u00e9pertoire comprend tous les fichiers non cod\u00e9s d’un projet d’application, y compris les fichiers XML (\u00e0 part AndroidManifest.xml<\/strong>), les images bitmap, etc. Cr\u00e9ez un fichier appel\u00e9 network_security_config.xml <\/strong>dans le r\u00e9pertoire res<\/strong>. Ensuite, ouvrez le fichier et ajoutez le code suivant :<\/p>\n Ce code sp\u00e9cifie qu’un seul domaine peut utiliser le texte clair. Vous pouvez ajouter d’autres \u00e9l\u00e9ments \u00ab domain includeSubdomains <\/strong>\u00bb pour autoriser des URL suppl\u00e9mentaires. Toutefois, pour des raisons de s\u00e9curit\u00e9, nous vous recommandons de limiter cette configuration aux seuls domaines qui en ont strictement besoin.<\/p>\n Enregistrez les modifications apport\u00e9es \u00e0 network_security_config.xml<\/strong> et retournez dans le r\u00e9pertoire manifests <\/em>. Pour que la configuration de la s\u00e9curit\u00e9 r\u00e9seau fonctionne, vous devez \u00e0 nouveau modifier AndroidManifest.xml<\/strong>.<\/p>\n Ouvrez le fichier et recherchez le sous-\u00e9l\u00e9ment application <\/strong>. Ensuite, ajoutez la ligne de code suivante dans ses balises :<\/p>\n Fermez AndroidManifest.xml<\/strong> apr\u00e8s avoir enregistr\u00e9 les modifications apport\u00e9es au fichier et c’est tout. Votre application devrait maintenant activer le texte clair pour le domaine que vous avez sp\u00e9cifi\u00e9.<\/p>\n La solution la plus sure \u00e0 l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED est de configurer le site web qui renvoie le message d’erreur pour qu’il utilise HTTPS<\/a>. De cette fa\u00e7on, toutes les donn\u00e9es transmises vers et depuis le site web sont crypt\u00e9es.<\/p>\n Dans le web moderne, il n’y a aucune raison de ne pas <\/em>utiliser HTTPS pour votre site. Vous pouvez obtenir gratuitement un certificat SSL (Secure Sockets Layer)<\/a> et le configurer sur votre site en quelques minutes. En fait, certains h\u00e9bergeurs (comme Kinsta) peuvent s’occuper de l’ensemble du processus pour vous.<\/p>\n Lorsque vous vous inscrivez \u00e0 un plan d’h\u00e9bergement Kinsta, nous configurons automatiquement un certificat SSL pour votre site web. De plus, vous pouvez forcer votre site \u00e0 se charger sur HTTPS depuis votre tableau de bord MyKinsta.<\/p>\n Pour cela, acc\u00e9dez \u00e0 MyKinsta, s\u00e9lectionnez un site web et allez dans l’onglet Outils<\/strong>. Recherchez l’option qui dit Forcer HTTPS <\/strong>et cliquez sur Activer <\/strong>:<\/p>\n Si vous n’utilisez pas Kinsta, vous pouvez soit modifier votre fichier WordPress .htaccess<\/strong> pour rediriger le trafic HTTP vers HTTPS<\/a>, soit utiliser une extension qui fera le travail pour vous. Si vous optez pour cette derni\u00e8re solution, nous vous recommandons d’utiliser l’extension Really Simple SSL<\/a>.<\/p>\n Vous pouvez consulter cet article pour obtenir des instructions sur la fa\u00e7on de rediriger le trafic HTTP vers HTTPS<\/a> sur Nginx et Apache<\/a>, et sur l’utilisation de l’extension en question. Apr\u00e8s avoir configur\u00e9 votre site web pour utiliser HTTPS, vous ne devriez plus rencontrer l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED en utilisant Android Webview pour y naviguer.<\/p>\n\n Si vous rencontrez l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED dans Android, cela signifie que l’application que vous utilisez tente d’acc\u00e9der \u00e0 une page web qui veut transmettre des informations en clair ou non s\u00e9curis\u00e9es. Android emp\u00eache les applications de faire cela afin d’\u00e9viter de compromettre les donn\u00e9es des utilisateurs.<\/p>\n Si vous \u00eates un utilisateur r\u00e9gulier, vous devrez utiliser un navigateur pour visiter le site web qui renvoie l’erreur. Toutefois, si vous \u00eates le d\u00e9veloppeur de l’application ou du site web, vous pouvez essayer de modifier le fichier AndroidManifest.xml<\/strong>, d’autoriser le domaine via le fichier network_security_config.xml<\/strong> et de forcer votre site Web \u00e0 utiliser HTTPS.<\/p>\n Les utilisateurs de Kinsta sont beaucoup moins susceptibles de rencontrer l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED pour leurs propres sites web. C’est parce que nous configurons automatiquement des certificats SSL pour les nouveaux sites web et que nous vous permettons de rediriger le trafic via HTTPS en quelques clics. Explorez nos plans d’h\u00e9bergement web<\/a> ou nos plans d’h\u00e9bergement d’applications<\/a> pour trouver ce qui vous convient le mieux !<\/p>\n","protected":false},"excerpt":{"rendered":" Si vous utilisez Android, vous pouvez rencontrer l’erreur NET::ERR_CLEARTEXT_NOT_PERMITTED en essayant d’acc\u00e9der \u00e0 un site web ou \u00e0 une application web. Cette erreur vous emp\u00eachera d’acc\u00e9der …<\/p>\n","protected":false},"author":117,"featured_media":66024,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kinsta_gated_content":false,"_kinsta_gated_content_redirect":"","footnotes":""},"tags":[],"topic":[974,1023],"class_list":["post-66023","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","topic-codes-etat-http","topic-erreurs-site-web"],"yoast_head":"\n![\"Android](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/android-webview.png\")
Que signifie NET::ERR_CLEARTEXT_NOT_PERMITTED ?<\/h2>\n
![\"L'erreur](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/cleartext-not-permitted.png\")
Quelle est la cause du message NET::ERR_CLEARTEXT_NOT_PERMITTED ?<\/h2>\n
Comment corriger l’erreur \u00ab NET::ERR_CLEARTEXT_NOT_PERMITTED \u00bb (3 fa\u00e7ons)<\/h2>\n
1. Modifier AndroidManifest.xml<\/h3>\n
![\"Android](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/android-studio.png\")
![\"AndroidManifest.xml](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/androidmanifest.png\")
<application\n\nandroid:icon=\"@drawable\/ic_launcher\"\n\nandroid:label=\"@string\/app_name\"\n\nandroid:theme=\"@style\/AppTheme\" >\n\n<\/application><\/code><\/pre>\nandroid:usesCleartextTraffic=\u201dtrue\u201d<\/code><\/p>\n2. Autoriser le domaine \u00e0 l’aide de network_security_config.xml<\/h3>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\n\n<network-security-config>\n\n<domain-config cleartextTrafficPermitted=\"true\">\n\n<domain includeSubdomains=\"true\">yourwebsite.com<\/domain>\n\n<\/domain-config>\n\n<\/network-security-config><\/code><\/pre>\nandroid:networkSecurityConfig=\"@xml\/network_security_config\"<\/code><\/p>\n3. Forcer votre site web \u00e0 utiliser HTTPS<\/h3>\n
![\"Forcer](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/force-https.png\")
R\u00e9sum\u00e9<\/h2>\n