Added some notes in the documentation about test sript and metadata download

git-svn-id: https://simplesamlphp.googlecode.com/svn/trunk@425 44740490-163a-0410-bde0-09ae8108e29a

docs/source/simplesamlphp-advancedfeatures.xml

@@ -58,7 +58,7 @@
       optionally can add a parameter called <literal>attributes</literal>. If
       you do not include this parameter, all available attributes will be sent
       by default. Adding an array of attributes to this parameter, limits the
-      attributes sent to match this list. </para>
+      attributes sent to match this list.</para>
 
       <example>
         <title>Example of attribute filtering</title>
@@ -181,6 +181,42 @@ $attributemap = array(
     </section>
   </section>
 
+  <section>
+    <title>Automatically update SAML 2.0 Metadata XML from HTTPS</title>
+
+    <para>simpleSAMLphp supports the SAML 2.0 Metadata XML format. There are
+    mulitple ways of using simpleSAMLphp with SAML 2.0 Metadata XML documents,
+    but the reccomended approach would be to use the command line utility
+    <filename>bin/parseMetadata.php</filename> to download and parse metadata
+    from a HTTPS location. This script will grab the XML document from an URL
+    and parse the content. Next it will output simpleSAMLphp flat files in a
+    directory. In config.php configuration you should configure simpleSAMLphp
+    to read these files generated by
+    <filename>parseMetadata.php</filename>.</para>
+  </section>
+
+  <section>
+    <title>Automated testing </title>
+
+    <para>simpleSAMLphp includes a test script that can go to a simpleSAMLphp
+    SP, initiate login, enter some credentials, and then follow the response
+    back to the SP where it is validated, and check the output for expected
+    attributes.</para>
+
+    <para>The intension of this script is to be run in some system monitoring
+    systems, like nagios or hobbit, and generate alerts when something breaks
+    (in example a server is down or metadata misconfigured).</para>
+
+    <para>This test script is located here: <filename>bin/test.php</filename>.
+    The configuration file is located in
+    <filename>config/test.php</filename>.</para>
+
+    <para>Documentation about configuration file format and more details about
+    this test script will be added later. If you in example write a nagios
+    plugin for this test script, let us know :) We will add a hobbit plugin
+    and publish it somewhere pretty soon. Stay tuned!</para>
+  </section>
+
   <section>
     <title>Support</title>