From c0d3e8ac441220feed6c4b4bcce04537b731b9da Mon Sep 17 00:00:00 2001
From: el_kaboing <el_kaboing@localhost>
Date: Thu, 01 Feb 2007 17:19:14 +0000
Subject: [PATCH] Added comments for the test cases for the test specifications and the parsing tool.

---
 opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_deprecated_schemes.xml |  105 +++++++++++++++++++++++++
 opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_multiple_schemes.xml   |  109 +++++++++++++++++++++++++++
 2 files changed, 212 insertions(+), 2 deletions(-)

diff --git a/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_deprecated_schemes.xml b/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_deprecated_schemes.xml
index f6d6658..d56ab90 100755
--- a/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_deprecated_schemes.xml
+++ b/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_deprecated_schemes.xml
@@ -30,10 +30,33 @@
   <defaultcall function="deprecated_schemes"/>
 
   <function name="deprecated_schemes">
-
+      <!---
+            Place suite-specific test information here.
+            #@TestSuiteName             Deprecated Schemes
+            #@TestSuitePurpose          Test the support for deprecated password schemes.
+            #@TestSuiteGroup            Deprecated Password Storage Scheme Tests
+            #@TestScript                security_deprecated_schemes.xml
+      -->
       <sequence>
 
         <!--- Test case: Admin Add Three Additional Pwd Storage Schemes -->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Deprecated Schemes Preamble
+            #@TestIssue                 323
+            #@TestPurpose               Prepare to deprecate MD5 scheme
+            #@TestPreamble              none
+            #@TestStep                  Admin Adding 3 Pwd Storage Schemes, 
+                                        MD5, SSHA256, and BASE64.
+            #@TestStep                  User Change Password.
+            #@TestStep                  Check MD5 Scheme Before Deprecating.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+                                        for all operations and a user password
+                                        is successfully stored in the MD5 scheme.
+        -->
         <testcase name="'Security: Depr Pwd Schemes: Preamble'">
           <sequence>
             <message>
@@ -95,6 +118,20 @@
         </testcase>
 
         <!--- Test Case : Admin Deprecate MD5 Scheme-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Admin Deprecate MD5
+            #@TestIssue                 323
+            #@TestPurpose               Deprecate MD5 scheme
+            #@TestPreamble              none
+            #@TestStep                  Admin Deprecate MD5 Scheme.
+            #@TestStep                  Admin Remove MD5 Scheme From Default.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+                                        for all operations.
+        -->
         <testcase name="'Security: Depr Pwd Schemes: Admin Deprecate MD5'">
           <sequence>
             <message>
@@ -134,6 +171,19 @@
         </testcase>
 
         <!--- Test Case : User Bind -->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  User Bind
+            #@TestIssue                 323
+            #@TestPurpose               Test a user bind.
+            #@TestPreamble              none
+            #@TestStep                  User binds.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+                                        and the user binds successfully.
+        -->
         <testcase name="'Security: Depr Pwd Schemes: User Bind'">
           <sequence>
             <message>
@@ -159,6 +209,19 @@
         </testcase>
 
         <!--- Test Case : Check that MD5 hashed password was deleted from from user's entry-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Check For MD5 Password Deletion
+            #@TestIssue                 323
+            #@TestPurpose               Test to determine if the user password in MD5 scheme was deleted.
+            #@TestPreamble              none
+            #@TestStep                  Admin retrieves userpassword from user entry.
+            #@TestPostamble             none
+            #@TestResult                Success if the prefix string, {MD5}, is not found
+                                        in the userpassword.
+        -->
         <testcase name="'Security: Depr Pwd Schemes: Check For Deletion'">
           <sequence>
              <message>
@@ -188,7 +251,20 @@
         </testcase>
 
         <!--- Test Case : Check that other schemes were not deleted from from user's entry-->
-        <testcase name="'Security: Depr Pwd Schemes: Check For Non-Deletions - SSHA'">
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Check For SSHA256 Password Deletion
+            #@TestIssue                 323
+            #@TestPurpose               Test to determine if the user password in SSHA256 scheme was deleted.
+            #@TestPreamble              none
+            #@TestStep                  Admin retrieves userpassword from user entry.
+            #@TestPostamble             none
+            #@TestResult                Success if the prefix string, {SSHA256}, is found
+                                        in the userpassword.
+        -->
+        <testcase name="'Security: Depr Pwd Schemes: Check For Non-Deletions - SSHA256'">
           <sequence>
              <message>
                'Security: Deprecating Pwd Schemes: Checking for SSHA256 Hashed Pwd After Deprecating'
@@ -216,6 +292,19 @@
           </sequence>
         </testcase>
           
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Check For BASE64 Password Deletion
+            #@TestIssue                 323
+            #@TestPurpose               Test to determine if the user password in Base64 scheme was deleted.
+            #@TestPreamble              none
+            #@TestStep                  Admin retrieves userpassword from user entry.
+            #@TestPostamble             none
+            #@TestResult                Success if the prefix string, {BASE64}, is found
+                                        in the userpassword.
+        -->
         <testcase name="'Security: Depr Pwd Schemes: Check For Non-Deletions - BASE64'">
           <sequence>
              <message>
@@ -245,6 +334,18 @@
         </testcase>
 
         <!--- Test case: Admin Reset To SSHA Storage Scheme -->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Deprecated Schemes
+            #@TestName                  Deprecated Schemes Postamble
+            #@TestIssue                 323
+            #@TestPurpose               Reset back to the default SSHA storage scheme.
+            #@TestPreamble              none
+            #@TestStep                  Admin reset the password policy to SSHA password scheme.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+        -->
         <testcase name="'Security: Depr Pwd Schemes: Postamble'">
           <sequence>
             <message>
diff --git a/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_multiple_schemes.xml b/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_multiple_schemes.xml
index 0019950..74b7186 100755
--- a/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_multiple_schemes.xml
+++ b/opendj-sdk/opends/tests/functional-tests/testcases/security/pwd_storage/security_multiple_schemes.xml
@@ -30,10 +30,29 @@
   <defaultcall function="multiple_schemes"/>
 
   <function name="multiple_schemes">
+      <!---
+            Place suite-specific test information here.
+            #@TestSuiteName             Multiple Schemes
+            #@TestSuitePurpose          Test the support for multiple password schemes.
+            #@TestSuiteGroup            Multiple Password Storage Scheme Tests
+            #@TestScript                security_multiple_schemes.xml
+      -->
 
       <sequence>
 
         <!--- Test case: Admin Add Base64 Storage Scheme -->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  Multiple Schemes Preamble
+            #@TestIssue                 322
+            #@TestPurpose               Add BASE64 password scheme
+            #@TestPreamble              none
+            #@TestStep                  Admin add BASE64.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Preamble'">
           <sequence>
             <message>
@@ -56,6 +75,20 @@
         </testcase>
 
         <!--- Test Case : Check for Multi-value for Pwd Schemes - SSHA-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  Check for SSHA Password Scheme
+            #@TestIssue                 322
+            #@TestPurpose               Test for the default SSHA scheme in the password policy
+            #@TestPreamble              none
+            #@TestStep                  Admin retrieve the value for 
+                                        ds-cfg-default-password-storage-scheme.
+            #@TestPostamble             none
+            #@TestResult                Success if the string, "SSHA", 
+                                        is part of the return string.
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Check Pwd Schemes - SSHA'">
           <sequence>
             <message>
@@ -85,6 +118,20 @@
         </testcase>
 
         <!--- Test Case : Check for Multi-value for Pwd Schemes - BASE64-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  Check for BASE64 Password Scheme
+            #@TestIssue                 322
+            #@TestPurpose               Test for the BASE64 scheme in the password policy
+            #@TestPreamble              none
+            #@TestStep                  Admin retrieve the value for 
+                                        ds-cfg-default-password-storage-scheme.
+            #@TestPostamble             none
+            #@TestResult                Success if the string, "BASE64", 
+                                        is part of the return string.
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Check Pwd Schemes - BASE64'">
           <sequence>
             <message>
@@ -114,6 +161,25 @@
         </testcase>
 
         <!--- Test Case : User Change Password Multiple Schemes-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  user Password Change
+            #@TestIssue                 322
+            #@TestPurpose               Test that a user's password is stored in the new schemes.
+            #@TestPreamble              none
+            #@TestStep                  User changes his password.
+            #@TestStep                  User binds with new password.
+            #@TestStep                  Admin retrieves userpassword from user entry and
+                                        checks for the prefix string {SSHA}.
+            #@TestStep                  Admin retrieves userpassword from user entry and
+                                        checks for the prefix string {BASE64}.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+                                        and the user password is stored in both
+                                        SSHA and BASE64 schemes.
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Pwd Change'">
           <sequence>
             <message>
@@ -176,6 +242,25 @@
           </sequence>
         </testcase>
 
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  User Password Change
+            #@TestIssue                 322
+            #@TestPurpose               Test that a user's password is stored in the new schemes.
+            #@TestPreamble              none
+            #@TestStep                  User changes his password.
+            #@TestStep                  User binds with new password.
+            #@TestStep                  Admin retrieves userpassword from user entry and
+                                        checks for the prefix string {SSHA}.
+            #@TestStep                  Admin retrieves userpassword from user entry and
+                                        checks for the prefix string {BASE64}.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+                                        and the user password is stored in both
+                                        SSHA and BASE64 schemes.
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Check for Second Scheme On Pwd Change'">
           <sequence>
             <message>
@@ -205,6 +290,18 @@
         </testcase>
 
         <!--- Test Case : User Improperly Add a Password-->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  User Improper Password Add
+            #@TestIssue                 322
+            #@TestPurpose               Test the response when a user improperly adds a password.
+            #@TestPreamble              none
+            #@TestStep                  User adds a pasword to his entry
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 53
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Improper Pwd Add'">
           <sequence>
             <message>
@@ -228,6 +325,18 @@
         </testcase>
 
         <!--- Test case: Admin Reset To SSHA Storage Scheme -->
+       <!---
+            Place test-specific test information here.
+            The tag, TestMarker, must be the same as the tag, TestSuiteName.
+            #@TestMarker                Multiple Schemes
+            #@TestName                  Multiple Schemes Postamble
+            #@TestIssue                 322
+            #@TestPurpose               Reset back to SSHA storage scheme alone
+            #@TestPreamble              none
+            #@TestStep                  Admin reset the password policy to SSHA password scheme.
+            #@TestPostamble             none
+            #@TestResult                Success if OpenDS returns 0
+        -->
         <testcase name="'Security: Mult Pwd Schemes: Postamble'">
           <sequence>
             <message>

--
Gitblit v1.10.0