Descripción detallada

Operaciones de codificación y descodificación según la norma SPB.

Consulte la documentación técnica del HSM.

Funciones
void	SPBListObjects (OBJTYPE type, DinamoApi.ListCallbackFilter filterCallBack, IntPtr param)
	Lista los objetos de un determinado tipo (clave, certificado, etc.).

byte[]	SPBGetCertificate (cadena strIdCertificate)
	Recupera un certificado almacenado en un espacio de nombres del HSM.

cadena	SPBGenerateKey (cadena ISPB, cadena dominio, bool isExportable)
	Genera una clave RSA 2048 según el estándar SPB. Esta función siempre se ajustará a los requisitos de SPB, según el manual de seguridad de RSFN. DinamoClient.GenerateKey(cadena, KEY_ALG, bool)

byte[]	SPBGenerateCSR (cadena sPrivateKeyName, cadena sSubject)
	Genera una nueva CSR basada en una clave existente (RSA 2048).

byte[]	SPBEncode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, byte bSpecialTreatment)
	Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

byte[]	SPBEncode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, byte bSpecialTreatment, byte bErrorCode, UInt32 dwFlags)
	Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

void	SPBEncode (cadena szSrcISPB, cadena szDstISPB, flujo sMsgIn, flujo sMsgOut, byte bErrorCode, byte bSpecialTreatment, UInt32 dwFlags)
	Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

byte[]	SPBDecode (cadena szSrcISPB, cadena szDstISPB, byte[] pbMsgIn)
	Descifra un mensaje en el estándar SPB, comprobando las firmas, descifrando, pero no comprueba la codificación.

byte[]	SPBDecode (cadena szSrcISPB, cadena szDstISPB, byte[] pbMsgIn, bool AcceptExpiredCert, bool AutoUpdateCert)
	Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

byte[]	SPBDecode (cadena szSrcISPB, cadena szDstISPB, byte[] pbMsgIn, bool AcceptExpiredCert, bool AutoUpdateCert, UInt32 dwFlags)
	Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

void	SPBDecode (cadena szSrcISPB, cadena szDstISPB, flujo sMsgIn, flujo sMsgOut, bool AcceptExpiredCert, bool AutoUpdateCert, UInt32 dwFlags)
	Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

cadena	SPBMapInfoCert (cadena sIdCert)
	Crea un mapa con el certificado de la institución en una ranura.

void	SPBSetISPBMap (cadena sIdMap, cadena sIdKey, cadena sIdCert)
	Crea un mapa con la clave y el certificado de la institución en una ranura.

void	SPBImportPKCS12 (cadena szPkcs12File, cadena szPkcs12Pwd, cadena szNamespace, cadena szDomain, int dwKeyAttr)
	Importa un certificado desde un contenedor PKCS#12 al HSM.

void	SPBImportPKCS12 (cadena szPkcs12File, cadena szPkcs12Pwd, cadena szNamespace, cadena szDomain, int dwKeyAttr, bool isActivate)
	Importa un certificado desde un contenedor PKCS#12 al HSM.

void	SPBImportCertificate (cadena szDominio, byte[] bCertificado)
	Importar un certificado a un espacio de nombres HSM.

void	SPBImportCertificate (cadena szDomain, byte[] bCertificate, bool isCIPCertificate=false)
	Importar un certificado a un espacio de nombres HSM.

void	SPBActivateCertificate (cadena szDomain, cadena szCA, cadena szSN, bool isCIPCertificate=false)
	Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

void	SPBImportCertificate (cadena szNamespace, cadena szDomain, byte[] bCertificate, bool isCIPCertificate=false)
	Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

void	SPBActivateCertificate (cadena szNamespace, cadena szDomain, cadena szCA, cadena szSN, bool isCIPCertificate=false)
	Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

cadena	SPBCalculateObjectId (cadena szISPB, cadena szDomain, KEYNAME dwKeyType)
	Función que ayuda a dar formato a la identificación de objetos HSM internos de acuerdo con la norma utilizada en el móduloSPB.

DinamoApi.SPB_CERT_X509_INFO	SPBGetCertificateInfo (byte[] certificado)
	Recupera información del certificado.

Funciones

◆ SPBListObjects()

void SPBListObjects	(	OBJTYPE	type,
		DinamoApi.ListCallbackFilter	filterCallBack,
		IntPtr	param )

inline

Lista los objetos de un determinado tipo (clave, certificado, etc.).

Parámetros

filterCallBack	Función callback llamada para cada objeto en la interacción
param	Parámetros
type	DinamoTipo de objeto .Hsm.DinamoClient.OBJTYPE

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBGetCertificate()

byte[] SPBGetCertificate ( string strIdCertificate )

inline

Recupera un certificado almacenado en un espacio de nombres del HSM.

Parámetros

strIdCertificate identificação do certificado no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".

Devolución: Devolución del certificado en formato DER como matriz de bytes

Excepciones

DinamoException.DinamoException En caso de error

Ejemplos: spb_import_activate.cs.

◆ SPBGenerateKey()

string SPBGenerateKey	(	string	ISPB,
		string	domain,
		bool	isExportable )

inline

Genera una clave RSA 2048 según el estándar SPB. Esta función siempre se ajustará a los requisitos de SPB, según el manual de seguridad de RSFN. DinamoClient.GenerateKey(cadena, KEY_ALG, bool)

Parámetros

ISPB	Número ISBP
domain	Dominio
isExportable	True para generar una clave exportable

Devolución: Etiqueta de la clave generada

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBGenerarCSR()

byte[] SPBGenerateCSR	(	string	sPrivateKeyName,
		string	sSubject )

inline

Genera una nueva CSR basada en una clave existente (RSA 2048).

Parámetros

sPrivateKeyName	Identificación de claves en el HSM
sSubject	Descripción del asunto del certificado DN (Dinstinguished Name) de la CSR para generar el campo Asunto del certificado. Los campos DN deben estar separados por "/".

Devolución: Etiqueta de la clave generada

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBEncode() [1/3]

byte[] SPBEncode	(	string	szSrcISPB,
		string	szDstISPB,
		byte[]	pbMsgIn,
		byte	bSpecialTreatment )

inline

Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

Parámetros

szSrcISPB	Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
szDstISPB	Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
pbMsgIn	Mensaje pasado como matriz de bytes. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.
bSpecialTreatment	Indicador de tratamiento especial. Véase C04 en el manual de seguridad SPB.

Devolución: Mensaje firmado.

Excepciones

DinamoException.DinamoException En caso de error

Ejemplos: spb.cs y spb_file_cip.cs.

◆ SPBEncode() [2/3]

byte[] SPBEncode	(	string	szSrcISPB,
		string	szDstISPB,
		byte[]	pbMsgIn,
		byte	bSpecialTreatment,
		byte	bErrorCode,
		UInt32	dwFlags )

inline

Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

Parámetros

szSrcISPB Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

szDstISPB Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

pbMsgIn Mensaje pasado como matriz de bytes. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.

bSpecialTreatment Indicador de tratamiento especial. Véase C04 en el manual de seguridad SPB.

bErrorCode Código de error del mensaje que se colocará en la cabecera de seguridad, normalmente en los mensajes de respuesta.

dwFlags

Define los detalles de codificación y puede adoptar los siguientes valores descritos en la tabla siguiente.

Valor	Significado
0	Utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_ENCODE_GEN_01	Genera un mensaje GEN 01.
DinamoApi.ND_SPB_USE_CIP1	Utiliza el estándar CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Cuando este indicador no está activado, se utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_USE_ANY	Acepta el estándar CIP/C3 Nuclea y SPB. La detección se realiza internamente.
DinamoApi.ND_SPB_ENCODE_HEADER_V3	Codifica el mensaje utilizando la cabecera de seguridad versión 3. En el futuro, esta opción estará activada por defecto. La cabecera V3 está disponible a partir de la versión 5.0.16 del firmware del HSM.

DinamoApi.ND_SPB_RAW

Modo sin comprobaciones específicas de SPB. Sólo acepta el uso del nombre MAP como parámetros para szSrcISPB e szDstISPB.

Devolución: Mensaje firmado.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBEncode() [3/3]

void SPBEncode	(	string	szSrcISPB,
		string	szDstISPB,
		Stream	sMsgIn,
		Stream	sMsgOut,
		byte	bErrorCode,
		byte	bSpecialTreatment,
		UInt32	dwFlags )

inline

Codifica un mensaje con la cabecera SPB, firmando, cifrando e incluyendo todos los campos de cabecera definidos en el manual de seguridad RSFN.

Parámetros

szSrcISPB Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

szDstISPB Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

sMsgIn Mensaje a codificar. El flujo pasado debe admitir la propiedad Length. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.

sMsgOut Flujo que recibirá el mensaje de salida codificado. El flujo introducido debe admitir la propiedad Length y el método Seek. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.

bSpecialTreatment Indicador de tratamiento especial. Véase C04 en el manual de seguridad SPB.

bErrorCode Código de error del mensaje que se colocará en la cabecera de seguridad, normalmente en los mensajes de respuesta.

dwFlags

Define los detalles de codificación y puede adoptar los siguientes valores descritos en la tabla siguiente.

Valor	Significado
0	Utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_ENCODE_GEN_01	Genera un mensaje GEN 01.
DinamoApi.ND_SPB_USE_CIP1	Utiliza el estándar CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Cuando este indicador no está activado, se utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_USE_ANY	Acepta el estándar CIP/C3 Nuclea y SPB. La detección se realiza internamente.
DinamoApi.ND_SPB_ENCODE_HEADER_V3	Codifica el mensaje utilizando la cabecera de seguridad versión 3. En el futuro, esta opción estará activada por defecto. La cabecera V3 está disponible a partir de la versión 5.0.16 del firmware del HSM.

DinamoApi.ND_SPB_RAW

Modo sin comprobaciones específicas de SPB. Sólo acepta el uso del nombre MAP como parámetros para szSrcISPB e szDstISPB.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBDecode() [1/4]

byte[] SPBDecode	(	string	szSrcISPB,
		string	szDstISPB,
		byte[]	pbMsgIn )

inline

Descifra un mensaje en el estándar SPB, comprobando las firmas, descifrando, pero no comprueba la codificación.

Parámetros

szSrcISPB	Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
szDstISPB	Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
pbMsgIn	Mensaje codificado en el estándar SPB pasado como una matriz de bytes.

Devolución: Mensaje decodificado.

Excepciones

DinamoException.DinamoException En caso de error

Ejemplos: spb.cs y spb_file_cip.cs.

◆ SPBDecode() [2/4]

byte[] SPBDecode	(	string	szSrcISPB,
		string	szDstISPB,
		byte[]	pbMsgIn,
		bool	AcceptExpiredCert,
		bool	AutoUpdateCert )

inline

Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

Parámetros

szSrcISPB	Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
szDstISPB	Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
pbMsgIn	Mensaje codificado en el estándar SPB pasado como una matriz de bytes.
AcceptExpiredCert	Acepta operaciones incluso con un certificado caducado.
AutoUpdateCert	Interpreta los mensajes de intercambio de certificados y realiza la operación internamente de forma automática.

Devolución: Mensaje decodificado.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBDecode() [3/4]

byte[] SPBDecode	(	string	szSrcISPB,
		string	szDstISPB,
		byte[]	pbMsgIn,
		bool	AcceptExpiredCert,
		bool	AutoUpdateCert,
		UInt32	dwFlags )

inline

Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

Parámetros

szSrcISPB Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

szDstISPB Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

pbMsgIn Mensaje codificado en el estándar SPB pasado como una matriz de bytes.

AcceptExpiredCert Acepta operaciones incluso con un certificado caducado.

AutoUpdateCert Interpreta los mensajes de intercambio de certificados y realiza la operación internamente de forma automática.

dwFlags

Define los detalles de descodificación y puede adoptar los siguientes valores descritos en la tabla siguiente.

Valor	Significado
0	Utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_OUT_NO_PADDING	Elimina el relleno del final del mensaje SPB tras el descifrado.
DinamoApi.ND_SPB_OUT_WITH_PADDING	Mantiene el relleno al final del mensaje SPB tras el descifrado.
DinamoApi.ND_SPB_USE_CIP1	Utiliza el estándar CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Cuando este indicador no está activado, se utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_USE_ANY	Acepta el estándar CIP/C3 Nuclea y SPB. La detección se realiza internamente.

Devolución: Mensaje decodificado.

DinamoApi.ND_SPB_RAW | Modo sin comprobaciones específicas de SPB. Sólo acepta el uso del nombre MAP como parámetros para szSrcISPB e szDstISPB.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBDecode() [4/4]

void SPBDecode	(	string	szSrcISPB,
		string	szDstISPB,
		Stream	sMsgIn,
		Stream	sMsgOut,
		bool	AcceptExpiredCert,
		bool	AutoUpdateCert,
		UInt32	dwFlags )

inline

Descifra un mensaje en el estándar SPB, comprobando las firmas y descifrando.

Parámetros

szSrcISPB Identificação do ISPB de origem no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

szDstISPB Identificação do ISPB de destino no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR". Também pode ser passado o nome do map correspondente, fora do padrão de nomenclatura do módulo SPB em casos específicos, ver dwFlags.

sMsgIn Mensaje codificado en el estándar SPB. El flujo pasado debe admitir la propiedad Length. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.

sMsgOut Flujo que recibirá el mensaje de salida codificado. El flujo introducido debe admitir la propiedad Length y el método Seek. HSM no realiza conversiones automáticas de formato. En el estándar SPB, el formato definido es UTF16-BE, y corresponde a quien llama a la API asegurarse de que el mensaje utiliza el formato correcto.

AcceptExpiredCert Acepta operaciones incluso con un certificado caducado.

AutoUpdateCert Interpreta los mensajes de intercambio de certificados y realiza la operación internamente de forma automática.

dwFlags

Define los detalles de descodificación y puede adoptar los siguientes valores descritos en la tabla siguiente.

Valor	Significado
0	Utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_OUT_NO_PADDING	Elimina el relleno del final del mensaje SPB tras el descifrado.
DinamoApi.ND_SPB_OUT_WITH_PADDING	Mantiene el relleno al final del mensaje SPB tras el descifrado.
DinamoApi.ND_SPB_USE_CIP1	Utiliza el estándar CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Cuando este indicador no está activado, se utiliza el estándar SPB (Sistema Brasileño de Pagos).
DinamoApi.ND_SPB_USE_ANY	Acepta el estándar CIP/C3 Nuclea y SPB. La detección se realiza internamente.

DinamoApi.ND_SPB_RAW

Modo sin comprobaciones específicas de SPB. Sólo acepta el uso del nombre MAP como parámetros para szSrcISPB e szDstISPB.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBMapInfoCert()

string SPBMapInfoCert ( string sIdCert )

inline

Crea un mapa con el certificado de la institución en una ranura.

Parámetros

sIdCert Identificación/etiqueta del certificado en el HSM

Devolución: Nombre del objeto de mapa creado en HSM.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBSetISPBMap()

void SPBSetISPBMap	(	string	sIdMap,
		string	sIdKey,
		string	sIdCert )

inline

Crea un mapa con la clave y el certificado de la institución en una ranura.

Parámetros

sIdMap	Identificación del mapa (puede ser ISPB)
sIdKey	Identificación de claves
sIdCert	Identificación del certificado

Excepciones

DinamoException.DinamoException Lanza una excepción en caso de error de firma

◆ SPBImportPKCS12() [1/2]

void SPBImportPKCS12	(	string	szPkcs12File,
		string	szPkcs12Pwd,
		string	szNamespace,
		string	szDomain,
		int	dwKeyAttr )

inline

Importa un certificado desde un contenedor PKCS#12 al HSM.

Parámetros

szPkcs12File Ruta y nombre del archivo.

szPkcs12Pwd Contraseña

szNamespace Partición en la que se encuentra el objeto. Si el objeto se encuentra en la misma partición que la registrada, puede pasar null.

szDomain Dominio del SPB.

dwKeyAttr

Parámetros clave adicionales.

Valor	Significado
DinamoApi.NONEXPORTABLE_KEY	La llave no puede salir del HSM.
DinamoApi.EXPORTABLE_KEY	La clave puede exportarse desde el HSM.
DinamoApi.TEMPORARY_KEY	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBImportPKCS12() [2/2]

void SPBImportPKCS12	(	string	szPkcs12File,
		string	szPkcs12Pwd,
		string	szNamespace,
		string	szDomain,
		int	dwKeyAttr,
		bool	isActivate )

inline

Importa un certificado desde un contenedor PKCS#12 al HSM.

Parámetros

szPkcs12File Ruta y nombre del archivo.

szPkcs12Pwd Contraseña.

szNamespace Partición en la que se encuentra el objeto. Si el objeto se encuentra en la misma partición que la registrada, puede pasar null.

szDomain Dominio del SPB.

dwKeyAttr

Parámetros clave adicionales.

Valor	Significado
DinamoApi.NONEXPORTABLE_KEY	La llave no puede salir del HSM.
DinamoApi.EXPORTABLE_KEY	La clave puede exportarse desde el HSM.
DinamoApi.TEMPORARY_KEY	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

isActivate Activa el certificado durante la importación

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBImportCertificate() [1/3]

void SPBImportCertificate	(	string	szDomain,
		byte[]	bCertificate )

inline

Importar un certificado a un espacio de nombres HSM.

Parámetros

szDomain	Dominio del SPB.
bCertificate	Certificado SPB en el estándar SPB como matriz de bytes.

Excepciones

DinamoException.DinamoException En caso de error

Ejemplos: spb_import_activate.cs.

◆ SPBImportCertificate() [2/3]

void SPBImportCertificate	(	string	szDomain,
		byte[]	bCertificate,
		bool	isCIPCertificate = false )

inline

Importar un certificado a un espacio de nombres HSM.

Parámetros

szDomain	Dominio del SPB.
bCertificate	Certificado SPB en el estándar SPB como matriz de bytes.
isCIPCertificate	Verdadero si el certificado está en el estándar CIP.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ SPBActivateCertificate() [1/2]

void SPBActivateCertificate	(	string	szDomain,
		string	szCA,
		string	szSN,
		bool	isCIPCertificate = false )

inline

Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

Parámetros

szDomain	Dominio del SPB.
szCA	Identificación de la CA (número de CA).
szSN	Número de serie del certificado en formato hexadecimal
isCIPCertificate	Verdadero si el certificado está en el estándar CIP.

Los números CA existentes pueden consultarse en el manual de seguridad RSFN.

Excepciones

DinamoException.DinamoException En caso de error

Ejemplos: spb_import_activate.cs.

◆ SPBImportCertificate() [3/3]

void SPBImportCertificate	(	string	szNamespace,
		string	szDomain,
		byte[]	bCertificate,
		bool	isCIPCertificate = false )

inline

Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

Parámetros

szNamespace	Partición en la que se encuentra el objeto. Si el objeto se encuentra en la misma partición que la registrada, puede pasar `null`.
szDomain	Dominio del SPB.
bCertificate	Certificado SPB en el estándar SPB como matriz de bytes.
isCIPCertificate	Verdadero si el certificado está en el estándar CIP.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBActivateCertificate() [2/2]

void SPBActivateCertificate	(	string	szNamespace,
		string	szDomain,
		string	szCA,
		string	szSN,
		bool	isCIPCertificate = false )

inline

Activa un certificado que ya se ha importado en el HSM. Si hay otro certificado activo, se desactivará. Sólo permanecerá activo un certificado por institución, por dominio dentro de un espacio de nombres de HSM.

Parámetros

szNamespace	Partición en la que se encuentra el objeto. Si el objeto se encuentra en la misma partición que la registrada, puede pasar `null`.
szDomain	Dominio del SPB.
szCA	Identificación de la CA (número de CA).
szSN	Número de serie del certificado en formato hexadecimal
isCIPCertificate	Verdadero si el certificado está en el estándar CIP.

Los números CA existentes pueden consultarse en el manual de seguridad RSFN.

Excepciones

DinamoException.DinamoException En caso de error

◆ SPBCalculateObjectId()

string SPBCalculateObjectId	(	string	szISPB,
		string	szDomain,
		KEYNAME	dwKeyType )

inline

Función que ayuda a dar formato a la identificación de objetos HSM internos de acuerdo con la norma utilizada en el móduloSPB.

Parámetros

szISPB	identificação do ISPB no formato "<ISPB>@<Dominio>". Por exemplo: "11223344@SPR".
szDomain	Dominio del SPB.
dwKeyType	DinamoTipo de objeto .Hsm.DinamoClient.KEYNAME

Devolución: Nombre en formato de módulo SPB.

◆ SPBGetCertificateInfo()

DinamoApi.SPB_CERT_X509_INFO SPBGetCertificateInfo ( byte[] certificate )

inline

Recupera información del certificado.

Parámetros

certificate Matriz de bytes con el certificado

Devolución: Información sobre el certificado. DinamoApi.SPB_CERT_X509_INFO

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: spb_import_activate.cs.