In questo articolo vi presenteremo il concetto di Android Webview e illustreremo le cause dell’errore NET::ERR_CLEARTEXT_NOT_PERMITTED. Infine, vi mostreremo tre modi per risolvere l’errore. Cominciamo!<\/p>\n
Cos’\u00e8 la Webview di Android?<\/h2>\n
La Webview<\/a> \u00e8 una funzione del sistema operativo Android che consente alle app di visualizzare le pagine web senza utilizzare un browser. Questa funzione \u00e8 comune alle web app, che sono essenzialmente dei wrapper che permettono ai siti web di essere installati sul telefono come applicazioni:<\/p>\n Sebbene Webview vi permetta di accedere ai siti web tramite app, non vi mette a disposizione la stessa quantit\u00e0 di funzioni di un browser. Se state navigando sul web, un browser come Chrome<\/a> vi offrir\u00e0 sempre un’esperienza migliore rispetto a Webview.<\/p>\n L’errore NET::ERR_CLEARTEXT_NOT_PERMITTED \u00e8 unico per le applicazioni che utilizzano Webview nel sistema operativo Android. Infatti, non riscontrerete mai questo errore utilizzando un browser come Chrome. Se state cercando di accedere a un sito web realizzato in PHP<\/a> tramite HTTP invece che tramite un canale sicuro con un normale browser, potreste incorrere in altri errori, come ad esempio gli avvisi “Not Secure”.<\/p>\n\n Se configurate Webview per caricare una pagina che utilizza HTTP<\/a> o che contiene altri tipi di informazioni non criptate, l’applicazione restituir\u00e0 il seguente errore (stiamo utilizzando uno strumento di sviluppo di applicazioni Android per mostrarvelo):<\/p>\n L’errore non significa che il sito web sia inaccessibile o che abbia problemi tecnici. Infatti, se provate ad accedere allo stesso URL<\/a> con un altro browser, potreste non riscontrare alcun tipo di errore. Al massimo, se si tratta di un URL HTTP, potreste vedere un’icona che indica che state visitando un sito web non protetto.<\/p>\n Poich\u00e9 l’errore compare solo all’interno delle applicazioni Android, gli utenti possono pensare che ci sia un problema con l’applicazione stessa. Tuttavia, ci sono modi per aggirare e risolvere questo errore, che siate degli sviluppatori di app o i responsabili del sito web che lo mostra. Se siete degli utenti finali, c’\u00e8 poco da fare oltre a provare ad accedere al sito web con un browser.<\/p>\n Per impostazione predefinita, Android impedisce alle app di inviare accidentalmente dati non criptati o “in chiaro”; questa \u00e8 la configurazione predefinita per le app da Android 9.0.<\/p>\n Questa configurazione si applica alle app che utilizzano Android Webview. Ecco perch\u00e9 l’errore NET::ERR_CLEARTEXT_NOT_PERMITTED compare solo nelle app e non nei browser del sistema operativo Android.<\/p>\n Poich\u00e9 la causa principale dell’errore sono le informazioni non criptate, ci sono diversi modi per risolvere il problema. Se siete gli sviluppatori dell’app, potete modificare i file di configurazione per abilitare il supporto al cleartext.<\/p>\n In alternativa, se siete i proprietari di un sito web, potrete configurare tutte le pagine del sito in modo che vengano caricate tramite HTTPS. In questo modo, gli utenti non avranno a che fare con canali non criptati, e le app Android che puntano al vostro sito web non restituiranno l’errore NET::ERR_CLEARTEXT_NOT_PERMITTED.<\/p>\n In questa sezione vi mostreremo come risolvere l’errore NET::ERR_CLEARTEXT_NOT_PERMITTED direttamente su Android e dal vostro sito web. Sar\u00e0 necessario avere accesso a un dispositivo Android per risolvere l’errore e verificare se persiste.<\/p>\n Ogni applicazione Android include un file AndroidManifest.xml<\/strong><\/a>. Il file contiene le informazioni sull’applicazione richieste dal sistema operativo, da Google Play Store e da alcuni strumenti per gli sviluppatori.<\/p>\n Il file AndroidManifest.xml<\/strong> contiene anche informazioni sui permessi principali, e se l’applicazione pu\u00f2 caricare il testo in chiaro su Webview o meno. Tenete presente che Google sconsiglia di consentire il cleartext a causa di problemi di sicurezza, quindi questo metodo di risoluzione dei problemi dovrebbe essere una soluzione temporanea fino a quando il sito web che state caricando non passa al traffico crittografato<\/a>.<\/p>\n Per individuare e modificare AndroidManifest.xml<\/strong> (che \u00e8 simile alla modifica di un file HTML<\/a>), dovrete accedere al file .apk<\/strong> dell’applicazione o al file sorgente del progetto. Esistono diversi modi per accedere ai file sorgente del progetto di un’applicazione, ma l’approccio pi\u00f9 consigliato \u00e8 quello di utilizzare Android Studio<\/a>, l’ambiente di sviluppo integrato (IDE) ufficiale per gli sviluppatori Android:<\/p>\n Una volta aperto un progetto in Android Studio<\/a>, potrete vedere tutti i file correlati in directory standardizzate. Il file AndroidManifest.xml<\/strong> si trova all’interno della directory manifests<\/strong>:<\/p>\n Aprite il file e cercate il sotto-elemento dell’applicazione<\/strong><\/a>, che dovrebbe avere questo aspetto:<\/p>\n Le variabili all’interno del sotto-elemento applicazione <\/strong>potrebbero cambiare, quindi dovrete cercare i tag di apertura e chiusura dell’applicazione <\/strong>per identificarle. Una volta individuati i tag, incollate la seguente riga di codice:<\/p>\n Se c’\u00e8 gi\u00e0 una variabile usesCleartexTraffic <\/strong>impostata su false<\/strong>, cambiatela in true. <\/strong>Salvate quindi le modifiche in AndroidManifest.xml<\/strong> e chiudete il file, e infine salvate le modifiche al progetto.<\/p>\n A partire da Android 7.0, Google consente alle applicazioni di utilizzare un file di configurazione della sicurezza di rete<\/a> per impostare le autorizzazioni per domini e applicazioni specifiche. In poche parole, potete usare network_security_config.xml<\/strong> per aggirare le restrizioni in chiaro per uno o pi\u00f9 domini.<\/p>\n Questo approccio \u00e8 pi\u00f9 sicuro rispetto all’abilitazione del supporto cleartext per l’intera applicazione (come mostrato nel metodo precedente). Tuttavia, l’approccio pi\u00f9 sicuro sarebbe quello di collegarsi solo a pagine sicure utilizzando Webview.<\/p>\n L’ideale sarebbe utilizzare solo uno di questi due approcci, in quanto abilitare il supporto al cleartext in tutta l’applicazione significa non dover consentire l’accesso a domini specifici. Se volete optare per l’approccio pi\u00f9 sicuro, seguite questo metodo.<\/p>\n Con queste premesse, creiamo un file network_security_config.xml<\/strong> per la vostra applicazione. Per farlo, aprite il progetto dell’app con Android Studio (come indicato nella sezione precedente) e navigate nella directory res<\/strong>.<\/p>\n Questa cartella contiene tutti i file non di codice di un progetto di app, compresi i file XML (a parte AndroidManifest.xml<\/strong>), le immagini bitmap e altro ancora. Create un file chiamato network_security_config.xml <\/strong>all’interno della cartella res<\/strong>. Quindi, aprite il file e aggiungete il seguente codice:<\/p>\n Questo codice specifica che solo un dominio pu\u00f2 utilizzare il cleartext. \u00c8 possibile anche aggiungere altri elementi “domain includeSubdomains<\/strong>” per consentire l’inserimento di altri URL. Tuttavia, per motivi di sicurezza, vi consigliamo di limitare questa configurazione solo ai domini che ne hanno strettamente bisogno.<\/p>\n Salvate le modifiche al file network_security_config.xml<\/strong> e tornate alla directory manifests<\/em>. Affinch\u00e9 la configurazione della sicurezza di rete funzioni, dovrete modificare nuovamente AndroidManifest.xml<\/strong>.<\/p>\n Aprite il file e cercate il sottoelemento Application<\/strong>. Quindi, aggiungete la seguente riga di codice all’interno dei suoi tag:<\/p>\n Chiudete AndroidManifest.xml<\/strong> dopo aver salvato le modifiche al file e il gioco \u00e8 fatto. La vostra applicazione dovrebbe ora abilitare il cleartext per il dominio specificato.<\/p>\n La soluzione pi\u00f9 sicura all’errore NET::ERR_CLEARTEXT_NOT_PERMITTED consiste nel configurare il sito web che restituisce il messaggio di errore in modo che utilizzi HTTPS<\/a>. In questo modo, tutti i dati trasmessi da e verso il sito web saranno criptati.<\/p>\n Al giorno d’oggi, non c’\u00e8 motivo di non <\/em>utilizzare l’HTTPS per il proprio sito web. Si pu\u00f2 ottenere gratuitamente un certificato Secure Sockets Layer (SSL)<\/a> e impostarlo sul proprio sito in pochi minuti. Infatti, alcuni web host (come Kinsta) possono occuparsi dell’intero processo per voi.<\/p>\n Quando vi iscrivete a un piano di hosting Kinsta, configuriamo noi automaticamente un certificato SSL per il vostro sito web. Inoltre, \u00e8 possibile forzare il caricamento del vostro sito web tramite HTTPS dal vostro cruscotto MyKinsta.<\/p>\n Per farlo, accedete a MyKinsta, selezionate un sito web e andate alla scheda Strumenti <\/strong>. Cercate l’opzione Forza HTTPS <\/strong>e cliccate su Attiva<\/strong>:<\/p>\n Se non utilizzate Kinsta, potete modificare il file .htaccess<\/strong> di WordPress per reindirizzare il traffico HTTP attraverso HTTPS<\/a> oppure utilizzare un plugin che faccia il lavoro per voi. Se optate per quest’ultima soluzione, vi consigliamo di utilizzare il plugin Really Simple SSL<\/a>.<\/p>\n Consultate questo articolo per le istruzioni su come reindirizzare HTTP a HTTPS<\/a> su Nginx e Apache<\/a> e sull’uso del plugin in questione. Dopo aver configurato il sito web per utilizzare l’HTTPS, non dovreste pi\u00f9 imbattervi nell’errore NET::ERR_CLEARTEXT_NOT_PERMITTED quando utilizzate Android Webview per navigare.<\/p>\n\n Se vi capita di imbattervi nell’errore NET::ERR_CLEARTEXT_NOT_PERMITTED in Android, significa che l’applicazione che state utilizzando sta cercando di accedere a una pagina web che vuole trasmettere informazioni in chiaro o non protette. Android impedisce alle app di farlo per evitare di compromettere i dati degli utenti.<\/p>\n Se siete dei normali utenti, dovrete utilizzare un browser per visitare il sito web che restituisce l’errore. Tuttavia, se siete gli sviluppatori dell’app o del sito web, potete provare a modificare il file AndroidManifest.xml<\/strong>, ad abilitare il dominio tramite il file network_security_config.xml<\/strong> e a forzare il sito web all’uso di HTTPS.<\/p>\n Gli utenti di Kinsta hanno molte meno probabilit\u00e0 di incorrere nell’errore NET::ERR_CLEARTEXT_NOT_PERMITTED per i propri siti web. Questo perch\u00e9 configuriamo automaticamente i certificati SSL per i nuovi siti web e consentiamo di reindirizzare il traffico tramite HTTPS con pochi clic. Date un’occhiata ai nostri piani di web hosting<\/a> o di hosting di applicazioni <\/a> per trovare quello pi\u00f9 adatto a voi!<\/p>\n","protected":false},"excerpt":{"rendered":" Se utilizzate Android, potreste imbattervi nell’errore NET::ERR_CLEARTEXT_NOT_PERMITTED mentre cercate di accedere a un sito o a un’applicazione web. Questo errore vi impedisce di accedere al sito, …<\/p>\n","protected":false},"author":117,"featured_media":64868,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kinsta_gated_content":false,"_kinsta_gated_content_redirect":"","footnotes":""},"tags":[],"topic":[],"class_list":["post-64867","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry"],"yoast_head":"\n![\"Android](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/android-webview.png\")
Cosa Significa NET::ERR_CLEARTEXT_NOT_PERMITTED?<\/h2>\n
![\"L'errore](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/cleartext-not-permitted.png\")
Cosa Causa il Messaggio NET::ERR_CLEARTEXT_NOT_PERMITTED?<\/h2>\n
Come Risolvere l’Errore “NET::ERR_CLEARTEXT_NOT_PERMITTED” (3 Metodi)<\/h2>\n
1. Modificare 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. Consentire l’Accesso al Dominio Utilizzando 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. Forzare il Sito Web a Usare l’HTTPS<\/h3>\n
![\"Forzare](\"https:\/\/kinsta.com\/wp-content\/uploads\/2023\/01\/force-https.png\")
Riepilogo<\/h2>\n