tls

Documentation

Index

• Variables
• func Client(c net.Conn, config *tls.Config) net.Conn
• func Server(c net.Conn, config *tls.Config) net.Conn
• type Certificate
  • func ParseCertificate(c *cert.Certificate) *Certificate
  • func (*Certificate) Descriptor() ([]byte, []int)
  • func (x *Certificate) GetCertificate() []byte
  • func (x *Certificate) GetKey() []byte
  • func (x *Certificate) GetUsage() Certificate_Usage
  • func (*Certificate) ProtoMessage()
  • func (x *Certificate) ProtoReflect() protoreflect.Message
  • func (x *Certificate) Reset()
  • func (x *Certificate) String() string
• type Certificate_Usage
  • func (Certificate_Usage) Descriptor() protoreflect.EnumDescriptor
  • func (x Certificate_Usage) Enum() *Certificate_Usage
  • func (Certificate_Usage) EnumDescriptor() ([]byte, []int)
  • func (x Certificate_Usage) Number() protoreflect.EnumNumber
  • func (x Certificate_Usage) String() string
  • func (Certificate_Usage) Type() protoreflect.EnumType
• type Config
  • func ConfigFromStreamSettings(settings *internet.MemoryStreamConfig) *Config
  • func (c *Config) BuildCertificates() []tls.Certificate
  • func (*Config) Descriptor() ([]byte, []int)
  • func (x *Config) GetAllowInsecure() bool
  • func (x *Config) GetAllowInsecureCiphers() bool
  • func (x *Config) GetCertificate() []*Certificate
  • func (x *Config) GetDisableSessionResumption() bool
  • func (x *Config) GetDisableSystemRoot() bool
  • func (x *Config) GetNextProtocol() []string
  • func (x *Config) GetServerName() string
  • func (c *Config) GetTLSConfig(opts ...Option) *tls.Config
  • func (c *Config) IsExperiment8357() bool
  • func (*Config) ProtoMessage()
  • func (x *Config) ProtoReflect() protoreflect.Message
  • func (x *Config) Reset()
  • func (x *Config) String() string
• type Conn
  • func (c *Conn) HandshakeAddress() net.Address
  • func (c *Conn) WriteMultiBuffer(mb buf.MultiBuffer) error
• type Option
  • func WithDestination(dest net.Destination) Option
  • func WithNextProto(protocol ...string) Option

Variables

var (
	Certificate_Usage_name = map[int32]string{
		0: "ENCIPHERMENT",
		1: "AUTHORITY_VERIFY",
		2: "AUTHORITY_ISSUE",
	}
	Certificate_Usage_value = map[string]int32{
		"ENCIPHERMENT":     0,
		"AUTHORITY_VERIFY": 1,
		"AUTHORITY_ISSUE":  2,
	}
)

Enum value maps for Certificate_Usage.

var File_transport_internet_tls_config_proto protoreflect.FileDescriptor

Functions

func Client

func Client(c net.Conn, config *tls.Config) net.Conn

Client initiates a TLS client handshake on the given connection.

func Server

func Server(c net.Conn, config *tls.Config) net.Conn

Server initiates a TLS server handshake on the given connection.

Types

type Certificate

type Certificate struct {

	// TLS certificate in x509 format.
	Certificate []byte `protobuf:"bytes,1,opt,name=Certificate,proto3" json:"Certificate,omitempty"`
	// TLS key in x509 format.
	Key   []byte            `protobuf:"bytes,2,opt,name=Key,proto3" json:"Key,omitempty"`
	Usage Certificate_Usage `protobuf:"varint,3,opt,name=usage,proto3,enum=xray.transport.internet.tls.Certificate_Usage" json:"usage,omitempty"`
	// contains filtered or unexported fields
}

func ParseCertificate

func ParseCertificate(c *cert.Certificate) *Certificate

ParseCertificate converts a cert.Certificate to Certificate.

func (*Certificate) Descriptor

func (*Certificate) Descriptor() ([]byte, []int)

Deprecated: Use Certificate.ProtoReflect.Descriptor instead.

func (*Certificate) GetCertificate

func (x *Certificate) GetCertificate() []byte

func (*Certificate) GetKey

func (x *Certificate) GetKey() []byte

func (*Certificate) GetUsage

func (x *Certificate) GetUsage() Certificate_Usage

func (*Certificate) ProtoMessage

func (*Certificate) ProtoMessage()

func (*Certificate) ProtoReflect

func (x *Certificate) ProtoReflect() protoreflect.Message

func (*Certificate) Reset

func (x *Certificate) Reset()

func (*Certificate) String

func (x *Certificate) String() string

type Certificate_Usage

type Certificate_Usage int32

const (
	Certificate_ENCIPHERMENT     Certificate_Usage = 0
	Certificate_AUTHORITY_VERIFY Certificate_Usage = 1
	Certificate_AUTHORITY_ISSUE  Certificate_Usage = 2
)

func (Certificate_Usage) Descriptor

func (Certificate_Usage) Descriptor() protoreflect.EnumDescriptor

func (Certificate_Usage) Enum

func (x Certificate_Usage) Enum() *Certificate_Usage

func (Certificate_Usage) EnumDescriptor

func (Certificate_Usage) EnumDescriptor() ([]byte, []int)

Deprecated: Use Certificate_Usage.Descriptor instead.

func (Certificate_Usage) Number

func (x Certificate_Usage) Number() protoreflect.EnumNumber

func (Certificate_Usage) String

func (x Certificate_Usage) String() string

func (Certificate_Usage) Type

func (Certificate_Usage) Type() protoreflect.EnumType

type Config

type Config struct {

	// Whether or not to allow self-signed certificates.
	AllowInsecure bool `protobuf:"varint,1,opt,name=allow_insecure,json=allowInsecure,proto3" json:"allow_insecure,omitempty"`
	// Whether or not to allow insecure cipher suites.
	AllowInsecureCiphers bool `protobuf:"varint,5,opt,name=allow_insecure_ciphers,json=allowInsecureCiphers,proto3" json:"allow_insecure_ciphers,omitempty"`
	// List of certificates to be served on server.
	Certificate []*Certificate `protobuf:"bytes,2,rep,name=certificate,proto3" json:"certificate,omitempty"`
	// Override server name.
	ServerName string `protobuf:"bytes,3,opt,name=server_name,json=serverName,proto3" json:"server_name,omitempty"`
	// Lists of string as ALPN values.
	NextProtocol []string `protobuf:"bytes,4,rep,name=next_protocol,json=nextProtocol,proto3" json:"next_protocol,omitempty"`
	// Whether or not to disable session (ticket) resumption.
	DisableSessionResumption bool `` /* 136-byte string literal not displayed */
	// If true, root certificates on the system will not be loaded for
	// verification.
	DisableSystemRoot bool `protobuf:"varint,7,opt,name=disable_system_root,json=disableSystemRoot,proto3" json:"disable_system_root,omitempty"`
	// contains filtered or unexported fields
}

func ConfigFromStreamSettings

func ConfigFromStreamSettings(settings *internet.MemoryStreamConfig) *Config

ConfigFromStreamSettings fetches Config from stream settings. Nil if not found.

func (*Config) BuildCertificates

func (c *Config) BuildCertificates() []tls.Certificate

BuildCertificates builds a list of TLS certificates from proto definition.

func (*Config) Descriptor

func (*Config) Descriptor() ([]byte, []int)

Deprecated: Use Config.ProtoReflect.Descriptor instead.

func (*Config) GetAllowInsecure

func (x *Config) GetAllowInsecure() bool

func (*Config) GetAllowInsecureCiphers

func (x *Config) GetAllowInsecureCiphers() bool

func (*Config) GetCertificate

func (x *Config) GetCertificate() []*Certificate

func (*Config) GetDisableSessionResumption

func (x *Config) GetDisableSessionResumption() bool

func (*Config) GetDisableSystemRoot

func (x *Config) GetDisableSystemRoot() bool

func (*Config) GetNextProtocol

func (x *Config) GetNextProtocol() []string

func (*Config) GetServerName

func (x *Config) GetServerName() string

func (*Config) GetTLSConfig

func (c *Config) GetTLSConfig(opts ...Option) *tls.Config

GetTLSConfig converts this Config into tls.Config.

func (*Config) IsExperiment8357

func (c *Config) IsExperiment8357() bool

func (*Config) ProtoMessage

func (*Config) ProtoMessage()

func (*Config) ProtoReflect

func (x *Config) ProtoReflect() protoreflect.Message

func (*Config) Reset

func (x *Config) Reset()

func (*Config) String

func (x *Config) String() string

type Conn

type Conn struct {
	*tls.Conn
}

func (*Conn) HandshakeAddress

func (c *Conn) HandshakeAddress() net.Address

func (*Conn) WriteMultiBuffer

func (c *Conn) WriteMultiBuffer(mb buf.MultiBuffer) error

type Option

type Option func(*tls.Config)

Option for building TLS config.

func WithDestination

func WithDestination(dest net.Destination) Option

WithDestination sets the server name in TLS config.

func WithNextProto

func WithNextProto(protocol ...string) Option

WithNextProto sets the ALPN values in TLS config.