Aller au contenu

Site marketplace de plugins

La marketplace est un site autonome qui publie le catalogue des plugins du harness. Elle est livrée dans le même dépôt et la même image app (rôle marketplace, port 8090), mais elle a sa propre base, ses propres clés et sa propre connexion : elle ne lit jamais la base ni les clés du harness.

Accès

  • Apache la publie sur le port HARNESS_MARKETPLACE_PORT (8081 par défaut), sur une origine distincte du harness (8080). Derrière un reverse proxy TLS, donner à la marketplace son propre nom d'hôte et renseigner l'URL publique dans Réglages.
  • Le site public liste le catalogue : recherche (nom, description, identifiant, étiquettes), tri, filtre de type, page de plugin. Il n'y a pas d'inscription.
  • Un plugin privé n'apparaît ni dans le catalogue ni dans l'API sans jeton de lecture qui le couvre (ou sans session d'administrateur).

Premier démarrage

  1. Au premier démarrage, un compte administrateur est créé (MKT_BOOTSTRAP_ADMIN, admin par défaut) avec un lien d'activation à usage unique. Le lien n'est jamais écrit dans les journaux ; lisez-le avec :
docker compose -f deploy/compose.yml exec marketplace cat /run/mkt/activation-link-admin
  1. Ouvrez le lien, choisissez un mot de passe (12 caractères minimum), puis connectez-vous sur /login.
  2. Si le catalogue est vide, trois plugins sont créés d'office : discord, telegram et template (publics). mkt-admin seed les recrée au besoin (--force écrase leurs champs).

Administration

Menu Administration (/admin) :

Page Contenu
Plugins Ajouter, modifier, supprimer. Obligatoires : lien GitLab, nom, description. Facultatifs : identifiant (slug), type, étiquettes, branche, visibilité, identifiant et jeton de clonage (chiffrés).
Jetons Créer un jeton mkt_ (lecture : tous les plugins privés ou une liste) ou mkta_ (administrateur), avec expiration. La valeur n'est affichée qu'une fois ; seule son empreinte est conservée. Révocation et date de dernier usage.
Utilisateurs Créer, désactiver, réactiver, réinitialiser (nouveau lien d'activation).
Réglages Nom du site, URL publique, SMTP.

Le mot de passe oublié n'apparaît sur la page de connexion que si un SMTP est configuré dans les réglages. La réponse est identique que le compte existe ou non ; le lien de réinitialisation est à usage unique et expire.

Connexion : verrouillage progressif après 5 échecs, limite par adresse IP, protection CSRF, cookie mkt_session (HttpOnly, Secure, SameSite=Strict). Pour une installation en HTTP clair uniquement, MKT_COOKIE_SECURE=0.

Lignes de commande

Sur le serveur (aucun réseau, accès direct à la base) :

docker compose -f deploy/compose.yml exec marketplace mkt-admin user add alice --email alice@example.org
docker compose -f deploy/compose.yml exec marketplace mkt-admin passwd alice --generate
docker compose -f deploy/compose.yml exec marketplace mkt-admin plugin list
docker compose -f deploy/compose.yml exec marketplace mkt-admin token create ci --kind admin --expires-days 90
docker compose -f deploy/compose.yml exec marketplace mkt-admin seed

À distance (jeton mkta_, conservé sous ~/.config/harness/marketplaces/<nom>/, droits 0600) :

harness mkt login --url https://marketplace.example.org --token-file jeton.txt
harness mkt search telegram
harness mkt plugin add --title "Mon plugin" --git-url https://gitlab.example.org/g/p.git --description "…"
harness mkt plugin update mon-plugin --visibility private
harness mkt token create lecture --slugs mon-plugin
harness mkt token revoke <id>

HARNESS_MKT_URL et HARNESS_MKT_TOKEN remplacent le profil enregistré.

API v1

Requête Effet
GET /api/v1/meta {name, version, api, public_url}
GET /api/v1/plugins?q=&type=&tag=&sort=name\|updated\|created&order=asc\|desc&limit=50&cursor= {items, next_cursor}
GET /api/v1/plugins/{slug} Résumé + install (git_url, branch, credential)
GET\|POST /api/v1/admin/plugins, GET\|PATCH\|DELETE /api/v1/admin/plugins/{slug} Gestion des plugins (jeton mkta_)
GET\|POST /api/v1/admin/tokens, DELETE /api/v1/admin/tokens/{id} Gestion des jetons (jeton mkta_)

Sans jeton : plugins publics. Avec un jeton mkt_ valide : publics plus plugins privés accordés. Un jeton invalide, expiré ou révoqué reçoit 401 (jamais un repli silencieux sur le public). Le champ install.credential n'est renvoyé que pour un plugin privé accordé. Les erreurs ont la forme {"error": {"code", "message"}}.

Variables d'environnement

Variable Rôle
HARNESS_MARKETPLACE_PORT Port publié par Apache (8081)
MKT_BOOTSTRAP_ADMIN Nom du compte initial (admin)
MKT_PUBLIC_URL URL publique (liens des courriels) ; modifiable dans Réglages
MKT_COOKIE_SECURE 0 pour désactiver l'attribut Secure (HTTP clair)
MKT_SEED_FILE Fichier JSON remplaçant la graine intégrée
MKT_MASTER_KEY Clé maître existante (32 octets en base64url) fournie à keygen
MKT_DATABASE_URL URL de base (sqlite:///… pour une installation légère)

Sauvegarde

Sauvegarder ensemble les volumes mkt-keys (sans lui, les jetons de clonage et le mot de passe SMTP sont perdus) et mkt-db, de préférence par un dump logique de marketplace-db.