Update to documentation for the module subgrouping selection attributes.
authorphampson <phampson>
Thu, 18 Sep 2003 16:25:05 +0000 (16:25 +0000)
committerphampson <phampson>
Thu, 18 Sep 2003 16:25:05 +0000 (16:25 +0000)
They mainly refer to Autz-Type exec Acct-Type which already had lots of text.

doc/Acct-Type
doc/Autz-Type
doc/Post-Auth-Type [new file with mode: 0644]
doc/Post-Proxy-Type [new file with mode: 0644]
doc/PostAuth-Type [deleted file]
doc/Pre-Acct-Type [new file with mode: 0644]
doc/Pre-Proxy-Type [new file with mode: 0644]
doc/Session-Type

index 9e12d4f..b356874 100644 (file)
@@ -10,6 +10,10 @@ part of the default files {} module is the 'acct_users' file, which
 serves the same purpose as the 'users' file, but applies to accounting
 packets.
 
+Like Autz-Type, if a module changes Acct-Type, after the current
+selection of modules has been run, the section is reexamined for
+a subsection matching the new Acct-Type.
+
 For example, a server administrator is responsible for handling the
 accounting data for two different realms, foo.com and bar.com, and
 wishes to use different instances of the SQL module for each. In
@@ -17,6 +21,7 @@ addition, there is one RADIUS client sending accounting data that is
 to be logged only to a specific detail file. Everything else should
 use a third SQL instance.
 
+
 The acct_users file would look something like this:
 
 ---
index 30504c4..d459e57 100644 (file)
@@ -82,7 +82,7 @@ DEFAULT Called-Station-Id == "236473", Session-Type := SQL
 
 radiusd.conf---
 
-session{
+session {
        radutmp
        Session-Type SQL {
                sql
diff --git a/doc/Post-Auth-Type b/doc/Post-Auth-Type
new file mode 100644 (file)
index 0000000..7a37242
--- /dev/null
@@ -0,0 +1,6 @@
+This is now called Post-Auth-Type, for consistency.
+
+Post-Auth-Type is used to select between groupings of
+modules using arbitrary attributes. It is functionally
+identical to Autz-Type, apart from the name of the
+attribute.
diff --git a/doc/Post-Proxy-Type b/doc/Post-Proxy-Type
new file mode 100644 (file)
index 0000000..351f089
--- /dev/null
@@ -0,0 +1,4 @@
+Post-Proxy-Type is used to select between groupings of
+modules using arbitrary attributes. It is functionally
+identical to Autz-Type, apart from the name of the
+attribute.
diff --git a/doc/PostAuth-Type b/doc/PostAuth-Type
deleted file mode 100644 (file)
index 35fbc56..0000000
+++ /dev/null
@@ -1,92 +0,0 @@
-This is now called Post-Auth-Type, for consistency.
-
-Like Auth-Type for authentication method selection freeradius also
-supports the Autz-Type to select between authorization methods.  The only
-problem is that authorization is the first thing to be called when an
-authentication request is handled.  As a result we first have to call the
-authorize section without checking for Autz-Type. After that we check for
-Autz-Type and if it exists we call the corresponding subsection in the
-authorize section.  In other words the authorize section in radiusd.conf
-should look like this:
-
-
-authorize{
-       suffix
-       preprocess
-       # whatever other authorize modules here
-       Autz-Type Ldap{
-               ldap
-       }
-       Autz-Type SQL{
-               sql
-       }
-       files
-}
-
-What happens is that the first time the authorize section is examined the
-suffix, preprocess and files modules are executed.  If Autz-Type is set
-after that the server core checks for any matching Autz-Type subsection.
-If one is found it is called.  The users file should look something
-like this:
-
-DEFAULT        Called-Station-Id == "123456789", Autz-Type := Ldap
-
-DEFAULT Realm == "other.company.com", Autz-Type := SQL
-
-Autz-Type could also be used to select between multiple instances of
-a module (ie sql or ldap) which have been configured differently.  For
-example based on the user realm different ldap servers (belonging to
-different companies) could be queried.  If Auth-Type was also set then we
-could do both Authentication and Authorization with the user databases
-belonging to other companies.  In detail:
-
-radiusd.conf-----------------
-
-authenticate{
-       Auth-Type customer1{
-               ldap1
-       }
-       Auth-Type customer2{
-               ldap2
-       }
-}
-
-authorize{
-       preprocess
-       suffix
-       Autz-Type customer1{
-               ldap1
-       }
-       Autz-Type customer2{
-               ldap2
-       }
-       files
-}
-
------------------------------
-
-users file-------------------
-
-DEFAULT Realm == "customer1", Autz-Type := customer1, Auth-Type := customer2
-
-DEFAULT Realm == "customer2", Autz-Type := customer2, Auth-Type := customer2
-
-----------------------------
-
-Apart from Autz-Type the server also supports the use of
-Post-Auth-Type, Session-Type and Acct-Type for the corresponding
-sections. The corresponding section names in the radiusd.conf file are
-the same.  So for example:
-
-users file---
-
-DEFAULT Called-Station-Id == "236473", Session-Type := SQL
-
-radiusd.conf---
-
-session{
-       radutmp
-       Session-Type SQL {
-               sql
-       }
-}
diff --git a/doc/Pre-Acct-Type b/doc/Pre-Acct-Type
new file mode 100644 (file)
index 0000000..a86a82c
--- /dev/null
@@ -0,0 +1,4 @@
+Pre-Acct-Type is used to select between groupings of
+modules using arbitrary attributes. It is functionally
+identical to Autz-Type, apart from the name of the
+attribute.
diff --git a/doc/Pre-Proxy-Type b/doc/Pre-Proxy-Type
new file mode 100644 (file)
index 0000000..7ea5e03
--- /dev/null
@@ -0,0 +1,4 @@
+Pre-Proxy-Type is used to select between groupings of
+modules using arbitrary attributes. It is functionally
+identical to Autz-Type, apart from the name of the
+attribute.
index ac4f189..5590c8d 100644 (file)
@@ -1,90 +1,8 @@
-Like Auth-Type for authentication method selection freeradius also
-supports the Autz-Type to select between authorization methods.  The only
-problem is that authorization is the first thing to be called when an
-authentication request is handled.  As a result we first have to call the
-authorize section without checking for Autz-Type. After that we check for
-Autz-Type and if it exists we call the corresponding subsection in the
-authorize section.  In other words the authorize section in radiusd.conf
-should look like this:
+Session-Type is used to select between groupings of
+modules using arbitrary attributes. It is similar
+to Autz-Type, but an update to Session-Type by a module
+in the session stanza will cause the named grouping
+to be immediately executed.
 
+This allows Simultaneous-Use checking behaviour to be very flexible.
 
-authorize{
-       suffix
-       preprocess
-       # whatever other authorize modules here
-       autztype Ldap{
-               ldap
-       }
-       autztype SQL{
-               sql
-       }
-       files
-}
-
-What happens is that the first time the authorize section is examined the
-suffix, preprocess and files modules are executed.  If Autz-Type is set
-after that the server core checks for any matching autztype subsection.
-If one is found it is called.  The users file should look something
-like this:
-
-DEFAULT        Called-Station-Id == "123456789", Autz-Type := Ldap
-
-DEFAULT Realm == "other.company.com", Autz-Type := SQL
-
-Autz-Type could also be used to select between multiple instances of
-a module (ie sql or ldap) which have been configured differently.  For
-example based on the user realm different ldap servers (belonging to
-different companies) could be queried.  If Auth-Type was also set then we
-could do both Authentication and Authorization with the user databases
-belonging to other companies.  In detail:
-
-radiusd.conf-----------------
-
-authenticate{
-       authtype customer1{
-               ldap1
-       }
-       authtype customer2{
-               ldap2
-       }
-}
-
-authorize{
-       preprocess
-       suffix
-       autztype customer1{
-               ldap1
-       }
-       autztype customer2{
-               ldap2
-       }
-       files
-}
-
------------------------------
-
-users file-------------------
-
-DEFAULT Realm == "customer1", Autz-Type := customer1, Auth-Type := customer2
-
-DEFAULT Realm == "customer2", Autz-Type := customer2, Auth-Type := customer2
-
-----------------------------
-
-Apart from Autz-Type the server also supports the use of PostAuth-Type,Session-Type
-and Acct-Type for the corresponding sections. The corresponding section names in the
-radiusd.conf file are post-authtype,sestype and accttype.
-So for example:
-
-users file---
-
-DEFAULT Called-Station-Id == "236473", Session-Type := SQL
-
-radiusd.conf---
-
-session{
-       radutmp
-       sesstype SQL {
-               sql
-       }
-}