Aller au contenu principal

H-13 Signature

Brique H de la plateforme Enterprise AI. Technologie : Cosign (Sigstore) en mode keyless avec OIDC ou avec des clés dans OpenBao/KMS ; signe les images, les SBOM, les skills et les plugins. Version anglaise : ../../en/bricks/H-13-signing.md.

Rôle et responsabilités​

  • Signer les artefacts et vérifier les signatures au déploiement (Kyverno) et au chargement (Skill Loader, installation de plugins).

Position et interactions​

  • Chemin d'exécution : workflow (CI) et vérification à l'admission.
  • POST /v1/skills/{name}/verify utilise les mêmes racines de confiance.

Part open source et part développée​

  • Open source réutilisé : Cosign, Rekor (instance privée optionnelle), Fulcio.
  • Développé dans la plateforme : Politique de confiance par tenant (identités autorisées).

Modèle de données​

Pas de table dédiée : l'état vit dans les objets Kubernetes, Git et le stockage propre de l'outil ; les actions passant par l'API sont auditées dans eai.audit_events par le Control Plane.

Contrat : contracts/v1/skill-manifest.schema.json (schema_version 1.0). L'usage est toujours remonté avec contracts/v1/usage-event.schema.json, l'audit avec contracts/v1/audit-event.schema.json.

Endpoints d'API​

MéthodeChemin
POST/v1/policies/evaluate

POST /v1/policies/evaluate​

Requête :

{
  "action": "image.deploy",
  "resource": {
    "type": "image",
    "digest": "sha256:ab12"
  },
  "context": {
    "signed": true,
    "critical_vulns": 0
  }
}

Réponse :

{
  "allow": true,
  "reasons": [],
  "decision_id": "dec_44"
}

Exemples SDK​

Python​

from enterprise_ai import EnterpriseAI

client = EnterpriseAI(base_url="<control-plane-url>", api_key="eai_live_xxx", tenant="acme", locale="fr")
client.policies.evaluate(request={"action": "image.deploy", "resource": {"type": "image", "digest": "sha256:ab12"}})

TypeScript​

import { EnterpriseAI } from "@enterprise-ai/sdk";

const client = new EnterpriseAI({ baseUrl: "<control-plane-url>", apiKey: process.env.EAI_API_KEY, tenant: "acme", locale: "fr" });
await client.policies.evaluate({ action: "image.deploy", resource: { type: "image", digest: "sha256:ab12" } });

Java​

EnterpriseAIClient client = EnterpriseAIClient.builder()
    .baseUrl("<control-plane-url>")
    .apiKey(System.getenv("EAI_API_KEY"))
    .tenant("acme")
    .locale(Locale.FRENCH)
    .build();
client.policies().evaluate(Map.of("action", "image.deploy", "resource", Map.of("type", "image", "digest", "sha256:ab12")));

Go​

client, err := eai.NewClient(eai.WithBaseURL("<control-plane-url>"), eai.WithAPIKey(os.Getenv("EAI_API_KEY")), eai.WithTenant("acme"), eai.WithLocale("fr"))
if err != nil { log.Fatal(err) }
ctx := context.Background()
_, err = client.Policies.Evaluate(ctx, map[string]any{"action": "image.deploy", "resource": map[string]any{"type": "image", "digest": "sha256:ab12"}})

Configuration​

Variables d'environnement : EAI_COSIGN_KEY, EAI_COSIGN_IDENTITY, EAI_COSIGN_OIDC_ISSUER.

Sécurité​

  • Les clés de signature ne quittent jamais le KMS ; identités keyless limitées aux charges CI.
  • Tenant déduit de l'identifiant d'accès, jamais du corps ; sécurité au niveau des lignes PostgreSQL sur chaque table de tenant.
  • Chaque mutation et décision de politique écrit un événement d'audit chaîné par hachage (G-11).
  • Les erreurs utilisent l'enveloppe standard avec message_i18n en et fr.

Observabilité​

  • Échecs de vérification par artefact.
  • traceparent W3C propagé, X-Request-Id renvoyé, les spans portent eai.tenant_id, eai.project, eai.agent_id, eai.run_id.

Unités FinOps​

  • Non applicable.

Modes de défaillance et résilience​

  • Rekor injoignable -> vérification hors ligne par bundle.

Adoption autonome​

Les clients publiant leurs propres skills les signent avec leur identité.

Tests d'acceptation​

  1. Une skill non signée est refusée par le Skill Loader.

Feuille de route d'implémentation