Alexis Metaireau committed 7834780

update documentation with latest changes

  • Participants
  • Parent commits 53adee9

Comments (0)

Files changed (1)

 Django OAuth Client Application
-A tree-legged OAuth authentication application for django.
+This application provides a simple way to setup a tree-legged OAuth 
+authentication for django.
+It has been originally created for the default client of `Bison Vert
+The code is avalaible under a BSD licence.
-Then, run syncdb::
+Please, note that you *need* to use the `` application,
+properly configured with your project default url. This is needed to redirect
+the user on you website once authenticated on the distant server.
+Then, run syncdb, in order to create the tables that will store the token key
+and secrets you'll use for your application.::
     $ python syncdb
-And go to the admin interface to set up the tokens (be sure to activate it.). You also can specify the tokens in your settings file. Here are the constants::
+Then, you can either go to the admin interface to set up the tokens and websites
+you want to use. For this purpose, you need to have an existant admin instance
+in your application.
+You also can use the `oauth_createtoken` command ::
+    $ python oauthcreatetoken
+Setting up the constants
+You also need to set up your session key in your settings. It need to be unique
+within all your applications::
     PERSISTENT_SESSION_KEY = 'unique persistant session key'
-    # OAUTH URLs
-    OAUTH_SERVER_URL = "the oauth server url"
-    OAUTH_REQUEST_TOKEN_URL = '%s/oauth/request_token/' % OAUTH_SERVER_URL
-    OAUTH_ACCESS_TOKEN_URL = '%s/oauth/access_token/' % OAUTH_SERVER_URL
-    OAUTH_AUTHORIZE_URL = '%s/oauth/authorize/' % OAUTH_SERVER_URL
+Now, you need to provide urls to access the oauthclient application, for your
+project. Here is a simple configuration::
+    urlpatterns = patterns('',
+        # your already existing urls
+        (r'^oauth/', include('oauthclient.urls', namespace='oauth',
+                app_name='yourappoauth'), {'identifier': 'yourappname'}),
+    )