Partilhar via


Preparando-se para usar o CAPICOM

Observação

O CAPICOM 2.1.0.2 estava disponível no SDK do Windows para uso nos seguintes sistemas operacionais: Windows Server 2008, Windows Vista e Windows XP. Para x64 e uso em sistemas operacionais posteriores, use .NET ou .NET Framework para implementar recursos de segurança. Para obter mais alternativas e informações adicionais, consulte Alternativas ao uso do CAPICOM.

Observação

Para obter informações sobre versões do CAPICOM, consulte versões do CAPICOM.

Os aplicativos que usam objetos CAPICOM devem ser criados usando CAPICOM.dll. CAPICOM.dll também deve estar presente e registrado em tempo de execução para usar objetos CAPICOM. CAPICOM.dll deve ser adicionado a referências de projetos do Visual Basic para usar objetos CAPICOM.

Para registrar CAPICOM.dll em um prompt de comando, vá para o diretório onde CAPICOM DLL está armazenado e digite o seguinte comando:

regsvr32 CAPICOM.dll

Exemplo de limitações de código

Para fornecer um código mais conciso e mais legível, os princípios de boas práticas de programação nem sempre são seguidos nestes exemplos. Em particular, apenas respostas de erro limitadas são mostradas. Os aplicativos de trabalho devem sempre verificar os códigos de erro retornados e executar as ações apropriadas quando um erro é encontrado.

Contêineres de Chaves Necessários, Chaves e Certificados no CAPICOM

Embora algumas operações com objetos CAPICOM possam ser feitas em qualquer computador por qualquer usuário, a criação de assinaturas digitais e a recuperação do conteúdo de texto simples de uma mensagem envelopada usando objetos CAPICOM são operações baseadas em certificado. O usuário que cria uma assinatura digital e o usuário que recupera o conteúdo criptografado de uma mensagem envelopada devem ter um certificado digital com uma chave privada associada disponível. Se um certificado com uma chave privada associada não estiver presente, a operação criptográfica falhará. Os usuários de aplicativos CAPICOM devem garantir que eles tenham o certificado apropriado e a chave privada disponível quando os aplicativos estiverem em execução.

Alguns exemplos nas seções a seguir executam operações que exigem um par de chaves pública/privada disponível para criptografar e descriptografar arquivos, mensagens e assinaturas. Muitos desses programas serão compilados e executados, mas falharão durante a execução sem a existência de contentores de chave adequados, chaves, repositórios de certificados e certificados nesses repositórios.

Criar um certificado autoassinado

Para criar um certificado autoassinado, use a ferramenta makecert.exe. As etapas a seguir mostram como criar um certificado autoassinado:

  1. Instale as ferramentas de assinatura. Eles são instalados como parte do Microsoft Windows Software Development Kit (SDK), o Platform Software Development Kit (SDK) ou o .NET Framework SDK.

  2. Depois que Makecert.exe for baixado, execute o seguinte comando em um prompt de comando, substituindo um nome de usuário por UserName, um nome de organização para OrganizationNamee um nome de empresa para CompanyName:

    makecert -r -n "cn=UserName, ou=OrganizationName, o=CompanyName" -ss my
    
  3. O certificado pode ser colocado no Meu repositório do usuário atual. Importe o certificado criado para o armazenamento raiz para que ele seja confiável.