L_DicomGetAuthenticationAlgorithmTLS

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetAuthenticationAlgorithmTLS(hNet, cipher)

HDICOMNET hNet;	/* handle to an existing DICOM network */
L_CIPHERSUITE cipher;	/* ciphersuite */

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

Parameter	Description
hNet	Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.
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_RSA	[0x20] Mutual authentication through RSA certificates.

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

See Also

Functions:	L_DicomGetEncryptionAlgorithmTLS, L_DicomGetIntegrityAlgorithmTLS, L_DicomGetKeyExchangeAlgorithmTLS, L_DicomGetEncryptKeyLengthTLS, L_DicomGetMutualAuthKeyLengthTLS
Topics:	DICOM Net: TLS Protocol
	Adding TLS Security to a DICOM Connection
	Negotiating a Ciphersuite
	General Transport Layer Secure (TLS) Information

Example

L_INT DicomGetAuthenticationAlgorithmTLSExample(L_VOID)
{
   L_INT nRet;
   HDICOMNET hDicomNet = NULL;

   // create and initialize hDicomNet
   //...

   nRet = L_DicomGetAuthenticationAlgorithmTLS( hDicomNet, TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA);
   if(nRet == L_MUTUALAUTH_RSA)
      MessageBox(NULL, TEXT(" Mutual authentication in TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA with L_MUTUALAUTH_RSA"), TEXT(""), MB_OK);

   return DICOM_SUCCESS;
}