dcmtls: extensões de segurança para a biblioteca de rede
Este módulo contém classes que implementam a comunicação de rede DICOM encapsulada em uma conexão Transport Layer Security (TLS), em conformidade com a extensão DICOM "Security Enhancements One" (anteriormente Supplement 31). Este módulo requer a biblioteca externa OpenSSL.
As principais classes de interface são:
Arquivos
Os arquivos a seguir fornecem documentação adicional:
- gerenciamento de certificados e autoridades de certificação no dcmtls
- arquivo ciphers.txt
- arquivo randseed.txt
Exemplos
O exemplo a seguir mostra um fragmento de código que ativa o TLS para uma aplicação requisitante de associação (association requestor). O código completo de inicialização de rede não é mostrado aqui, e a maior parte do código de verificação de erros é omitida por questões de concisão.
T_ASC_Network *net; // network initialization code not shown,
T_ASC_Parameters *params; // we just assume these pointers to be valid
DcmTLSTransportLayer::initializeOpenSSL(); // initialize OpenSSL library
// create TLS object that initializes the random generator through a file
// "random.dat" containing random data (1 kByte is sufficient).
DcmTLSTransportLayer *tLayer = new DcmTLSTransportLayer(
NET_REQUESTOR, "random.dat");
if (tLayer->setPrivateKeyFile("privkey.pem", SSL_FILETYPE_PEM).bad())
{
cerr << "unable to load private key" << endl;
return;
}
if (tLayer->setCertificateFile("certificate.pem", SSL_FILETYPE_PEM).bad())
{
cerr << "unable to load certificate" << endl;
return;
}
// enable the ciphersuites for the BCP 195 RFC 8996 secure transport profile
tLayer->setTLSProfile(TSP_Profile_BCP_195_RFC_8996);
tLayer->activateCipherSuites();
// accept any certificate from the remote site (not recommended)
tLayer->setCertificateVerification(DCV_ignoreCertificate);
// register and activate TLS layer
ASC_setTransportLayer(net, tLayer, 1);
ASC_setTransportLayerType(params, 1);