Avant de commencer
- Une organisation CertOne et une clé d'API
member. - La clé enregistrée comme secret du dépôt ou de l'organisation, par exemple
CERTONE_API_KEY. - Les permissions
contents: readet, pour l'analyse de code,security-events: write.
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.
Ajoutez le flux de travail
Créez .github/workflows/certone.yml. L'action, certkorai/certone-action@v1, installe Python et certone-sdk puis lance l'analyse; la seconde étape envoie les constats à l'analyse de code.
YAML
name: CertOne
on: [pull_request]
permissions:
contents: read
security-events: write
jobs:
certone:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: CertOne confidential scan
uses: certkorai/certone-action@v1
with:
api-key: ${{ secrets.CERTONE_API_KEY }}
path: .
asset: ADAS Forward Perception
country-code: EU
tee: amd_sev_snp
fail-on: high
- name: Findings in code scanning
if: always()
uses: github/codeql-action/upload-sarif@v4
with:
sarif_file: certone.sarifPour analyser plusieurs systèmes d'IA dans un même dépôt, utilisez une matrice avec un
path et un asset par système. Chacun apparaît comme sa propre vérification.Paramètres
| Paramètre | Défaut | Rôle |
|---|---|---|
api-key | requis | La clé d'API CertOne. |
path | . | Le dossier du projet dans le dépôt. |
asset | nom du dépôt | Le nom du système d'IA dans CertOne. |
country-code | ZZ | Où le système est exploité, par exemple EU, US ou CA. |
tee | amd_sev_snp | amd_sev_snp ou kata_cc. |
fail-on | high | Sévérité minimale qui fait échouer : low, medium, high ou none. |
sarif | certone.sarif | Emplacement du fichier SARIF. |
report | certone-report.json | Emplacement du rapport complet. |
attestation | certone-attestation.json | Écrit seulement si le verdict est favorable. |
soft-fail | false | Si true, un verdict défavorable ne fait pas échouer la tâche. |
api-url | https://platform.certkor.ai | La plateforme CertOne. |
Sorties : verdict (pass, fail ou error), scan-id et sarif-path.
Ce que vous voyez
- La demande de tirage affiche la tâche CertOne comme vérification, réussie ou échouée selon le verdict.
- Le résumé de la tâche montre le verdict, le décompte par sévérité, le lieu d'exécution et le tableau des constats.
- L'analyse de code liste chaque constat sous l'outil
CertOne: high en erreur, medium en avertissement, low en note. - Le journal montre la progression et une ligne par constat :
Journal
CertOne: packing adas-perception for a confidential scan ...
submitted 'ADAS Forward Perception' for confidential processing: scan 3f2c... (sha256:...)
verdict: FAIL (4 finding(s): 4 high, 0 medium, 0 low)
executed in: ...
[HIGH] ... (src/ecu_config.h:30)Comment le contrôle fonctionne
- Un verdict favorable sort avec le code 0 et la vérification réussit.
- Un verdict défavorable sort avec le code 1 et la vérification échoue, sauf si
soft-failvauttrue. - Une erreur (par exemple une clé invalide) fait toujours échouer la tâche.