feat(auth): add PAT auth, scoped REST/MCP access, CSRF, and tenant isolation

Introduce Personal Access Tokens (nzp_*) as a stateless auth path alongside
JWT, gated per-endpoint by a scope middleware (nezha:{resource}:{verb}) with
fail-closed empty-scope defaults and a server-id whitelist. Self-management
endpoints (profile, api-tokens, oauth2 bind, refresh-token) explicitly reject
PATs to block privilege-escalation chains. A revoke registry tears down active
long-lived connections (terminal, fm, ws, transfer, mcp) the moment a PAT is
deleted, with a tombstone closing the revoke->register race.

Add an MCP endpoint that proxies tool calls (exec, fs read/write/delete,
transfer) to agents over gRPC, guarded by origin/DNS-rebinding checks, a
per-token rate limiter, audit logging, and a kill switch. Serialize all
sends through the IOStream wrapper to honour grpc-go's concurrency contract.

Add CSRF double-submit protection on unsafe cookie-authenticated methods,
exempting authenticated PAT requests by context identity (not a forgeable
Authorization header). Apply visibility/whitelist filtering consistently
across list, get-by-id, and mutate paths to enforce tenant isolation.

Migrate legacy mcp:* scopes: rewrite read/exec to nezha:* equivalents and
drop dangerous write/delete/wildcard grants.

Co-authored-by: cloudcode <cloudcode@users.noreply.github.com>
This commit is contained in:
naiba
2026-05-30 15:56:44 +00:00
co-authored by cloudcode
parent 029695344c
commit e8dabf5bc6
153 changed files with 16974 additions and 244 deletions
@@ -0,0 +1,63 @@
package controller
import (
"net/http/httptest"
"testing"
"github.com/gin-gonic/gin"
"github.com/nezhahq/nezha/model"
)
// H3 regression: file-manager sessions read/write/delete files, but the route
// only requires nezha:server:write. PAT scopes are advertised as fine-grained
// (read / write / delete / exec); allowing a write-only PAT to open an FM
// session that can list & remove files silently widens the scope.
func TestRestScopeAllOf_RequiresEveryScope(t *testing.T) {
mw := restScopeAllOf(model.ScopeServerRead, model.ScopeServerWrite, model.ScopeServerDelete)
t.Run("rejects_token_missing_delete", func(t *testing.T) {
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
tok := &model.APIToken{ScopesCSV: "nezha:server:read,nezha:server:write"}
c.Set(apiTokenCtxKey, tok)
c.Set(model.CtxKeyAPIToken, tok)
mw(c)
if !c.IsAborted() || w.Code != 403 {
t.Fatalf("missing delete scope must abort with 403, got aborted=%v code=%d", c.IsAborted(), w.Code)
}
})
t.Run("accepts_token_with_all_scopes", func(t *testing.T) {
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
tok := &model.APIToken{ScopesCSV: "nezha:server:read,nezha:server:write,nezha:server:delete"}
c.Set(apiTokenCtxKey, tok)
c.Set(model.CtxKeyAPIToken, tok)
mw(c)
if c.IsAborted() {
t.Fatal("token carrying all required scopes must pass")
}
})
t.Run("jwt_callers_skip_check", func(t *testing.T) {
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
mw(c)
if c.IsAborted() {
t.Fatal("JWT (no PAT) must pass through restScopeAllOf unchanged")
}
})
t.Run("wildcard_resource_scope_satisfies_all", func(t *testing.T) {
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
tok := &model.APIToken{ScopesCSV: "nezha:server:*"}
c.Set(apiTokenCtxKey, tok)
c.Set(model.CtxKeyAPIToken, tok)
mw(c)
if c.IsAborted() {
t.Fatal("nezha:server:* must satisfy server:read+write+delete")
}
})
}