You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by GitBox <gi...@apache.org> on 2020/01/06 15:53:18 UTC

[GitHub] [cordova-docs] mosabab opened a new pull request #1050: usesCleartextTraffic information

mosabab opened a new pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050
 
 
   The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
   
   <!--
   Please make sure the checklist boxes are all checked before submitting the PR. The checklist is intended as a quick reference, for complete details please see our Contributor Guidelines:
   
   http://cordova.apache.org/contribute/contribute_guidelines.html
   
   Thanks!
   -->
   
   ### Platforms affected
   Android
   
   
   ### Motivation and Context
   <!-- Why is this change required? What problem does it solve? -->
   <!-- If it fixes an open issue, please link to the issue here. -->
   After upgrading to Cordova Android 8.0, you will see the error: net::ERR_CLEARTEXT_NOT_PERMITTED errors when trying to connect to http:// targets on external websites
   
   
   ### Checklist
   
   - [x] I've run the tests to see all new and existing tests pass
   - [x] I added automated test coverage as appropriate for this change
   - [x] Commit is prefixed with `(platform)` if this change only applies to one platform (e.g. `(android)`)
   - [x] If this Pull Request resolves an issue, I linked to the issue in the text above (and used the correct [keyword to close issues using keywords](https://help.github.com/articles/closing-issues-using-keywords/))
   - [x] I've updated the documentation if necessary
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r363371697
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,22 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+Indicates whether the app intends to use cleartext network traffic, such as cleartext HTTP. The default value for apps that target API level 27 or lower is "true". Apps that target API level 28 or higher default to "false".
+When the attribute is set to "false", platform components (for example, HTTP and FTP stacks, DownloadManager, and MediaPlayer) will refuse the app’s requests to use cleartext traffic. Third-party libraries are strongly encouraged to honor this setting as well. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected.
 
 Review comment:
   ```suggestion
   When the attribute is set to "false", for example, HTTP and FTP will refuse the app’s requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected.
   ```
   
   I thinkt this would make it easier for Cordova app developers to understand.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r392604545
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,26 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` or any other android application elements setting in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/application-element).
+
+To allow clear text communication again, set the `android:usesCleartextTraffic` on your application tag to true in `config.xml` file:
+```xml
+<platform name="android">
+  <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
+      <application android:usesCleartextTraffic="true" />
+  </edit-config>
+</platform>
+
 
 Review comment:
   Oops, maybe I messed up in my last suggestion, but the block end is missing after the `</platform>`
   
   We should have a ``` after `<platform>`
   
   The reason this is necessary is because without the ending ```, we are making the rest of the document a pre-formatted block.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] mosabab commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
mosabab commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r363377712
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,22 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+Indicates whether the app intends to use cleartext network traffic, such as cleartext HTTP. The default value for apps that target API level 27 or lower is "true". Apps that target API level 28 or higher default to "false".
+When the attribute is set to "false", platform components (for example, HTTP and FTP stacks, DownloadManager, and MediaPlayer) will refuse the app’s requests to use cleartext traffic. Third-party libraries are strongly encouraged to honor this setting as well. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected.
 
 Review comment:
   looks good to me.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r363498110
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,22 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+Indicates whether the app intends to use cleartext network traffic, such as cleartext HTTP. The default value for apps that target API level 27 or lower is "true". Apps that target API level 28 or higher default to "false".
 
 Review comment:
   ```suggestion
   
   ```
   This might be confusing in this context. Better link to the Android docs below.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599215855
 
 
   > good now ?
   
   There was a small mistake in the last commit. See https://github.com/apache/cordova-docs/pull/1050#discussion_r392604545

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] mosabab commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
mosabab commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-571586057
 
 
   Looks better now

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek merged pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek merged pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050
 
 
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r363501694
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,22 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+Indicates whether the app intends to use cleartext network traffic, such as cleartext HTTP. The default value for apps that target API level 27 or lower is "true". Apps that target API level 28 or higher default to "false".
+When the attribute is set to "false", for example, HTTP and FTP will refuse the app’s requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected.
 
 Review comment:
   ```suggestion
   By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` setting in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/application-element).
   ```
   
   Sorry for the next suggestions. I always find something while proofreading a second time. I want to make sure this setting is properly explained  and attributed with it's security implications.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599237564
 
 
   will do

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] mosabab commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
mosabab commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599237010
 
 
   > Sorry, it's still not quite right. I think the ending ``` needs to be on its own line.
   > 
   > As you can see in the screenshot below, the preformatted text is extending to the remainder of the document.
   > 
   > ![Screenshot_2020-03-15_13-55-23](https://user-images.githubusercontent.com/11200662/76706250-d74d1e00-66c4-11ea-9ac4-1e9a0dc0d346.png)
   
   Could you please solve it from your side, because this come confused to me.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
NiklasMerz commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r363502435
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,22 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+Indicates whether the app intends to use cleartext network traffic, such as cleartext HTTP. The default value for apps that target API level 27 or lower is "true". Apps that target API level 28 or higher default to "false".
+When the attribute is set to "false", for example, HTTP and FTP will refuse the app’s requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected.
 
 Review comment:
   Is it better to link the Android docs here? Open for opinions.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] mosabab commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
mosabab commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-571601318
 
 
   @NiklasMerz 
   
   I added another information about Android Manifest information as global resource for android manifest info., please check it and review it if it need other info or edit.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599238092
 
 
   All checks passed, merged and thank you for your contribution :tada: 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r392604545
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,26 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` or any other android application elements setting in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/application-element).
+
+To allow clear text communication again, set the `android:usesCleartextTraffic` on your application tag to true in `config.xml` file:
+```xml
+<platform name="android">
+  <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
+      <application android:usesCleartextTraffic="true" />
+  </edit-config>
+</platform>
+
 
 Review comment:
   Oops, maybe I messed up in my last suggestion, but the block end is missing after the `</platform>`
   
   We should have a ``` after `<platform>`
   
   Without the ending ```, we are making the rest of the document a pre-formatted block.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r392602587
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,25 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` or any other android application elements setting in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/application-element).
+
+To allow clear text communication again, set the `android:usesCleartextTraffic` on your application tag to true in `config.xml` file:
+`<platform name="android">
+  <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
+      <application android:usesCleartextTraffic="true" />
+  </edit-config>
+</platform>`
 
 Review comment:
   I think this is intended to be a preformatted block
   ```suggestion
   ```xml
   <platform name="android">
     <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
         <application android:usesCleartextTraffic="true" />
     </edit-config>
   </platform>
   ```
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599236552
 
 
   Sorry, it's still not quite right. I think the ending ``` needs to be on its own line.
   
   As you can see in the screenshot below, the preformatted text is extending to the remainder of the document.
   
   ![Screenshot_2020-03-15_13-55-23](https://user-images.githubusercontent.com/11200662/76706250-d74d1e00-66c4-11ea-9ac4-1e9a0dc0d346.png)

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] mosabab commented on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
mosabab commented on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599235303
 
 
   > > good now ?
   > 
   > There was a small mistake in the last commit. See [#1050 (comment)](https://github.com/apache/cordova-docs/pull/1050#discussion_r392604545)
   
   I update this , please take a look.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek edited a comment on issue #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek edited a comment on issue #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#issuecomment-599237564
 
 
   will do.
   
   As soon as the checks are completed, I'll merge given there are 2 other approval votes.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


[GitHub] [cordova-docs] breautek commented on a change in pull request #1050: usesCleartextTraffic information

Posted by GitBox <gi...@apache.org>.
breautek commented on a change in pull request #1050: usesCleartextTraffic information
URL: https://github.com/apache/cordova-docs/pull/1050#discussion_r392604545
 
 

 ##########
 File path: www/docs/en/dev/guide/platforms/android/index.md
 ##########
 @@ -766,6 +766,26 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` or any other android application elements setting in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/application-element).
+
+To allow clear text communication again, set the `android:usesCleartextTraffic` on your application tag to true in `config.xml` file:
+```xml
+<platform name="android">
+  <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
+      <application android:usesCleartextTraffic="true" />
+  </edit-config>
+</platform>
+
 
 Review comment:
   Oops, maybe I messed up in my last suggestion, but the block end is missing after the `</platform>`
   
   We should have a ``` after `<platform>`

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org