Proxy de chiffrement

Le Proxy de chiffrement est une passerelle sécurisée qui s’exécute dans votre environnement et se connecte à l’enclave Subnoto en votre nom. Il effectue l’attestation à distance et établit un tunnel chiffré vers l’enclave, ce qui vous permet d’appeler l’API Subnoto en HTTP simple (par ex. curl ou tout client REST) tandis que le proxy gère l’authentification, l’attestation et le canal sécurisé. Vous envoyez les requêtes au proxy ; il les transmet à l’enclave via le tunnel et renvoie les réponses.

Sécurité : Pour vérifier l’authenticité du conteneur et inspecter son SBOM, consultez le Guide d’attestation & vérification.

Utilisation du Conteneur

Exécutez le conteneur Proxy de chiffrement avec Docker :

docker run -p 8080:8080 subnoto/api-proxy:latest

Le conteneur expose le service sur le port 8080. Vous pouvez mapper ceci sur n’importe quel port de votre machine hôte en changeant le premier numéro de port (par exemple, -p 3000:8080 pour exposer sur le port 3000).

Utilisateurs Mac (Apple Silicon) : Si vous rencontrez des problèmes de connexion, liez explicitement à localhost et spécifiez la plateforme :

docker run --platform linux/amd64 -p 127.0.0.1:8080:8080 subnoto/api-proxy:latest

Note : Le conteneur ne nécessite pas de variables d’environnement pour s’exécuter. Les identifiants API sont fournis lors des requêtes, pas au démarrage du conteneur.

Authentification API

Pour utiliser le Proxy de chiffrement, vous avez besoin d’une clé d’accès et d’une clé secrète. Ces identifiants sont fournis lorsque vous créez une clé API dans votre espace de travail Subnoto.

Obtention des Identifiants

1. Connectez-vous à votre espace de travail Subnoto sur app.subnoto.com
2. Naviguez vers Paramètres → Clés API
3. Créez une nouvelle clé API
4. Sauvegardez la ACCESS_KEY et la SECRET_KEY en toute sécurité

Effectuer des Requêtes Authentifiées

Incluez vos identifiants dans l’en-tête Authorization en utilisant le format de jeton Bearer :

Authorization: Bearer $ACCESS_KEY:$SECRET_KEY

Utilisation Basique de l’API

Testez votre connexion avec le point de terminaison whoami :

curl http://localhost:8080/public/utils/whoami \
  -H "Authorization: Bearer $ACCESS_KEY:$SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Remplacez :

• localhost:8080 par votre URL de déploiement si le conteneur s’exécute ailleurs
• $ACCESS_KEY par votre clé d’accès réelle
• $SECRET_KEY par votre clé secrète réelle

Une réponse réussie retournera des informations sur votre session authentifiée :

{
  "teamUuid": "...",
  "teamName": "...",
  "ownerEmail": "...",
  "ownerUuid": "...",
  "accessKey": "..."
}

Documentation API Subnoto

Tutoriels

Créer et envoyer votre première enveloppe

Créer une enveloppe à partir d'un modèle

Dépannage