Mercurial > prosody-wiki

annotate mod_s2s_auth_fingerprint.wiki @ 403:6c54b5a7ccfb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Document ldap_scope
author Kim Alvefur <zash@zash.se>
date Mon, 04 Nov 2013 17:44:29 +0100
parents c35cf2a46b78
children dc20cb1bb874
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
330
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
1 #summary Fingerprint based s2s authentication
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
2
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
3 = Introduction =
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
4
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
16
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
17 = Configuration =
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
20
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
21 {{{
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
24 ["matthewwild.co.uk"] = {
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
25 "FD:7F:B2:B9:4C:C4:CB:E2:E7:48:FB:0D:98:11:C7:D8:4D:2A:62:AA";
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
26 "CF:F3:EC:43:A9:D5:D1:4D:D4:57:09:55:52:BC:5D:73:06:1A:A1:A0";
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
27 };
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
28 }
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
29 }}}
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
33 = Compatibility =
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
34
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
35 ||trunk||Works||
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
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
533a06d9b6db added mod_s2s_auth_fingerprint.wiki
Kim Alvefur <zash@zash.se>
parents:
diff changeset
38