Documentation
¶
Overview ¶
TLSOptions abstracts the configuration options for the [StreamPeerTLS] and [PacketPeerDTLS] classes. Objects of this class cannot be instantiated directly, and one of the static methods [Instance.Client], [Instance.ClientUnsafe], or [Instance.Server] should be used instead.
Index ¶
- type Advanced
- type Any
- type Extension
- type ID
- type Instance
- func Client(trusted_chain X509Certificate.Instance, common_name_override string) Instance
- func ClientOptions(trusted_chain X509Certificate.Instance, common_name_override string) Instance
- func ClientUnsafe(trusted_chain X509Certificate.Instance) Instance
- func ClientUnsafeOptions(trusted_chain X509Certificate.Instance) Instance
- func New() Instance
- func Server(key CryptoKey.Instance, certificate X509Certificate.Instance) Instance
- func (self Instance) AsObject() [1]gd.Object
- func (self Instance) AsRefCounted() [1]gd.RefCounted
- func (self Instance) AsTLSOptions() Instance
- func (self Instance) GetCommonNameOverride() string
- func (self Instance) GetOwnCertificate() X509Certificate.Instance
- func (self Instance) GetPrivateKey() CryptoKey.Instance
- func (self Instance) GetTrustedCaChain() X509Certificate.Instance
- func (self Instance) ID() ID
- func (self Instance) IsServer() bool
- func (self Instance) IsUnsafeClient() bool
- func (self *Instance) SetObject(obj [1]gd.Object) bool
- func (self Instance) Virtual(name string) reflect.Value
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Advanced ¶
type Advanced = class
Advanced exposes a 1:1 low-level instance of the class, undocumented, for those who know what they are doing.
type Extension ¶
Extension can be embedded in a new struct to create an extension of this class. T should be the type that is embedding this Extension
func (*Extension[T]) AsRefCounted ¶
func (self *Extension[T]) AsRefCounted() [1]gd.RefCounted
func (*Extension[T]) AsTLSOptions ¶
type ID ¶
ID is a typed object ID (reference) to an instance of this class, use it to store references to objects with unknown lifetimes, as an ID will not panic on use if the underlying object has been destroyed.
type Instance ¶
type Instance [1]gdclass.TLSOptions
Instance of the class with convieniently typed arguments and results.
var Nil Instance
Nil is a nil/null instance of the class. Equivalent to the zero value.
func Client ¶
func Client(trusted_chain X509Certificate.Instance, common_name_override string) Instance
Creates a TLS client configuration which validates certificates and their common names (fully qualified domain names). You can specify a custom 'trusted_chain' of certification authorities (the default CA list will be used if null), and optionally provide a 'common_name_override' if you expect the certificate to have a common name other than the server FQDN. Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
func ClientOptions ¶
func ClientOptions(trusted_chain X509Certificate.Instance, common_name_override string) Instance
Creates a TLS client configuration which validates certificates and their common names (fully qualified domain names). You can specify a custom 'trusted_chain' of certification authorities (the default CA list will be used if null), and optionally provide a 'common_name_override' if you expect the certificate to have a common name other than the server FQDN. Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
func ClientUnsafe ¶
func ClientUnsafe(trusted_chain X509Certificate.Instance) Instance
Creates an unsafe TLS client configuration where certificate validation is optional. You can optionally provide a valid 'trusted_chain', but the common name of the certificates will never be checked. Using this configuration for purposes other than testing is not recommended. Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
func ClientUnsafeOptions ¶
func ClientUnsafeOptions(trusted_chain X509Certificate.Instance) Instance
Creates an unsafe TLS client configuration where certificate validation is optional. You can optionally provide a valid 'trusted_chain', but the common name of the certificates will never be checked. Using this configuration for purposes other than testing is not recommended. Note: On the Web platform, TLS verification is always enforced against the CA list of the web browser. This is considered a security feature.
func Server ¶
func Server(key CryptoKey.Instance, certificate X509Certificate.Instance) Instance
Creates a TLS server configuration using the provided 'key' and 'certificate'. Note: The 'certificate' should include the full certificate chain up to the signing CA (certificates file can be concatenated using a general purpose text editor).
func (Instance) AsRefCounted ¶
func (self Instance) AsRefCounted() [1]gd.RefCounted
func (Instance) AsTLSOptions ¶
func (Instance) GetCommonNameOverride ¶
Returns the common name (domain name) override specified when creating with [Instance.Tlsoptions.Client].
func (Instance) GetOwnCertificate ¶
func (self Instance) GetOwnCertificate() X509Certificate.Instance
Returns the [X509Certificate] specified when creating with [Instance.Tlsoptions.Server].
func (Instance) GetPrivateKey ¶
Returns the [CryptoKey] specified when creating with [Instance.Tlsoptions.Server].
func (Instance) GetTrustedCaChain ¶
func (self Instance) GetTrustedCaChain() X509Certificate.Instance
Returns the CA [X509Certificate] chain specified when creating with [Instance.Tlsoptions.Client] or [Instance.Tlsoptions.ClientUnsafe].
func (Instance) IsServer ¶
Returns true if created with [Instance.Tlsoptions.Server], false otherwise.
func (Instance) IsUnsafeClient ¶
Returns true if created with [Instance.Tlsoptions.ClientUnsafe], false otherwise.
Source Files