Documentation›SDK et CLI
Intégrations

SDK et CLI

Soumettez un projet et attendez le verdict depuis n'importe quel script, avec la commande certone-submit ou le SDK.

Avant de commencer

  • Python 3.10 ou plus récent pour certone-submit et le SDK Python.
  • Une clé d'API member, définie dans CERTONE_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 admin dans votre organisation.
  • Une clé viewer peut 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
OptionDéfautRôle
--project.Le dossier à envoyer. Les caches, environnements virtuels et dossiers de gestion de versions sont exclus.
--assetrequisLe nom du système d'IA dans CertOne.
--environmentcici, cli, cloud, edge, api, jupyter ou vscode.
--country-codeZZOù le système est exploité.
--teeamd_sev_snpamd_sev_snp ou kata_cc.
--fail-onhighSévérité minimale qui rend le verdict défavorable.
--timeout1800Secondes 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-outAjouter un résumé Markdown, par exemple au résumé d'une tâche.
--api-key-vaultLire 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

LangageInstallationExige
Pythonpip install certone-sdkPython 3.10+
JavaScript et TypeScriptnpm install @certkor/certoneNode.js 18+ ou un navigateur
Rustcargo add certoneRust stable
Ccertone-c-0.1.0.tar.gz, compilé avec CMakeC11 et libcurl
C++certone-cpp-0.1.0.tar.gz, compilé avec CMake (inclut le SDK C)C++17 et libcurl
JavaCompiler depuis certkorai/certone-sdksJava 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.