Lot 3 (4/5) : API admin S3, variables S3_*, tests et documentation
GET/PUT /api/admin/s3 et POST /api/admin/s3/test (administrateurs) ; S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY, S3_SECRET_KEY (_FILE), S3_INSECURE ; miniatures S3 sous DATA_DIR/.s3cache. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LNfwm4pfYR9C914C2EeiuB
This commit is contained in:
1 parent
53972f9762
commit
e79a813272
6 files changed
+95
No files matched your search
@@ -30,3 +30,10 @@ SHARE_SECRET=
|
|||||||
# spécial d'URL (@ : / ? #), sinon fournir DATABASE_URL complète et encodée.
|
# spécial d'URL (@ : / ? #), sinon fournir DATABASE_URL complète et encodée.
|
||||||
POSTGRES_PASSWORD=
|
POSTGRES_PASSWORD=
|
||||||
DATABASE_URL=
|
DATABASE_URL=
|
||||||
|
# Racine S3 (facultatif, exige DATABASE_URL ; aussi réglable dans Administration).
|
||||||
|
# À reporter dans le bloc environment du service si utilisé.
|
||||||
|
S3_ENDPOINT=
|
||||||
|
S3_REGION=
|
||||||
|
S3_BUCKET=
|
||||||
|
S3_ACCESS_KEY=
|
||||||
|
S3_SECRET_KEY=
|
||||||
@@ -47,9 +47,13 @@ Pour imposer l'administrateur : `ADMIN_USER` et `ADMIN_PASSWORD` dans `.env`. Le
|
|||||||
| `SESSION_TTL` / `SESSION_SECRET` | `24h` / aléatoire | Session ; clé de signature (sinon `DATA_DIR/.session-secret`). Obligatoire avec `DATABASE_URL` ; `hex:<contenu de .session-secret>` garde les sessions ouvertes |
|
| `SESSION_TTL` / `SESSION_SECRET` | `24h` / aléatoire | Session ; clé de signature (sinon `DATA_DIR/.session-secret`). Obligatoire avec `DATABASE_URL` ; `hex:<contenu de .session-secret>` garde les sessions ouvertes |
|
||||||
| `SHARE_SECRET` | aléatoire | Clé de signature des liens de partage. Obligatoire avec `DATABASE_URL` ; `hex:<contenu de .share-secret>` garde valides les liens existants |
|
| `SHARE_SECRET` | aléatoire | Clé de signature des liens de partage. Obligatoire avec `DATABASE_URL` ; `hex:<contenu de .share-secret>` garde valides les liens existants |
|
||||||
| `PUBLIC_URL` | | URL publique (cookies `Secure`) |
|
| `PUBLIC_URL` | | URL publique (cookies `Secure`) |
|
||||||
|
| `S3_ENDPOINT` / `S3_REGION` / `S3_BUCKET` | / `garage` / | Racine S3 (Garage ou S3 compatible), exige `DATABASE_URL`. Configurable aussi dans Administration ; une variable définie verrouille son champ |
|
||||||
|
| `S3_ACCESS_KEY` / `S3_SECRET_KEY` (ou `_FILE`) / `S3_INSECURE` | / / `false` | Clés du bucket ; `S3_INSECURE=true` : HTTP pour un endpoint sans schéma. Clé saisie dans l'interface : chiffrée en base avec `SHARE_SECRET`, jamais renvoyée |
|
||||||
|
|
||||||
Les valeurs d'inscription, de quota, de lecture seule et de poubelle sont des défauts : une fois modifiées dans l'interface, c'est le réglage de l'interface qui prime.
|
Les valeurs d'inscription, de quota, de lecture seule et de poubelle sont des défauts : une fois modifiées dans l'interface, c'est le réglage de l'interface qui prime.
|
||||||
|
|
||||||
|
Racine S3 : dossier « S3 » commun à tous, mêmes droits que l'arborescence commune (lecture seule possible, l'administrateur écrit toujours). Le bucket doit être vide au départ ; l'arborescence vit dans le catalogue PostgreSQL et chaque fichier garde la clé d'objet fixée au dépôt (renommer ou déplacer ne touche pas le bucket). Pas d'historique de versions, de recherche plein texte ni de favoris sur S3. Une configuration modifiée dans l'interface est reprise par toutes les instances sous 30 s. Les variables `S3_*` doivent être ajoutées au bloc `environment` du service dans `docker-compose.yml` si on les utilise.
|
||||||
|
|
||||||
## API et jetons
|
## API et jetons
|
||||||
|
|
||||||
Chaque utilisateur peut créer des jetons (*Jetons d'API*) pour scripter :
|
Chaque utilisateur peut créer des jetons (*Jetons d'API*) pour scripter :
|
||||||
|
|||||||
@@ -13,6 +13,7 @@ import (
|
|||||||
"os"
|
"os"
|
||||||
"os/signal"
|
"os/signal"
|
||||||
"path"
|
"path"
|
||||||
|
"path/filepath"
|
||||||
"strconv"
|
"strconv"
|
||||||
"strings"
|
"strings"
|
||||||
"syscall"
|
"syscall"
|
||||||
@@ -162,6 +163,16 @@ func main() {
|
|||||||
slog.Info("catalogue PostgreSQL branché")
|
slog.Info("catalogue PostgreSQL branché")
|
||||||
}
|
}
|
||||||
spaces.MaxUpload = envInt("MAX_UPLOAD_MB", 0) << 20 // 0 : illimité
|
spaces.MaxUpload = envInt("MAX_UPLOAD_MB", 0) << 20 // 0 : illimité
|
||||||
|
// Racine S3 (Garage ou S3 compatible) : variables S3_* et/ou interface
|
||||||
|
// d'administration ; exige le catalogue PostgreSQL.
|
||||||
|
spaces.ConfigureS3(ctx, storage.S3Config{
|
||||||
|
Endpoint: env("S3_ENDPOINT", ""),
|
||||||
|
Region: env("S3_REGION", ""),
|
||||||
|
Bucket: env("S3_BUCKET", ""),
|
||||||
|
AccessKey: secretEnv("S3_ACCESS_KEY"),
|
||||||
|
SecretKey: secretEnv("S3_SECRET_KEY"),
|
||||||
|
Insecure: envBool("S3_INSECURE", false),
|
||||||
|
}, filepath.Join(dataDir, ".s3cache"))
|
||||||
|
|
||||||
mode := strings.ToLower(env("AUTH_MODE", "local"))
|
mode := strings.ToLower(env("AUTH_MODE", "local"))
|
||||||
handler := (&api.Handler{Store: store, Spaces: spaces, Mode: mode, Version: version}).Init()
|
handler := (&api.Handler{Store: store, Spaces: spaces, Mode: mode, Version: version}).Init()
|
||||||
|
|||||||
@@ -32,6 +32,7 @@
|
|||||||
// POST /api/public/{jeton}/unlock mot de passe d'un lien protégé
|
// POST /api/public/{jeton}/unlock mot de passe d'un lien protégé
|
||||||
// GET /api/public/{jeton}/file|zip|thumb|preview contenu d'un lien de partage
|
// GET /api/public/{jeton}/file|zip|thumb|preview contenu d'un lien de partage
|
||||||
// GET /api/settings / PUT paramètres (écriture : administrateur)
|
// GET /api/settings / PUT paramètres (écriture : administrateur)
|
||||||
|
// GET /api/admin/s3 / PUT, POST /api/admin/s3/test racine S3 (administrateur)
|
||||||
// GET /api/logo / PUT (image/png) / DELETE logo 64x64
|
// GET /api/logo / PUT (image/png) / DELETE logo 64x64
|
||||||
// POST /api/account/password changement du mot de passe (compte local)
|
// POST /api/account/password changement du mot de passe (compte local)
|
||||||
// PATCH /api/account nom et e-mail (compte local)
|
// PATCH /api/account nom et e-mail (compte local)
|
||||||
@@ -173,6 +174,9 @@ func (h *Handler) Register(mux *http.ServeMux) {
|
|||||||
mux.HandleFunc("GET /api/logo", h.readLogo)
|
mux.HandleFunc("GET /api/logo", h.readLogo)
|
||||||
mux.HandleFunc("PUT /api/logo", h.writeLogo)
|
mux.HandleFunc("PUT /api/logo", h.writeLogo)
|
||||||
mux.HandleFunc("DELETE /api/logo", h.deleteLogo)
|
mux.HandleFunc("DELETE /api/logo", h.deleteLogo)
|
||||||
|
mux.HandleFunc("GET /api/admin/s3", h.adminS3)
|
||||||
|
mux.HandleFunc("PUT /api/admin/s3", h.adminSaveS3)
|
||||||
|
mux.HandleFunc("POST /api/admin/s3/test", h.adminTestS3)
|
||||||
if h.Accounts != nil {
|
if h.Accounts != nil {
|
||||||
mux.HandleFunc("POST /api/account/password", h.changePassword)
|
mux.HandleFunc("POST /api/account/password", h.changePassword)
|
||||||
mux.HandleFunc("PATCH /api/account", h.patchAccount)
|
mux.HandleFunc("PATCH /api/account", h.patchAccount)
|
||||||
|
|||||||
@@ -502,6 +502,10 @@ func TestSettingsAndAdminPermissions(t *testing.T) {
|
|||||||
want(t, bob.json("PUT", "/api/settings", map[string]any{"title": "X"}), 403)
|
want(t, bob.json("PUT", "/api/settings", map[string]any{"title": "X"}), 403)
|
||||||
want(t, bob.do("DELETE", "/api/logo", nil), 403)
|
want(t, bob.do("DELETE", "/api/logo", nil), 403)
|
||||||
want(t, bob.get("/api/admin/users"), 403)
|
want(t, bob.get("/api/admin/users"), 403)
|
||||||
|
want(t, bob.get("/api/admin/s3"), 403)
|
||||||
|
want(t, bob.json("PUT", "/api/admin/s3", map[string]any{"bucket": "b"}), 403)
|
||||||
|
want(t, admin.get("/api/admin/s3"), 200)
|
||||||
|
want(t, admin.json("PUT", "/api/admin/s3", map[string]any{"bucket": "b"}), 400) // sans catalogue
|
||||||
want(t, bob.json("POST", "/api/admin/users", map[string]any{"username": "eve", "password": "mot-de-passe-eve"}), 403)
|
want(t, bob.json("POST", "/api/admin/users", map[string]any{"username": "eve", "password": "mot-de-passe-eve"}), 403)
|
||||||
want(t, bob.json("PATCH", "/api/admin/users/alice", map[string]any{"role": "user"}), 403)
|
want(t, bob.json("PATCH", "/api/admin/users/alice", map[string]any{"role": "user"}), 403)
|
||||||
want(t, bob.do("DELETE", "/api/admin/users/alice", nil), 403)
|
want(t, bob.do("DELETE", "/api/admin/users/alice", nil), 403)
|
||||||
|
|||||||
@@ -0,0 +1,65 @@
|
|||||||
|
package api
|
||||||
|
|
||||||
|
import (
|
||||||
|
"errors"
|
||||||
|
"log/slog"
|
||||||
|
"net/http"
|
||||||
|
|
||||||
|
"github.com/vblogio/upandown/internal/storage"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Configuration de la racine S3 (administrateurs). La clé secrète n'est
|
||||||
|
// jamais renvoyée ; un champ fixé par l'environnement ne peut être modifié.
|
||||||
|
|
||||||
|
func (h *Handler) adminS3(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !h.admin(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
w.Header().Set("Cache-Control", "no-store")
|
||||||
|
writeJSON(w, http.StatusOK, h.Spaces.S3Status())
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *Handler) adminSaveS3(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !h.admin(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
var p storage.S3Patch
|
||||||
|
if !h.decode(w, r, &p) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
st, err := h.Spaces.SaveS3(p)
|
||||||
|
if err != nil {
|
||||||
|
s3Fail(w, err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
slog.Info("racine S3 : configuration modifiée", "by", userID(r))
|
||||||
|
writeJSON(w, http.StatusOK, st)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *Handler) adminTestS3(w http.ResponseWriter, r *http.Request) {
|
||||||
|
if !h.admin(w, r) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
var p storage.S3Patch
|
||||||
|
if !h.decode(w, r, &p) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if err := h.Spaces.TestS3(p); err != nil {
|
||||||
|
s3Fail(w, err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
writeJSON(w, http.StatusOK, map[string]bool{"ok": true})
|
||||||
|
}
|
||||||
|
|
||||||
|
// s3Fail : les erreurs de connexion au bucket sont renvoyées telles quelles
|
||||||
|
// (utiles à l'administrateur).
|
||||||
|
func s3Fail(w http.ResponseWriter, err error) {
|
||||||
|
switch {
|
||||||
|
case errors.Is(err, storage.ErrS3NotEmpty):
|
||||||
|
writeErr(w, http.StatusConflict, err.Error())
|
||||||
|
case errors.Is(err, storage.ErrInvalidPath):
|
||||||
|
writeErr(w, http.StatusBadRequest, err.Error())
|
||||||
|
default:
|
||||||
|
writeErr(w, http.StatusBadGateway, err.Error())
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in new issue
Block a user