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¶
- Au premier démarrage, un compte administrateur est créé (
MKT_BOOTSTRAP_ADMIN,adminpar 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
- Ouvrez le lien, choisissez un mot de passe (12 caractères minimum), puis connectez-vous sur
/login. - Si le catalogue est vide, trois plugins sont créés d'office :
discord,telegramettemplate(publics).mkt-admin seedles 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.