Files
Enterprise-Knowledge-Base/internal/middleware/api_key_scope.go
T
wizardchen 9a76a24ce6 refactor(api-keys): use role field and route-level API key guards
Replace scopes JSON with a viewer/contributor/admin role column, move
unsafe-method authorization from path-prefix middleware to declarative
APIKey* guards on routes, and close remaining KB-scope gaps in handlers.
2026-07-07 12:00:13 +08:00

56 lines
1.3 KiB
Go

package middleware
import (
"context"
stderrors "errors"
"net/http"
"github.com/Tencent/WeKnora/internal/types"
)
var errTenantAPIKeyScopeForbidden = stderrors.New("tenant api key scope forbidden")
// authorizeTenantAPIKeyAccess enforces baseline rules for X-API-Key callers
// before route-level guards run: block key-management paths and require
// Viewer+ for safe reads. Unsafe methods defer to per-route APIKey* guards.
func authorizeTenantAPIKeyAccess(ctx context.Context, method, path string) error {
scope, ok := types.TenantAPIKeyScopeFromContext(ctx)
if !ok {
return nil
}
role := scope.Role
if role == "" {
role = types.TenantRoleViewer
}
if isTenantAPIKeyManagementPath(path) {
return errTenantAPIKeyScopeForbidden
}
if isSafeHTTPMethod(method) {
if role.HasPermission(types.TenantRoleViewer) {
return nil
}
return errTenantAPIKeyScopeForbidden
}
return nil
}
func authorizeTenantAPIKeyKnowledgeBase(ctx context.Context, kbID string) error {
scope, ok := types.TenantAPIKeyScopeFromContext(ctx)
if !ok {
return nil
}
if scope.AllowsKnowledgeBase(kbID) {
return nil
}
return errTenantAPIKeyScopeForbidden
}
func isSafeHTTPMethod(method string) bool {
switch method {
case http.MethodGet, http.MethodHead, http.MethodOptions:
return true
default:
return false
}
}