gblinux 0.1.0__tar.gz

gblinux-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.3
+Name: gblinux
+Version: 0.1.0
+Summary: Assinador de PDF com token A3 ICP-Brasil para Linux
+Author: renatormc
+Author-email: renatormc <renatomartinsrmc@gmail.com>
+Requires-Dist: asn1crypto>=1.5.1
+Requires-Dist: cryptography>=50.0.2
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: pyhanko>=0.38.1
+Requires-Dist: pykcs11>=1.5.21
+Requires-Dist: pyside6-essentials>=6.12.0
+Requires-Dist: requests>=2.34.2
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Assinador de PDF com token A3
+
+Programa para Linux que assina documentos PDF com certificado digital ICP-Brasil A3 em token USB.
+Ele fica aberto no computador e atende os pedidos de assinatura feitos pela página web do sistema.
+
+Estas instruções são para Ubuntu e derivados, como Linux Mint e Pop!_OS. É preciso ter o
+Python 3.13 ou mais novo; para conferir a versão, use `python3 --version`.
+
+## 1. Instale o driver do token
+
+```bash
+sudo apt update
+sudo apt install -y pcscd libpcsclite1 libccid pcsc-tools opensc libnss3-tools
+
+
+cd ~/Downloads
+
+# 1. Baixar e extrair o pacote oficial do ePass 2003
+curl -O "https://site.solutinet.com.br/drivers/Token/ePass2003/Linux/ePass2003_Castle_20141128.tar.gz"
+tar -zxvf ePass2003_Castle_20141128.tar.gz
+
+# 2. Copiar para /usr/lib no formato esperado pelo Assinador Serpro
+sudo rm -rf /usr/lib/ePass2003-Linux-x64
+sudo cp -rf ~/Downloads/ePass2003-Castle-20141128 /usr/lib/ePass2003-Linux-x64
+
+# 3. Criar atalhos da biblioteca PKCS#11 (libcastle.so.1.0.0) em /usr/lib
+sudo cp /usr/lib/ePass2003-Linux-x64/x86_64/redist/libcastle.so.1.0.0 /usr/lib/
+sudo ln -sf /usr/lib/libcastle.so.1.0.0 /usr/lib/libcastle.so
+
+# 4. Configurar regras USB (udev) e reiniciar o daemon pcscd
+sudo sh /usr/lib/ePass2003-Linux-x64/x86_64/config/config.sh
+sudo systemctl enable --now pcscd.socket
+sudo systemctl restart pcscd
+```
+
+Depois disso, retire o token e conecte de novo.
+
+## 2. Instale o pipx
+
+```bash
+sudo apt update
+sudo apt install pipx libxcb-cursor0
+pipx ensurepath
+```
+
+Depois disso, **feche o terminal e abra outro**.
+
+## 3. Instale o assinador
+
+```bash
+pipx install gblinux
+```
+
+## 4. Crie a entrada no menu de aplicativos
+
+```bash
+gblinux --instalar-atalho
+```
+
+O **Assinador de PDF** vai aparecer no menu de aplicativos. Se não aparecer logo, encerre a sessão e
+entre de novo.
+
+## Como usar
+
+1. Conecte o token.
+2. Abra o **Assinador de PDF** pelo menu.
+3. Deixe a janela aberta e peça a assinatura na página web.
+4. Se a janela de senha aparecer, digite a senha do token.
+
+Para encerrar, clique em **Fechar**.
+
+**Cuidado com a senha:** cada senha errada gasta uma tentativa, e o token é bloqueado quando as
+tentativas acabam.
+
+## Como testar
+
+Com o assinador aberto, rode em um terminal:
+
+```bash
+testar-assinatura arquivo.pdf
+```
+
+O arquivo assinado é salvo na mesma pasta, como `arquivo-assinado.pdf`.
+
+## Problemas comuns
+
+| O que acontece | O que fazer |
+|---|---|
+| `comando não encontrado` depois de instalar | Feche o terminal e abra outro |
+| `Token não encontrado` | Confira se o token está conectado e se o driver foi instalado |
+| A janela de senha não aparece, ou `Assinador não respondeu` | Feche o assinador, retire o token, conecte de novo e abra o assinador |
+| `O assinador já está aberto` | Procure a janela que já está aberta |
+| Aviso de porta ocupada | Feche o assinador antigo ou o outro programa que usa as portas 3399 e 4499 |
+
+## Atualizar
+
+```bash
+pipx upgrade gblinux
+```
+
+## Desinstalar
+
+```bash
+rm ~/.local/share/applications/gblinux.desktop
+rm ~/.local/share/icons/hicolor/scalable/apps/gblinux.svg
+pipx uninstall gblinux
+```

gblinux-0.1.0/README.md

@@ -0,0 +1,107 @@
+# Assinador de PDF com token A3
+
+Programa para Linux que assina documentos PDF com certificado digital ICP-Brasil A3 em token USB.
+Ele fica aberto no computador e atende os pedidos de assinatura feitos pela página web do sistema.
+
+Estas instruções são para Ubuntu e derivados, como Linux Mint e Pop!_OS. É preciso ter o
+Python 3.13 ou mais novo; para conferir a versão, use `python3 --version`.
+
+## 1. Instale o driver do token
+
+```bash
+sudo apt update
+sudo apt install -y pcscd libpcsclite1 libccid pcsc-tools opensc libnss3-tools
+
+
+cd ~/Downloads
+
+# 1. Baixar e extrair o pacote oficial do ePass 2003
+curl -O "https://site.solutinet.com.br/drivers/Token/ePass2003/Linux/ePass2003_Castle_20141128.tar.gz"
+tar -zxvf ePass2003_Castle_20141128.tar.gz
+
+# 2. Copiar para /usr/lib no formato esperado pelo Assinador Serpro
+sudo rm -rf /usr/lib/ePass2003-Linux-x64
+sudo cp -rf ~/Downloads/ePass2003-Castle-20141128 /usr/lib/ePass2003-Linux-x64
+
+# 3. Criar atalhos da biblioteca PKCS#11 (libcastle.so.1.0.0) em /usr/lib
+sudo cp /usr/lib/ePass2003-Linux-x64/x86_64/redist/libcastle.so.1.0.0 /usr/lib/
+sudo ln -sf /usr/lib/libcastle.so.1.0.0 /usr/lib/libcastle.so
+
+# 4. Configurar regras USB (udev) e reiniciar o daemon pcscd
+sudo sh /usr/lib/ePass2003-Linux-x64/x86_64/config/config.sh
+sudo systemctl enable --now pcscd.socket
+sudo systemctl restart pcscd
+```
+
+Depois disso, retire o token e conecte de novo.
+
+## 2. Instale o pipx
+
+```bash
+sudo apt update
+sudo apt install pipx libxcb-cursor0
+pipx ensurepath
+```
+
+Depois disso, **feche o terminal e abra outro**.
+
+## 3. Instale o assinador
+
+```bash
+pipx install gblinux
+```
+
+## 4. Crie a entrada no menu de aplicativos
+
+```bash
+gblinux --instalar-atalho
+```
+
+O **Assinador de PDF** vai aparecer no menu de aplicativos. Se não aparecer logo, encerre a sessão e
+entre de novo.
+
+## Como usar
+
+1. Conecte o token.
+2. Abra o **Assinador de PDF** pelo menu.
+3. Deixe a janela aberta e peça a assinatura na página web.
+4. Se a janela de senha aparecer, digite a senha do token.
+
+Para encerrar, clique em **Fechar**.
+
+**Cuidado com a senha:** cada senha errada gasta uma tentativa, e o token é bloqueado quando as
+tentativas acabam.
+
+## Como testar
+
+Com o assinador aberto, rode em um terminal:
+
+```bash
+testar-assinatura arquivo.pdf
+```
+
+O arquivo assinado é salvo na mesma pasta, como `arquivo-assinado.pdf`.
+
+## Problemas comuns
+
+| O que acontece | O que fazer |
+|---|---|
+| `comando não encontrado` depois de instalar | Feche o terminal e abra outro |
+| `Token não encontrado` | Confira se o token está conectado e se o driver foi instalado |
+| A janela de senha não aparece, ou `Assinador não respondeu` | Feche o assinador, retire o token, conecte de novo e abra o assinador |
+| `O assinador já está aberto` | Procure a janela que já está aberta |
+| Aviso de porta ocupada | Feche o assinador antigo ou o outro programa que usa as portas 3399 e 4499 |
+
+## Atualizar
+
+```bash
+pipx upgrade gblinux
+```
+
+## Desinstalar
+
+```bash
+rm ~/.local/share/applications/gblinux.desktop
+rm ~/.local/share/icons/hicolor/scalable/apps/gblinux.svg
+pipx uninstall gblinux
+```

gblinux-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "gblinux"
+version = "0.1.0"
+description = "Assinador de PDF com token A3 ICP-Brasil para Linux"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "asn1crypto>=1.5.1",
+    "cryptography>=50.0.2",
+    "pillow>=13.0.0",
+    "pyhanko>=0.38.1",
+    "pykcs11>=1.5.21",
+    "pyside6-essentials>=6.12.0",
+    "requests>=2.34.2",
+]
+
+[[project.authors]]
+name = "renatormc"
+email = "renatomartinsrmc@gmail.com"
+
+[project.scripts]
+gblinux = "gblinux:main"
+testar-assinatura = "gblinux.testar:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = ["pytest>=9.2.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["tests"]

gblinux-0.1.0/pyproject.toml.orig

@@ -0,0 +1,35 @@
+[project]
+name = "gblinux"
+version = "0.1.0"
+description = "Assinador de PDF com token A3 ICP-Brasil para Linux"
+readme = "README.md"
+authors = [
+    { name = "renatormc", email = "renatomartinsrmc@gmail.com" }
+]
+requires-python = ">=3.13"
+dependencies = [
+    "asn1crypto>=1.5.1",
+    "cryptography>=50.0.2",
+    "pillow>=13.0.0",
+    "pyhanko>=0.38.1",
+    "pykcs11>=1.5.21",
+    "pyside6-essentials>=6.12.0",
+    "requests>=2.34.2",
+]
+
+[project.scripts]
+gblinux = "gblinux:main"
+testar-assinatura = "gblinux.testar:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["tests"]

gblinux-0.1.0/src/gblinux/__init__.py

@@ -0,0 +1,8 @@
+"""Assinador de PDF com token A3 para Linux."""
+
+
+def main() -> int:
+    # Importação tardia: o processo filho usa este pacote e não deve carregar o Qt.
+    from .aplicacao import main as principal
+
+    return principal()

gblinux-0.1.0/src/gblinux/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from . import main
+
+sys.exit(main())

gblinux-0.1.0/src/gblinux/aplicacao.py

@@ -0,0 +1,86 @@
+"""Ponto de entrada do programa com janela (seção 9)."""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import signal
+import sys
+
+from PySide6.QtCore import QDir, QLockFile, QStandardPaths, QTimer
+from PySide6.QtWidgets import QApplication, QMessageBox
+
+from . import config as configuracao
+from .atalho import instalar_atalho
+from .interface import JanelaPrincipal, PerguntasQt
+from .servico import ServicoAssinatura
+from .servidor import Contexto, PortaOcupada, Servidores
+
+
+def _avisar(mensagem: str) -> None:
+    print(mensagem, file=sys.stderr)
+    QMessageBox.critical(None, "Assinador de PDF", mensagem)
+
+
+def main() -> int:
+    argumentos = argparse.ArgumentParser(description="Assinador de PDF com token A3")
+    argumentos.add_argument(
+        "--instalar-atalho", action="store_true", help="cria o atalho no menu de aplicativos e sai"
+    )
+    if argumentos.parse_args().instalar_atalho:
+        print(f"Atalho criado em {instalar_atalho()}")
+        return 0
+
+    logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(name)s: %(message)s")
+    aplicacao = QApplication(sys.argv[:1])
+    aplicacao.setApplicationName("gblinux")
+    aplicacao.setQuitOnLastWindowClosed(False)
+
+    pasta = QStandardPaths.writableLocation(QStandardPaths.StandardLocation.RuntimeLocation)
+    trava = QLockFile(QDir(pasta or QDir.tempPath()).filePath("gblinux.lock"))
+    trava.setStaleLockTime(0)
+    if not trava.tryLock(0):
+        _avisar("O assinador já está aberto.")
+        return 1
+
+    config = configuracao.carregar()
+    perguntas = PerguntasQt()
+    janela: JanelaPrincipal | None = None
+
+    def ao_mudar_ocupado(ocupado: bool) -> None:
+        if janela is not None:
+            janela.ocupado_mudou.emit(ocupado)
+
+    def ao_resultado(mensagem: str) -> None:
+        if janela is not None:
+            janela.resultado_novo.emit(mensagem)
+
+    servico = ServicoAssinatura(config, perguntas, ao_mudar_ocupado)
+    servidores = Servidores(Contexto(config, servico, ao_resultado))
+    try:
+        servidores.iniciar()
+    except PortaOcupada as erro:
+        _avisar(
+            f"A porta {erro.porta} está ocupada: o assinador já está aberto ou outro "
+            "programa usa a porta."
+        )
+        return 1
+
+    def encerrar() -> None:
+        servidores.parar()
+        servico.encerrar()
+
+    janela = JanelaPrincipal(encerrar)
+    janela.show()
+
+    # O Python só trata sinais quando recupera o controle do laço de eventos do Qt.
+    def tratar_sinal(_sinal, _quadro) -> None:
+        QTimer.singleShot(0, janela.encerrar_sem_perguntar)
+
+    signal.signal(signal.SIGTERM, tratar_sinal)
+    signal.signal(signal.SIGINT, tratar_sinal)
+    relogio = QTimer()
+    relogio.timeout.connect(lambda: None)
+    relogio.start(200)
+
+    return aplicacao.exec()

gblinux-0.1.0/src/gblinux/atalho.py

@@ -0,0 +1,39 @@
+"""Atalho no menu de aplicativos, instalado na pasta do usuário, sem root (seção 9)."""
+
+from __future__ import annotations
+
+import os
+import shlex
+import sys
+from pathlib import Path
+
+_ICONE = """<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+<path fill="#f5f5f5" stroke="#444" stroke-width="3" d="M14 5h26l12 12v42H14z"/>
+<path fill="none" stroke="#444" stroke-width="3" d="M40 5v12h12"/>
+<path fill="none" stroke="#1565c0" stroke-width="4" stroke-linecap="round"
+ d="M20 46c5-14 8-14 9-6s4 7 7 1 4-5 8 0"/>
+</svg>
+"""
+
+
+def instalar_atalho() -> Path:
+    dados = Path(os.environ.get("XDG_DATA_HOME") or Path.home() / ".local/share")
+    icone = dados / "icons/hicolor/scalable/apps/gblinux.svg"
+    icone.parent.mkdir(parents=True, exist_ok=True)
+    icone.write_text(_ICONE, encoding="utf-8")
+
+    atalho = dados / "applications/gblinux.desktop"
+    atalho.parent.mkdir(parents=True, exist_ok=True)
+    comando = shlex.join([sys.executable, "-m", "gblinux"])
+    atalho.write_text(
+        "[Desktop Entry]\n"
+        "Type=Application\n"
+        "Name=Assinador de PDF\n"
+        "Comment=Assina PDFs com o token A3\n"
+        f"Exec={comando}\n"
+        "Icon=gblinux\n"
+        "Terminal=false\n"
+        "Categories=Office;\n",
+        encoding="utf-8",
+    )
+    return atalho

gblinux-0.1.0/src/gblinux/config.py

@@ -0,0 +1,35 @@
+"""Configuração lida do ambiente. Os valores padrão vêm da especificação."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+
+PORTA_PAGINA = 3399
+PORTA_DIRETA = 4499
+
+
+def _int(nome: str, padrao: int) -> int:
+    valor = os.environ.get(nome, "").strip()
+    return int(valor) if valor else padrao
+
+
+@dataclass(frozen=True)
+class Config:
+    biblioteca_pkcs11: str = "/usr/lib/libcastle.so"
+    arquivo_cas: str | None = None
+    limite_bytes: int = 100 * 1024 * 1024
+    tempo_limite_s: float = 600.0
+    tempo_conectar_s: float = 30.0
+    tempo_ler_s: float = 120.0
+    # Tempo que o driver recebe para terminar depois de um SIGTERM.
+    tempo_encerrar_s: float = 15.0
+
+
+def carregar() -> Config:
+    return Config(
+        biblioteca_pkcs11=os.environ.get("ASSINADOR_PKCS11_LIB") or Config.biblioteca_pkcs11,
+        arquivo_cas=os.environ.get("ASSINADOR_CA_BUNDLE") or None,
+        limite_bytes=_int("ASSINADOR_LIMITE_BYTES", Config.limite_bytes),
+        tempo_limite_s=_int("ASSINADOR_TEMPO_LIMITE_S", int(Config.tempo_limite_s)),
+    )

gblinux-0.1.0/src/gblinux/download.py

@@ -0,0 +1,35 @@
+"""Download dos PDFs (seção 4.5)."""
+
+from __future__ import annotations
+
+from urllib.parse import urlsplit
+
+import requests
+
+from .config import Config
+
+
+class FalhaDownload(Exception):
+    pass
+
+
+def baixar(url: str, config: Config) -> bytes:
+    if urlsplit(url).scheme.lower() not in ("http", "https"):
+        raise FalhaDownload("somente URLs http e https são aceitas")
+    dados = bytearray()
+    try:
+        # Em redirecionamentos, o requests só aceita http e https, e recusa file:// ou ftp://.
+        with requests.get(
+            url,
+            stream=True,
+            timeout=(config.tempo_conectar_s, config.tempo_ler_s),
+            verify=config.arquivo_cas or True,
+        ) as resposta:
+            resposta.raise_for_status()
+            for bloco in resposta.iter_content(1024 * 1024):
+                dados += bloco
+                if len(dados) > config.limite_bytes:
+                    raise FalhaDownload("o arquivo excede o tamanho máximo permitido")
+    except requests.RequestException as erro:
+        raise FalhaDownload(str(erro)) from erro
+    return bytes(dados)

gblinux-0.1.0/src/gblinux/erros.py

@@ -0,0 +1,36 @@
+"""Mensagens de erro de assinatura (seção 7), mantidas iguais às do original."""
+
+from __future__ import annotations
+
+CANCELADO = "ASSINATURA DE DOCUMENTO CANCELADO PELO USUÁRIO"
+TOKEN_NAO_ENCONTRADO = "Token não encontrado"
+SENHA_INCORRETA = "Senha incorreta para o token"
+PDF_INVALIDO = (
+    "Documento não pode ser aberto e editado. Verifique se o documento esta protegido de "
+    "edição ou contem senha e se os dados do TOKEN foram informados corretamente!"
+)
+NENHUM_CERTIFICADO = "Nenhum certificado valido. Procure o gestor da sua instituição!"
+FALHA_LISTAR = (
+    "Houve um erro ao listar os dados do Token, verifique se o token ta inserido "
+    "corretamente e o dados informados"
+)
+ERRO_DRIVER = "Erro desconhecido, Verifique se foi instalado corretamente os drivers do token"
+SENHA_BLOQUEADA = "Token bloqueado por excesso de tentativas de senha."
+SEM_RESPOSTA = "Assinador não respondeu. Reinsira o token e tente novamente."
+GOVBR_INDISPONIVEL = "Assinatura via Gov.br não está disponível nesta versão"
+SEM_DOCUMENTO = "Nenhum arquivo para fazer a assinatura!"
+
+
+def chave_nao_encontrada(cpf: str) -> str:
+    return (
+        f"Chave privada do token não encontrada para o CPF [{cpf}]. Verifique se o token está "
+        "inserido, se a chave privada está correta e se o certicado está valido!"
+    )
+
+
+class ErroAssinatura(Exception):
+    """Erro que vira a resposta JSON da seção 7."""
+
+    def __init__(self, mensagem: str) -> None:
+        super().__init__(mensagem)
+        self.mensagem = mensagem