LDicomNet::GetMutualAuthKeyLengthTLS

#include "ltdic.h"

L_UINT32 LDicomNet::GetMutualAuthKeyLengthTLS(cipher)

/* ciphersuite */

Returns the effective length (in bits) of the mutual authentication key associated with the specified ciphersuite. This function is available in the PACS Imaging toolkits.

Parameter	Description
cipher	Value that represents the current ciphersuite for which to get the length of the mutual authentication key.

Returns

Returns the effective length of the mutual authentication key.

Comments

The usual sizes for a RSA key is 512 and 1024 bits. There is a limitation for import in Europe a RSA key must be at least 768 bits long. There are no known export restrictions. In addition, the length of the mutual authentication key can be found only after a successful call to the LDicomNet::SetClientCertificateTLS or LDicomNet::SetServerCertificateTLS function.

Required DLLs and Libraries

LTDIC
LTCRY
LTTLS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions:	LDicomNet::GetAuthenticationAlgorithmTLS, LDicomNet::GetIntegrityAlgorithmTLS, LDicomNet::GetEncryptionAlgorithmTLS, LDicomNet::GetKeyExchangeAlgorithmTLS, LDicomNet::GetEncryptKeyLengthTLS, Class Members
Topics:	Adding TLS Security to a DICOM Connection
	Negotiating a Ciphersuite
	General Transport Layer Secure (TLS) Information

Example

L_INT LDicomNet_GetMutualAuthKeyLengthTLSExample(LDicomNet* m_pDicomNet)
{
   L_INT       nRet;
   LDicomNet*  pDicomNet;
   L_TCHAR     strMsg[64];
   // create and initialize pDicomNet
   pDicomNet = m_pDicomNet;
   nRet = pDicomNet->GetMutualAuthKeyLengthTLS(TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA);
   wsprintf(strMsg, TEXT("Mutual authentication key length for TLS_DHE_RSA_WITH_DES_EDE_CBC_SHA is %d"), nRet);
   AfxMessageBox(strMsg);
   return DICOM_SUCCESS;
}