Documentation›Registre de modèles
Intégrations

Registre de modèles

Quand une version de modèle est promue, le registre envoie un webhook et CertOne récupère cet instantané exact pour une analyse confidentielle.

Avant de commencer

  • Un utilisateur admin pour créer le connecteur.
  • Des instantanés de modèles accessibles en HTTPS par un lien en lecture seule de courte durée, par exemple une URL SAS de stockage blob.
  • Un registre capable d'envoyer un POST HTTPS lors d'une promotion.

Créez le connecteur

  1. Dans la console, ouvrez Connectors, choisissez API / webhook puis Connect.
  2. Nommez-le, choisissez le système d'IA, l'environnement (par exemple cloud), le mode process et la région.
  3. Dans Allowed artifact hosts, indiquez les hôtes que CertOne peut interroger, comme models.example.com ou *.blob.core.windows.net. Jusqu'à 16 hôtes, sans adresse IP.
  4. Créez-le, puis copiez la Webhook URL et le Webhook secret. Le secret n'est affiché qu'une fois.

Envoyez l'événement de promotion

Envoyez cet événement lors d'une promotion. Authentifiez-vous avec le secret dans l'en-tête x-certone-secret; l'identifiant de livraison rend les reprises sans risque.

HTTP
POST /v1/connectors/<connector-id>/events
content-type: application/json
x-certone-secret: <webhook secret>
x-certone-delivery: <unique delivery id>

{"id": "<unique delivery id>", "eventType": "model.promoted", "version": "v3",
 "artifact_url": "https://<allowed host>/releases/hydro-turbine-health/v3.tar.gz?<read-only token>"}

CertOne répond immédiatement avec l'analyse mise en file :

Réponse
HTTP 202
{"status": "accepted", "run_id": "...", "event_type": "model.promoted", "scan_id": "..."}

Scripts d'exemple

Les scripts de référence déposent un instantané dans Azure Blob, créent un lien en lecture seule valide 15 minutes, envoient l'événement et suivent l'analyse jusqu'au verdict.

Shell
pip install --quiet requests azure-storage-blob
export AZURE_STORAGE_CONNECTION_STRING=...      # the registry's storage account
export CERTONE_WEBHOOK_SECRET=...               # shown once when the connector was created
export CERTONE_API_KEY=ck_...                   # only for --follow (a viewer key is enough)

ARTIFACT_URL=$(python release.py hydro-turbine-health v3)
python promote_model.py \
  --connector-url "https://platform.certkor.ai/v1/connectors/<connector-id>/events" \
  --artifact-url "$ARTIFACT_URL" --version v3 --follow

promote_model.py affiche l'exécution et l'analyse acceptées, puis verdict: PASS ou verdict: FAIL avec le décompte. Il sort avec 0 si favorable, 1 si défavorable et 2 si une variable manque.

Règles de récupération

  • HTTPS seulement, aucun identifiant dans l'URL, aucune redirection et une taille limitée.
  • Seulement les hôtes de la liste du connecteur, résolus vers des adresses publiques.
  • Chaque analyse est consignée avec le nom du connecteur et la version, par exemple connector:Model registry@v3.
  • Champs facultatifs : tee (amd_sev_snp ou kata_cc) et fail_on.
RéponseSens
202Accepté; l'analyse est en file.
401Le secret ne correspond pas.
403Le connecteur est désactivé.
422artifact_url manque ou la récupération est refusée. Rien n'est consigné, vous pouvez réessayer.
429Trop de requêtes.