Configurer les modèles et API keys
Enregistrer un fournisseur, configurer le backend du modèle et gérer les API keys pour le trafic AI-FW.
Utilisez ce guide pour ajouter un modèle à l’inventaire et vérifier l’accès de la passerelle au fournisseur. Les API keys sont stockées dans la configuration gateway, pas dans le code client.
Avant de commencer#
- Vérifiez que la passerelle peut joindre l’endpoint du fournisseur.
- Obtenez une API key autorisée et stockez-la dans le gestionnaire de secrets approuvé.
- Décidez d’utiliser une clé enregistrée du modèle ou une clé fournie par le client.
Ajouter un modèle#
- Ouvrez Model Inventory.
- Choisissez Add custom model.
- Saisissez l’ID du modèle, le fournisseur, l’URL backend et le protocole.
- Ajoutez l’API key selon la politique d’identifiants de l’organisation.
- Enregistrez le modèle et activez-le après vérification.
Vérifier les modes de clé#
Le mode model utilise la clé enregistrée. Le mode client transmet le Bearer key du client et ne doit être utilisé que si BYOK est autorisé. Vérifiez la priorité règle -> modèle -> global dans Settings -> Access Control.
Tester#
Envoyez une requête de test avec une API key AI-FW et l’ID enregistré. Consultez Activity et les journaux pour vérifier identité, modèle, backend et décision d’inspection.
Protéger les identifiants#
- Ne stockez pas d’API keys dans les dépôts, exemples partagés ou historiques de terminal.
- Faites tourner ou révoquez les clés lorsque responsables ou permissions changent.
- Utilisez des clés distinctes par modèle si possible.
- Limitez qui peut gérer les identifiants et consulter les journaux.