Plain Text Apache-Format htpasswd Plugin

A description of the Plain Text Apache-Format htpasswd plugin, which accesses Apache-format htpasswd and htgroup files to perform user and group authentication.

To use this plugin:

  1. Create an htpasswd file.

    For details regarding this file and the Apache htpasswd utility, see

    Note: This plugin supports only apache's MD5 encryption format. Use the Apache
    htpasswd
    
    command with the
    -m
    
    option to create htpasswd records and ensure proper encryption.
  2. If you are defining groups, create a htgroup file, using the following format for each group:
    
    group-name
    :
    user-name
    ,
    user-name
    ,
    user-name
    
    where
    
    group-name
    
    is the name of a group and
    
    user-name
    
    is a user name associated with the group. You can define multiple groups, one under the other. Each group may include multiple users.
  3. Configure the following entry in the "SybaseC8/Security/AccessControl/Authentication" section of the c8-server.conf file:
    <section name="SybaseC8/Security">
    	...
    	<section name="AccessControl">
       ...
       <section name="Authentication">
          <section name="Plugin">
             <preference name="LibraryName"
                 value="c8_server_plugins_lib"/>
             <preference name="InitializeFunction"
                 value="c8_auth_plugin_htpasswd_initialize"/>
             <preference name="AuthenticateFunction" 
                 value="c8_auth_plugin_htpasswd_authenticate"/>
             <preference name="ShutdownFunction"
                 value="c8_auth_plugin_htpasswd_shutdown"/>
             <preference name="PasswordFilePath"
                 value="
    path-to-htpasswd-file
    \htpasswd.txt"/>
             <preference name="GroupFilePath" 
                 value="
    path-to-htgroup-file
    \htgroup.txt"/>
           </section>
       ...
    
    where
    
    path-to-htpasswd-file
    
    is the directory path to your htpasswd.txt file and
    
    path-to-htgroup-file
    
    is the directory path to your htgroup.txt file.