Mercurial > prosody-wiki
annotate mod_s2s_auth_fingerprint.wiki @ 404:37502ad2fcb8
Edited wiki page mod_register_json through web user interface.
| author | maranda3985@gmail.com |
|---|---|
| date | Tue, 12 Nov 2013 15:35:42 +0000 |
| parents | c35cf2a46b78 |
| children | dc20cb1bb874 |
| rev | line source |
|---|---|
| 330 | 1 #summary Fingerprint based s2s authentication |
| 2 | |
| 3 = Introduction = | |
| 4 | |
| 5 This module allows you to explicitly say that you trust remote servers if they show a certificate with a known fingerprint. | |
|
399
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
6 This is useful if you have many connections to servers that use self-signed certificates. |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
7 |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
8 = Details = |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
9 |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
10 In the default mode, the module will only mark connections as trusted *if* their certificate matches one of the fingerprints listed. |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
11 If it doesn't match, the status of the standard PKIX and identity validation is preserved. |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
12 Thus it is easy to switch from a self-signed certificate to a CA-signed certificate. |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
13 |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
14 The module has an optional mode in which it will reject listed servers that don't match one of the listed fingerprints, aka certificate pinning. |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
15 Servers not listed in the configuration are not affected. |
| 330 | 16 |
| 17 = Configuration = | |
| 18 | |
|
363
4a39ef28e2d9
slight change and fix syntax error in example config
Kim Alvefur <zash@zash.se>
parents:
330
diff
changeset
|
19 After installing and enabling this module, you can put SHA-1 fingerprints of remote servers in your config like this: |
| 330 | 20 |
| 21 {{{ | |
| 22 s2s_trusted_fingerprints = { | |
|
363
4a39ef28e2d9
slight change and fix syntax error in example config
Kim Alvefur <zash@zash.se>
parents:
330
diff
changeset
|
23 ["jabber.org"] = "11:C2:3D:87:3F:95:F8:13:F8:CA:81:33:71:36:A7:00:E0:01:95:ED"; |
| 330 | 24 ["matthewwild.co.uk"] = { |
| 25 "FD:7F:B2:B9:4C:C4:CB:E2:E7:48:FB:0D:98:11:C7:D8:4D:2A:62:AA"; | |
| 26 "CF:F3:EC:43:A9:D5:D1:4D:D4:57:09:55:52:BC:5D:73:06:1A:A1:A0"; | |
| 27 }; | |
| 28 } | |
| 29 }}} | |
| 30 | |
|
399
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
31 To enable certificate pinning mode, set {{{s2s_pin_fingerprints = true}}} |
|
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
32 |
| 330 | 33 = Compatibility = |
| 34 | |
| 35 ||trunk||Works|| | |
| 36 ||0.9||Works|| | |
|
399
c35cf2a46b78
mod_s2s_auth_fingerprint: Describe cert pinning mode
Kim Alvefur <zash@zash.se>
parents:
363
diff
changeset
|
37 ||0.8||Doesn't work|| |
| 330 | 38 |