From 29945e0e5d339480d7b85ce3d23b890ef753dd42 Mon Sep 17 00:00:00 2001
From: Nassim Babaci <nassim.babaci@cloudwatt.com>
Date: Fri, 11 Jul 2014 11:48:10 +0000
Subject: [PATCH] update README.md

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/README.md b/README.md
index e69de29..655ac08 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,40 @@
+Swift3
+------
+
+SwiftPolicy Middleware for OpenStack Swift, allows to use json policy file 
+format to handle swift authorizations.
+
+SwiftPolicy is an adaptation of the keystoneauth middleware here:
+https://github.com/openstack/swift/blob/master/swift/common/middleware/keystoneauth.py
+
+For compatibity reasons, with the shipped default.json file SwiftPolicy 
+will behave exactly like keystoneauth. (except we removed the deprecated 
+is_admin feature).
+
+Install
+-------
+
+1) Install SwiftPolicy  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 SwiftPolicy:
+
+You can use SwiftPolicy in place of keystoneauth middleware:
+
+    Was::
+
+        [pipeline:main]
+        pipeline = catch_errors cache tempauth proxy-server
+
+    Change To::
+
+        [pipeline:main]
+        pipeline = catch_errors cache swiftpolicy tempauth proxy-server
+
+3) Add to your proxy-server.conf the section for the SwiftPolicy WSGI filter::
+
+Policy file is given using ``policy`` option 
+
+    [filter:swift3]
+    use = egg:swiftpolicy#swiftpolicy
+    policy = {HERE}/default.json