Mode autonome
En mode autonome, l'agent traite les requêtes locales signées sans être activé dans aucun cloud. Utilisez-le sur des réseaux sans accès à Internet, ou quand votre organisation ne veut pas dépendre d'un cloud. Seul le mode local fonctionne : pas de travaux cloud, pas de tableau de bord, pas de webhooks et pas de mises à jour automatiques.
1. Créer une paire de clés de signature
Générez une paire de clés Ed25519 sur votre backend. La clé publique est la clé brute de 32 octets en base64 standard ; la clé privée reste sur votre backend, où createSigner de @jodaprint/node l'utilise. Choisissez vous-même l'identifiant de votre organisation (org_ suivi de lettres et de chiffres) et l'identifiant de la clé.
2. Écrire la configuration
{
"local": { "standalone": true, "orgId": "org_acme" },
"security": {
"allowedOrigins": ["https://pos.example.com"],
"requireSignature": true,
"signingPublicKeys": [
{ "keyId": "sk_acme_1", "publicKey": "11qYAYKxCrfVS/7TyWQHOg7hcvPapiMlrwIaaPcHURo=" }
]
},
"printers": { "aliases": { "receipt": "prn_7f3a" } }
}
3. L'importer
sudo jodaprint-agent config import jodaprint-config.json
Ou installez l'agent avec elle : la propriété MSI CONFIG_FILE, un fichier jodaprint-config.json à côté du pkg macOS, ou /etc/jodaprint/config.json sous Linux. Voir Déployer sur de nombreux ordinateurs.
4. Imprimer
Le SDK navigateur fonctionne comme d'habitude, avec le même orgId et un signataire qui utilise votre clé :
const jp = new JodaPrint({ orgId: "org_acme", signer: httpSigner("/jodaprint/sign") });
Licence
Sans cloud, l'agent ne peut pas renouveler son jeton de licence : les limites du forfait gratuit s'appliquent donc (y compris la ligne de pied de page « Printed with JodaPrint »). Importez un fichier de licence fourni par JodaPrint :
sudo jodaprint-agent license import license.jwt
jodaprint-agent license status
Mises à jour
Installez vous-même les nouvelles versions avec votre outil de déploiement ; une mise à niveau conserve la configuration et les données.