maddy

 1/*
 2Maddy Mail Server - Composable all-in-one email server.
 3Copyright © 2019-2020 Max Mazurov <fox.cpp@disroot.org>, Maddy Mail Server contributors
 4
 5This program is free software: you can redistribute it and/or modify
 6it under the terms of the GNU General Public License as published by
 7the Free Software Foundation, either version 3 of the License, or
 8(at your option) any later version.
 9
10This program is distributed in the hope that it will be useful,
11but WITHOUT ANY WARRANTY; without even the implied warranty of
12MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13GNU General Public License for more details.
14
15You should have received a copy of the GNU General Public License
16along with this program.  If not, see <https://www.gnu.org/licenses/>.
17*/
18
19package module
20
21import (
22	"crypto/tls"
23)
24
25// TLSLoader interface is module interface that can be used to supply TLS
26// certificates to TLS-enabled endpoints.
27//
28// The interface is intentionally kept simple, all configuration and parameters
29// necessary are to be provided using conventional module configuration.
30//
31// If loader returns multiple certificate chains - endpoint will serve them
32// based on SNI matching.
33//
34// Note that loading function will be called for each connections - it is
35// highly recommended to cache parsed form.
36//
37// Modules implementing this interface should be registered with prefix
38// "tls.loader." in name.
39type TLSLoader interface {
40	ConfigureTLS(c *tls.Config) error
41}