3 // Password Plugin options
4 // -----------------------
5 // A driver to use for password change. Default: "sql".
6 // See README file for list of supported driver names.
7 $rcmail_config['password_driver'] = 'sql';
9 // Determine whether current password is required to change password.
11 $rcmail_config['password_confirm_current'] = true;
13 // Require the new password to be a certain length.
14 // set to blank to allow passwords of any length
15 $rcmail_config['password_minimum_length'] = 0;
17 // Require the new password to contain a letter and punctuation character
18 // Change to false to remove this check.
19 $rcmail_config['password_require_nonalpha'] = false;
21 // Enables logging of password changes into logs/password
22 $rcmail_config['password_log'] = false;
27 // PEAR database DSN for performing the query. By default
28 // Roundcube DB settings are used.
29 $rcmail_config['password_db_dsn'] = '';
31 // The SQL query used to change the password.
32 // The query can contain the following macros that will be expanded as follows:
33 // %p is replaced with the plaintext new password
34 // %c is replaced with the crypt version of the new password, MD5 if available
36 // %D is replaced with the dovecotpw-crypted version of the new password
37 // %o is replaced with the password before the change
38 // %n is replaced with the hashed version of the new password
39 // %q is replaced with the hashed password before the change
40 // %h is replaced with the imap host (from the session info)
41 // %u is replaced with the username (from the session info)
42 // %l is replaced with the local part of the username
43 // (in case the username is an email address)
44 // %d is replaced with the domain part of the username
45 // (in case the username is an email address)
46 // Escaping of macros is handled by this module.
47 // Default: "SELECT update_passwd(%c, %u)"
48 $rcmail_config['password_query'] = 'SELECT update_passwd(%c, %u)';
50 // By default domains in variables are using unicode.
51 // Enable this option to use punycoded names
52 $rcmail_config['password_idn_ascii'] = false;
54 // Path for dovecotpw (if not in $PATH)
55 // $rcmail_config['password_dovecotpw'] = '/usr/local/sbin/dovecotpw';
57 // Dovecot method (dovecotpw -s 'method')
58 $rcmail_config['password_dovecotpw_method'] = 'CRAM-MD5';
60 // Enables use of password with crypt method prefix in %D, e.g. {MD5}$1$LUiMYWqx$fEkg/ggr/L6Mb2X7be4i1/
61 $rcmail_config['password_dovecotpw_with_method'] = false;
63 // Using a password hash for %n and %q variables.
64 // Determine which hashing algorithm should be used to generate
65 // the hashed new and current password for using them within the
66 // SQL query. Requires PHP's 'hash' extension.
67 $rcmail_config['password_hash_algorithm'] = 'sha1';
69 // You can also decide whether the hash should be provided
70 // as hex string or in base64 encoded format.
71 $rcmail_config['password_hash_base64'] = false;
74 // Poppassd Driver options
75 // -----------------------
76 // The host which changes the password
77 $rcmail_config['password_pop_host'] = 'localhost';
79 // TCP port used for poppassd connections
80 $rcmail_config['password_pop_port'] = 106;
83 // SASL Driver options
84 // -------------------
85 // Additional arguments for the saslpasswd2 call
86 $rcmail_config['password_saslpasswd_args'] = '';
89 // LDAP and LDAP_SIMPLE Driver options
90 // -----------------------------------
91 // LDAP server name to connect to.
92 // You can provide one or several hosts in an array in which case the hosts are tried from left to right.
93 // Exemple: array('ldap1.exemple.com', 'ldap2.exemple.com');
94 // Default: 'localhost'
95 $rcmail_config['password_ldap_host'] = 'localhost';
97 // LDAP server port to connect to
99 $rcmail_config['password_ldap_port'] = '389';
101 // TLS is started after connecting
102 // Using TLS for password modification is recommanded.
104 $rcmail_config['password_ldap_starttls'] = false;
108 $rcmail_config['password_ldap_version'] = '3';
110 // LDAP base name (root directory)
111 // Exemple: 'dc=exemple,dc=com'
112 $rcmail_config['password_ldap_basedn'] = 'dc=exemple,dc=com';
114 // LDAP connection method
115 // There is two connection method for changing a user's LDAP password.
116 // 'user': use user credential (recommanded, require password_confirm_current=true)
117 // 'admin': use admin credential (this mode require password_ldap_adminDN and password_ldap_adminPW)
119 $rcmail_config['password_ldap_method'] = 'user';
122 // Used only in admin connection mode
124 $rcmail_config['password_ldap_adminDN'] = null;
126 // LDAP Admin Password
127 // Used only in admin connection mode
129 $rcmail_config['password_ldap_adminPW'] = null;
132 // The user's DN is mandatory and as we only have his login,
133 // we need to re-create his DN using a mask
134 // '%login' will be replaced by the current roundcube user's login
135 // '%name' will be replaced by the current roundcube user's name part
136 // '%domain' will be replaced by the current roundcube user's domain part
137 // '%dc' will be replaced by domain name hierarchal string e.g. "dc=test,dc=domain,dc=com"
138 // Exemple: 'uid=%login,ou=people,dc=exemple,dc=com'
139 $rcmail_config['password_ldap_userDN_mask'] = 'uid=%login,ou=people,dc=exemple,dc=com';
142 // The DN roundcube should bind with to find out user's DN
143 // based on his login. Note that you should comment out the default
144 // password_ldap_userDN_mask setting for this to take effect.
145 // Use this if you cannot specify a general template for user DN with
146 // password_ldap_userDN_mask. You need to perform a search based on
147 // users login to find his DN instead. A common reason might be that
148 // your users are placed under different ou's like engineering or
149 // sales which cannot be derived from their login only.
150 $rcmail_config['password_ldap_searchDN'] = 'cn=roundcube,ou=services,dc=example,dc=com';
152 // LDAP search password
153 // If password_ldap_searchDN is set, the password to use for
154 // binding to search for user's DN. Note that you should comment out the default
155 // password_ldap_userDN_mask setting for this to take effect.
156 // Warning: Be sure to set approperiate permissions on this file so this password
157 // is only accesible to roundcube and don't forget to restrict roundcube's access to
158 // your directory as much as possible using ACLs. Should this password be compromised
159 // you want to minimize the damage.
160 $rcmail_config['password_ldap_searchPW'] = 'secret';
163 // If password_ldap_searchDN is set, the base to search in using the filter below.
164 // Note that you should comment out the default password_ldap_userDN_mask setting
165 // for this to take effect.
166 $rcmail_config['password_ldap_search_base'] = 'ou=people,dc=example,dc=com';
168 // LDAP search filter
169 // If password_ldap_searchDN is set, the filter to use when
170 // searching for user's DN. Note that you should comment out the default
171 // password_ldap_userDN_mask setting for this to take effect.
172 // '%login' will be replaced by the current roundcube user's login
173 // '%name' will be replaced by the current roundcube user's name part
174 // '%domain' will be replaced by the current roundcube user's domain part
175 // '%dc' will be replaced by domain name hierarchal string e.g. "dc=test,dc=domain,dc=com"
176 // Example: '(uid=%login)'
177 // Example: '(&(objectClass=posixAccount)(uid=%login))'
178 $rcmail_config['password_ldap_search_filter'] = '(uid=%login)';
180 // LDAP password hash type
181 // Standard LDAP encryption type which must be one of: crypt,
182 // ext_des, md5crypt, blowfish, md5, sha, smd5, ssha, or clear.
183 // Please note that most encodage types require external libraries
184 // to be included in your PHP installation, see function hashPassword in drivers/ldap.php for more info.
186 $rcmail_config['password_ldap_encodage'] = 'crypt';
188 // LDAP password attribute
189 // Name of the ldap's attribute used for storing user password
190 // Default: 'userPassword'
191 $rcmail_config['password_ldap_pwattr'] = 'userPassword';
193 // LDAP password force replace
194 // Force LDAP replace in cases where ACL allows only replace not read
195 // See http://pear.php.net/package/Net_LDAP2/docs/latest/Net_LDAP2/Net_LDAP2_Entry.html#methodreplace
197 $rcmail_config['password_ldap_force_replace'] = true;
199 // LDAP Password Last Change Date
200 // Some places use an attribute to store the date of the last password change
201 // The date is meassured in "days since epoch" (an integer value)
202 // Whenever the password is changed, the attribute will be updated if set (e.g. shadowLastChange)
203 $rcmail_config['password_ldap_lchattr'] = '';
205 // LDAP Samba password attribute, e.g. sambaNTPassword
206 // Name of the LDAP's Samba attribute used for storing user password
207 $rcmail_config['password_ldap_samba_pwattr'] = '';
209 // LDAP Samba Password Last Change Date attribute, e.g. sambaPwdLastSet
210 // Some places use an attribute to store the date of the last password change
211 // The date is meassured in "seconds since epoch" (an integer value)
212 // Whenever the password is changed, the attribute will be updated if set
213 $rcmail_config['password_ldap_samba_lchattr'] = '';
216 // DirectAdmin Driver options
217 // --------------------------
218 // The host which changes the password
219 // Use 'ssl://host' instead of 'tcp://host' when running DirectAdmin over SSL.
220 // The host can contain the following macros that will be expanded as follows:
221 // %h is replaced with the imap host (from the session info)
222 // %d is replaced with the domain part of the username (if the username is an email)
223 $rcmail_config['password_directadmin_host'] = 'tcp://localhost';
225 // TCP port used for DirectAdmin connections
226 $rcmail_config['password_directadmin_port'] = 2222;
229 // vpopmaild Driver options
230 // -----------------------
231 // The host which changes the password
232 $rcmail_config['password_vpopmaild_host'] = 'localhost';
234 // TCP port used for vpopmaild connections
235 $rcmail_config['password_vpopmaild_port'] = 89;
238 // cPanel Driver options
239 // --------------------------
240 // The cPanel Host name
241 $rcmail_config['password_cpanel_host'] = 'host.domain.com';
243 // The cPanel admin username
244 $rcmail_config['password_cpanel_username'] = 'username';
246 // The cPanel admin password
247 $rcmail_config['password_cpanel_password'] = 'password';
249 // The cPanel port to use
250 $rcmail_config['password_cpanel_port'] = 2082;
252 // Using ssl for cPanel connections?
253 $rcmail_config['password_cpanel_ssl'] = true;
255 // The cPanel theme in use
256 $rcmail_config['password_cpanel_theme'] = 'x';
259 // XIMSS (Communigate server) Driver options
260 // -----------------------------------------
261 // Host name of the Communigate server
262 $rcmail_config['password_ximss_host'] = 'mail.example.com';
264 // XIMSS port on Communigate server
265 $rcmail_config['password_ximss_port'] = 11024;
268 // chpasswd Driver options
269 // ---------------------
271 $rcmail_config['password_chpasswd_cmd'] = 'sudo /usr/sbin/chpasswd 2> /dev/null';
274 // XMail Driver options
275 // ---------------------
276 $rcmail_config['xmail_host'] = 'localhost';
277 $rcmail_config['xmail_user'] = 'YourXmailControlUser';
278 $rcmail_config['xmail_pass'] = 'YourXmailControlPass';
279 $rcmail_config['xmail_port'] = 6017;
282 // hMail Driver options
283 // -----------------------
284 // Remote hMailServer configuration
285 // true: HMailserver is on a remote box (php.ini: com.allow_dcom = true)
286 // false: Hmailserver is on same box as PHP
287 $rcmail_config['hmailserver_remote_dcom'] = false;
288 // Windows credentials
289 $rcmail_config['hmailserver_server'] = array(
290 'Server' => 'localhost', // hostname or ip address
291 'Username' => 'administrator', // windows username
292 'Password' => 'password' // windows user password
296 // Virtualmin Driver options
297 // -------------------------
299 // 0: username@domain
300 // 1: username%domain
301 // 2: username.domain
302 // 3: domain.username
303 // 4: username-domain
304 // 5: domain-username
305 // 6: username_domain
306 // 7: domain_username
307 $rcmail_config['password_virtualmin_format'] = 0;