Avant de commencer
- Python 3.10 ou plus récent pour
certone-submitet le SDK Python. - Une clé d'API
member, définie dansCERTONE_API_KEY.
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.
Ligne de commande
Shell
pip install certone-sdk
export CERTONE_API_KEY=ck_...
certone-submit --project . --asset "RAG Answering Service" --country-code EU \
--environment ci --tee kata_cc --fail-on high \
--report-out report.json --sarif-out certone.sarif| Option | Défaut | Rôle |
|---|---|---|
--project | . | Le dossier à envoyer. Les caches, environnements virtuels et dossiers de gestion de versions sont exclus. |
--asset | requis | Le nom du système d'IA dans CertOne. |
--environment | ci | ci, cli, cloud, edge, api, jupyter ou vscode. |
--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. |
--timeout | 1800 | Secondes d'attente du verdict. |
--report-out | Écrire le rapport complet en JSON. | |
--attestation-out | Écrire l'attestation signée, si favorable. | |
--sarif-out | Écrire les constats en SARIF pour les outils d'analyse de code. | |
--markdown-out | Ajouter un résumé Markdown, par exemple au résumé d'une tâche. | |
--api-key-vault | Lire la clé dans Azure Key Vault plutôt que dans l'environnement. |
Codes de sortie : 0 si le verdict est favorable, 1 sinon, 2 en cas d'erreur ou de délai dépassé.
Python
Python
from pathlib import Path
from certone_sdk import CertOneClient, ProgressPrinter, submit_and_wait
client = CertOneClient("https://platform.certkor.ai", token=os.environ["CERTONE_API_KEY"])
sub = submit_and_wait(client, Path("rag-service-kata"), asset="RAG Answering Service",
country_code="EU", tee="kata_cc", on_progress=ProgressPrinter())
print(sub.verdict, sub.report["by_severity"])
raise SystemExit(0 if sub.passed else 1)submit_and_wait retourne le résultat avec verdict, passed, report, attestation et scan_id. Les erreurs lèvent CertOneError.
Sept langages
| Langage | Installation | Exige |
|---|---|---|
| Python | pip install certone-sdk | Python 3.10+ |
| JavaScript et TypeScript | npm install @certkor/certone | Node.js 18+ ou un navigateur |
| Rust | cargo add certone | Rust stable |
| C | certone-c-0.1.0.tar.gz, compilé avec CMake | C11 et libcurl |
| C++ | certone-cpp-0.1.0.tar.gz, compilé avec CMake (inclut le SDK C) | C++17 et libcurl |
| Java | Compiler depuis certkorai/certone-sdks | Java 17+ |
| C# | Compiler depuis certkorai/certone-sdks | .NET 8 |
Python, JavaScript et Rust s'installent depuis leurs registres; C et C++ sont livrés en archives de version. Tous les SDK sont libres dans
certkorai/certone-sdks sous licence Apache 2.0. Les paquets Java et C# arrivent bientôt; d'ici là, compilez-les depuis le dépôt.