# Permettre à Kortex de modifier votre site, en sécurité

Cette page est publique. Elle dit, pour chaque sorte de site, ce qu'il faut donner à Kortex pour
qu'il publie et corrige, et comment le reprendre à tout moment. Elle s'adresse au propriétaire du
site comme à son développeur.

## En bref

- **Rien n'est écrit sans vous.** Kortex propose, vous décidez dans votre espace (approuver,
  publier, dépublier) ; seules vos décisions partent sur le site.
- **Un seul service écrit** : le *cœur* de votre site (son superviseur), dédié à votre site. Votre
  espace d'édition (`<site>.kortex.center`) et kortex.center n'ont aucun accès au site.
- **Les accès se posent sur kortex.center**, page *Relier le site* de votre espace. Ils sont
  chiffrés pour le seul cœur de votre site dès votre navigateur : ni l'espace ni l'équipe Kortex
  n'en voient la valeur, et elle n'est plus jamais affichée.
- **Vous pouvez tout couper** : révoquez l'accès chez vous (mot de passe d'application, clé,
  secret), ou choisissez le connecteur *Aucun* dans *Réglages › Publication*. Kortex ne lit plus
  alors que les pages publiques, comme Google.
- **Sans aucun accès**, Kortex fonctionne quand même : diagnostic, suivi SEO et GEO, rédaction.
  Vous publiez alors vous-même ce que vous approuvez.

## Quel cas est le vôtre ?

| Votre site | Ce que vous donnez | Ce que Kortex peut faire |
|---|---|---|
| WordPress | un utilisateur dédié + un mot de passe d'application | publier articles et pages, médias, titres et descriptions (Yoast), corrections |
| WordPress + WooCommerce | en plus : une clé API WooCommerce | fiches produits (textes, attributs SEO) |
| Site statique (Astro, Hugo, Eleventy, Jekyll…) | une adresse de publication + un secret partagé | tout ce que votre service accepte d'appliquer |
| Shopify, Wix, PrestaShop, autre | une adresse de publication + un secret partagé, via votre développeur | idem |
| Vous ne voulez rien donner | rien | lecture publique seule ; vous publiez vous-même |
| Search Console (tous les cas) | un compte de service Google, en lecture | mesures réelles de recherche dans vos rapports |

## WordPress

Kortex écrit par l'API REST de WordPress, avec un **mot de passe d'application** : un accès propre
à Kortex, distinct de votre mot de passe, que vous révoquez d'un clic sans rien changer d'autre.

### 1. Créez un utilisateur dédié

*Comptes › Ajouter* : un utilisateur `kortex` avec une adresse de votre équipe. **Ne donnez pas
votre propre compte** : avec un compte dédié, le journal de WordPress montre ce qui vient de
Kortex, et le retirer ne touche à personne d'autre.

### 2. Donnez-lui le bon rôle

- **Éditeur** suffit pour l'essentiel : articles, pages, médias, champs Yoast des contenus,
  corrections de contenu. C'est le rôle conseillé.
- **Administrateur** n'est utile que pour les réglages du site (permaliens, menus, widgets,
  réglages Yoast globaux). Si vous ne le donnez pas, ces actions-là échouent et votre espace vous le
  signale ; le reste fonctionne.

### 3. Créez le mot de passe d'application

Connecté **avec l'utilisateur `kortex`** : *Profil › Mots de passe d'application*, nom
« Kortex », *Ajouter*. Copiez le mot de passe affiché (il ne le sera qu'une fois).

### 4. Posez-le sur kortex.center

Page *Relier le site* de votre espace, champ *Accès WordPress* :
`kortex:abcd efgh ijkl mnop qrst uvwx` (identifiant, deux-points, mot de passe d'application).
Le test de connexion dit tout de suite si l'accès répond.

### Si ça ne marche pas

- **HTTPS obligatoire** : WordPress n'active les mots de passe d'application que sur un site en
  `https://`.
- **Extension de sécurité** (Wordfence, iThemes, All In One WP Security…) : elle peut fermer l'API
  REST ou les mots de passe d'application. Autorisez-les pour l'utilisateur `kortex`.
- **Pare-feu ou hébergeur** qui bloque `/wp-json/` ou l'en-tête `Authorization` : demandez à votre
  hébergeur de le laisser passer.
- **« Mots de passe d'application » absent du profil** : une extension ou un réglage
  (`wp_is_application_passwords_available`) les désactive.

### Pour couper

*Comptes › kortex › Mots de passe d'application › Révoquer*. Ou supprimez l'utilisateur `kortex`
(attribuez ses contenus à un autre compte).

## WooCommerce (en plus de WordPress)

*WooCommerce › Réglages › Avancé › API REST › Ajouter une clé* : utilisateur `kortex`, droits
**Lecture/Écriture** (Kortex met à jour les fiches produits ; en *Lecture* seule, il ne fait que
proposer). Posez la clé (`ck_…`), le secret (`cs_…`) et l'adresse de la boutique sur *Relier le
site*. Pour couper : révoquez la clé au même endroit.

## Site statique, Shopify, Wix, PrestaShop et tout autre site

Kortex ne se connecte pas à votre hébergeur ni à votre dépôt. Il envoie chaque décision, **signée**,
à une adresse que votre développeur prépare ; votre service vérifie la signature, applique ce qu'il
accepte, et répond. Votre service reste seul juge de ce qui entre sur le site.

1. Votre développeur suit le contrat du connecteur :
   [Connecteur de publication webhook](/modules/publication-webhook/) (exemple de service compris).
2. Sur *Relier le site* : l'adresse de publication (`https://…`), puis le secret de signature, tiré
   dans votre navigateur ; transmettez-le à votre développeur.
3. Dans votre espace, *Réglages › Publication* : connecteur **Webhook**.

Pour couper : changez le secret, ou retirez l'adresse, ou choisissez le connecteur *Aucun*.

## Search Console (facultatif, tous les cas)

Créez un compte de service Google, ajoutez son adresse comme utilisateur de votre propriété Search
Console avec l'autorisation **Restreinte** (lecture), puis collez son fichier JSON et le nom de la
propriété (`sc-domain:votre-site.fr`) sur *Relier le site*. Pour couper : retirez cet utilisateur
dans Search Console.

## Ce que Kortex ne fait jamais

- se connecter avec votre mot de passe personnel, ou vous le demander ;
- installer une extension sans votre accord, toucher aux fichiers du serveur ou à la base de données ;
- publier ce que vous n'avez pas approuvé ;
- garder un accès que vous avez révoqué : il échoue au prochain envoi, et votre espace vous le dit.
