Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming. Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
218 lines
12 KiB
Go
218 lines
12 KiB
Go
package server
|
|
|
|
import (
|
|
"net/http"
|
|
"strings"
|
|
)
|
|
|
|
type authorizationTargetKind string
|
|
|
|
const (
|
|
targetPath authorizationTargetKind = "path"
|
|
targetDomain authorizationTargetKind = "domain"
|
|
)
|
|
|
|
type endpointPolicy struct {
|
|
Name string
|
|
Capability string
|
|
Target authorizationTargetKind
|
|
Resolver endpointTargetResolver
|
|
}
|
|
|
|
type endpointTargetResolver string
|
|
|
|
const (
|
|
resolveNone endpointTargetResolver = ""
|
|
resolveHandler endpointTargetResolver = "handler"
|
|
resolveObjectURL endpointTargetResolver = "object_url"
|
|
resolveRevision endpointTargetResolver = "revision_url"
|
|
resolveRaw endpointTargetResolver = "raw_address"
|
|
resolveText endpointTargetResolver = "text_revision"
|
|
resolvePDF endpointTargetResolver = "pdf_revision"
|
|
resolvePreview endpointTargetResolver = "preview_document"
|
|
resolveQueryPath endpointTargetResolver = "query_path"
|
|
resolveViewPath endpointTargetResolver = "view_path"
|
|
resolvePrint endpointTargetResolver = "print_address"
|
|
resolveDiff endpointTargetResolver = "revision_diff"
|
|
)
|
|
|
|
var endpointPolicies = map[string]endpointPolicy{
|
|
"GET /_/api/v1/extension": {Name: "extension.catalog", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /-/sys/config/vim": {Name: "config.vim", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /:/new": {Name: "page.create_form", Capability: "create", Target: targetDomain},
|
|
"GET /v/upload": {Name: "upload.form", Capability: "read", Target: targetDomain},
|
|
"GET /_/api/v1/object/list": {Name: "object.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/path-picker": {Name: "path_picker.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/search/suggest": {Name: "search.suggest", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/browser/navigation": {Name: "browser.navigation.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"HEAD /_/api/v1/object/list": {Name: "object.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/revisions/list": {Name: "revision.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"HEAD /_/api/v1/revisions/list": {Name: "revision.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/gc/zombies/list": {Name: "gc.list", Capability: "manage", Target: targetDomain},
|
|
"POST /:/new": {Name: "page.create", Capability: "create", Target: targetDomain},
|
|
"POST /:/compile/markdown": {Name: "render.markdown", Capability: "read", Target: targetDomain},
|
|
"POST /_/api/v1/object/create": {Name: "object.create", Capability: "create", Target: targetDomain},
|
|
"POST /_/api/v1/object/delete": {Name: "object.delete", Capability: "delete", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/revisions/save": {Name: "revision.save", Capability: "write", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/revisions/restore": {Name: "revision.restore", Capability: "write", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/render/markdown": {Name: "render.markdown", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/tag/add": {Name: "tag.add", Capability: "write", Target: targetDomain},
|
|
"POST /_/api/v1/path/bind": {Name: "path.bind", Capability: "link", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/path/rename": {Name: "path.rename", Capability: "rename", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/path/rename-preview": {Name: "path.rename_preview", Capability: "rename", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/path/remove": {Name: "path.remove", Capability: "delete", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/path/copy": {Name: "path.copy", Capability: "create", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/browser/navigation": {Name: "browser.navigation.add", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"PATCH /_/api/v1/browser/navigation": {Name: "browser.navigation.rename", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"DELETE /_/api/v1/browser/navigation": {Name: "browser.navigation.delete", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/gc/zombies/purge": {Name: "gc.purge", Capability: "delete", Target: targetDomain},
|
|
"POST /v/upload": {Name: "document.upload", Capability: "upload", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/assets": {Name: "asset.list", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/assets": {Name: "asset.create", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"DELETE /_/api/v1/assets": {Name: "asset.delete", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/notifications": {Name: "notifications.list", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"GET /_/api/v1/notifications/push": {Name: "notifications.push", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/notifications/push": {Name: "notifications.push", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"DELETE /_/api/v1/notifications/push": {Name: "notifications.push", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/notifications/read": {Name: "notifications.read", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"PATCH /_/api/v1/notifications/read": {Name: "notifications.read", Capability: "read", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/publication/requests": {Name: "publication.request", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
"POST /_/api/v1/publication/requests/": {Name: "publication.decide", Capability: "manage", Target: targetDomain, Resolver: resolveHandler},
|
|
}
|
|
|
|
var mutationPrefixPolicies = []struct {
|
|
Prefix string
|
|
Policy endpointPolicy
|
|
}{
|
|
{Prefix: "/e/", Policy: endpointPolicy{Name: "document.edit", Capability: "write", Target: targetPath}},
|
|
{Prefix: "/-/sys/", Policy: endpointPolicy{Name: "system.manage", Capability: "manage", Target: targetDomain}},
|
|
{Prefix: "/_/api/v1/event", Policy: endpointPolicy{Name: "event.manage", Capability: "manage", Target: targetDomain}},
|
|
{Prefix: "/_/api/v1/queue", Policy: endpointPolicy{Name: "queue.manage", Capability: "manage", Target: targetDomain}},
|
|
{Prefix: "/_/api/v1/adapter", Policy: endpointPolicy{Name: "adapter.manage", Capability: "manage", Target: targetDomain}},
|
|
{Prefix: "/_/api/v1/publication/requests/", Policy: endpointPolicy{Name: "publication.decide", Capability: "manage", Target: targetDomain, Resolver: resolveHandler}},
|
|
{Prefix: "/_/api/v1/city/", Policy: endpointPolicy{Name: "city.mutate", Capability: "write", Target: targetDomain}},
|
|
{Prefix: "/_/api/v1/import/", Policy: endpointPolicy{Name: "import.mutate", Capability: "write", Target: targetDomain}},
|
|
{Prefix: "/v/import", Policy: endpointPolicy{Name: "import.mutate", Capability: "write", Target: targetDomain}},
|
|
{Prefix: "/:/compile/diagram/", Policy: endpointPolicy{Name: "render.diagram", Capability: "read", Target: targetDomain}},
|
|
{Prefix: "/l/", Policy: endpointPolicy{Name: "path.link", Capability: "link", Target: targetDomain, Resolver: resolveHandler}},
|
|
}
|
|
|
|
func policyForRequest(r *http.Request) endpointPolicy {
|
|
if taskRoute(r.URL.Path) {
|
|
return endpointPolicy{Name: "tasks.handler", Capability: "read", Target: targetDomain, Resolver: resolveHandler}
|
|
}
|
|
if calendarRoute(r.URL.Path) {
|
|
return endpointPolicy{Name: "calendar.handler", Capability: "read", Target: targetDomain, Resolver: resolveHandler}
|
|
}
|
|
if kind, operation := periodicalRoute(r.URL.Path); kind != "" {
|
|
if (r.Method == "GET" && operation != "posts") || (r.Method == "POST" && operation != "view" && operation != "plan" && operation != "new") {
|
|
capability := "read"
|
|
if r.Method == "POST" {
|
|
capability = "write"
|
|
if operation == "settings" {
|
|
capability = "manage"
|
|
}
|
|
}
|
|
return endpointPolicy{Name: "extension." + kind + "." + operation, Capability: capability, Target: targetDomain, Resolver: resolveHandler}
|
|
}
|
|
return endpointPolicy{Name: "extension.method.undefined", Capability: "deny", Target: targetDomain}
|
|
}
|
|
if cityGovernanceRoute(r.URL.Path) {
|
|
return endpointPolicy{Name: "city.governance", Capability: "manage", Target: targetDomain, Resolver: resolveHandler}
|
|
}
|
|
cleanPath := strings.TrimSuffix(r.URL.Path, "/")
|
|
if policy, ok := endpointPolicies[r.Method+" "+cleanPath]; ok {
|
|
return policy
|
|
}
|
|
// Exact routes are method-closed. This also protects older handlers that do
|
|
// not yet carry their own explicit method guard.
|
|
for route := range endpointPolicies {
|
|
_, declaredPath, ok := strings.Cut(route, " ")
|
|
if ok && declaredPath == cleanPath {
|
|
return endpointPolicy{Name: "method.undefined", Capability: "deny", Target: targetDomain}
|
|
}
|
|
}
|
|
if r.Method == http.MethodGet || r.Method == http.MethodHead || r.Method == http.MethodOptions {
|
|
if resolver, capability := readEndpointResolver(r.URL.Path); resolver != resolveNone {
|
|
return endpointPolicy{Name: "derived.read", Capability: capability, Target: targetPath, Resolver: resolver}
|
|
}
|
|
if strings.HasPrefix(r.URL.Path, "/e/") {
|
|
return endpointPolicy{Name: "document.editor", Capability: "write", Target: targetPath}
|
|
}
|
|
if strings.HasPrefix(r.URL.Path, "/-/sys/") ||
|
|
strings.HasPrefix(r.URL.Path, "/_/api/v1/event") ||
|
|
strings.HasPrefix(r.URL.Path, "/_/api/v1/queue") {
|
|
return endpointPolicy{Name: "system.read", Capability: "manage", Target: targetDomain}
|
|
}
|
|
return endpointPolicy{Name: "content.read", Capability: "read", Target: endpointTargetKind(r.URL.Path)}
|
|
}
|
|
|
|
for _, rule := range mutationPrefixPolicies {
|
|
if strings.HasPrefix(r.URL.Path, rule.Prefix) {
|
|
return rule.Policy
|
|
}
|
|
}
|
|
if isReservedEndpoint(r.URL.Path) {
|
|
return endpointPolicy{Name: "reserved.undefined", Capability: "deny", Target: targetDomain}
|
|
}
|
|
return endpointPolicy{Name: "document.mutate", Capability: "write", Target: targetPath}
|
|
}
|
|
|
|
func readEndpointResolver(path string) (endpointTargetResolver, string) {
|
|
switch {
|
|
case path == "/v/children", path == "/v/tree", strings.HasPrefix(path, "/v/tree/"):
|
|
return resolveHandler, "read"
|
|
case path == "/v/city", strings.HasPrefix(path, "/v/city/"), strings.HasPrefix(path, "/_/api/v1/city/"):
|
|
return resolveHandler, "read"
|
|
case path == "/v/bookmarks":
|
|
return resolveHandler, "read"
|
|
case strings.HasPrefix(path, "/_/obj/"):
|
|
return resolveHandler, "read"
|
|
case strings.HasPrefix(path, "/v/raw/"):
|
|
return resolveRaw, "read"
|
|
case strings.HasPrefix(path, "/v/text/"):
|
|
return resolveText, "read"
|
|
case path == "/v/pdf-page":
|
|
return resolvePDF, "read"
|
|
case strings.HasPrefix(path, "/v/preview-cache/"):
|
|
return resolvePreview, "read"
|
|
case path == "/v/archive", path == "/v/email-html":
|
|
return resolveQueryPath, "read"
|
|
case path == "/v/search", path == "/v/tree", strings.HasPrefix(path, "/v/tree/"):
|
|
return resolveHandler, "read"
|
|
case strings.HasPrefix(path, "/_/view/print/"):
|
|
return resolvePrint, "read"
|
|
case strings.HasPrefix(path, "/v/preview"), strings.HasPrefix(path, "/v/plain"), strings.HasPrefix(path, "/v/markdown"):
|
|
return resolveViewPath, "read"
|
|
case strings.HasPrefix(path, "/o/e/"):
|
|
return resolveObjectURL, "write"
|
|
case strings.HasPrefix(path, "/l/uuid:"):
|
|
return resolveObjectURL, "read"
|
|
case strings.HasPrefix(path, "/o/r/"), strings.HasPrefix(path, "/o/"):
|
|
return resolveObjectURL, "read"
|
|
case strings.HasPrefix(path, "/r/history/"):
|
|
return resolveObjectURL, "read"
|
|
case strings.HasPrefix(path, "/r/view/"):
|
|
return resolveRevision, "read"
|
|
case strings.HasPrefix(path, "/r/diff/"):
|
|
return resolveDiff, "read"
|
|
}
|
|
return resolveNone, ""
|
|
}
|
|
|
|
func endpointTargetKind(path string) authorizationTargetKind {
|
|
if isReservedEndpoint(path) {
|
|
return targetDomain
|
|
}
|
|
return targetPath
|
|
}
|
|
|
|
func isReservedEndpoint(path string) bool {
|
|
for _, prefix := range []string{"/_/", "/-/", "/:/", "/o/", "/r/", "/v/", "/l/", "/static/"} {
|
|
if strings.HasPrefix(path, prefix) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|