aboutsummaryrefslogtreecommitdiffstats
path: root/README.txt
blob: c6c980f65cb877ee586c204abda5a504283eda92 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Originally cloned from git://git.drupal.org/project/htpasswdsync.git

Hosted at https://git.faster-it.com/drupal_htpasswdsync
Mirrored at https://github.com/fasterit/drupal_htpasswdsync

This is the Faster IT version of the htpasswdsync module for Drupal 7.
We have applied patches and improved over the module hosted on drupal.org.
This version supports secure (salted) SHA-256-crypt and SHA-512-crypt password
storage.

Pleas be aware that SHA-512-crypt hashes are larger than the 64 bytes the
original authors of this module specified. So if you are upgrading from a
previous version and not re-installing new, please execute the following
in MySQL:

  use drupal7; # or whatever your Drupal database is
  alter table htpasswdsync_htpasswd modify passwd varchar(128);

For an overview of other changes please review the git log.

-- SUMMARY --

The HTPasswd Sync module let you synchronize a htpasswd and a htgroup file with
the user database.

For a full description of the module, visit the project page:
  http://drupal.org/project/htpasswdsync

To submit bug reports and feature suggestions, or to track changes:
  http://drupal.org/project/issues/htpasswdsync

-- REQUIREMENTS --

The syncrhonization only happen on password change. Hence, this module shall be 
installed before any user creation.

You need to run the cron.php job on a regular basis to ensure old users are 
properly cleaned up.

-- INSTALLATION --

* Install as usual, see http://drupal.org/node/70151 for further information.


-- CONFIGURATION --

* Configure synchronized files in Administer >> User management >> HTPasswd Sync >>
  
  htpasswdsync module:

  - htpasswd file
    
    The file that will contain users and password, password are crypted, using
    the standard crypt function, with a random two charaters seed.

  - htgroup file
  
    The file that will synchronize the roles.
    
  - password hashing algorithm
    
    Let you choose how the password is encrypted/hashed. There are two options
    crypt and SHA-1.
    Crypt works only on Un*x platforms. SHA-1 shall work on bother Windows 
    based systems and Un*xes.
    
    WARNING: changing this value only change the way new or updated password
             are hashed.
             You will need to request you users to all change their password
             if you want to migrate from one hash to another.

  - roles
  
    The roles you want to export in the htgroup file.

  - overwrite
  
    Activate if you want to overwrite your htpassword file. I left inactive
    htpasswdsync will try its best to keep old entries, but will only try.
    
-- CUSTOMIZATION --

None.

-- TROUBLESHOOTING --



-- FAQ --


-- CONTACT --

Current maintainers:
* Marc Furrer (m.fu) - http://drupal.org/user/310415
* Stefan Wilhelm (7.x-xx) - http://drupal.org/user/1344522
* Faster IT GmbH - https://www.faster-it.com

© 2014-2024 Faster IT GmbH | imprint | privacy policy