Differences

This shows you the differences between two versions of the page.

--- plugin:authremoteuser [2020-11-08 19:23] – dokuwiki.org@rips.de
+++ plugin:authremoteuser [2021-09-06 11:44] (current) – karl-wilhelm-rips
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: Provides authentication via web server's REMOTE_USER environment variable which is set through authentication systems like HTTP-Auth, LDAP, CAS, Cosign, NTLM, PAM, WebAuth, SSPI, and so on
+description: Provides single sign-on authentication via an environment variable which is set through authentication systems like HTTP-Auth, LDAP, CAS, Cosign, NTLM, PAM, WebAuth, SSPI, and so on
 author     : Karl-Wilhelm Rips
 email      : dokuwiki.org@rips.de
 type       : Auth
-lastupdate : 2020-11-08
+lastupdate : 2021-08-30
 compatible : Detritus, Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather
 depends    :
@@ Line 24: / Line 24: @@
 ===== Description =====
-This plugin allows integration with the web server's built-in authentication system via the ''REMOTE_USER'' environment variable which is set through
+This plugin allows integration with the web server's built-in authentication system via an environment variable which is set through
   * HTTP-Auth,
@@ Line 35: / Line 35: @@
   * SSPI,
   * and so on.
+Default variable name is ''REMOTE_USER''.
 It uses the default plain text file ''conf/users.auth.php'' to store user information.
@@ Line 40: / Line 42: @@
 ===== Installation =====
-  - Enable an authentication system which sets ''REMOTE_USER'' (and disable anonymous authentication) on your web server.
+  - Enable an authentication system which sets (domain and) username in an environment variable on your webserver (''_SERVER[...]'') (and disable anonymous authentication) on your web server.
   - Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugin Installation Instructions#Manual instructions|Plugin Installation Instructions]] on how to install plugins manually.
 ===== Usage =====
-  - Determine your ''REMOTE_USER'' name:
+  - Determine the variable name your authentication system uses:
+    * Default is ''REMOTE_USER''.
+    * If your authentication system uses another variable name notice this name.
+  - Determine your username:
     - Save file ''phpinfo.php'' on your web server:\\ \\ <file php phpinfo.php><?PHP
     phpinfo();
 ?></file>
-    - Open ''phpinfo.php'' in your web browser and search for the value in ''_SERVER["REMOTE_USER"]''.
+    - Open ''phpinfo.php'' in your web browser and search for the value in ''_SERVER[...]'' whereby ''...'' is the variable name of your authentication system.
     - Add this value as new user ID to your user list if it is missing and add them groups ''admin'' and ''user''((Don't be surprised: The user ID is converted to a valid [[:pagename]].))
     - Remove file ''phpinfo.php''.
@@ Line 57: / Line 62: @@
     - Enable ''authtype'' //AuthRemoteUser//.
     - Disable ''rememberme''.
+    - If your authentication system doesn't use variable name ''REMOTE_USER'' set the name (see also topic 1.2) in ''server_var_name_of_auth_system''.
     - Save this configuration.
   - Remove //DokuWiki// cookie from your browser or close and restart your browser.