Browse Source

document SNI

tags/v2.6.0-rc1
Shivaram Lingamneni 3 years ago
parent
commit
1fc513cef0
3 changed files with 19 additions and 0 deletions
  1. 2
    0
      default.yaml
  2. 15
    0
      docs/MANUAL.md
  3. 2
    0
      traditional.yaml

+ 2
- 0
default.yaml View File

49
 
49
 
50
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
50
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
51
         ":6697":
51
         ":6697":
52
+            # this is a standard TLS configuration with a single certificate;
53
+            # see the manual for instructions on how to configure SNI
52
             tls:
54
             tls:
53
                 cert: fullchain.pem
55
                 cert: fullchain.pem
54
                 key: privkey.pem
56
                 key: privkey.pem

+ 15
- 0
docs/MANUAL.md View File

49
     - [Redirect from plaintext to TLS](#how-can-i-redirect-users-from-plaintext-to-tls)
49
     - [Redirect from plaintext to TLS](#how-can-i-redirect-users-from-plaintext-to-tls)
50
     - [Reverse proxies](#reverse-proxies)
50
     - [Reverse proxies](#reverse-proxies)
51
     - [Client certificates](#client-certificates)
51
     - [Client certificates](#client-certificates)
52
+    - [SNI](#sni)
52
 - [Modes](#modes)
53
 - [Modes](#modes)
53
     - [User Modes](#user-modes)
54
     - [User Modes](#user-modes)
54
     - [Channel Modes](#channel-modes)
55
     - [Channel Modes](#channel-modes)
606
 
607
 
607
 Client certificates are not supported over websockets due to a [Chrome bug](https://bugs.chromium.org/p/chromium/issues/detail?id=329884).
608
 Client certificates are not supported over websockets due to a [Chrome bug](https://bugs.chromium.org/p/chromium/issues/detail?id=329884).
608
 
609
 
610
+## SNI
611
+
612
+Oragono supports [SNI](https://en.wikipedia.org/wiki/Server_Name_Indication); this is useful if you have multiple domain names for your server, with different certificates covering different domain names. Configure your TLS listener like this:
613
+
614
+```yaml
615
+        ":6697":
616
+            tls-certificates:
617
+                -
618
+                    cert: cert1.pem
619
+                    key:  key1.pem
620
+                -
621
+                    cert: cert2.pem
622
+                    key:  key2.pem
623
+```
609
 
624
 
610
 --------------------------------------------------------------------------------------------
625
 --------------------------------------------------------------------------------------------
611
 
626
 

+ 2
- 0
traditional.yaml View File

23
 
23
 
24
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
24
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
25
         ":6697":
25
         ":6697":
26
+            # this is a standard TLS configuration with a single certificate;
27
+            # see the manual for instructions on how to configure SNI
26
             tls:
28
             tls:
27
                 cert: fullchain.pem
29
                 cert: fullchain.pem
28
                 key: privkey.pem
30
                 key: privkey.pem

Loading…
Cancel
Save