devise-proxy 0.1.3 → 0.1.4

data/README.md

@@ -8,17 +8,44 @@ Authentication is done on *every* request, so it is advisable to use devise-prox
 devise-proxy will return a 502 if a network connection to your authentication host cannot be established.
 
 
-# Quick Start #
+## Quick Start ##
 
-- Create a devise-proxy.yml using the provided .sample.
-- `rackup config.ru' to start the proxy server.
-- Configure you web browser or other client software to use the proxy and set a username (email) and password.
-- Enjoy!
+1. Create a devise-proxy.yml using the provided .sample.
+1. Start the proxy server:
+>  rackup config.ru
+1. Configure you web browser or other client software to use the proxy and set a username (email) and password.
+1. Enjoy!
 
-# Authors #
+## Example Configuration ##
+
+You'll need a config/devise-proxy.yml file to start the application. For example:
+
+    authentication:
+      hostname: localhost
+      port: 3000
+    forwarding:
+      hostname: localhost
+      port: 3000
+
+
+## Troubleshooting ##
+
+
+
+### Infinite Client Redirects ###
+
+If your client complains about infinite redirects, you're probably forwarding traffic to a hostname that returns a 302.
+This may be the case if you request example.com, but the server redirects you to www.example.com.
+When this occurs, the client will receive the 302 with the preferred hostname try again with a new URL. Since the proxy tosses out the hostname portion of the URL
+and replaces it with whatever's in the config file, however, the proxy will forward to the same bad hostname, get another 302,
+and return it to the client, introducing an infinite loop that the browser *should* eventually catch and stop.
+This shouldn't be a big deal if you're forwarding to your own well-behaved devise app, but is worth mentioning. 
+
+
+## Authors ##
 
 Preston Lee
 
-# Legal #
+## Legal ##
 
 See LICENSE file for details.

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

data/devise-proxy.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "devise-proxy"
-  s.version = "0.1.3"
+  s.version = "0.1.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Preston Lee"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: devise-proxy
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -115,7 +115,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3790407277146841335
+      hash: -1230018857575091658
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: