Changes between Version 12 and Version 13 of AuthFramework

Timestamp:

Aug 22, 2008, 10:19:12 PM (16 years ago)

Author:

cmlenz

Comment:

--

AuthFramework

@@ -1 @@
-= Framework for Authentication and Authorization =
+= Authentication and Authorization =
 
-This page describes an [source:branches/experimental/auth-framework experimental branch] that adds a simple generic auth framework to Diva.
+Diva includes a simple but flexible subsystem for authentication and authorization.
 
-The main goals of this framework are:
+The main goals of this subsystem are:
 
  * Enable relatively easy switching between HTTP authentication (such as `Basic` or `Digest` authentication performed by the web server) and form-based authentication.
@@ -11 +11 @@
  * No restriction to a specific method of controlling access to resources (such as ACLs). Applications can use whatever access control granularity they need.
  * Storage-independent generation and verification of authentication cookies for form-based login.
-
-Possible/peripheral goals:
-
  * Utility functions for generating and verifying encrypted passwords.
  * WSGI middleware for using HTTP authentication, primarily in the context of the DevelopmentServer
 
-All of the above is implemented on the branch at this point.
-
-Non-goals include:
-
- * Built-in processes and UI for user registration, activation, password resetting, and other high-level features.
+The subsystem does not provide built-in processes and UI for user registration, activation, password resetting, and other high-level features.
 
 === Open Issues ===
@@ -30 +23 @@
  * The password encryption utilities are a bit on the silly side. They should either be really useful or get nixed.
 
-== High-Level Architecture Stuff ==
+== Basic Architecture ==
 
-=== Application Mixin Approach ===
-
-The current branch defines an `AuthMixIn` class that auth-enabled applications are supposed to subclass. It adds a couple of method stubs to the `Application` class, and contributes a [wiki:RequestFilters request filter] that performs authentication.
+The `diva.auth` module provides an `AuthMixIn` class that auth-enabled applications are supposed to subclass. It adds a couple of method stubs to `Application` subclasses, and contributes a [wiki:RequestFilters request filter] that performs authentication.
 
 A concrete application would inherit from `AuthMixIn` in addition to being derived from [wiki:ApplicationObject Application], and would probably want to implement two methods for handling the domain-specific details of identifying users and controlling their access to certain actions and/or resources. For example:
@@ -51 +42 @@
         return True
 }}}
-
-=== Filters Refactoring ===
-
-Due to the way application mix-in classes can contribute filters, ordering request filters explicitly becomes too painful. The branch enhances the way request filters are defined by allowing them to declare the abstract service they provide (such as "localization" or "error-handling"), and also declare what services they rely on to do their job. For example:
-
-{{{
-#!python
-@filters.register('form-processing', requires=['templating', 'localization'])
-def form_filter(request, response, chain):
-    ...
-}}}
-
-The ordering of request filters is then inferred from this dependency information.
 
 == Authentication Methods ==