From 1fc513cef006b33923a47bb6c2594e291fa4823c Mon Sep 17 00:00:00 2001
From: Shivaram Lingamneni <slingamn@cs.stanford.edu>
Date: Wed, 7 Apr 2021 23:13:20 -0400
Subject: [PATCH] document SNI

---
 default.yaml     |  2 ++
 docs/MANUAL.md   | 15 +++++++++++++++
 traditional.yaml |  2 ++
 3 files changed, 19 insertions(+)

diff --git a/default.yaml b/default.yaml
index bb785fb8..87a91a57 100644
--- a/default.yaml
+++ b/default.yaml
@@ -49,6 +49,8 @@ server:
 
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
         ":6697":
+            # this is a standard TLS configuration with a single certificate;
+            # see the manual for instructions on how to configure SNI
             tls:
                 cert: fullchain.pem
                 key: privkey.pem
diff --git a/docs/MANUAL.md b/docs/MANUAL.md
index 3a40d1cf..94bda532 100644
--- a/docs/MANUAL.md
+++ b/docs/MANUAL.md
@@ -49,6 +49,7 @@ _Copyright © Daniel Oaks <daniel@danieloaks.net>, Shivaram Lingamneni <slingamn
     - [Redirect from plaintext to TLS](#how-can-i-redirect-users-from-plaintext-to-tls)
     - [Reverse proxies](#reverse-proxies)
     - [Client certificates](#client-certificates)
+    - [SNI](#sni)
 - [Modes](#modes)
     - [User Modes](#user-modes)
     - [Channel Modes](#channel-modes)
@@ -606,6 +607,20 @@ Oragono supports authenticating to user accounts via TLS client certificates. Th
 
 Client certificates are not supported over websockets due to a [Chrome bug](https://bugs.chromium.org/p/chromium/issues/detail?id=329884).
 
+## SNI
+
+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:
+
+```yaml
+        ":6697":
+            tls-certificates:
+                -
+                    cert: cert1.pem
+                    key:  key1.pem
+                -
+                    cert: cert2.pem
+                    key:  key2.pem
+```
 
 --------------------------------------------------------------------------------------------
 
diff --git a/traditional.yaml b/traditional.yaml
index 3dc24556..47601ac4 100644
--- a/traditional.yaml
+++ b/traditional.yaml
@@ -23,6 +23,8 @@ server:
 
         # The standard SSL/TLS port for IRC is 6697. This will listen on all interfaces:
         ":6697":
+            # this is a standard TLS configuration with a single certificate;
+            # see the manual for instructions on how to configure SNI
             tls:
                 cert: fullchain.pem
                 key: privkey.pem