]> git.basschouten.com Git - openhab-addons.git/commitdiff
[influxdb] Add docs for usage of self-signed certs (#14228)
authorFlorian Hotze <florianh_dev@icloud.com>
Sun, 15 Jan 2023 22:55:42 +0000 (23:55 +0100)
committerGitHub <noreply@github.com>
Sun, 15 Jan 2023 22:55:42 +0000 (23:55 +0100)
* [influxdb] Add docs for usage of self-signed certs

See
https://community.openhab.org/t/influxdb-persistence-doesnt-work-with-s
sl/35409/10?u=florian-h05.

Signed-off-by: Florian Hotze <florianh_dev@icloud.com>
bundles/org.openhab.persistence.influxdb/README.md

index b9b46294a00d8c249b32561714597ffd641eb494..6cf565a33abdf6a7c75a7db318126242d3b35215 100644 (file)
@@ -106,3 +106,13 @@ Besides the metadata tags, there are additional configuration parameters to acti
 | addCategoryTag | false   | no       | Should the category of the item be included as tag "category"? If no category is set, "n/a" is used. |
 | addTypeTag     | false   | no       | Should the item type be included as tag "type"?                                                      |
 | addLabelTag    | false   | no       | Should the item label be included as tag "label"? If no label is set, "n/a" is used.                 |
+
+### Connect to InfluxDB via TLS
+
+InfluxDB supports TLS encryption to secure the communication with clients.
+
+If you use a self-signed certificate for your InfluxDB instance (which is very likely), you need to add the certificate itself or your internal CA's certificate to the Java keystore:
+
+1. Find your JVM's path with `ls -all /usr/bin/java`, e.g. `/opt/java/zulu17.38.21-ca-jdk17.0.5-linux_aarch32hf/bin/java`. You may need to follow some symlinks, use `ls -all` again.
+1. Go to the `lib/security` directory of your JVM, e.g. `cd /opt/java/zulu17.38.21-ca-jdk17.0.5-linux_aarch32hf/lib/security`.
+1. Add the certificate to the JVM's keystore: `sudo keytool -importcert -file <path-to-certfile> -cacerts -keypass changeit -storepass changeit -alias <alias-for-cert>`.