Contents

• 1. Introduction
  • 1.1 Definition
  • 1.2 Implementation
  • 1.3 Single sign-on
  
  
• 2. Installation
  • 2.1 Installation using clump
  • 2.2 Manual OpenPKG installation
  • 2.3 Post-Installation Configuration
    • 2.3.1 Apache Web Server
    • 2.3.2 Server Module Configuration
    • 2.3.3 Virtual Organization
    • 2.3.4 Method Access Control
    • 2.3.5 File Access Control
  
  
• 3. Client Usage
  • 3.1 Command-Line Utilities
    • 3.1.1 clarens-proxy-init
    • 3.1.2 clarens-ping
    • 3.1.3 clarens-package-hostcert
    • 3.1.4 clarens-package-hostkey
    • 3.1.5 clarens-package-cacert
    • 3.1.6 clarens-package-cadir
    • 3.1.7 clarens-package-root
  • 3.2 Kerberos Certificate Authority
  • 3.3 Python
    • 3.3.1 Simple example
    • 3.3.2 Procedure calls
    • 3.3.3 Session termination
    • 3.3.4 Complete example
    • 3.3.5 Binary return data
    • 3.3.6 Debugging
    • 3.3.7 Using a different certificate file
  • 3.4 ROOT
    • 3.4.1 TCWebfile
    • 3.4.2 A simple example
    • 3.4.3 Different certificate and key files
    • 3.4.4 Caching file reads
    • 3.4.5 Multiple files on a single site
    • 3.4.6 Multiple sites, single login
    • 3.4.7 TCSystemDirectory
  
  
• 4. Writing Browser Interfaces
  • 4.1 Files and paths
    • 4.1.1 Accessing files on the server in different contexts
    • 4.1.2 Browser interface path conventions
    • 4.1.3 Registry files
  • 4.2 Creating the interface
    • 4.2.1 HTML file
    • 4.2.2 Javascript file
  
  
• 5. Writing new Clarens modules
  • 5.1 Introduction
  • 5.2 First Example: the echo module
    • 5.2.1 Starting out
    • 5.2.2 Defining a new method
    • 5.2.3 Exposing the method
    • 5.2.4 The full example
  • 5.3 Debugging
    • 5.3.1 Python debugger
    • 5.3.2 Automatic tracebacks
  • 5.4 Handling exceptions with build_fault
  • 5.5 Service initialization
    • 5.5.1 Example
    • 5.5.2 Per server initialization
  • 5.6 Persistent data storage using tdb
    • 5.6.1 Opening database handles
    • 5.6.2 Standard databases
    • 5.6.3 Printf-style debugging
  
  
• 6. Service packaging and configuration
  • 6.1 Service installation
    • 6.1.1 Service code
    • 6.1.2 Configuration files
    • 6.1.3 Minimal example
  • 6.2 Service configuration
    • 6.2.1 Configuration file format
    • 6.2.2 Configuration file example
    • 6.2.3 Command-line configuration
  
  
• 7. Clarens authentication/login protocol
  • 7.1 Introduction
  • 7.2 Two steps
  • 7.3 SSL based authentication
    • 7.3.1 Proxy authentication over SSL
  • 7.4 GET requests
  • 7.5 Other transport protocols
  • 7.6 Discussion
  
  
• Bibliography