Linux
Configurando o Receitanet no Linux 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 Java. 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 é " /home/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.
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 Localize o diretório de bibliotecas do Mozilla/Firefox
Primeiramente é preciso localizar o diretório do Mozilla/Firefox que contém a biblioteca "libsoftokn3.so".
Isto pode ser feito usando-se o comando locate .
Em um terminal, digite:
usuario$ locate libsoftokn3.so
/usr/lib/firefox-1.0.7/libsoftokn3.so
/usr/lib/thunderbird-1.0.6/libsoftokn3.so
usuario$
Neste exemplo, o diretório de bibliotecas do Mozilla/Firefox é " /usr/lib/firefox-1.0.7 "
Passo 3.2 - Localize o diretório de profile do Mozilla/Firefox
O segundo passo é determinar qual o diretório associado ao profile do Mozilla/Firefox. Neste diretório o Mozilla/Firefox armazena as configurações do usuário. Se um certificado já estiver instalado no Mozilla/Firefox, ele também estará armazenado neste diretório, em arquivos com a extensão ".db".
Os diretórios de profile do Mozilla/Firefox no Linux estão sob o diretório " $HOME/.mozilla " (Mozilla) ou " $HOME/.mozilla/firefox " (Firefox).
Dentro do diretório de profiles do Mozilla/Firefox existe um diretório de profile chamado de default (padrão). Na maioria dos casos, é onde estarão armazenados os certificados do navegador.
O diretório do profile default para o usuário de exemplo (usuario) no Firefox seria parecido com " /home/usuario/.mozilla/firefox/iy9q2qt8.default ".
Observação: O prefixo "iy9q2qt8" é gerado aleatoriamente pelo navegador Firefox e varia de sistema para sistema.
O diretório do profile default para o usuário de exemplo (usuario) no Mozilla seria parecido com " /home/usuario/.mozilla/default/r5khment.slt ".
Observação: O prefixo "r5khment" é gerado aleatoriamente pelo navegador Mozilla e varia de sistema para sistema.
Nomes de profile contendo caracteres não-ASCII (por exemplo, caracteres acentuados), embora permitidos pelo Mozilla/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 de acordo com o padrão a seguir:
name=Mozilla/Firefox
library=[Diretório de bibliotecas do Mozilla]/libsoftokn3.so
nssArgs="configdir='[Diretório de profile]' certPrefix='' keyPrefix='' secmod='secmod.db' flags=readOnly"
slot=2
substituindo [Diretório de bibliotecas 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=/usr/lib/firefox-1.0.7/libsoftokn3.so
nssArgs="configdir='/home/usuario/.mozilla/firefox/iy9q2qt8.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)
- 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 Mozilla/Firefox, pode ser necessário que o diretório de bibliotecas do Mozilla/Firefox seja adicionado à variável de ambiente " LD_LIBRARY_PATH ", dependendo da configuração de seu sistema.
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.