TsgcWebSocketClientProperties › TLSOptions

TLSOptions 속성

TLS가 활성화될 때 사용되는 인증서, TLS 버전, ALPN, IOHandler 및 기타 보안 연결 세부 정보를 구성합니다.

구문

property TLSOptions: TsgcWSTLS_Options read FTLSOptions write SetTLSOptions;

기본값

Preset=tlspCustom

설명

TLSTrue일 때만 접근할 수 있습니다. 하위 속성에는 RootCertFile, CertFile, KeyFile, Password, VerifyCertificate, VerifyDepth, Version(tlsUndefined부터 tls1_3까지), ALPNProtocolsIOHandler(iohOpenSSL, iohSChannel, iohAndroidTLS 또는 iohAppleTLS)가 포함됩니다. Android에서 iohAndroidTLS는 플랫폼 네이티브 TLS(javax.net.ssl.SSLEngine)를 사용하고, iOS 및 macOS에서 iohAppleTLS는 Apple 네이티브 TLS를 사용하므로 OpenSSL 라이브러리를 배포할 필요가 없습니다. 네이티브 플랫폼 TLS에는 Enterprise 에디션이 필요합니다. OpenSSL 관련 설정은 OpenSSL_Options 아래에, SChannel 관련 설정은 SChannel_Options 아래에 있습니다.

Preset은 한 번의 할당으로 일련의 보안 기본값을 적용합니다. tlspCustom(기본값)이면 모든 옵션이 수동으로 구성한 값을 유지하여 이전 동작이 보존됩니다. Preset := tlspSecureDefaults를 설정하면 인증서 검증(VerifyCertificate := True)이 활성화되고, (더 낮거나 정의되지 않은 버전이 구성된 경우) Version이 최소 TLS 1.2로 올라가며, 서버 인증서의 호스트 이름 확인(OpenSSL X509Checks 호스트 이름 검증)이 활성화됩니다. 프리셋을 적용한 후에도 개별 옵션을 계속 조정할 수 있습니다.

예제


oClient := TsgcWebSocketClient.Create(nil);
oClient.URL := 'wss://www.esegece.com:2053';
oClient.TLSOptions.Version := tls1_2;
oClient.TLSOptions.VerifyCertificate := true;
oClient.TLSOptions.RootCertFile := 'cacert.pem';
oClient.Active := true;

속성으로 돌아가기