Documentation›GitHub Actions
Intégrations

GitHub Actions

Analysez chaque demande de tirage dans une VM confidentielle et faites échouer la vérification si le verdict n'est pas favorable.

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: read et, 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 admin dans votre organisation.
  • Une clé viewer peut 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.sarif
Pour 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ètreDéfautRôle
api-keyrequisLa clé d'API CertOne.
path.Le dossier du projet dans le dépôt.
assetnom du dépôtLe nom du système d'IA dans CertOne.
country-codeZZOù le système est exploité, par exemple EU, US ou CA.
teeamd_sev_snpamd_sev_snp ou kata_cc.
fail-onhighSévérité minimale qui fait échouer : low, medium, high ou none.
sarifcertone.sarifEmplacement du fichier SARIF.
reportcertone-report.jsonEmplacement du rapport complet.
attestationcertone-attestation.jsonÉcrit seulement si le verdict est favorable.
soft-failfalseSi true, un verdict défavorable ne fait pas échouer la tâche.
api-urlhttps://platform.certkor.aiLa 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-fail vaut true.
  • Une erreur (par exemple une clé invalide) fait toujours échouer la tâche.