Skip to content

Commit

Permalink
Adding faq on SSL/TLS config (#310)
Browse files Browse the repository at this point in the history
* Adding faq on SSL/TLS

* Fixing typo

* Update docs/faq.asciidoc

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>

* Update docs/faq.asciidoc

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>

* Update docs/faq.asciidoc

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>

* Update docs/faq.asciidoc

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>

---------

Co-authored-by: Brandon Morelli <brandon.morelli@elastic.co>
  • Loading branch information
LikeTheSalad and bmorelli25 authored May 17, 2024
1 parent 7838098 commit 3087a50
Showing 1 changed file with 41 additions and 0 deletions.
41 changes: 41 additions & 0 deletions docs/faq.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,47 @@ It is created by a Java Champion, awarded with the Dukes Choice award and curren
Unlike other bytecode instrumentation libraries, Byte Buddy is designed so that it is impossible to corrupt the bytecode of instrumented classes.
It also respects other transformations applied to your application at the same time.

[float]
[[faq-ssl]]
=== How can I configure SSL/TLS?

Please note that the Elastic Agent does not handle SSL/TLS configs internally, therefore, the recommended way to manage these types of configurations is by doing so as part of your app's network security configurations, as explained in Android's official https://developer.android.com/privacy-and-security/security-ssl[security guidelines].
Below we show a set of common use-cases and quick tips on what could be done on each one, however, each case might be different, so please refer to Android's https://developer.android.com/privacy-and-security/security-config[official docs] on this topic in case you need more details.

[float]
[[faq-ssl-elastic-cloud]]
==== Connecting to Elastic Cloud

If your Elastic Stack is hosted in Elastic Cloud, you shouldn't need to add any SSL/TLS config changes in your app, it should work out of the box.

[float]
[[faq-ssl-on-prem]]
==== Connecting to an on-prem server

If your Elastic Stack is hosted on-prem, then it depends on the type of CA your host uses to sign its certificates, if it's a commonly trusted CA, then you shouldn't have to worry about changing your app's SSL/TLS configuration as it all should work well out of the box, however, if your CAs are unknown/private or your server uses a self-signed certificate, then you would need to configure your app to trust custom CAs by following https://developer.android.com/privacy-and-security/security-config[Android's guide on it].

[float]
[[faq-ssl-debug]]
==== Debugging purposes

If you're running a local server and need to connect to it without using https in order to run a quick test, then you could temporarily https://developer.android.com/guide/topics/manifest/application-element#usesCleartextTraffic[enable cleartext traffic] within your `AndroidManifest.xml` file, inside the `<application>` tag.
As shown below:

[source,xml]
----
<application
...
android:usesCleartextTraffic="true">
...
</application>
----

NOTE: You should only enable cleartext traffic for debugging purposes and not for production code.

If enabling cleartext traffic isn't a valid option for your debugging use-case, you should refer to Android's guide on https://developer.android.com/privacy-and-security/security-config#TrustingDebugCa[configuring CAs for debugging].

For more information on how Android handles network security, please refer to the official https://developer.android.com/privacy-and-security/security-ssl[Android docs on it].

[float]
[[faq-unsupported-technologies]]
=== What if the agent doesn't support the technologies I'm using?
Expand Down

0 comments on commit 3087a50

Please sign in to comment.