Installation & Clés API
Ce guide détaille les prérequis techniques, les options d'installation du package boundry-sensor et les règles de gestion des clés API d'organisation.
Prérequis système
Le SDK Python Boundry est optimisé pour être le plus léger possible.
- Python Runtime :
Python >= 3.10(compatible 3.11, 3.12, 3.13) - Dépendances principales :
requests >= 2.28,pydantic >= 2.0 - Systèmes d'exploitation supportés : Linux (Ubuntu, Debian, Alpine), macOS (Apple Silicon & Intel), Windows 10/11 / Server.
Installation du package
Installation standard (PyPI)
pip install boundry-sensor
Installation dans un environnement virtuel (Recommandé)
python -m venv .venv
source .venv/bin/activate # Sur Windows : .venv\Scripts\activate
pip install boundry-sensor
Installation pour environnements Enterprise (Air-Gapped / Private Wheel)
Pour les entreprises déployant Boundry en mode On-Premises ou cloud souverain (Air-Gapped) :
pip install --no-index --find-links=./wheels boundry-sensor
Gestion des Clés API
Toutes les requêtes de télémétrie et de validation de règles doivent être authentifiées par une clé d'organisation valide (préfixe sk_org_...).
Obtention d'une clé API
- Connectez-vous à votre console Boundry Dashboard.
- Rendez-vous dans Paramètres → Clés API d'Organisation.
- Cliquez sur Faire tourner la clé (Rotation) pour générer un nouveau secret cryptographique.
Ne commitez jamais votre clé secrète dans un dépôt Git public ou privé. Stockez-la toujours sous forme de variable d'environnement ou dans votre gestionnaire de secrets (AWS Secrets Manager, GCP Secret Manager, HashiCorp Vault).
Configuration par variables d'environnement
Le sensor détecte automatiquement ces variables sans nécessiter de configuration manuelle dans le code :
export BOUNDRY_API_KEY="sk_org_07fd47fe4b89fd10f2f8212f33af23787d230cd3a3db313672fbf4076e9a5661"
export BOUNDRY_ENDPOINT="https://api.boundry.io" # Ou URL de votre passerelle interne
Tableau de compatibilité
| Composant | Version minimale | Version recommandée | Statut |
|---|---|---|---|
| Python | >= 3.10 | 3.11 / 3.12 | Support Officiel |
| LangChain | >= 0.1.0 | >= 0.2.14 | Support Complet |
| LangGraph | >= 0.0.10 | >= 0.2.0 | Support Complet |
| CrewAI | >= 0.50.0 | >= 0.51.0 | Support Décorateur |
| AutoGPT | >= 0.5.0 | v0.5.2 | Support Expérimental |