Avant de commencer
- Un utilisateur
adminpour 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
- Dans la console, ouvrez Connectors, choisissez API / webhook puis Connect.
- Nommez-le, choisissez le système d'IA, l'environnement (par exemple
cloud), le modeprocesset la région. - Dans Allowed artifact hosts, indiquez les hôtes que CertOne peut interroger, comme
models.example.comou*.blob.core.windows.net. Jusqu'à 16 hôtes, sans adresse IP. - 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.
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 :
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.
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 --followpromote_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_snpoukata_cc) etfail_on.
| Réponse | Sens |
|---|---|
| 202 | Accepté; l'analyse est en file. |
| 401 | Le secret ne correspond pas. |
| 403 | Le connecteur est désactivé. |
| 422 | artifact_url manque ou la récupération est refusée. Rien n'est consigné, vous pouvez réessayer. |
| 429 | Trop de requêtes. |