Avant de commencer
- Python 3.10 ou plus récent sur la passerelle, avec un accès HTTPS sortant vers la plateforme.
- Une clé d'API
member, définie dansCERTONE_API_KEY(ou montée depuis un Secret Kubernetes).
Dans la console CertOne, ouvrez Developer Hub, puis API keys. Nommez la clé, choisissez le rôle member et sélectionnez New key.
- Copiez le secret immédiatement : il n'est affiché qu'une fois.
- Les clés commencent par
ck_et expirent après au plus 365 jours. - La création de clés exige le rôle
admindans votre organisation. - Une clé
viewerpeut lire les résultats mais ne peut pas soumettre d'analyses.
Installer et surveiller
Installez certone-sdk, qui fournit certone-agent, puis lancez la surveillance. Utilisez --mode confidential : le mode par défaut, local, exécute le moteur sur l'appareil.
pip install certone-sdk
export CERTONE_API_KEY=ck_...
certone-agent watch --mode confidential --project binpick-sort \
--asset "Bin-Pick Sorter Vision" --country-code EU --interval 30 \
--api https://platform.certkor.aiOptions
| Option | Défaut | Rôle |
|---|---|---|
--mode | local | Utilisez confidential pour analyser sur la plateforme. |
--api | requis | La plateforme CertOne, https://platform.certkor.ai. |
--project | . | Le dossier à surveiller. |
--asset | Le nom du système d'IA dans CertOne. | |
--country-code | ZZ | Où le système est exploité. |
--tee | amd_sev_snp | amd_sev_snp ou kata_cc. |
--fail-on | high | Sévérité minimale qui rend le verdict défavorable. |
--interval | 300 | Secondes entre deux vérifications. |
--token | CERTONE_API_KEY | Préférez la variable pour garder la clé hors de la liste des processus. |
certone-agent run analyse une seule fois au lieu de surveiller.
Ce que vous voyez
L'agent calcule l'empreinte de tous les fichiers du dossier. Quand elle change, il analyse la nouvelle version :
certone-agent: watching /home/dev/binpick-sort
certone-agent: Bin-Pick Sorter Vision -> confidential scan aed6... (sha256:...)
certone-agent: verdict FAIL (2 high, 8 medium, 1 low) in ...
certone-agent: new version detected (sha256:...)Chaque verdict apparaît aussi dans la console, sous le système d'IA.
Comment le contrôle fonctionne
watchcontinue quel que soit le verdict, et reprend une analyse échouée à la vérification suivante.run --mode confidentialsort avec 0 si favorable, 1 si défavorable et 2 en cas d'erreur, donc un script de déploiement peut s'arrêter dessus.