#include "dinamo.h"

Data Fields
char	szAddr [MAX_ADDR_LEN]

int	nPort

char	szUserId [MAX_USR_LEN]

char	szPassword [MAX_USR_PWD]

DWORD	dwAuthType

BYTE *	pbStrongAuth

int	nStrongAuthLen

Detailed description

Data for opening user/password authenticated sessions with Dinamo with a second authentication factor. This structure is mainly used by the DOpenSession() function.

Examples: gen_csr.c, spb_activate_deactivate_cert.c, spb_enc_dec.c, spb_gen_key_csr.c, spb_get_cert.c, spb_import_p12.c, and user_otp.c.

Fields

◆ szAddr

char szAddr[MAX_ADDR_LEN]

HSM address (Name or IP in the format xxx.xxx.xxx.xxx).

Examples: gen_csr.c, spb_activate_deactivate_cert.c, spb_enc_dec.c, spb_gen_key_csr.c, spb_get_cert.c, spb_import_p12.c, and user_otp.c.

◆ nPort

int nPort

TCP port (4433).

Examples: gen_csr.c, spb_activate_deactivate_cert.c, spb_enc_dec.c, spb_gen_key_csr.c, spb_get_cert.c, spb_import_p12.c, and user_otp.c.

◆ szUserId

char szUserId[MAX_USR_LEN]

Identification of the user in the HSM. The user name can contain MAX_USR_LEN characters. If the user name is shorter than MAX_USR_LEN, complete it with zeros (\0).

Examples: gen_csr.c, spb_activate_deactivate_cert.c, spb_enc_dec.c, spb_gen_key_csr.c, spb_get_cert.c, spb_import_p12.c, and user_otp.c.

◆ szPassword

char szPassword[MAX_USR_PWD]

User password . The password can contain MAX_USR_PWD characters. If the password is shorter than MAX_USR_PWD, complete it with zeros (\0).

Examples: gen_csr.c, spb_activate_deactivate_cert.c, spb_enc_dec.c, spb_gen_key_csr.c, spb_get_cert.c, spb_import_p12.c, and user_otp.c.

◆ dwAuthType

DWORD dwAuthType

Type of authentication. Value	Meaning
SA_AUTH_NONE	Uses user and password authentication. Set pbStrongAuth to NULL and nStrongAuthLen to 0 (zero).
SA_AUTH_OTP	Uses user, password and OTP authentication. Set pbStrongAuth to OTP(One Time Password). Do not include NULL terminator. Set nStrongAuthLen to OTP size in bytes. Do not include NULL terminator.
SA_AUTH_CERTIFICATE	Uses user, password and certificate authentication (mutual authentication with HSM). Set pbStrongAuth to TLS_MUTUAL_AUTH_INFO and nStrongAuthLen to the size of pbStrongAuth.
SA_AUTH_HSM_CERT	Uses username and password authentication and the HSM certificate. Set pbStrongAuth to the HSM certificate in PEM or DER format. Set nStrongAuthLen to the size of the certificate in bytes. See DGetHSMTLSCert() to retrieve the HSM certificate.