Distrobox-adv-br

Trata-se de arquivo assemble para criar contêiner via distrobox com pacotes que fornecem ambiente para uso de certificado digital por advogados no Brasil em qualquer distribuição de Linux recente.

Estão incluídos:

1. Driver denominado Safesign necessário para uso do token GD Burti, atualmente o mais utilizado pela advocacia;

2. Driver denominado SafeNet necessário para uso do token SafeNet 5100, o segundo mais utilizado pela advocacia;

3. Driver denominado SerproID, necessário para uso do certificado digital na nuvem da Serpro;

4. PJeOffice Pro, utilizado para assinatura eletrônica de documentos do sistema PJe, fornecido pelo Conselho Nacional de Justiça - CNJ;

5. Assinador Serpro, utilizado para assinar documentos com certificado digital ou validar documentos já assinados;

6. Lacuna Webpki e Softplan Websigner, utilizado para assinatura eletrônica de documento em sistemas SAJ, fornecido pela Softplan;

7. Certisign WebSigner, utilizado no portal de assinatura eletrônica da OAB;

8. Firefox, utilizado para acessar sítios de internet, especialmente aqueles que demandam acesso ao token de certificado digital de modo direto, tais como Projudi e eproc.

---

Instalação

1. Primeiramente, é necessário instalar o distrobox e podman em sua distribuição, além dos pacotes pcsc-lite e ccid - caso já não os tenha -, necessários para que seu sistema possa acessar o token.

Debian, Ubuntu, Linux Mint, Zorin e Pop!_OS:

sudo apt install pcscd libccid distrobox podman

OBS:: Se sua distribuição for Ubuntu 24.04 ou derivada, tais com Linux Mint (versão principal), Zorin OS e Pop!_OS, é necessário antes instalar o PPA do distrobox, uma vez que a versão da distribuição está desatualizada:

sudo add-apt-repository ppa:michel-slm/distrobox -y

Fedora Workstation e KDE Plasma:

sudo dnf install distrobox podman

Arch Linux:

pacman -S distrobox podman pcsclite ccid

openSUSE Tumbleweed:

sudo zypper in distrobox podman pcsc-ccid

OBS: Distribuições como Bluefin e Aurora já vêm com distrobox pré-instalado no sistema.

2. Habilitar o pcsc-lite no sistema caso já não esteja:

sudo systemctl enable --now pcscd.service

3. Instalar o distrobox-adv-br mediante o comando abaixo:

Para distribuições em geral:

distrobox-assemble create --file https://raw.githubusercontent.com/pedrohqb/distrobox-adv-br/refs/heads/main/distrobox-adv-br

Para Ubuntu 24.04 ou distribuições derivadas, tais com Linux Mint (versão principal), Zorin OS e Pop!_OS, bem como Bluefin LTS (baseado em CentOS):

distrobox-assemble create --file https://raw.githubusercontent.com/pedrohqb/distrobox-adv-br/refs/heads/main/distrobox-adv-br-ubuntu-24-04

---

Uso

Terminada a instalação, os aplicativos acima mencionados estarão disponíveis para acesso no menu ou equivalente de seu ambiente desktop devidamente identificados com o nome do projeto entre parenteses. Por exemplo: Firefox-ESR (on distrobox-adv-br).

Os token SafeNet e Safesign já estão habilitados no Firefox; o certificado na nuvem SerproID é configurado automaticamente no Firefox após sua instalação na máquina.

---

Configuração SerproID

Para configurar o certificado SerproID no plugin do Lacuna Webpki, Softplan Websigner e Certisign WebSigner, deve-se aplicar as orientações a seguir:

1. Abrir o plugin no Firefox;

2. Acessar a aba "Cripto Dispositivos";

3. Em "Opções personalizadas", no campo "Nome do arquivo SO (com extensão), adicionar "/lib/libneoidp11.so" (sem aspas) e apertar o sinal de "+".

---

Configuração Assinador Serpro

Para configurar o Assinador Serpro, deve-se aplicar as orientações a seguir:

1. Acessar a opção "Configurações" no aplicativo;

2. Acessar a aba "Carregar Driver";

3. Selecionar "Carregar driver local" e clicar em "Selecionar arquivo (.so ou .dll);

4. Abrir o arquivo /lib/libneoidp11.so, se for utilizar o certificado do SerproID; o arquivo /lib/libaetpkss.so, se for utilizar token SafeSign; ou o /lib/libeToken.so, se for utilizar token Safenet.

5. Pressionar "Salvar".

---

Desinstalação

Para desinstalar (inclusive para fazer uma reinstalação limpa), basta rodar os seguintes comandos:

distrobox rm distrobox-adv-br distrobox-adv-br-ubuntu-24-04

rm -rf ~/.distrobox-adv-br*

---

Limitações

Existem algumas limitações decorrentes do próprio uso de contêineres. As conhecidas encontram-se a seguir:

1. Assinador Serpro indica que não há conexão por internet. Trata-se de falso positivo, uma vez que a integração com outros sistemas funciona normalmente.

Nenhuma das limitações traz repercussões negativas ao uso das ferramentas.

---

Suporte

Havendo qualquer dificuldade no uso de ferramenta, forneça um issue e peça suporte no grupo oficial no Telegram.