Skip to content

Commit

Permalink
README: Add information about copying TLS certificates
Browse files Browse the repository at this point in the history
Signed-off-by: Robert Foss <[email protected]>
  • Loading branch information
Robert Foss committed Jan 1, 2019
1 parent e2dc10b commit b88bf85
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,42 @@ sending `accounts add-existing $PROTOCOL $USERNAME` where the protocol and usern

You should also run `accounts enable $PROTOCOL $USERNAME` to enable the account for the bridge, and then it should connect automatically.


#### Bridging XMPP room

##### Installing TLS certificates
If you're having issues connecting, consider enabling debug in `config.yaml`
```
purple:
enableDebug: true
```
Restart the appservice using `start.sh`.
```
(12:36:54) nss: subject=CN=jabber.ccc.de issuer=CN=Let's Encrypt Authority X3,O=Let's Encrypt,C=US
(12:36:54) nss: subject=CN=Let's Encrypt Authority X3,O=Let's Encrypt,C=US issuer=CN=DST Root CA X3,O=Digital Signature Trust Co.
(12:36:54) nss: partial certificate chain
(12:36:54) certificate/x509/tls_cached: Starting verify for jabber.ccc.de
(12:36:54) certificate/x509/tls_cached: Checking for cached cert...
(12:36:54) certificate/x509/tls_cached: ...Not in cache
(12:36:54) certificate/x509/ca: Couldn't open location '/usr/local/share/purple/ca-certs'
(12:36:54) certificate/x509/ca: Lazy init completed.
(12:36:54) nss: CERT 1. CN=Let's Encrypt Authority X3,O=Let's Encrypt,C=US [Certificate Authority]:
(12:36:54) nss: ERROR -8179: SEC_ERROR_UNKNOWN_ISSUER
```

```
If you're seeing issues like the ones above, consider installing the correct TLS certificates.
In my case the Let's Encrypt certificates.
```
mkdir -p /usr/local/share/purple/ca-certs
cd /usr/local/share/purple/ca-certs
wget https://letsencrypt.org/certs/isrgrootx1.pem
wget https://letsencrypt.org/certs/letsencryptauthorityx3.pem
wget https://letsencrypt.org/certs/lets-encrypt-x3-cross-signed.pem
````
Connect to your matrix server and open a chat with `@_purple_bot:$YOUR_MATRIX_DOMAIN`.
```
accounts add-existing prpl-jabber $USERNAME@$XMPP_SERVER/$CLIENT_NAME
Expand Down

0 comments on commit b88bf85

Please sign in to comment.