11.2. Certificado Digital
11.2.1. Pega o nome do certificado digital
11.2. Certificado Digital
« Anterior
11.2.2. Pega propriedades de um certificado digital
Próximo »

11.2.1. Pega o nome do certificado digital

Pega o nome do certificado digital

Assinatura:

string PegaNomeCertificado(ref string certificado, out string MsgResultado)

Descrição:

Funcionalidade para recuperar o nome (Assunto) do titular do certificado digital ou confirmar a existência de um certificado digital com o mesmo nome no repositório de certificados digitais do usuário corrente do Windows.

A conexão com o WS e o processo de assinatura digital XML requerem o uso do certificado digital do emissor.

A indicação do certificado digital que será utilizado é realizada através do parâmetro Nome na maioria das funcionalidades, devendo ser preenchido com o campo Assunto do titular do certificado digital.

Validade do Certificado Digital

A funcionalidade só mostra e pesquisa a lista de certificados digitais que estão dentro do período de validade. Assim, os certificados digitais que não se encontram dentro do período de validade não serão apresentados. Algumas AC emitem certificados digitais com data de início de validade futura, neste caso o certificado digital só vai ser mostrado a partir da data e hora que constar como data de início de validade, da mesma forma os certificados digitais expirados não serão mostrados.

Repositório de Certificado Digital

A funcionalidade pesquisa o repositório de certificados digitais do usuário corrente, isto é, somente os certificados digitais instalados no repositório de certificados digitais do logon do usuário estarão disponíveis. Caso a aplicação seja um serviço windows ou seja executada como um serviço (aplicação ASP), pode ser necessária a instalação do certificado digital no repositório local machine e uma versão diferente da DLL.

Certificado Digital com chave privada

Quando falamos de certificado digital válido, estamos falando de um certificado digital com chave privada. Já aconteceu do desenvolvedor receber o certificado digital do cliente, que mesmo após a instalação não aparecia no repositório de certificados digitais por não possuir a chave privada. A chave pública do certificado digital não tem a chave privada e geralmente tem a extensão cer, assim caso receba um arquivo com esta extensão, existe uma grande possibilidade de ser uma chave pública que não serve para autenticar e nem para assinatura digital.

Também é possível verificar se o certificado digital tem chave privada ou não pela sua propriedade na opção Ferramentas/Opções da Internet/Conteúdo/Certificados/Exibir do menu do Internet Explorer:

ExemploCertificado

Parâmetros:

nome tipo fluxo descrição
certificado string entrada/saída informar o nome do titular do certificado digital que deseja confirmar a existência. Se o conteúdo for omitido, a funcionalidade exibe uma caixa de diálogo com os certificados digitais existentes no repositórios de certificados digitais do usuário corrente para seleção. Caso seja informado um nome do titular do certificado digital, a funcionalidade verifica a existência do certificado digital
msgResultado string saída retorna a literal do resultado da chamada da DLL

Retorno:

O resultado da chamada do pegaNomeCertificado retorna um código numérico com os seguintes significados:

código Mensagem
0 Selecionado um Certificado
1 Foi selecionado um Certificado com o nome informado
2 Nenhum Certificado Selecionado
3 Nenhum certificado válido foi encontrado com o nome informado
4 Erro Inesperado: [Mensagem]

Histórico de atualização:

Exemplos de uso:

Visual Basic 6.0

'
' declaração das variáveis que serão utilizadas na passagem de parâmetros da DLL
'
Dim resultado As Long       ' retorna o resultado da consulta do certificado digital
Dim msgResultado As String  ' retorna a literal do resultado da chamada da DLL
Dim certificado As String   ' informar o nome do titular do certificado digital que deseja confirmar a existência. Se o conteúdo for omitido, a funcionalidade exibe uma caixa de diálogo com os certificados digitais existentes no repositórios de certificados digitais do usuário corrente para seleção. Caso seja informado um nome do titular do certificado digital, a funcionalidade verifica a existência do certificado digital

resultado = 0       ' retorna o resultado da consulta do certificado digital
certificado = ""    ' informar o nome do titular do certificado digital
msgResultado = ""   ' retorna a literal do resultado da chamada da DLL
'
' referenciando a DLL em late binding
' não é necessário fazer o reference da DLL
' o intelisense não funciona
'
Dim objCTeUtil As Object
 
Set objCTeUtil = CreateObject("CTe_Util.Util")
'
' pega certificado
'
' o texto que retorna no campo Certificado será utilizada para identificar
' o certificado digital em uso para as demais chamadas que necessitam de
' um certificado digital
'
resultado = objCTeUtil.PegaNomeCertificado(certificado, msgResultado)
If resultado < 5403 Then
   If InStr(1, certificado, "Associacao", vbTextCompare) > 0 Then
      MsgBox "O certificado digital da Associação não é um certificado válido para consumir os WS do CT-e! Procure adquirir um certificado digital válido para prosseguir com os testes...", vbInformation, "Resultado"
   End If
   MsgBox certificado, vbInformation, "Informação" ' escolhido um certificado digital  
Else
   MsgBox msgResultado, vbInformation, "Resultado"
End If
 
'
' libera classe
'
Set objCTeUtil = Nothing
End Sub
11.2.1. Pega o nome do certificado digital
11.2. Certificado Digital
« Anterior
11.2. Certificado Digital
Próximo »
11.2.2. Pega propriedades de um certificado digital