internal/httpd/routes.go
216 lines · 11340 bytes
1package httpd
2
3import (
4 "fmt"
5 "net"
6 "net/http"
7 "strings"
8)
9
10// Route is one entry in the explicit route table. The view-only guarantee is
11// structural: Handler() consults web.mode when building the table, and the
12// route test asserts no mutating route exists in view_only mode.
13type Route struct {
14 Method string
15 Pattern string // without method prefix
16 // Mutating marks routes that can change server state. The git transport
17 // POSTs are not mutating: upload-pack is a pure read, and the
18 // receive-pack endpoint is a static refusal that writes nothing.
19 Mutating bool
20 Handler http.HandlerFunc
21}
22
23// Routes returns the route table for the configured web.mode.
24func (s *Server) Routes() []Route {
25 // Git smart transport (anonymous, public repos only).
26 routes := []Route{
27 {Method: "GET", Pattern: "/{owner}/{repo}/info/refs", Handler: s.infoRefs},
28 {Method: "POST", Pattern: "/{owner}/{repo}/git-upload-pack", Handler: s.uploadPack},
29 {Method: "POST", Pattern: "/{owner}/{repo}/git-receive-pack", Handler: s.receivePackRefusal},
30 // Git LFS: token-authenticated transport (minted over SSH), not
31 // web-session routes — anonymous download for public repos only.
32 {Method: "POST", Pattern: "/{owner}/{repo}/info/lfs/objects/batch", Handler: s.lfsBatch},
33 {Method: "GET", Pattern: "/{owner}/{repo}/info/lfs/objects/{oid}", Handler: s.lfsDownload},
34 {Method: "PUT", Pattern: "/{owner}/{repo}/info/lfs/objects/{oid}", Handler: s.lfsUpload},
35 }
36
37 // Web UI, read-only. These exist in every mode.
38 routes = append(routes,
39 Route{Method: "GET", Pattern: "/{$}", Handler: s.index},
40 Route{Method: "GET", Pattern: "/explore", Handler: s.explore},
41 Route{Method: "GET", Pattern: "/privacy", Handler: s.privacy},
42 Route{Method: "GET", Pattern: "/static/style.css", Handler: s.stylesheet},
43 // Literal per-file routes: a {name} wildcard is ambiguous against
44 // /{owner}/{repo}/... patterns in ServeMux precedence.
45 Route{Method: "GET", Pattern: "/static/fonts/plex-sans.woff2", Handler: s.font},
46 Route{Method: "GET", Pattern: "/static/fonts/plex-mono-400.woff2", Handler: s.font},
47 Route{Method: "GET", Pattern: "/static/fonts/plex-mono-500.woff2", Handler: s.font},
48 Route{Method: "GET", Pattern: "/favicon.svg", Handler: s.favicon},
49 Route{Method: "GET", Pattern: "/{owner}", Handler: s.ownerPage},
50 Route{Method: "GET", Pattern: "/{owner}/{repo}", Handler: s.repoHome},
51 Route{Method: "GET", Pattern: "/{owner}/{repo}/tree/{ref}/{path...}", Handler: s.tree},
52 Route{Method: "GET", Pattern: "/{owner}/{repo}/blob/{ref}/{path...}", Handler: s.blob},
53 Route{Method: "GET", Pattern: "/{owner}/{repo}/blame/{ref}/{path...}", Handler: s.blame},
54 Route{Method: "GET", Pattern: "/{owner}/{repo}/search", Handler: s.search},
55 Route{Method: "GET", Pattern: "/{owner}/{repo}/milestones", Handler: s.milestones},
56 Route{Method: "GET", Pattern: "/{owner}/{repo}/wiki", Handler: s.wiki},
57 Route{Method: "GET", Pattern: "/{owner}/{repo}/wiki/_raw/{path...}", Handler: s.wikiRaw},
58 Route{Method: "GET", Pattern: "/{owner}/{repo}/wiki/{page}", Handler: s.wiki},
59 Route{Method: "GET", Pattern: "/{owner}/{repo}/releases", Handler: s.releases},
60 Route{Method: "GET", Pattern: "/{owner}/{repo}/builds", Handler: s.builds},
61 Route{Method: "GET", Pattern: "/{owner}/{repo}/badge/build.svg", Handler: s.buildBadge},
62 Route{Method: "GET", Pattern: "/{owner}/{repo}/builds/{n}", Handler: s.build},
63 Route{Method: "GET", Pattern: "/{owner}/{repo}/releases/download/{tag}/{name}", Handler: s.releaseAsset},
64 Route{Method: "GET", Pattern: "/{owner}/{repo}/raw/{ref}/{path...}", Handler: s.raw},
65 Route{Method: "GET", Pattern: "/{owner}/{repo}/log", Handler: s.log},
66 Route{Method: "GET", Pattern: "/{owner}/{repo}/log/{ref}", Handler: s.log},
67 Route{Method: "GET", Pattern: "/{owner}/{repo}/commit/{sha}", Handler: s.commit},
68 Route{Method: "GET", Pattern: "/{owner}/{repo}/refs", Handler: s.refs},
69 Route{Method: "GET", Pattern: "/{owner}/{repo}/archive/{file}", Handler: s.archive},
70 Route{Method: "GET", Pattern: "/{owner}/{repo}/issues", Handler: s.issues},
71 Route{Method: "GET", Pattern: "/{owner}/{repo}/issues/{n}", Handler: s.issue},
72 Route{Method: "GET", Pattern: "/{owner}/{repo}/mrs", Handler: s.mrs},
73 Route{Method: "GET", Pattern: "/{owner}/{repo}/mrs/{n}", Handler: s.mr},
74 )
75
76 // The JSON API is its own opt-in surface, independent of web.mode.
77 if s.cfg.API.Enabled {
78 routes = append(routes,
79 Route{Method: "POST", Pattern: "/api/v1/cmd", Mutating: true, Handler: s.apiCmd},
80 )
81 }
82
83 // Account-mode routes exist only when web.mode = "accounts". In
84 // view_only they are never registered — the structural guarantee.
85 if s.cfg.Web.Mode == "accounts" {
86 routes = append(routes,
87 Route{Method: "GET", Pattern: "/login", Handler: s.login, Mutating: true}, // consumes a one-time token
88 Route{Method: "POST", Pattern: "/logout", Mutating: true,
89 Handler: s.checkOrigin(s.logout)},
90 Route{Method: "GET", Pattern: "/new", Handler: s.requireUser(s.newRepoForm)},
91 )
92 // Web signup fronts the same registration path as SSH register,
93 // so it exists only when registration is open or invite.
94 if s.cfg.Registration.Mode != "closed" {
95 routes = append(routes,
96 Route{Method: "GET", Pattern: "/register", Handler: s.signupForm},
97 Route{Method: "POST", Pattern: "/register", Mutating: true,
98 Handler: s.checkOrigin(s.signupSubmit)},
99 )
100 }
101 routes = append(routes,
102 Route{Method: "POST", Pattern: "/new", Mutating: true,
103 Handler: s.checkOrigin(s.requireUser(s.newRepoSubmit))},
104 Route{Method: "POST", Pattern: "/{owner}/{repo}/pin", Mutating: true,
105 Handler: s.checkOrigin(s.requireUser(s.pinToggle))},
106 Route{Method: "GET", Pattern: "/{owner}/{repo}/issues/new",
107 Handler: s.requireUser(s.issueCreateForm)},
108 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/new", Mutating: true,
109 Handler: s.checkOrigin(s.requireUser(s.issueCreateSubmit))},
110 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/comment", Mutating: true,
111 Handler: s.checkOrigin(s.requireUser(s.issueCommentSubmit))},
112 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/edit", Mutating: true,
113 Handler: s.checkOrigin(s.requireUser(s.issueEditSubmit))},
114 // Triage: each runs the matching issue command.
115 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/state", Mutating: true,
116 Handler: s.checkOrigin(s.requireUser(s.issueStateSubmit))},
117 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/label", Mutating: true,
118 Handler: s.checkOrigin(s.requireUser(s.issueLabelSubmit))},
119 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/assign", Mutating: true,
120 Handler: s.checkOrigin(s.requireUser(s.issueAssignSubmit))},
121 Route{Method: "POST", Pattern: "/{owner}/{repo}/issues/{n}/milestone", Mutating: true,
122 Handler: s.checkOrigin(s.requireUser(s.issueMilestoneSubmit))},
123 Route{Method: "POST", Pattern: "/{owner}/{repo}/releases", Mutating: true,
124 Handler: s.checkOrigin(s.requireUser(s.releaseSubmit))},
125 Route{Method: "POST", Pattern: "/{owner}/{repo}/builds", Mutating: true,
126 Handler: s.checkOrigin(s.requireUser(s.buildTriggerSubmit))},
127 Route{Method: "GET", Pattern: "/{owner}/{repo}/settings",
128 Handler: s.requireUser(s.settingsForm)},
129 Route{Method: "POST", Pattern: "/{owner}/{repo}/settings", Mutating: true,
130 Handler: s.checkOrigin(s.requireUser(s.settingsSubmit))},
131 Route{Method: "GET", Pattern: "/{owner}/{repo}/mrs/new",
132 Handler: s.requireUser(s.mrCreateForm)},
133 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/new", Mutating: true,
134 Handler: s.checkOrigin(s.requireUser(s.mrCreateSubmit))},
135 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/edit", Mutating: true,
136 Handler: s.checkOrigin(s.requireUser(s.mrEditSubmit))},
137 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/comment", Mutating: true,
138 Handler: s.checkOrigin(s.requireUser(s.mrCommentSubmit))},
139 // Review loop: each runs the matching mr command.
140 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/review", Mutating: true,
141 Handler: s.checkOrigin(s.requireUser(s.mrReviewSubmit))},
142 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/merge", Mutating: true,
143 Handler: s.checkOrigin(s.requireUser(s.mrMergeSubmit))},
144 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/close", Mutating: true,
145 Handler: s.checkOrigin(s.requireUser(s.mrCloseSubmit))},
146 Route{Method: "POST", Pattern: "/{owner}/{repo}/mrs/{n}/thread", Mutating: true,
147 Handler: s.checkOrigin(s.requireUser(s.mrThreadSubmit))},
148 Route{Method: "GET", Pattern: "/{owner}/{repo}/edit/{ref}/{path...}",
149 Handler: s.requireUser(s.editForm)},
150 Route{Method: "POST", Pattern: "/{owner}/{repo}/edit/{ref}/{path...}", Mutating: true,
151 Handler: s.checkOrigin(s.requireUser(s.editSubmit))},
152 )
153 }
154 return routes
155}
156
157func (s *Server) Handler() http.Handler {
158 mux := http.NewServeMux()
159 for _, r := range s.Routes() {
160 mux.HandleFunc(r.Method+" "+r.Pattern, r.Handler)
161 }
162 var h http.Handler = mux
163 if len(s.cfg.GoImport) > 0 {
164 h = s.goImportHandler(mux)
165 }
166 // Always wrapped: custom pages domains work with or without the
167 // built-in [pages] domain.
168 return s.pagesRouter(s.securityHeaders(h))
169}
170
171// securityHeaders sets defensive response headers on every reply. The CSP
172// is strict where it can be: no scripts at all (the UI needs none), no
173// plugins, no embedding. Inline styles are allowed because label chips
174// carry their color inline (chroma is class-based so the syntax palette
175// can follow the color scheme). Images may load from anywhere so external README images
176// still render; they are the one thing a reader-facing forge can't police
177// without a proxy.
178func (s *Server) securityHeaders(next http.Handler) http.Handler {
179 const csp = "default-src 'self'; script-src 'none'; style-src 'self' 'unsafe-inline'; " +
180 "img-src * data:; object-src 'none'; base-uri 'none'; form-action 'self'; frame-ancestors 'none'"
181 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
182 hd := w.Header()
183 hd.Set("Content-Security-Policy", csp)
184 hd.Set("X-Frame-Options", "DENY")
185 hd.Set("X-Content-Type-Options", "nosniff")
186 hd.Set("Referrer-Policy", "no-referrer")
187 hd.Set("Cross-Origin-Opener-Policy", "same-origin")
188 if s.cfg.HTTP.TLS != "off" {
189 hd.Set("Strict-Transport-Security", "max-age=31536000; includeSubDomains")
190 }
191 next.ServeHTTP(w, r)
192 })
193}
194
195func (s *Server) goImportHandler(mux http.Handler) http.Handler {
196 // Vanity Go modules: ?go-get=1 requests under a configured module
197 // path answer with the go-import meta tag before normal routing.
198 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
199 if r.URL.Query().Get("go-get") == "1" {
200 host := r.Host
201 if h, _, err := net.SplitHostPort(host); err == nil {
202 host = h
203 }
204 requested := host + strings.TrimSuffix(r.URL.Path, "/")
205 for module, repo := range s.cfg.GoImport {
206 if requested == module || strings.HasPrefix(requested, module+"/") {
207 w.Header().Set("Content-Type", "text/html; charset=utf-8")
208 fmt.Fprintf(w, `<!DOCTYPE html><html><head><meta name="go-import" content="%s git %s/%s.git"></head><body>%s</body></html>`,
209 module, s.cfg.Server.SiteURL, repo, module)
210 return
211 }
212 }
213 }
214 mux.ServeHTTP(w, r)
215 })
216}