| // Copyright 2009 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| // Package tls partially implements TLS 1.2, as specified in RFC 5246. |
| package runner |
| |
| import ( |
| "bytes" |
| "crypto" |
| "crypto/ecdsa" |
| "crypto/ed25519" |
| "crypto/rsa" |
| "crypto/x509" |
| "encoding/pem" |
| "errors" |
| "net" |
| "os" |
| "strings" |
| "time" |
| ) |
| |
| // Server returns a new TLS server side connection |
| // using conn as the underlying transport. |
| // The configuration config must be non-nil and must have |
| // at least one certificate. |
| func Server(conn net.Conn, config *Config) *Conn { |
| c := &Conn{conn: conn, config: config} |
| c.init() |
| return c |
| } |
| |
| // Client returns a new TLS client side connection |
| // using conn as the underlying transport. |
| // The config cannot be nil: users must set either ServerHostname or |
| // InsecureSkipVerify in the config. |
| func Client(conn net.Conn, config *Config) *Conn { |
| c := &Conn{conn: conn, config: config, isClient: true} |
| c.init() |
| return c |
| } |
| |
| // A listener implements a network listener (net.Listener) for TLS connections. |
| type listener struct { |
| net.Listener |
| config *Config |
| } |
| |
| // Accept waits for and returns the next incoming TLS connection. |
| // The returned connection c is a *tls.Conn. |
| func (l *listener) Accept() (c net.Conn, err error) { |
| c, err = l.Listener.Accept() |
| if err != nil { |
| return |
| } |
| c = Server(c, l.config) |
| return |
| } |
| |
| // NewListener creates a Listener which accepts connections from an inner |
| // Listener and wraps each connection with Server. |
| // The configuration config must be non-nil and must have |
| // at least one certificate. |
| func NewListener(inner net.Listener, config *Config) net.Listener { |
| l := new(listener) |
| l.Listener = inner |
| l.config = config |
| return l |
| } |
| |
| // Listen creates a TLS listener accepting connections on the |
| // given network address using net.Listen. |
| // The configuration config must be non-nil and must have |
| // at least one certificate. |
| func Listen(network, laddr string, config *Config) (net.Listener, error) { |
| if config == nil || config.Credential == nil { |
| return nil, errors.New("tls.Listen: no certificates in configuration") |
| } |
| l, err := net.Listen(network, laddr) |
| if err != nil { |
| return nil, err |
| } |
| return NewListener(l, config), nil |
| } |
| |
| type timeoutError struct{} |
| |
| func (timeoutError) Error() string { return "tls: DialWithDialer timed out" } |
| func (timeoutError) Timeout() bool { return true } |
| func (timeoutError) Temporary() bool { return true } |
| |
| // DialWithDialer connects to the given network address using dialer.Dial and |
| // then initiates a TLS handshake, returning the resulting TLS connection. Any |
| // timeout or deadline given in the dialer apply to connection and TLS |
| // handshake as a whole. |
| // |
| // DialWithDialer interprets a nil configuration as equivalent to the zero |
| // configuration; see the documentation of Config for the defaults. |
| func DialWithDialer(dialer *net.Dialer, network, addr string, config *Config) (*Conn, error) { |
| // We want the Timeout and Deadline values from dialer to cover the |
| // whole process: TCP connection and TLS handshake. This means that we |
| // also need to start our own timers now. |
| timeout := dialer.Timeout |
| |
| if !dialer.Deadline.IsZero() { |
| deadlineTimeout := dialer.Deadline.Sub(time.Now()) |
| if timeout == 0 || deadlineTimeout < timeout { |
| timeout = deadlineTimeout |
| } |
| } |
| |
| var errChannel chan error |
| |
| if timeout != 0 { |
| errChannel = make(chan error, 2) |
| time.AfterFunc(timeout, func() { |
| errChannel <- timeoutError{} |
| }) |
| } |
| |
| rawConn, err := dialer.Dial(network, addr) |
| if err != nil { |
| return nil, err |
| } |
| |
| colonPos := strings.LastIndex(addr, ":") |
| if colonPos == -1 { |
| colonPos = len(addr) |
| } |
| hostname := addr[:colonPos] |
| |
| if config == nil { |
| config = defaultConfig() |
| } |
| // If no ServerName is set, infer the ServerName |
| // from the hostname we're connecting to. |
| if config.ServerName == "" { |
| // Make a copy to avoid polluting argument or default. |
| c := *config |
| c.ServerName = hostname |
| config = &c |
| } |
| |
| conn := Client(rawConn, config) |
| |
| if timeout == 0 { |
| err = conn.Handshake() |
| } else { |
| go func() { |
| errChannel <- conn.Handshake() |
| }() |
| |
| err = <-errChannel |
| } |
| |
| if err != nil { |
| rawConn.Close() |
| return nil, err |
| } |
| |
| return conn, nil |
| } |
| |
| // Dial connects to the given network address using net.Dial |
| // and then initiates a TLS handshake, returning the resulting |
| // TLS connection. |
| // Dial interprets a nil configuration as equivalent to |
| // the zero configuration; see the documentation of Config |
| // for the defaults. |
| func Dial(network, addr string, config *Config) (*Conn, error) { |
| return DialWithDialer(new(net.Dialer), network, addr, config) |
| } |
| |
| // LoadX509KeyPair reads and parses a public/private key pair from a pair of |
| // files. The files must contain PEM encoded data. |
| func LoadX509KeyPair(certFile, keyFile string) (cert Credential, err error) { |
| certPEMBlock, err := os.ReadFile(certFile) |
| if err != nil { |
| return |
| } |
| keyPEMBlock, err := os.ReadFile(keyFile) |
| if err != nil { |
| return |
| } |
| return X509KeyPair(certPEMBlock, keyPEMBlock) |
| } |
| |
| // X509KeyPair parses a public/private key pair from a pair of |
| // PEM encoded data. |
| func X509KeyPair(certPEMBlock, keyPEMBlock []byte) (cert Credential, err error) { |
| var certDERBlock *pem.Block |
| for { |
| certDERBlock, certPEMBlock = pem.Decode(certPEMBlock) |
| if certDERBlock == nil { |
| break |
| } |
| if certDERBlock.Type == "CERTIFICATE" { |
| cert.Certificate = append(cert.Certificate, certDERBlock.Bytes) |
| } |
| } |
| |
| if len(cert.Certificate) == 0 { |
| err = errors.New("crypto/tls: failed to parse certificate PEM data") |
| return |
| } |
| |
| var keyDERBlock *pem.Block |
| for { |
| keyDERBlock, keyPEMBlock = pem.Decode(keyPEMBlock) |
| if keyDERBlock == nil { |
| err = errors.New("crypto/tls: failed to parse key PEM data") |
| return |
| } |
| if keyDERBlock.Type == "PRIVATE KEY" || strings.HasSuffix(keyDERBlock.Type, " PRIVATE KEY") { |
| break |
| } |
| } |
| |
| cert.PrivateKey, err = parsePrivateKey(keyDERBlock.Bytes) |
| if err != nil { |
| return |
| } |
| |
| // We don't need to parse the public key for TLS, but we so do anyway |
| // to check that it looks sane and matches the private key. |
| x509Cert, err := x509.ParseCertificate(cert.Certificate[0]) |
| if err != nil { |
| return |
| } |
| |
| switch pub := x509Cert.PublicKey.(type) { |
| case *rsa.PublicKey: |
| priv, ok := cert.PrivateKey.(*rsa.PrivateKey) |
| if !ok { |
| err = errors.New("crypto/tls: private key type does not match public key type") |
| return |
| } |
| if pub.N.Cmp(priv.N) != 0 { |
| err = errors.New("crypto/tls: private key does not match public key") |
| return |
| } |
| case *ecdsa.PublicKey: |
| priv, ok := cert.PrivateKey.(*ecdsa.PrivateKey) |
| if !ok { |
| err = errors.New("crypto/tls: private key type does not match public key type") |
| return |
| |
| } |
| if pub.X.Cmp(priv.X) != 0 || pub.Y.Cmp(priv.Y) != 0 { |
| err = errors.New("crypto/tls: private key does not match public key") |
| return |
| } |
| case ed25519.PublicKey: |
| priv, ok := cert.PrivateKey.(ed25519.PrivateKey) |
| if !ok { |
| err = errors.New("crypto/tls: private key type does not match public key type") |
| return |
| } |
| if !bytes.Equal(priv[32:], pub) { |
| err = errors.New("crypto/tls: private key does not match public key") |
| return |
| } |
| default: |
| err = errors.New("crypto/tls: unknown public key algorithm") |
| return |
| } |
| |
| return |
| } |
| |
| // Attempt to parse the given private key DER block. OpenSSL 0.9.8 generates |
| // PKCS#1 private keys by default, while OpenSSL 1.0.0 generates PKCS#8 keys. |
| // OpenSSL ecparam generates SEC1 EC private keys for ECDSA. We try all three. |
| func parsePrivateKey(der []byte) (crypto.PrivateKey, error) { |
| if key, err := x509.ParsePKCS1PrivateKey(der); err == nil { |
| return key, nil |
| } |
| if key, err := x509.ParsePKCS8PrivateKey(der); err == nil { |
| switch key := key.(type) { |
| case *rsa.PrivateKey, *ecdsa.PrivateKey, ed25519.PrivateKey: |
| return key, nil |
| default: |
| return nil, errors.New("crypto/tls: found unknown private key type in PKCS#8 wrapping") |
| } |
| } |
| if key, err := x509.ParseECPrivateKey(der); err == nil { |
| return key, nil |
| } |
| |
| return nil, errors.New("crypto/tls: failed to parse private key") |
| } |