Documentation›Air‑gapped
Intégrations

Air‑gapped

Évaluez dans un réseau isolé et ne sortez qu'un résultat signé. Le code et les données ne quittent jamais l'enclave.

Avant de commencer

  • Le moteur CertOne (commande certone) dans l'enclave, fourni avec votre accès CertOne.
  • Un utilisateur admin pour enregistrer la clé publique de l'enclave.
  • Une clé d'API member du côté connecté, pour livrer les résultats.

1. Créez et enregistrez une clé source

Dans l'enclave
certone result keygen -o enclave.pem --key-id plant-enclave-01
# writes enclave.pem (private, stays in the enclave) and enclave.pub.pem (public, to register)

Dans la console, ouvrez Developer Hub, puis Source keys. Saisissez le même identifiant de clé, un nom et le contenu de enclave.pub.pem, puis sélectionnez Register public key. La clé privée ne quitte jamais l'enclave.

Utilisez le même --key-id à l'enregistrement et à la signature. Un résultat signé avec une clé non enregistrée ou révoquée est refusé.

2. Évaluez, signez et livrez

Shell
# Inside the enclave
certone check . --registry "$CERTONE_REGISTRY" --fail-on high -o report.json --no-fail
certone result sign report.json --project . --key enclave.pem --key-id plant-enclave-01 \
  -o result.signed.json

# On the connected side, after carrying result.signed.json out
export CERTONE_API_KEY=ck_...
certone-agent deliver result.signed.json --api https://platform.certkor.ai

La signature couvre le rapport, l'empreinte du projet, la version du moteur et l'heure de signature.

Ce que vous voyez

Sortie
certone-agent: signed result accepted (signature verified): scan 61b0..., verdict FAIL
  • Le résultat apparaît dans la console comme exécuté à la source, vérifié par signature.
  • Livrer de nouveau le même résultat est sans risque; il retourne la même analyse.
  • deliver sort avec 0 si le résultat est accepté et 2 s'il est refusé.

Comment le contrôle fonctionne

Dans l'enclave, certone check sort avec 3 pour un verdict défavorable. L'exemple utilise --no-fail pour que le résultat soit signé et livré dans tous les cas; arrêtez la publication sur le verdict dans votre propre pipeline.