secret.reveal
Markdownv0.3.0
Lire la valeur en clair d'un secret. N'est autorisée à aucun rôle, sans exception.
- API
GET /v1/projects/{projectId}/secrets/reveal - CLI
bastide secret reveal
Déclarée pour que le refus soit explicite, nommé et journalisé, plutôt que de se manifester par une route absente. Un secret se remplace, il ne se relit pas.
| Propriété | Valeur |
|---|---|
| Niveau | project |
| Rang minimal | — |
| Rôle transversal | — |
| Portées | secrets:write |
| Compte de service | ne la mène pas : elle est réservée à une personne |
| Réversibilité | N — lecture seule, aucun effet |
| Idempotence | une lecture, rejouable sans précaution |
| Limites de débit, par jeton | 600 appels par 60 secondes (general), et 60 appels par 60 secondes (sensitive) |
API
GET /v1/projects/{projectId}/secrets/reveal — succès en 200.
| Paramètre | Où | Type | Requis | Description |
|---|---|---|---|---|
projectId | chemin | texte, motif ^prj_[0-9A-HJKMNP-TV-Z]{26}$ | oui | Identifiant de projet |
key | requête | texte | oui |
La réponse :
| Champ | Type | Description |
|---|---|---|
value | valeur |
En-têtes de la réponse : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy.
Autres réponses : 400, 401, 403, 404, 409, 429, 500, 503 — communes à toute opération.
Ligne de commande
bastide secret reveal --project-id <valeur> --key <valeur>
| Option | Type | Requise | Défaut | Description |
|---|---|---|---|---|
--project-id | texte | oui | — | Identifiant de projet |
--key | texte | oui | — |
La commande s'exécute sans confirmation.
MCP
Aucun outil : elle rend la valeur d'un secret, une seule fois, ou la refuse à tous : aucun outil MCP ne renvoie la valeur d'un secret, quelle que soit la portée du jeton (EX-MCP-070, EX-SEC-270).
Erreurs
Aucun code propre à cette opération.
S'y ajoutent les refus communs à toute opération — entrée invalide, authentification, autorisation, cible introuvable, conflit, limite de débit, indisponibilité — que le catalogue des erreurs décrit.