# Token A3 Físico
Este guia é um passo a passo sobre como instalar o componente do Presto para que seja possível acessar sistemas via Presto com o token A3 físico.
** Suporte: **em caso de dúvidas, entre em contato com a nossa equipe de suporte pelo e-mail **leandro@oystr.com.br**.
# **Pré-requisitos de funcionamento**
Para que o Presto possa usar o A3 para acessar um sistema, é necessário que:
**1. **O token A3 esteja instalado em uma máquina ligada e com acesso à internet no momento em que o usuário do Presto deseja realizar o login.
**2. **A máquina deve estar rodando o componente a3-proxy-go, que faz a conexão entre o Presto e o A3.
**3. **O certificado A3 deve estar corretamente configurado no cofre do Presto.
**4. **O usuário tenha a permissão de acessar o site desejado com o A3.
# **Requisitos**
Para instalação do a3-proxy-go, é necessária uma máquina Linux com Ubuntu 22.04 LTS ou Ubuntu 24.04 LTS, com os seguintes pacotes instalados:
● pcscd (instalado e rodando)
● docker (instalado e rodando)
● driver do seu token físico
● a3-proxy-go (instalado e rodando)
● token A3 (plugado na máquina e devidamente reconhecido)
# **Preparação**
## **Interface USB**
Certifique-se de que o token A3 está conectado à máquina e execute o seguinte comando:
sudo lsusb | grep -iE 'giesecke|starsign|token|smart'
O resultado deve ser algo semelhante a:
Bus 001 Device 004: ID 0529:0620 Giesecke & Devrient GmbH StarSign CUT
Indicando que o token A3 está conectado à máquina e que o sistema USB reconheceu o token.
## **pcscd**
Certifique-se de que o daemon pcscd esteja rodando e execute os seguintes comandos:
sudo pcscd --version
sudo systemctl is-active pcscd
sudo ls -la /run/pcscd/pcscd.comm
sudo pcsc\_scan -n
O resultado do último comando deve ser algo semelhante a:
Scanning present readers...
0: Giesecke & Devrient StarSign CUT (00000000) 00 00
Reader 0: Giesecke & Devrient StarSign CUT (00000000) 00 00
Card state: Card inserted,
ATR: 3B FF 96 00 00 81 31 FE 43 80 31 80 65 B0 84 41 3D F6 12 0F FE 82 90 00 55
Indicando que o pcscd reconhece o seu token A3. Em caso de erro, verifique se o token A3 está devidamente conectado à máquina, com o driver instalado e com o daemon pcscd rodando.
Caso seja necessário, instale os pacotes do pcscd com:
sudo apt update
sudo apt install -y pcscd libccid pcsc-tools
sudo systemctl enable --now pcscd
## **docker**
Instale o docker no Ubuntu:
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \\
| sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb \[arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg\] \\
https://download.docker.com/linux/ubuntu jammy stable" \\
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo usermod -aG docker "$USER" \# faça logout/login para o grupo ter efeito
Teste o docker com:
sudo docker run --rm hello-world
# **Instalação do a3-proxy-go**
Faça o download das 2 versões disponíveis do nosso container com:
sudo docker pull southamerica-east1-docker.pkg.dev/oystr-presto-test/presto-public/a3-proxy-go:<versão-1>
sudo docker pull southamerica-east1-docker.pkg.dev/oystr-presto-test/presto-public/a3-proxy-go:<versão-2>
** Atenção: **as tags de versão das imagens (nos comandos docker pull e na imagem do docker run) aparecem truncadas no documento de origem. Substitua <versão-1>, <versão-2> e v1.1.<patch> pelas tags exatas informadas pela equipe do Presto.
Após a realização de todos os passos anteriores, você está pronto para rodar o a3-proxy-go. Antes de rodar, é necessário entrar em contato com a nossa equipe e requisitar o id a ser usado. No exemplo abaixo, usamos <id> como exemplo:
sudo docker run -d \\
--name a3-proxy-go \\
--restart unless-stopped \\
-e HOST\_PCSC=1 \\
-e FRP\_NAME=<id> \\
-e POLL\_INTERVAL=5 \\
-e PKCS11\_MODULE=/usr/lib/libaetpkss.so \\
-p 8443:8443 \\
-v /run/pcscd/pcscd.comm:/run/pcscd/pcscd.comm \\
southamerica-east1-docker.pkg.dev/oystr-presto-test/presto-public/a3-proxy-go:v1.1.<patch>
A depender da sua versão de Linux, o parâmetro HOST\_PCSC deve ser alterado segundo a tabela abaixo:
| **Host**
| **pcscd version**
| **HOST\_PCSC**
|
| Ubuntu 22.04
| 1.9.x
| 1
|
| Ubuntu 24.04
| 2.0.3
| 1
|
| Fedora 41+
| 2.3.x
| 2
|
| macOS
| (none)
| unsupported
|
# **Pronto!**
Depois de obter o id com a equipe do Presto e rodar o container, você está pronto para configurar o token A3 no nosso cofre.
# **Manutenção**
**1. **Se a máquina estiver desligada, o container do docker parado, ou sem acesso à internet, o acesso ao A3 não funciona e, por consequência, o login via Presto também não.
**2. **Eventualmente será necessário retirar e recolocar o A3 na máquina. Isso não tem relação com o Presto, mas com o hardware da máquina.
**3. **Se o container a3-proxy-go tiver problemas, é necessário enviar os logs para a nossa equipe avaliar. Rode: sudo docker logs --tail 5000 a3-proxy-go
**4. **Caso seja necessário, reinicie o container com: sudo docker restart a3-proxy-go
*Presto · Oystr — Guia de instalação do a3-proxy-go para acesso via token A3 físico.*