1 USING: help.markup help.syntax io.streams.string quotations urls
3 IN: furnace.redirection
5 HELP: <redirect-responder>
6 { $values { "url" url } { "responder" "a responder" } }
7 { $description "Creates a responder which unconditionally redirects the client to the given URL." } ;
10 { $values { "url" url } { "response" response } }
11 { $description "Creates a response which redirects the client to the given URL." } ;
14 { $values { "responder" "a responder" } { "secure-only" "a responder" } }
15 { $description "Creates a new responder which ensures that the client is connecting via HTTPS before delegating to the underlying responder. If the client is connecting via HTTP, a redirect is sent instead." } ;
17 HELP: <secure-redirect>
20 { "response" response }
22 { $description "Creates a responder which unconditionally redirects the client to the given URL after setting its protocol to HTTPS." }
23 { $notes "This word is intended to be used with a relative URL. The client is redirected to the relative URL, but with HTTPS instead of HTTP." } ;
30 { $description "Sets the protocol of a URL to HTTPS." } ;
35 { "response" response }
37 { $description "Runs a quotation if the current request was made over HTTPS, otherwise returns a redirect to have the client request the current page again via HTTPS." } ;
39 ARTICLE: "furnace.redirection.secure" "Secure redirection"
40 "The words in this section help with implementing sites which require SSL/TLS for additional security."
42 "Converting a HTTP URL into an HTTPS URL:"
43 { $subsections >secure-url }
44 "Redirecting the client to an HTTPS URL:"
45 { $subsections <secure-redirect> }
46 "Tools for writing responders which require SSL/TLS connections:"
52 ARTICLE: "furnace.redirection" "Furnace redirection support"
53 "The " { $vocab-link "furnace.redirection" } " vocabulary builds additional functionality on top of " { $vocab-link "http.server.redirection" } ", and integrates with various Furnace features such as " { $link "furnace.asides" } " and " { $link "furnace.conversations" } "."
55 "A redirection response which takes asides and conversations into account:"
56 { $subsections <redirect> }
57 "A responder which unconditionally redirects the client to another URL:"
60 "furnace.redirection.secure"
63 ABOUT: "furnace.redirection"