Organization IA Sources de recette · paquets 0.5.1

Développeurs · Édition du 14 novembre 2026

Réaliser une première intégration de test

Ce parcours concerne un développeur autorisé par l’administrateur de l’entreprise. Il lit d’abord des clients avec REST puis découvre les outils MCP accessibles à la même clé. Il ne donne pas accès aux sources privées et n’accorde aucune licence de modification ou de redistribution du logiciel.

Préparer l’environnement

  1. Utiliser une instance de test avec données fictives. Vérifier son organisation et créer un client fictif depuis l’interface.
  2. Faire vérifier l’accès au module Studio. Le code associe cette fonction à l’offre Sur mesure ; la documentation ne fixe ni prix ni droit commercial.
  3. Dans Studio, repérer Clés d’API puis choisir + Nouvelle clé. Donner un nom de test, cocher uniquement le droit read:clients parmi les Droits de la clé, puis Créer. Conserver sa valeur au moment de la création dans un environnement protégé.
  4. Ne pas réutiliser une clé de fournisseur IA. La clé Studio commence par oia_ et sa valeur complète n’est affichée qu’à sa création.
  5. Définir ORGIA_URL avec l’adresse réelle de l’instance et ORGIA_API_KEY dans le gestionnaire de secrets ou l’environnement du service d’intégration. Ne pas les placer dans une page publique ni dans l’URL.

En réseau, utiliser HTTPS. L’application limite actuellement les appels par clé en mémoire du processus ; ce n’est pas un quota partagé entre plusieurs serveurs.

Lire les clients sans écrire

L’exemple nécessite Python avec sa bibliothèque standard. Il ne crée ni client ni facture et n’affiche pas la clé.

import json
import os
import urllib.request

base = os.environ['ORGIA_URL'].rstrip('/')
request = urllib.request.Request(
    base + '/api/v1/clients',
    headers={'Authorization': 'Bearer ' + os.environ['ORGIA_API_KEY']})
with urllib.request.urlopen(request, timeout=15) as response:
    payload = json.load(response)
print('Clients accessibles :', len(payload['data']))

Comparer le nombre aux clients fictifs accessibles à cette organisation. Ne pas traiter une liste vide comme une erreur d’authentification : lire le statut et le corps de la réponse. Les routes REST exposées ici sont en lecture ; ne pas inventer un POST /api/v1/clients.

Découvrir les outils MCP autorisés

Envoyer POST /mcp avec Content-Type: application/json et le même en-tête Authorization: Bearer, puis demander tools/list. Le programme qui envoie la requête doit rester côté serveur de l’intégration.

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

Lire les outils et leurs schémas réellement renvoyés. Un droit read:clients ne donne pas write:clients ou write:tasks. Ne pas considérer la présence d’un nom dans un exemple comme l’autorisation d’appeler cet outil.

Pour un second essai explicitement autorisé, créer une autre clé de test avec write:tasks et appeler create_task avec un titre fictif. Vérifier ensuite dans Tâches que la tâche existe dans la bonne entreprise, puis révoquer cette clé de test. Voir le contrat et l’exemple d’écriture dans API REST et serveur MCP.

Tester les refus et la révocation

  1. Avec la clé de lecture, demander une opération qui exige un droit absent dans un environnement de test. Vérifier le refus dans le corps de la réponse ; ne pas élargir automatiquement la clé.
  2. Révoquer la clé depuis Studio et vérifier qu’un nouvel appel n’accède plus aux données.
  3. Contrôler les logs de l’intégration : ils doivent contenir résultat et erreur utile, jamais la valeur de la clé.
  4. Si deux organisations de test sont disponibles, comparer les lectures avec deux clés distinctes. Chaque clé doit rester limitée à son organisation. Aucun identifiant provenant d’une autre entreprise ne doit être accepté comme autorité.
  5. Une réponse tardive d’un ancien contexte ne doit pas alimenter l’écran du nouveau contexte ; traiter les changements de session et annuler les affichages obsolètes côté client.

Étendre le logiciel lui-même

Pour modifier les sources, il faut une copie autorisée du dépôt et des droits d’utilisation clarifiés avec l’éditeur. Aucun téléchargement de sources ni licence de redistribution n’est fourni par ce portail. Les ajouts passent par les contrôles de session, rôle, module et appartenance à l’organisation, puis les tests SQLite et PostgreSQL nécessaires. Lire Créer ses propres outils.

Le serveur n’est pas un exécuteur universel de scripts fournis par le navigateur. Le portail ne promet ni magasin de plugins, ni OAuth MCP, ni compatibilité avec tous les clients MCP. Les webhooks ont leurs limites propres de livraison : lire Webhooks sortants avant de construire une synchronisation fiable.

Documentation préparée pour publication. Logiciel et accès web en recette privée ; aucun accès public ouvert par ce portail.