1 USING: help.markup help.syntax http quotations urls ;
2 IN: furnace.redirection
4 HELP: <redirect-responder>
5 { $values { "url" url } { "responder" "a responder" } }
6 { $description "Creates a responder which unconditionally redirects the client to the given URL." } ;
9 { $values { "url" url } { "response" response } }
10 { $description "Creates a response which redirects the client to the given URL." } ;
13 { $values { "responder" "a responder" } { "secure-only" "a responder" } }
14 { $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." } ;
16 HELP: <secure-redirect>
19 { "response" response }
21 { $description "Creates a responder which unconditionally redirects the client to the given URL after setting its protocol to HTTPS." }
22 { $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." } ;
29 { $description "Sets the protocol of a URL to HTTPS." } ;
34 { "response" response }
36 { $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." } ;
38 ARTICLE: "furnace.redirection.secure" "Secure redirection"
39 "The words in this section help with implementing sites which require SSL/TLS for additional security."
41 "Converting a HTTP URL into an HTTPS URL:"
42 { $subsections >secure-url }
43 "Redirecting the client to an HTTPS URL:"
44 { $subsections <secure-redirect> }
45 "Tools for writing responders which require SSL/TLS connections:"
51 ARTICLE: "furnace.redirection" "Furnace redirection support"
52 "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 " { $vocab-link "furnace.asides" } " and " { $vocab-link "furnace.conversations" } "."
54 "A redirection response which takes asides and conversations into account:"
55 { $subsections <redirect> }
56 "A responder which unconditionally redirects the client to another URL:"
59 "furnace.redirection.secure"
62 ABOUT: "furnace.redirection"