-
Notifications
You must be signed in to change notification settings - Fork 157
Troubleshooting Login Issues
Cypht has 2 modes of operation, "debug" and "production". When you are running in debug mode a ton of useful information is output to the PHP error log. This can be very helpful when troubleshooting login issues. Enabling debug mode is as simple as accessing the index.php file in the main Cypht download. Production mode is enabled by accessing the index.php file in the site/ subdirectory. DEBUG MODE IS NOT SECURE, and should only be used when doing development or troubleshooting issues. Anytime you change your hm3.ini file, you must rerun the scripts/config_gen.php script, even in debug mode.
Cypht has a lot of different authentication options. If you are authenticating against an IMAP or LDAP server, you must be sure to fill out the relevant connection details in the hm3.ini file, and confirm you have access from the server hosting to Cypht to the correct auth source and port. If you are using db auth, the same applies (you must be able to connect to the database), and you will need to configure a db with the proper table for auth to work.
Cypht uses cookies to maintain a login session. If you are using a reverse proxy it's possible the domain used for the cookie does not match the domain you are using to access Cypht. The result is you won't be recognized as logged in even though your authentication may have succeeded. When running in debug mode Cypht dumps information about cookie properties that should help determine if this is an issue for your setup. Also, see the "cookie_domain" hm3.ini option for hard coding the domain to use for cookies.