From 22605e7336e2346c781207f286a032ce668c2e2a Mon Sep 17 00:00:00 2001
From: Jan Pazdziora <jpazdziora@redhat.com>
Date: Wed, 8 Jan 2014 13:45:37 +0800
Subject: List the PAM authorization feature first to de-emphasise Basic Auth.

---
 README | 59 ++++++++++++++++++++++++++++++-----------------------------
 1 file changed, 30 insertions(+), 29 deletions(-)

(limited to 'README')

diff --git a/README b/README
index 5becfe9..016d8d2 100644
--- a/README
+++ b/README
@@ -2,16 +2,42 @@
 Apache module mod_authnz_pam
 ============================
 
-Apache module mod_authnz_pam serves as Basic Authentication provider
-which runs the [login, password] authentication through the PAM
-stack. It can also be used as an authorization module, supplementing
-authentication done by other modules, for example mod_auth_kerb.
+Apache module mod_authnz_pam serves as PAM authorization module,
+supplementing authentication done by other modules, for example
+mod_auth_kerb. It can also be used as a full Basic Authentication
+provider for testing purposes, running the [login, password]
+authentication through the PAM stack.
 
 The primary intended use is in connection with sssd and pam_sss.so.
 
 Module configuration
 --------------------
 
+Authorization:
+
+Let us assume there is already Kerberos authentication configured:
+
+    <Location /private>
+      AuthType Kerberos
+      AuthName "Kerberos Login"
+      KrbMethodNegotiate On
+      KrbMethodK5Passwd Off
+      KrbAuthRealms EXAMPLE.COM
+      Krb5KeyTab /etc/http.keytab
+      KrbLocalUserMapping On
+      Require valid-user
+    </Location>
+
+The Require valid-user line can be replaced by
+
+    Require pam-account pam_service_name
+
+for example to run authorization check for the Kerberos-authenticated
+user using the PAM service pam_service_name.
+
+This can be useful to get for example host-based access control from
+an IPA server for the web service.
+
 Basic Authentication:
 
 The module is configured using the
@@ -42,31 +68,6 @@ tlwiki example, file /etc/pam.d/tlwiki could be created with content
 
 to authenticate against sssd.
 
-Authorization:
-
-Let us assume there is already Kerberos authentication configured:
-
-    <Location /private>
-      AuthType Kerberos
-      AuthName "Kerberos Login"
-      KrbMethodNegotiate On
-      KrbMethodK5Passwd Off
-      KrbAuthRealms EXAMPLE.COM
-      Krb5KeyTab /etc/http.keytab
-      KrbLocalUserMapping On
-      Require valid-user
-    </Location>
-
-The Require valid-user line can be replaced by
-
-    Require pam-account pam_service_name
-
-for example to run authorization check for the Kerberos-authenticated
-user using the PAM service pam_service_name.
-
-This can be useful to get for example host-based access control from
-an IPA server for the web service.
-
 On SELinux enabled systems, boolean allow_httpd_mod_auth_pam needs to
 be enabled:
 
-- 
cgit