Microsoft Windows
Configurando o Receitanet no Microsoft Windows para uso dos certificados instalados nos navegadores Mozilla e Firefox
Passo 1 - Identificar o diretório de configurações do Receitanet
Primeiramente, é preciso localizar o diretório de configurações do Receitanet. Na tela principal do programa clique no botão "Sobre..." . Será exibida uma tela semelhante à seguinte:
Neste exemplo, o diretório de configuração do Receitanet é "C:\DocumentsandSettings\usuario\.receitanet".
Passo 2 - Criar um arquivo de configuração PKCS#11
Para que o provider possa ter acesso aos certificados, é preciso criar um arquivo com a extensão ".cfg" no diretório de configuração do Receitanet. Utilizando um editor de texto de sua preferência, crie o arquivo "mozilla.cfg" no diretório obtido no passo 1 acima.
Observação: Ao criar o arquivo, certifique-se de que a extensão seja realmente ".cfg", e não ".txt".
Passo 3 - Inserir informações no arquivo de configuração
Uma vez criado o arquivo de configuração, é necessário preenchê-lo com algumas informações sobre a instalação do Mozilla/Firefox no seu sistema.
Passo 3.1. Primeiro localize o diretório de instalação do Mozilla/Firefox
Clique com o botão direito no atalho de acesso ao navegador Mozilla/Firefox em sua área de trabalho (Desktop) ou no menu Iniciar. Selecione a opção"Propriedades..." .Será exibida uma tela semelhante a esta:
Neste exemplo, o diretório de instalação do Firefox é " C:\Program Files\Mozilla Firefox ".
Passo 3.2. Localize o diretório de profile do Mozilla Firefox
Este diretório é o local onde o Firefox armazena as configurações do usuário. Se um certificado já estiver instalado no Firefox, ele também estará armazenado neste diretório, em arquivos com a extensão ".db".
A localização dos diretórios de profile do Firefox varia de acordo com a versão do Windows.
Windows XP | \Documents and Settings\<usuario>\Application Data\Mozilla\Firefox\Profiles\<aleatorio>.<profile> |
Windows Vista / Windows 7 | \Users\<usuario>\AppData\Roaming\Mozilla\Firefox\Profiles\<aleatorio>.<profile> |
No diretório de profiles do Firefox existe um diretório chamado default (padrão). Na maioria dos casos, é onde estarão armazenados os certificados digitais do navegador.
O diretório do profile default para o usuário de exemplo ( usuario ) no Firefox (Windows XP) seria parecido com "C:\Documents and Settings\usuario\Dados de aplicativos\Mozilla\Firefox\Profiles\yztgbs9m.default". No Windows 7 seria parecido com C:\Users\usuario\AppData\Roaming\Mozilla\Firefox\Profiles\yztgbs9m.default
Observação: O prefixo "yztgbs9m" é gerado aleatoriamente pelo navegador Firefox e varia de sistema para sistema.
Nomes de profile contendo caracteres não-ASCII (por exemplo, caracteres acentuados), embora permitidos pelo Firefox, não podem ser usados com o Receitanet.
Passo 3.3. Atualize o arquivo de configuração com as informações obtidas anteriormente
O próximo passo é criar o conteúdo do arquivo mozilla.cfg conforme o padrão descrito a seguir:
name=Mozilla/Firefox
library=[Diretório de instalação do Mozilla]\softokn3.dll
nssArgs="configdir='[Diretório de profile]' certPrefix='' keyPrefix='' secmod='secmod.db' flags=readOnly"
slot=2
substituindo [Diretório de instalação do Mozilla] pelo valor obtido no passo 3.1 e [Diretório de profile] pelo valor obtido no passo 3.2
Por exemplo, o conteúdo do arquivo de configuração para o Firefox com o usuário de exemplo ( usuario ) seria:
name=Mozilla/Firefox
library=C:\Program Files\Mozilla Firefox\softokn3.dll
nssArgs="configdir='C:/Documents and Settings/usuario/Application Data/Mozilla/Firefox/Profiles/yztgbs9m.default' certPrefix='' keyPrefix='' secmod='secmod.db' flags=readOnly"
slot=2
Observações:
- O valor da propriedade name não deve conter espaços (inclusive ao final da linha), nem caracteres não-ASCII (por exemplo, caracteres acentuados)
- Na propriedade nssArgs é importante trocar "\" por "/" no nome do diretório de profile.
- O valor da propriedade nssArgs deve ser mantido em uma só linha
Passo 4 - Adicionar o diretório de instalação do Mozilla/Firefox ao PATH
Para que o Receitanet possa usar os certificados instalados no Firefox, é necessário que o diretório de instalação do mesmo seja adicionado à variável de ambiente "PATH", conforme os passos a seguir:
Na sua área de trabalho, clique com o botão direito do mouse sobre o ícone Meu Computador
Escolha a opção Propriedades
Escolha a aba Avançado , a seguinte tela aparecerá:
Clique no botão Variáveis de ambiente
Na primeira lista de variáveis, procure PATH
Se encontrou, dê um duplo clique nela e no final do valor da variável acrescente ;[Caminho do passo 3.1]
Se não encontrou, clique em Nova . No nome da variável preencha com PATH , e no valor, insira ;[Caminho do passo 3.1]
Passo 5 - Utilizando os Certificados no Receitanet
Efetuadas as configurações anteriores, vamos exemplificar o uso de um certificado instalado no Mozilla/Firefox para assinar uma declaração no Receitanet.
Suponha que o seguinte certificado, instalado no Mozilla/Firefox, será utilizado para assinar uma declaração:
No Receitanet, antes de enviar a declaração, selecione a opção "Assinar a declaração digitalmente" . O Receitanet exibirá a seguinte tela para escolha do certificado digital:
Informe a senha-mestre ( master password ) do Mozilla/Firefox e clique em Ok. Serão exibidos todos os certificados instalados no Mozilla/Firefox.
Selecione o certificado desejado e clique em " Assinar ". A declaração será assinada digitalmente e a transmissão será efetuada em seguida.