En un coup d'œil
- Ce que vous pouvez faire : donner aux agents Semji un accès contrôlé à vos contenus Drupal.
- Pour qui : propriétaires de workspace et administrateurs Drupal.
- Compatibilité : à partir de Drupal 8.7, la version qui a intégré JSON:API au cœur de Drupal.
Prérequis
- Drupal 8.7 ou plus récent, en ligne, public et en HTTPS.
- Les modules JSON:API et HTTP Basic Authentication (basic_auth) activés. Les deux sont livrés avec Drupal.
- JSON:API réglé en lecture-écriture. C'est le blocage le plus courant, car il est en lecture seule par défaut.
- Un compte Drupal dédié à Semji, autorisé à voir, créer et modifier les types de contenus visés, et à les supprimer si vous activez l'outil de suppression. Sur les sites qui utilisent Paragraphs, accordez aussi les permissions Paragraphs correspondantes.
Comment connecter votre site Drupal
1) Préparer votre site Drupal
Trois réglages à faire côté Drupal avant de connecter Semji.
Activer les modules. Sur la page des modules (menu Extend, /admin/modules), activez JSON:API et HTTP Basic Authentication. Les deux sont fournis avec Drupal.
Autoriser l'écriture. Dans Configuration → Services web → JSON:API (/admin/config/services/jsonapi), sélectionnez l'option « Accept all JSON:API create, read, update, and delete operations ». Sans cela, Semji peut lire vos contenus mais pas en créer ni en modifier.
Créer un compte pour Semji. Dans Personnes (People, /admin/people), créez un compte dédié, par exemple semji-api, avec un mot de passe robuste et un rôle capable de voir, créer et modifier les types de contenus visés. Vous pouvez aussi lui donner accès en lecture à la configuration des champs : Semji s'en sert pour mieux comprendre la structure de votre site, mais fonctionne sans.
Conseil ✅ : si la publication échoue, le premier réglage à vérifier est presque toujours l'autorisation d'écriture de JSON:API.
2) Connecter depuis Semji
Vous devez être propriétaire du workspace, car la connexion vaut pour toute l'équipe. Dans Semji, ouvrez Paramètres → Intégrations, allez dans l'onglet CMS et cliquez sur Connecter sur la ligne Drupal.
Remplissez les trois champs :
- URL du site : l'adresse exacte de votre site en HTTPS, par exemple https://votre-site.com. Entrez l'adresse réellement utilisée par votre site : s'il bascule de exemple.com vers www.exemple.com, saisissez la version www. Semji ne suit pas les redirections.
- Nom d'utilisateur : le compte Drupal créé à l'étape 1.
- Mot de passe : le mot de passe de ce compte.
Cliquez sur Suivant.
Semji vérifie aussitôt que ces identifiants fonctionnent bien sur votre site.
3) Choisir les outils Drupal
Décidez ce que les agents IA peuvent faire sur votre site. Les trois groupes sont activés par défaut :
- Lecture : parcourir, lire et inspecter le contenu et la structure du site.
- Écriture : créer et mettre à jour du contenu.
- Suppression : supprimer du contenu. Attention, cette action est irréversible.
4) Enregistrer
Cliquez sur Enregistrer. La ligne Drupal s'affiche désormais comme connectée.
Ce que Semji peut faire une fois connecté
| Groupe d'outils | Ce qu'il fait |
|---|---|
| Lecture | Lister les types de contenus, repérer leurs champs et formats de texte, lister et lire les contenus tels qu'ils sont stockés, pour des modifications fidèles |
| Écriture | Créer et mettre à jour du contenu. Le nouveau contenu est créé en brouillon, sauf si vous demandez explicitement à un agent de publier. Les étiquettes existantes sont réutilisées, les nouvelles sont créées. Les mises en page à base de Paragraphs sont prises en charge |
| Suppression | Supprimer définitivement un contenu. L'agent demande toujours une confirmation avant |
Gérer ou déconnecter
Depuis Paramètres → Intégrations → CMS, la ligne Drupal propose :
- Gérer les outils : activer ou désactiver chaque groupe d'outils.
- Déconnecter : retirer l'intégration pour tout le workspace.
Pare-feu et autorisation d'IP
Semji appelle directement le JSON:API de votre site. Si un pare-feu ou une protection type Cloudflare se trouve devant votre Drupal, il doit laisser passer ces appels, sinon la connexion échoue.
Sur Cloudflare, créez une règle qui laisse passer (action Skip) les requêtes venant des adresses IP de Semji et dont l'adresse commence par /jsonapi/.
Adresses IP de Semji à autoriser :
-
63.34.75.122
-
63.35.78.179
-
54.228.104.165
-
18.200.156.37
-
34.248.117.83
-
52.213.28.177
Attention ⚠️ : un blocage par le pare-feu ressemble à une erreur d'identifiants. Quand une protection répond « 403 Forbidden » sur /jsonapi, Semji affiche une erreur d'identifiants invalides même si votre nom d'utilisateur et votre mot de passe sont corrects. Si vous êtes sûr de vos identifiants, vérifiez d'abord le pare-feu.
Dépannage
« Identifiants Drupal invalides. Vérifiez le nom d'utilisateur et le mot de passe. » Drupal a refusé la connexion. Les causes possibles : le nom d'utilisateur ou le mot de passe est erroné, le module basic_auth n'est pas activé (Drupal traite alors la demande comme un visiteur anonyme), ou un pare-feu bloque la requête avant qu'elle n'atteigne Drupal.
« Impossible de se connecter au site Drupal. Vérifiez les identifiants, l'URL du site, et que les modules JSON:API et Basic Auth sont activés. » Semji n'a pas réussi à joindre votre site. Les causes les plus fréquentes :
- Le module JSON:API est désactivé : /jsonapi renvoie une erreur 404.
- L'adresse redirige. Semji ne suit pas les redirections, entrez donc l'adresse finale, par exemple la version www.
- Le site est injoignable : problème de DNS, hébergeur indisponible, ou site non public.
- Un pare-feu affiche une page de vérification anti-bot, que Semji ne peut pas franchir.
- Le site répond trop lentement : la réponse doit arriver en moins de 10 secondes.
La publication échoue avec une erreur de lecture seule : « Le JSON:API de Drupal est configuré pour n'accepter que les opérations de lecture. » Un administrateur doit activer l'option « Accept all JSON:API create, read, update, and delete operations » dans /admin/config/services/jsonapi.
Un agent signale une erreur de permission : « Erreur d'authentification ou de permission Drupal : le compte d'API ne peut pas créer ou mettre à jour ce contenu. » Le compte créé pour Semji n'a pas les droits nécessaires sur ce type de contenu. Sur les sites Paragraphs, vérifiez aussi ses permissions Paragraphs.
Erreurs affichées avant même de valider le formulaire :
- « Veuillez saisir une URL valide. » : le texte saisi n'est pas une adresse web.
- « L'URL du site doit commencer par https://. » : les sites en HTTP ne peuvent pas être connectés.
- « L'URL du site pointe vers une adresse privée ou réservée, ce qui n'est pas autorisé. » : les sites locaux ou internes sont refusés, le site doit être public.