TlsOptions — C# API

class TlsOptionsReckfellSharpНаследует RefCounted

Client создаёт проверяющий клиент. По умолчанию используются стандартные доверенные CA и имя подключения. Переданная trustedChain заменяет стандартный набор для этого соединения; commonNameOverride задаёт другую ожидаемую идентичность.

ClientUnsafe отключает проверку имени, а без trustedChain также обязательное доверие цепочке. Это не исправление неверного сертификата. Server требует согласованные закрытый ключ и сертификат; клиенту закрытый ключ сервера не нужен. Доступность TLS и правила доверия целевой платформы проверяются отдельно.

Рабочий пример.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Методы9

ClientTlsOptions

# Client

C#
public static TlsOptions Client(X509Certificate trustedChain = null, string commonNameOverride = "");

Создаёт проверяющий TLS-клиент. trustedChain заменяет стандартный набор доверия; пустой commonNameOverride сохраняет имя подключения.

Параметры
Имя	Тип	По умолчанию
`trustedChain`	`X509Certificate`	`null`
`commonNameOverride`	`string`	`""`

Возвращает TlsOptions

ClientUnsafeTlsOptions

# ClientUnsafe

C#
public static TlsOptions ClientUnsafe(X509Certificate trustedChain = null);

Отключает проверку имени сервера. Без trustedChain отключает и обязательную проверку доверия цепочке. Не используйте как исправление сертификата.

Параметры
Имя	Тип	По умолчанию
`trustedChain`	`X509Certificate`	`null`

Возвращает TlsOptions

GetCommonNameOverridestring

# GetCommonNameOverride

C#
public string GetCommonNameOverride();

Ожидаемое имя, заданное вместо имени подключения; пустая строка оставляет имя подключения. Это не результат успешной проверки сертификата.

Возвращает string

GetOwnCertificateX509Certificate

# GetOwnCertificate

C#
public X509Certificate GetOwnCertificate();

Возвращает X509Certificate, указанный при создании с помощью TlsOptions.Server.

Возвращает X509Certificate

GetPrivateKeyCryptoKey

# GetPrivateKey

C#
public CryptoKey GetPrivateKey();

Возвращает CryptoKey, указанный при создании с помощью TlsOptions.Server.

Возвращает CryptoKey

GetTrustedCaChainX509Certificate

# GetTrustedCaChain

C#
public X509Certificate GetTrustedCaChain();

Возвращает цепочку CA X509Certificate, указанную при создании с помощью TlsOptions.Client или TlsOptions.ClientUnsafe.

Возвращает X509Certificate

IsServerbool

# IsServer

C#
public bool IsServer();

Возвращает true, если создано с помощью TlsOptions.Server, в противном случае false.

Возвращает bool

IsUnsafeClientbool

# IsUnsafeClient

C#
public bool IsUnsafeClient();

Возвращает true, если создано с помощью TlsOptions.ClientUnsafe, в противном случае false.

Возвращает bool

ServerTlsOptions

# Server

C#
public static TlsOptions Server(CryptoKey key, X509Certificate certificate);

Создает конфигурацию сервера TLS с использованием предоставленных key и certificate. Примечание: certificate должен включать полную цепочку сертификатов вплоть до подписывающего CA (файл сертификатов можно объединить с помощью текстового редактора общего назначения).

Параметры
Имя	Тип	По умолчанию
`key`	`CryptoKey`	—
`certificate`	`X509Certificate`	—

Возвращает TlsOptions