[jboss-cvs] JBossAS SVN: r64635 - projects/security/security-jboss-sx/trunk/src/resources/schema.

[jboss-cvs-commits at lists.jboss.org]

Author: anil.saldhana at jboss.com
Date: 2007-08-16 16:41:22 -0400 (Thu, 16 Aug 2007)
New Revision: 64635

Modified:
   projects/security/security-jboss-sx/trunk/src/resources/schema/security-config_5_0.xsd
Log:
add annotation

Modified: projects/security/security-jboss-sx/trunk/src/resources/schema/security-config_5_0.xsd
===================================================================
--- projects/security/security-jboss-sx/trunk/src/resources/schema/security-config_5_0.xsd	2007-08-16 20:15:35 UTC (rev 64634)
+++ projects/security/security-jboss-sx/trunk/src/resources/schema/security-config_5_0.xsd	2007-08-16 20:41:22 UTC (rev 64635)
@@ -118,6 +118,37 @@
     
    
    <xsd:simpleType name="module-option-flag">
+      <xsd:annotation>
+           <xsd:documentation>The flag attribute controls how a login module
+              participates in the overall authentication proceedure.
+              Required - The LoginModule is required to succeed. If it
+              succeeds or fails, authentication still continues to proceed
+              down the LoginModule list.
+
+              Requisite - The LoginModule is required to succeed. If it succeeds,
+              authentication continues down the LoginModule list. If it fails,
+              control immediately returns to the application (authentication does not proceed
+              down the LoginModule list).
+
+              Sufficient - The LoginModule is  not required to succeed. If it does
+              succeed, control immediately returns to the application (authentication
+              does not proceed down the LoginModule list). If it fails,
+              authentication continues down the LoginModule list.
+                  
+              Optional - The LoginModule is not required to succeed. If it succeeds or
+              fails, authentication still continues to proceed down the
+              LoginModule list.
+                  
+              The overall authentication succeeds only if
+              all required and requisite LoginModules succeed. If a
+              sufficient LoginModule is configured and succeeds, then only
+              the required and requisite LoginModules prior to that
+              sufficient LoginModule need to have succeeded for the overall
+              authentication to succeed. If no required or requisite
+              LoginModules are configured for an application, then at least
+              one sufficient or optional LoginModule must succeed.
+           </xsd:documentation>
+        </xsd:annotation> 
       <xsd:restriction base="xsd:string">
          <xsd:enumeration value="required"/>
          <xsd:enumeration value="requisite"/>