aboutsummaryrefslogtreecommitdiffstats
path: root/examples/basic_auth/README.md
diff options
context:
space:
mode:
authorIvan Lisenkov <[email protected]>2013-01-30 00:30:05 +0400
committerIvan Lisenkov <[email protected]>2013-01-30 00:30:05 +0400
commit54c6d3fa3aada272839a431a45318d33dbc6b9e5 (patch)
treed702271731de3dff8e5af1863dc210280a5f961c /examples/basic_auth/README.md
parentfd5a977a39ec99d0aa57a2864f91cca7af5c67d6 (diff)
downloadcowboy-54c6d3fa3aada272839a431a45318d33dbc6b9e5.tar.gz
cowboy-54c6d3fa3aada272839a431a45318d33dbc6b9e5.tar.bz2
cowboy-54c6d3fa3aada272839a431a45318d33dbc6b9e5.zip
Implement authorization header parsing
Basic HTTP authorization according to RFC 2617 is implemented. Added an example of its usage with REST handler.
Diffstat (limited to 'examples/basic_auth/README.md')
-rw-r--r--examples/basic_auth/README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/examples/basic_auth/README.md b/examples/basic_auth/README.md
new file mode 100644
index 0000000..74662cd
--- /dev/null
+++ b/examples/basic_auth/README.md
@@ -0,0 +1,44 @@
+Cowboy Basic Authorization Rest Hello World.
+============================================
+
+To compile this example you need rebar in your PATH.
+
+Type the following command:
+```
+$ rebar get-deps compile
+```
+
+You can then start the Erlang node with the following command:
+```
+./start.sh
+```
+
+Then run any given command or point your browser to the indicated URL.
+
+Examples
+--------
+
+### Get 401
+``` bash
+$ curl -i http://localhost:8080
+HTTP/1.1 401 Unauthorized
+connection: keep-alive
+server: Cowboy
+date: Sun, 20 Jan 2013 14:10:27 GMT
+content-length: 0
+www-authenticate: Restricted
+```
+
+### Get 200
+``` bash
+$ curl -i -u "Alladin:open sesame" http://localhost:8080
+HTTP/1.1 200 OK
+connection: keep-alive
+server: Cowboy
+date: Sun, 20 Jan 2013 14:11:12 GMT
+content-length: 16
+content-type: text/plain
+
+Hello, Alladin!
+```
+