LDicomNet::GetAuthenticationAlgorithmTLS

#include "ltdic.h"

L_UINT32 LDicomNet::GetAuthenticationAlgorithmTLS(cipher)

L_CIPHERSUITE cipher;

/* ciphersuite */

Returns the mutual authentication mode or algorithm for the cipher. This function is available in the PACS Imaging toolkits.

Parameter

Description

cipher

Value that indicates the ciphersuite for which to get the authentication mode or algorithm.

Returns

A value that represents the authentication mode or algorithm. Possible values are:

Value

Meaning

L_MUTUALAUTH_NONE

[0x00] No mutual authentication.  Returned if no secure connection is established.

L_MUTUALAUTH_RSA

[0x20] Mutual authentication through RSA certificates.

L_MUTUALAUTH_DSS

[0x21] Mutual authentication through DSS.

L_MUTUALAUTH_DH

[0x22] Mutual authentication through DH.

Comments

There are several different cipher suites. Some differ only in the mutual authentication algorithm. Usually the authentication algorithm is based on RSA or DSS certificates.

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::GetEncryptionAlgorithmTLS, LDicomNet::GetIntegrityAlgorithmTLS, LDicomNet::GetKeyExchangeAlgorithmTLS, LDicomNet::GetEncryptKeyLengthTLS, LDicomNet::GetMutualAuthKeyLengthTLS, Class Members

Topics:

Adding TLS Security to a DICOM Connection

 

Negotiating a Ciphersuite

 

General Transport Layer Secure (TLS) Information

Example

L_INT LDicomNet_GetAuthenticationAlgorithmTLSExample(LDicomNet* m_pDicomNet)
{
   L_INT       nRet;
   LDicomNet*  pDicomNet;
   // create and initialize pDicomNet
   pDicomNet = m_pDicomNet;
   nRet = pDicomNet->GetAuthenticationAlgorithmTLS(TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA);
   if(nRet == L_MUTUALAUTH_RSA)
      AfxMessageBox(TEXT(" Mutual authentication in TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA with L_MUTUALAUTH_RSA"));
   return DICOM_SUCCESS;
}