Version 8 (modified by Dominic König, 13 years ago) ( diff )


DeveloperGuidelinesS3Framework | S3AAA

S3 Authentication, Authorization and Accounting

Authentication is the act of establishing or confirming someone's identity.
Authorization is the concept of allowing access to resources only to those permitted to use them.
Accounting refers to the tracking of user actions - an audit trail.


AAA functions for S3 are implemented in the modules/s3/ module. This module extends the web2py Auth class as AuthS3 (Authentication), and defines additional classes for role management, access control and audit.

AuthS3modules/s3/s3aaa.pyAuthentication, Login
S3Permissionmodules/s3/s3aaa.pyAuthorization of Access, ACLs
S3Auditmodules/s3/s3aaa.pyData access logging, audit trail
S3RoleManagermodules/s3/s3aaa.pyRESTful method to manage roles and ACLs
Admin controllerscontrollers/admin.pyUser Management, role management


Current user

Interactive Login

HTTP Simple Authentication


Access permissions are granted to roles, i.e. to get a particular permission the user must be assigned a role with this permission.

Roles are defined in the auth_group table. This table is defined by the AuthS3 module in modules/s3/ Each role as an ID, a unique name and can have a description.

At the start of every request, the IDs of all roles of the currently logged-in user are stored as list in session.s3.roles (in models/ In cases where the user is logged-in during the request (e.g. by HTTP simple auth), a refresh of this list is also triggered by the login_bare() method of AuthS3.

Roles can be managed in the S3RoleManager interface (Administration => User Management => Roles).


Access Control Lists (ACLs) are bit arrays with each bit representing a permissions to access data with a particular method:

auth.permission.CREATE0x0001may create new records
auth.permission.READ0x0002may read or list records
auth.permission.UPDATE0x0004may update existing records
auth.permission.DELETE0x0008may delete records

ACLs are combinations of these bits (by logical OR), e.g. an ACL with the value 0x0006 defines permissions to read and update records, while no permission to add or to delete any records.

ACLs are stored per role and request destination in the s3_permission table, which is defined by the S3Permission class (in modules/s3/

Record Ownership

Controller Restriction

Resource Restriction

Implementation of Access Control



Data Access Logging (Audit)


Note: See TracWiki for help on using the wiki.