TrustBridge

Signing platform for ICP-Brasil certificates

Sign from your own application,
without moving a private key.

TrustBridge is a REST implementation of the SignSession Contract: your application presents an API key, opens a Signing Session bound to a CPF, and posts documents to it. The certificate is read where it already lives — on the holder's workstation, or in the Server's own vault — and the private key never sees more than a hash.

The key only ever sees a hash

A1 and A3 certificates are read where they live, by a service on the workstation itself; a Vault Certificate is opened inside the Server. Either way what reaches the key is a hash and what comes back is a signature, so no exportable key material crosses the network.

The holder authorises every session

Opening a session takes a PIN. For a certificate on a workstation it is compared against the PIN entered at that machine's own console and never presented to the token, so a wrong value cannot burn a retry counter. The session it opens is bound to one holder and one certificate, and expires on its own when the signing stops.

One Server, inside your own network

A single container against your own SQL Server. The versioned contract, the admin console, the workstation channel and the published API document are served from the same host on the same port, and the Audit Log stays somewhere you can query it.

Built to be called by your applications

An integration is a registered Client Application and the API keys issued to it — there is no SDK to link against and nothing to install on the machine your code runs on. The surface is a versioned REST contract, published by the deployment itself as an OpenAPI 3.1 document, and it has another implementation: an application already written against that contract integrates here, with the differences written down rather than discovered.

Everything an integration calls:

X-API-Key: <api-key>

POST /v1/sessions                           → sessionId
POST /v1/signatures                         → signatureId
POST /v1/signatures/batch                   → signatureId[]
GET  /v1/signatures/{signatureId}/document  → 200 application/pdf
Transport
HTTPS · application/json · multipart/form-data
Authentication
X-API-Key
Contract
OpenAPI 3.1 · /v1
Refusals
{ "error": { "code", "message", "details" } }

What the platform puts on screen

Your application never draws a signing screen. The admin console is where an operator watches sessions, keys and the Audit Log; the Tray App is where a holder types a PIN, on their own workstation and nowhere else.

An illustration of the admin console's Signing Sessions screen: a navigation drawer beside a table of sessions, each row naming its holder, the certificate it is bound to, when it expires and its state. TrustBridgeAdmin AM Sign out Monitoring Fleet Access System Audit log Workstations Certificate registry Signing sessions Signing operations Client applications Settings and users Signing sessions 4 live · 5 of 12 shown Session Holder Bound to Expires State f3a9c1…8d •••.•••.789-09 WS-0148 A1B2…9F0E 12 min Live 7b6204…12 •••.•••.321-00 WS-0203 44C7…21A9 9 min Live c18f5a…e7 •••.•••.004-51 WS-0117 9E0B…7C33 24 min Live 2d6b90…a4 •••.•••.887-30 WS-0148 A1B2…9F0E 3 min Live 81c47e…05 •••.•••.512-46 WS-0092 D5F1…8802 Expired
The admin console. Every Signing Session on the deployment, the certificate and workstation each one is bound to, and the trail behind it.
An illustration of the TrustBridge Tray App on a workstation: a status strip over a Certificates tab, listing the holder, CPF, status and validity of each certificate the machine holds, beside a panel carrying the serial number, thumbprint and validation verdict of the one that is selected. TrustBridge TrustBridgeWorkstation WS-0148 Admitted Server connected At this machine's console Certificates Service Log Holder CPF Status Valid until PIN Ada Lovelace •••.•••.789-09 ACTIVE 2027-12-04 Cached Alan Turing •••.•••.321-00 EXPIRED 2026-03-18 Not cached CERTIFICATE Serial number Thumbprint 4A7C1B9F3D6E2058 4B71 9C05 2D68 3F14 8A27 6E39 0B52 7C81 5D40 9F63 VALIDATION Status Status last checked ACTIVE 2026-08-27 09:41 Enter PIN… Your PIN is checked against the token on this machine and never leaves it.
The Tray App. The certificates one workstation holds, the verdict on each, and the only place a PIN can be typed.