RETIRED, An alternative authentication system for Swift
Go to file
gholt 69fd700039 Quick doc updates 2011-07-31 16:31:57 +00:00
bin Added ability to purge stored tokens. Fixes #5 2011-06-06 00:06:59 +00:00
doc Quick doc updates 2011-07-31 16:31:57 +00:00
etc Quick doc updates 2011-07-31 16:31:57 +00:00
locale Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
swauth Quick doc updates 2011-07-31 16:31:57 +00:00
test_swauth Tests for swauth initialization related to auth types 2011-07-30 16:05:27 -07:00
webadmin First edition of the webadmin 2011-06-27 04:47:10 +00:00
.gitignore Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
.unittests Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
AUTHORS Quick doc updates 2011-07-31 16:31:57 +00:00
CHANGELOG Versionn change to 1.0.3-dev 2011-06-06 20:24:32 +00:00
LICENSE Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
MANIFEST.in Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
README.md Move README to README.md for github 2011-06-30 21:53:09 +00:00
babel.cfg Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
setup.cfg Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00
setup.py Initial commit of original codebase, altered to work in new codebase. 2011-05-26 10:39:59 +00:00

README.md

Swauth

An Auth Service for Swift as WSGI Middleware that uses Swift itself as a backing store. Sphinx-built docs at: http://gholt.github.com/swauth/

See also https://github.com/khussein/keystone for the future standard OpenStack auth service.

This is currently a work in progress of pulling Swauth out of the Swift repo and here into its own project. See https://code.launchpad.net/~gholt/swift/deswauth/+merge/62392 for the Swift side of things.

Quick Install

  1. Install Swauth with sudo python setup.py install or sudo python setup.py develop or via whatever packaging system you may be using.

  2. Alter your proxy-server.conf pipeline to have swauth instead of tempauth:

    Was::

     [pipeline:main]
     pipeline = catch_errors cache tempauth proxy-server
    

    Change To::

     [pipeline:main]
     pipeline = catch_errors cache swauth proxy-server
    
  3. Add to your proxy-server.conf the section for the Swauth WSGI filter::

    [filter:swauth] use = egg:swauth#swauth set log_name = swauth super_admin_key = swauthkey

  4. Restart your proxy server swift-init proxy reload

  5. Initialize the Swauth backing store in Swift swauth-prep -K swauthkey

  6. Add an account/user swauth-add-user -A http://127.0.0.1:8080/auth/ -K swauthkey -a test tester testing

  7. Ensure it works swift -A http://127.0.0.1:8080/auth/v1.0 -U test:tester -K testing stat -v

Web Admin Install

  1. If you installed from packages, you'll need to cd to the webadmin directory the package installed. This is /usr/share/doc/python-swauth/webadmin with the Lucid packages. If you installed from source, you'll need to cd to the webadmin directory in the source directory.

  2. Upload the Web Admin files with swift -A http://127.0.0.1:8080/auth/v1.0 -U .super_admin:.super_admin -K swauthkey upload .webadmin .

  3. Open http://127.0.0.1:8080/auth/ in your browser.