Descrição detalhada

Operações de Encode e Decode conforme o padrão SPB.

Funções
void	SPBListObjects (OBJTYPE type, DinamoApi.ListCallbackFilter filterCallBack, IntPtr param)
	Lista os objetos de um determinado tipo (chave, certificado, etc).

byte[]	SPBGetCertificate (string strIdCertificate)
	Recupera um certificado armazenado em um namespace no HSM.

string	SPBGenerateKey (string ISPB, string domain, bool isExportable)
	Gera chave RSA 2048 no padrão SPB. Esta função sempre vai estar aderente aos requisitos do SPB, segundo o manual de segurança da RSFN. DinamoClient.GenerateKey(string, KEY_ALG, bool)

byte[]	SPBGenerateCSR (string sPrivateKeyName, string sSubject)
	Gera uma nova CSR baseada em uma chave existente (RSA 2048).

byte[]	SPBEncode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, byte bSpecialTreatment)
	Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da RSFN.

byte[]	SPBEncode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, byte bSpecialTreatment, byte bErrorCode, UInt32 dwFlags)
	Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da RSFN.

void	SPBEncode (string szSrcISPB, string szDstISPB, Stream sMsgIn, Stream sMsgOut, byte bErrorCode, byte bSpecialTreatment, UInt32 dwFlags)
	Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da RSFN.

byte[]	SPBDecode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn)
	Decodifica uma mensagem no padrão SPB, checando as assinaturas, decriptografando porem não faz a checagem de encoding.

byte[]	SPBDecode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, bool AcceptExpiredCert, bool AutoUpdateCert)
	Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

byte[]	SPBDecode (string szSrcISPB, string szDstISPB, byte[] pbMsgIn, bool AcceptExpiredCert, bool AutoUpdateCert, UInt32 dwFlags)
	Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

void	SPBDecode (string szSrcISPB, string szDstISPB, Stream sMsgIn, Stream sMsgOut, bool AcceptExpiredCert, bool AutoUpdateCert, UInt32 dwFlags)
	Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

string	SPBMapInfoCert (string sIdCert)
	Cria um mapa com o certificado da instituição em um slot.

void	SPBSetISPBMap (string sIdMap, string sIdKey, string sIdCert)
	Cria um mapa com a chave e certificado da instituição em um slot.

void	SPBImportPKCS12 (string szPkcs12File, string szPkcs12Pwd, string szNamespace, string szDomain, int dwKeyAttr)
	Importa um certificado de um container PKCS#12 para o HSM.

void	SPBImportPKCS12 (string szPkcs12File, string szPkcs12Pwd, string szNamespace, string szDomain, int dwKeyAttr, bool isActivate)
	Importa um certificado de um container PKCS#12 para o HSM.

void	SPBImportCertificate (string szDomain, byte[] bCertificate)
	Importa um certificado para um namespace do HSM.

void	SPBImportCertificate (string szDomain, byte[] bCertificate, bool isCIPCertificate=false)
	Importa um certificado para um namespace do HSM.

void	SPBActivateCertificate (string szDomain, string szCA, string szSN, bool isCIPCertificate=false)
	Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

void	SPBImportCertificate (string szNamespace, string szDomain, byte[] bCertificate, bool isCIPCertificate=false)
	Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

void	SPBActivateCertificate (string szNamespace, string szDomain, string szCA, string szSN, bool isCIPCertificate=false)
	Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

string	SPBCalculateObjectId (string szISPB, string szDomain, KEYNAME dwKeyType)
	Função para auxiliar a formatação da identificação de objetos internos do HSM segundo o padrão utilizado no móduloSPB.

DinamoApi.SPB_CERT_X509_INFO	SPBGetCertificateInfo (byte[] certificate)
	Recupera informações do certificado.

Funções

◆ SPBListObjects()

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

inline

Lista os objetos de um determinado tipo (chave, certificado, etc).

Parâmetros

filterCallBack	Função de callback chamada para cada objeto da interação
param	Parämetro
type	Tipo de objeto Dinamo.Hsm.DinamoClient.OBJTYPE

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBGetCertificate()

byte[] SPBGetCertificate ( string strIdCertificate )

inline

Recupera um certificado armazenado em um namespace no HSM.

Parâmetros

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

Retorna: Retorno do certificado no formato DER como array de bytes

Exceções

DinamoException.DinamoException Em caso de erro

Exemplos: spb_import_activate.cs.

◆ SPBGenerateKey()

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

inline

Gera chave RSA 2048 no padrão SPB. Esta função sempre vai estar aderente aos requisitos do SPB, segundo o manual de segurança da RSFN. DinamoClient.GenerateKey(string, KEY_ALG, bool)

Parâmetros

ISPB	Número ISBP
domain	Domínio
isExportable	Verdadeiro para gerar uma chave exportável

Retorna: Label da chave gerada

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBGenerateCSR()

byte[] SPBGenerateCSR	(	string	sPrivateKeyName,
		string	sSubject )

inline

Gera uma nova CSR baseada em uma chave existente (RSA 2048).

Parâmetros

sPrivateKeyName	Identificação da chave no HSM
sSubject	Descriçáo do subject do certificado DN (Dinstinguished Name) do CSR para a geração do campo Subject do certificado. Os campos de DN deverão ser separados por '/'.

Retorna: Label da chave gerada

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBEncode() [1/3]

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

inline

Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da 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	Mensagem passada como um array de bytes. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.
bSpecialTreatment	Indicador de tratamento especial. Vide C04 no manual de segurança do SPB.

Retorna: Mensagem assinada.

Exceções

DinamoException.DinamoException Em caso de erro

Exemplos: spb.cs e spb_file_cip.cs.

◆ SPBEncode() [2/3]

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

inline

Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da 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 Mensagem passada como um array de bytes. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.

bSpecialTreatment Indicador de tratamento especial. Vide C04 no manual de segurança do SPB.

bErrorCode Código de erro da mensagem para ser colocado no cabeçalho de segurança, normalmente em mensagens de resposta.

dwFlags

Define detalhes da codificação, podendo assumir os seguintes valores descritos na tabela abaixo.

Valor	Signficado
0	Utiliza o padrão SPB(Sistema de Pagamentos Brasileiro).
DinamoApi.ND_SPB_ENCODE_GEN_01	Gera uma mensagem GEN 01.
DinamoApi.ND_SPB_USE_CIP1	Utiliza o padrão CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Quando esta flag não está definida o padrão SPB(Sistema de Pagamentos Brasileiro) é utilizado.
DinamoApi.ND_SPB_USE_ANY	Aceita o padrão CIP/C3 Nuclea e SPB. A detecção é feita internamente.
DinamoApi.ND_SPB_ENCODE_HEADER_V3	Codifica a mensagem utilizando o cabeçalho de segurança versão 3. No futuro esta opção será definida por padrão. O cabeçalho V3 está disponível a partir da versão 5.0.16 do firmware do HSM.

DinamoApi.ND_SPB_RAW

Modo sem verificações específicas de SPB. Aceita apenas o uso do nome do MAP como parâmetros de szSrcISPB e szDstISPB.

Retorna: Mensagem assinada.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBEncode() [3/3]

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

inline

Codifica uma mensagem com o cabeçalho do SPB, assinando, criptografando e incluindo todos os campos de cabeçalhos definidos no manual de segurança da 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 Mensagem que será codificada. O Stream passado deve suportar a propriedade Length. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.

sMsgOut Stream que receberá a mensagem de saída codificada. O Stream passado deve suportar a propriedade Length e o método Seek. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.

bSpecialTreatment Indicador de tratamento especial. Vide C04 no manual de segurança do SPB.

bErrorCode Código de erro da mensagem para ser colocado no cabeçalho de segurança, normalmente em mensagens de resposta.

dwFlags

Define detalhes da codificação, podendo assumir os seguintes valores descritos na tabela abaixo.

Valor	Signficado
0	Utiliza o padrão SPB(Sistema de Pagamentos Brasileiro).
DinamoApi.ND_SPB_ENCODE_GEN_01	Gera uma mensagem GEN 01.
DinamoApi.ND_SPB_USE_CIP1	Utiliza o padrão CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Quando esta flag não está definida o padrão SPB(Sistema de Pagamentos Brasileiro) é utilizado.
DinamoApi.ND_SPB_USE_ANY	Aceita o padrão CIP/C3 Nuclea e SPB. A detecção é feita internamente.
DinamoApi.ND_SPB_ENCODE_HEADER_V3	Codifica a mensagem utilizando o cabeçalho de segurança versão 3. No futuro esta opção será definida por padrão. O cabeçalho V3 está disponível a partir da versão 5.0.16 do firmware do HSM.

DinamoApi.ND_SPB_RAW

Modo sem verificações específicas de SPB. Aceita apenas o uso do nome do MAP como parâmetros de szSrcISPB e szDstISPB.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBDecode() [1/4]

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

inline

Decodifica uma mensagem no padrão SPB, checando as assinaturas, decriptografando porem não faz a checagem de encoding.

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	Mensagem codificada no padrão SPB passada como um array de bytes.

Retorna: Mensagem decodificada.

Exceções

DinamoException.DinamoException Em caso de erro

Exemplos: spb.cs e spb_file_cip.cs.

◆ SPBDecode() [2/4]

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

inline

Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

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	Mensagem codificada no padrão SPB passada como um array de bytes.
AcceptExpiredCert	Aceita fazer operação mesmo com um certificado expirado.
AutoUpdateCert	Interpreta mensagens de troca de certificado e executa internamente a operação automaticamente.

Retorna: Mensagem decodificada.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBDecode() [3/4]

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

inline

Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

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 Mensagem codificada no padrão SPB passada como um array de bytes.

AcceptExpiredCert Aceita fazer operação mesmo com um certificado expirado.

AutoUpdateCert Interpreta mensagens de troca de certificado e executa internamente a operação automaticamente.

dwFlags

Define detalhes da decodificação, podendo assumir os seguintes valores descritos na tabela abaixo.

Valor	Signficado
0	Utiliza o padrão SPB(Sistema de Pagamentos Brasileiro).
DinamoApi.ND_SPB_OUT_NO_PADDING	Retira o padding do final da mensagem SPB após a decriptação.
DinamoApi.ND_SPB_OUT_WITH_PADDING	Mantem o padding no final da mensagem SPB após a decriptação.
DinamoApi.ND_SPB_USE_CIP1	Utiliza o padrão CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Quando esta flag não está definida o padrão SPB(Sistema de Pagamentos Brasileiro) é utilizado.
DinamoApi.ND_SPB_USE_ANY	Aceita o padrão CIP/C3 Nuclea e SPB. A detecção é feita internamente.

Retorna: Mensagem decodificada.

DinamoApi.ND_SPB_RAW | Modo sem verificações específicas de SPB. Aceita apenas o uso do nome do MAP como parâmetros de szSrcISPB e szDstISPB.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBDecode() [4/4]

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

inline

Decodifica uma mensagem no padrão SPB, checando as assinaturas e decriptografando.

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 Mensagem codificada no padrão SPB. O Stream passado deve suportar a propriedade Length. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.

sMsgOut Stream que receberá a mensagem de saída codificada. O Stream passado deve suportar a propriedade Length e o método Seek. O HSM Não faz conversão automática de formato. No padrão do SPB o formato definido é o UTF16-BE, e cabe ao chamador da API garantir que a mensagem esteja usando o formato correto.

AcceptExpiredCert Aceita fazer operação mesmo com um certificado expirado.

AutoUpdateCert Interpreta mensagens de troca de certificado e executa internamente a operação automaticamente.

dwFlags

Define detalhes da decodificação, podendo assumir os seguintes valores descritos na tabela abaixo.

Valor	Signficado
0	Utiliza o padrão SPB(Sistema de Pagamentos Brasileiro).
DinamoApi.ND_SPB_OUT_NO_PADDING	Retira o padding do final da mensagem SPB após a decriptação.
DinamoApi.ND_SPB_OUT_WITH_PADDING	Mantem o padding no final da mensagem SPB após a decriptação.
DinamoApi.ND_SPB_USE_CIP1	Utiliza o padrão CIP(Camara Interbancaria de Pagamentos)/C3 Nuclea. Quando esta flag não está definida o padrão SPB(Sistema de Pagamentos Brasileiro) é utilizado.
DinamoApi.ND_SPB_USE_ANY	Aceita o padrão CIP/C3 Nuclea e SPB. A detecção é feita internamente.

DinamoApi.ND_SPB_RAW

Modo sem verificações específicas de SPB. Aceita apenas o uso do nome do MAP como parâmetros de szSrcISPB e szDstISPB.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBMapInfoCert()

string SPBMapInfoCert ( string sIdCert )

inline

Cria um mapa com o certificado da instituição em um slot.

Parâmetros

sIdCert Identificação/label do certificado no HSM

Retorna: Nome do objeto mapa criado no HSM.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBSetISPBMap()

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

inline

Cria um mapa com a chave e certificado da instituição em um slot.

Parâmetros

sIdMap	Identificação do mapa (pode ser o ISPB)
sIdKey	Identificação da chave
sIdCert	Identificação do certificado

Exceções

DinamoException.DinamoException Lança exceção no caso de erros na assinatura

◆ SPBImportPKCS12() [1/2]

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

inline

Importa um certificado de um container PKCS#12 para o HSM.

Parâmetros

szPkcs12File Caminho e nome do arquivo.

szPkcs12Pwd Senha

szNamespace Partição onde está o objeto.Se o objeto estiver na mesma partição logada, pode passar null.

szDomain Dominio do SPB.

dwKeyAttr

Parâmetros adicionais da chave.

Valor	Significado
DinamoApi.NONEXPORTABLE_KEY	A chave Não poderá sair do HSM.
DinamoApi.EXPORTABLE_KEY	A chave poderá ser exportada do HSM.
DinamoApi.TEMPORARY_KEY	A chave somente existirá enquanto a sessão estiver ativa. Ela será destruída após o encerramento da sessão.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBImportPKCS12() [2/2]

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

inline

Importa um certificado de um container PKCS#12 para o HSM.

Parâmetros

szPkcs12File Caminho e nome do arquivo.

szPkcs12Pwd Senha.

szNamespace Partição onde está o objeto.Se o objeto estiver na mesma partição logada, pode passar null.

szDomain Dominio do SPB.

dwKeyAttr

Parâmetros adicionais da chave.

Valor	Significado
DinamoApi.NONEXPORTABLE_KEY	A chave Não poderá sair do HSM.
DinamoApi.EXPORTABLE_KEY	A chave poderá ser exportada do HSM.
DinamoApi.TEMPORARY_KEY	A chave somente existirá enquanto a sessão estiver ativa. Ela será destruída após o encerramento da sessão.

isActivate Ativa o certificado durante a importação

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBImportCertificate() [1/3]

void SPBImportCertificate	(	string	szDomain,
		byte[]	bCertificate )

inline

Importa um certificado para um namespace do HSM.

Parâmetros

szDomain	Dominio do SPB.
bCertificate	Certificado SPB no padrão SPB como um array de bytes.

Exceções

DinamoException.DinamoException Em caso de erro

Exemplos: spb_import_activate.cs.

◆ SPBImportCertificate() [2/3]

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

inline

Importa um certificado para um namespace do HSM.

Parâmetros

szDomain	Dominio do SPB.
bCertificate	Certificado SPB no padrão SPB como um array de bytes.
isCIPCertificate	Verdadeiro se o certificado for no padrão CIP.

Exceções

DinamoException Lança exceção em caso de erro.

◆ SPBActivateCertificate() [1/2]

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

inline

Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

Parâmetros

szDomain	Dominio do SPB.
szCA	Identificação da CA (número da CA).
szSN	Número de série do certificado no formato Hexadecimal
isCIPCertificate	Verdadeiro se o certificado for no padrão CIP.

Os números de CA existentes consta no manual de segurança da RSFN.

Exceções

DinamoException.DinamoException Em caso de erro

Exemplos: spb_import_activate.cs.

◆ SPBImportCertificate() [3/3]

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

inline

Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

Parâmetros

szNamespace	Partição onde está o objeto.Se o objeto estiver na mesma partição logada, pode passar `null`.
szDomain	Dominio do SPB.
bCertificate	Certificado SPB no padrão SPB como um array de bytes.
isCIPCertificate	Verdadeiro se o certificado for no padrão CIP.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBActivateCertificate() [2/2]

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

inline

Ativa um certificado que já foi importado para o HSM. Se houver um outro certificado ativo, ele será inativado.Somente um certificado permanecerá ativo por instituição, por domínio dentro de um namespace do HSM.

Parâmetros

szNamespace	Partição onde está o objeto.Se o objeto estiver na mesma partição logada, pode passar `null`.
szDomain	Dominio do SPB.
szCA	Identificação da CA (número da CA).
szSN	Número de série do certificado no formato Hexadecimal
isCIPCertificate	Verdadeiro se o certificado for no padrão CIP.

Os números de CA existentes consta no manual de segurança da RSFN.

Exceções

DinamoException.DinamoException Em caso de erro

◆ SPBCalculateObjectId()

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

inline

Função para auxiliar a formatação da identificação de objetos internos do HSM segundo o padrão utilizado no móduloSPB.

Parâmetros

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

Retorna: Nome no formato do móduloSPB.

◆ SPBGetCertificateInfo()

DinamoApi.SPB_CERT_X509_INFO SPBGetCertificateInfo ( byte[] certificate )

inline

Recupera informações do certificado.

Parâmetros

certificate Array de bytes com o certificado

Retorna: Informções do certificado. DinamoApi.SPB_CERT_X509_INFO

Exceções

DinamoException Lança exceção em caso de erro.

Exemplos: spb_import_activate.cs.