xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From r...@apache.org
Subject svn commit: r498968 - in /xml/site/targets/security/Java: api.html examples.html faq.html index.html installation.html interop.html resolver.html
Date Tue, 23 Jan 2007 09:42:16 GMT
Author: raul
Date: Tue Jan 23 01:42:12 2007
New Revision: 498968

URL: http://svn.apache.org/viewvc?view=rev&rev=498968
Log:
Updating web pages for 1.4 release

Added:
    xml/site/targets/security/Java/api.html
    xml/site/targets/security/Java/examples.html
    xml/site/targets/security/Java/faq.html
    xml/site/targets/security/Java/index.html
    xml/site/targets/security/Java/installation.html
    xml/site/targets/security/Java/interop.html
    xml/site/targets/security/Java/resolver.html

Added: xml/site/targets/security/Java/api.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/api.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/api.html (added)
+++ xml/site/targets/security/Java/api.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,195 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Java API Documentation</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">API Docs</div>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Java API Documentation</h1> 
+    
+<a name="N1000D"></a><a name="Javadoc+Generated+Documentation"></a>
+<h2 class="h3">Javadoc Generated Documentation</h2>
+<div class="section">
+<p>Apache-XML-Security-J comes packaged with API documentation.</p>
+<p>This documentation is generated automatically from the Javadoc-style
+	comments inside the source files.  Click on one of the links below to
+	go to the appropriate API documentation.</p>
+</div>
+    
+<a name="N1001A"></a><a name="xml-security+API+Documentation"></a>
+<h2 class="h3">xml-security API Documentation</h2>
+<div class="section">
+<ul>
+      
+<li>
+<a target="_top" href="../Java/api/index.html">Full API documentation</a>
+</li>
+      
+<li>
+<a target="_top" href="../Java/api/overview-tree.html">Hierarchy for all the packages</a>
+</li>
+    
+</ul>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/examples.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/examples.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/examples.html (added)
+++ xml/site/targets/security/Java/examples.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,205 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Java Examples</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Examples</div>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Java Examples</h1> 
+    
+<a name="N1000D"></a><a name="XML+Signatures"></a>
+<h2 class="h3">XML Signatures</h2>
+<div class="section">
+<p>
+	Part of this software can be used to create and verify arbitrary forms
+	of XML Signatures. The documentation available here is not very huge;
+	my first approach is to supply usage examples which are available in
+	the <span class="codefrag">src_samples/</span> directory to give interested users a
+	first starting point to jump-start with XML Signature. 
+      </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+	The samples divide into two groups: Samples that <em>create</em> and
+	samples that <em>verify</em> Signatures. Eventually, you should adjust
+	the verifying program to another filename if you get
+	<span class="codefrag">FileNotFoundException</span>s.
+      </div>
+</div>
+</div>
+	
+<a name="N10026"></a><a name="XML+Encryption"></a>
+<h2 class="h3">XML Encryption</h2>
+<div class="section">
+<p>
+		As with signatures, samples are provided to show how to encrypt
+		and decrypt XML content.  See 
+		<span class="codefrag">src_samples/org/apache/xml/security/samples/encryption</span>.
+	  </p>
+<p>
+		The samples can be compiled and run using <span class="codefrag">ant encrypt</span>
+		and <span class="codefrag">ant decrypt</span>.
+	  </p>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/faq.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/faq.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/faq.html (added)
+++ xml/site/targets/security/Java/faq.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,457 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Frequently Asked Questions - Java</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">FAQs</div>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Frequently Asked Questions - Java</h1>
+<a name="N10008"></a><a name="Questions"></a>
+<h2 class="h3">Questions</h2>
+<div class="section">
+<a name="N1000C"></a><a name="general_j"></a>
+<h3 class="h4">1. Questions about Java</h3>
+<a name="N10010"></a><a name="security_j"></a>
+<h4 class="faq">1.1. 
+	I have a Java-(security/cryptography) problem. Can you help me?
+      </h4>
+<div align="right">
+<a href="#security_j-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  Go to the <a class="external" href="http://forum.java.sun.com/">java forum</a> of Sun. You can
+	  find forums where you can ask questions like "How do I generate
+	  a keypair", etc.
+	</p>
+</div>
+<a name="N1001C"></a><a name="xml_j"></a>
+<h4 class="faq">1.2. 
+	I have a Java-XML problem.
+      </h4>
+<div align="right">
+<a href="#xml_j-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  Go to the <a class="external" href="http://forum.java.sun.com/">java forum</a> of Sun, section
+	  Java Technology &amp; XML and have a look at <a class="external" href="http://xml.apache.org/xerces2-j/index.html"> Apache Xerces</a>.
+	</p>
+</div>
+<a name="N1002C"></a><a name="specific_"></a>
+<h3 class="h4">2. Questions about this package</h3>
+<a name="N10030"></a><a name="crimson"></a>
+<h4 class="faq">2.1. 
+	I'm using Crimson, but it throws Exceptions. Why?
+      </h4>
+<div align="right">
+<a href="#crimson-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  Crimson is not supported at the moment. The main reason is that
+	  Crimson did not support the
+	  <span class="codefrag">org.w3c.dom.traversal.TreeWalker</span> interface in the
+	  past. Additionally, it does not support the
+	  <span class="codefrag">org.apache.xerces.dom.DocumentImpl.putIdentifier(String ID,
+	    Element e)</span> functionality where Xerces allows us to enable ID
+	  attributes during document generation.
+	</p>
+<p>
+	  Use <a class="external" href="http://xml.apache.org/xerces2-j/index.html">Apache Xerces</a>
+	  instead of Crimson.
+	</p>
+</div>
+<a name="N10045"></a><a name="bouncy"></a>
+<h4 class="faq">2.2. 
+	What's up with the Bouncy Castle CSP? / Where is my CSP?
+      </h4>
+<div align="right">
+<a href="#bouncy-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  There is <em>no</em> JCE bundled together with this
+	  distribution. This is because the Apache Project web site is hosted
+	  in the US where some export restrictions apply to the cryptographic
+	  primitives. 
+	</p>
+<p>
+	  The nice guys from the <a class="external" href="http://www.bouncycastle.org/">Legion of Bouncy
+	    Castle</a> where so helpful to supply their JCE in a simple JAR
+	  package so that we can simply fetch it during the compilation process
+	  and put it into the <span class="codefrag">libs/</span> directory. When you use the
+	  ant makefile <span class="codefrag">build.xml</span> and simply say <span class="codefrag">ant
+	    compile</span> or <span class="codefrag">ant get-jce</span>, <span class="codefrag">ant</span> tries
+	  to fetch this JAR from the australian server. After that step, the
+	  compilation works completely.  
+	</p>
+<p>
+	  The ant make tools initiates an automated download of the
+	  BouncyCastle JCE. The file is downloaded into the <span class="codefrag">libs/</span>
+	  directory and a "bc-" is prepended to the filename. This is
+	  done because we want the provider name (bc means BouncyCastle) being
+	  visible in the JAR's filename. 
+	</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+	  The fact that we <em>use</em> Bouncy in this project does not mean
+	  that you <em>must</em> use it, it's only the default. If you take a
+	  look at the configuration
+	  <span class="codefrag">src/org/apache/xml/security/resource/config.xml</span>, you'll
+	  notice the sections which do integrate these alternative JCEs.
+	</div>
+</div>
+<p>
+	  More information can be found in the <a href="../Java/installation.html">Installation</a> section.
+	</p>
+</div>
+<a name="N1007F"></a><a name="logging"></a>
+<h4 class="faq">2.3. 
+	How do I enable/turn off logging?
+      </h4>
+<div align="right">
+<a href="#logging-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  The logging is configured in the <span class="codefrag">config.xml</span> file which
+	  either in the <span class="codefrag">xmlsec.jar</span> file or in the class path. This
+	  is a little bit complicated as config.xml is used both for library
+	  wide configurations like algorithms as well as for the user setting
+	  about log4j. This will be changed someday ;-))
+	</p>
+<p>OK, so it goes: In the 
+	  <a class="external" href="http://cvs.apache.org/viewcvs.cgi/xml-security/src/org/apache/xml/security/resource/config.xml?rev=HEAD&content-type=text/vnd.viewcvs-markup">
+	    <span class="codefrag">xml-security/src/org/apache/xml/security/resource/config.xml</span>
+	  </a> file, there is an element called
+	  <span class="codefrag">&lt;log4j:configuration&gt;</span>. This element contains the
+	  XML style configuration information as defined in the 
+	  <a class="external" href="http://jakarta.apache.org/log4j/docs/api/org/apache/log4j/xml/DOMConfigurator.html">
+	    log4j DOMConfigurator class
+	  </a>. You can find examples 
+	  <a class="external" href="http://cvs.apache.org/viewcvs.cgi/jakarta-log4j/tests/input/xml/">here</a>
+	
+</p>
+</div>
+<a name="N100A2"></a><a name="baseURI"></a>
+<h4 class="faq">2.4. 
+	What is the meaning of BaseURI?
+      </h4>
+<div align="right">
+<a href="#baseURI-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  When you work with URIs like
+	  "<span class="codefrag">http://www.example.com/index.html</span>", it is
+	  quite sure what you mean as this is an absolute URL, i.e. it is clear
+	  which protocol ise used to fetch which file from which server. When
+	  you use such a URL inside a signature, the software can automatically
+	  figure out what you sign. But when you sign something in your local
+	  file system or if you use a relative path like
+	  "<span class="codefrag">../1.txt</span>", it's not possible to understand
+	  this reference without some context. <em>This</em> context is the
+	  <span class="codefrag">BaseURI</span>. For instance, if you sign
+	  <span class="codefrag">URI="../1.txt"</span> and the
+	  <span class="codefrag">BaseURI="file:///home/user/work/signature.xml"</span>, 
+	  it is clear that the file
+	  <span class="codefrag">BaseURI="file:///home/user/1.txt"</span> is to be
+	  signed. But when you create the signature, the file
+	  <span class="codefrag">BaseURI="file:///home/user/work/signature.xml"</span>
+	  does not yet exist; therefore, you have to supply the URL where you
+	  intend to store the signature later (relative to the signed objects). 
+	</p>
+<p>
+	  The String BaseURI is the systemID on which the Object will be stored
+	  in the future. This is needed to resolve relative links in the
+	  <span class="codefrag">Reference</span> elements which point to the filesystem or
+	  something similar. 
+	</p>
+<p>
+	  Example: Imagine that you want to create a signature to store it on a
+	  web server as
+	  <span class="codefrag">http://www.acme.com/signatures/sig1.xml</span>. So
+	  <span class="codefrag">BaseURI="http://www.acme.com/sig1.xml"</span>. This
+	  means that if you create a <span class="codefrag">Reference</span> with
+	  <span class="codefrag">URI="./index.html"</span>, the library can easily use
+	  it's HTTPResourceResolver to fetch
+	  <span class="codefrag">http://www.acme.com/index.html</span> without that you have to
+	  say <span class="codefrag">URI="http://www.acme.com/index.html"</span>. 
+	</p>
+</div>
+<a name="N100E0"></a><a name="examples"></a>
+<h4 class="faq">2.5. 
+	How do I use the package to generate and verify a signature?
+      </h4>
+<div align="right">
+<a href="#examples-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  Checkout the samples in
+	  <span class="codefrag">src_samples/org/apache/xml/security/samples/signature/</span>. 
+	</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+	  The samples divide into two groups: Samples that <em>create</em> and
+	  samples that <em>verify</em> Signatures. Eventually, you should
+	  adjust the verifying program to another filename if you get
+	  <span class="codefrag">FileNotFoundException</span>s.
+	</div>
+</div>
+</div>
+<a name="N100F7"></a><a name="jdk140"></a>
+<h4 class="faq">2.6. 
+	I'm using SUN JDK v1.4.0 or v1.4.1 and it get some exceptions. Any clues?
+      </h4>
+<div align="right">
+<a href="#jdk140-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  After SUN released the  <a class="external" href="http://java.sun.com/j2se/1.4/index.html"> Java (TM) 2 Platform
+	    Standard Edition v1.4.0 </a>, the xml-security package stopped
+	  working. This is a  
+	  <a class="external" href="http://developer.java.sun.com/developer/bugParade/bugs/4615582.html">
+	    known 
+	  </a> 
+	  problem: SUN packaged a beta of Xalan into the JDK1.4.0, but the
+	  xml-security package requires a stable version of Xalan (v2.2.0 or
+	  later). To fix the problem, you have to put the xalan.jar into a
+	  special directory in your JDK:
+	  <span class="codefrag">j2sdk1.4.0/jre/lib/endorsed/xalan.jar</span>. If you installed
+	  an out-of-the-box JDK1.4 (e.g. on Windows 2000), the
+	  "endorsed" directory does not exist: you'll have to create
+	  it by hand.
+	</p>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Putting this JAR to another location like lib/ext WILL NOT WORK. </div>
+</div>
+<p>
+	  For more on that, you can also check the  <a class="external" href="http://xml.apache.org/~edwingo/jaxp-faq.html#override">
+	    Unofficial JAXP FAQ </a>. 
+	</p>
+</div>
+<a name="N10114"></a><a name="nullptrexception"></a>
+<h4 class="faq">2.7. 
+	I get a NullPointerException, and I don't know what's wrong.
+      </h4>
+<div align="right">
+<a href="#nullptrexception-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+	  Often, this problem is caused by using DOM1 calls like
+	  <span class="codefrag">createElement(), setAttribute(), createAttribute()</span>. These are
+	  non-namespace-aware and will cause XPath and C14N errors.
+	  Always use the DOM2 <span class="codefrag">create(Attribute|Element)NS(...)</span>
+	  methods instead, even if you're creating an element without a namespace
+	  (in that case, you can use null as a namespace).
+	</p>
+<p>
+	  The Xalan-J Team told us that DOM1 calls are deprecated and are not to
+	  be used in code. xml-security has been reviewed and is DOM1 clean now. 
+	  The Xalan folks told us that if you create Elements or attributes 
+	  using DOM1 calls which are not namespace aware, they do not care about
+	  any problem you have because of incorrect hehaviour of Xalan.
+	</p>
+</div>
+<a name="N10125"></a><a name="elementorder"></a>
+<h4 class="faq">2.8. 
+		I sign a document and when I try to verify using the same key, it fails
+	  </h4>
+<div align="right">
+<a href="#elementorder-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+		  After you have created the XMLSignature object, before you sign the
+		  document, you <em>must</em> embed the signature element in the owning
+		  document (using a call to <span class="codefrag">XMLSignature.getElement()</span> to
+		  retrieve the newly created Element node from the signature) before
+		  calling the <span class="codefrag">XMLSignature.sign()</span> method,
+		</p>
+<p>
+		  During canonicalisation of the SignedInfo element, the library looks
+		  at the parent and ancestor nodes of the Signature element to find
+		  any namespaces that the SignedInfo node has inherited.  Any that are
+		  found are embedded in the canonical form of the SignedInfo.  (This
+		  is not true when Exclusive Canonicalisation is used, but it is still
+		  good practice to insert the element node prior to the sign()
+		  method being called).
+		</p>
+<p>
+		  If you have not embedded the signature node in the document, it will
+		  not have any parent or ancestor nodes, so it will not inherit their
+		  namespaces.  If you then embed it in the document and call <span class="codefrag">
+			verify()</span>, the namespaces will be found and the canonical 
+		  form of SignedInfo will be different to that generated during 
+		  <span class="codefrag">sign()</span>.
+		</p>
+</div>
+</div>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/index.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/index.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/index.html (added)
+++ xml/site/targets/security/Java/index.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,262 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>The Java section</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Index</div>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>The Java section</h1> 
+    
+<a name="N1000D"></a><a name="Version+1.4+Released"></a>
+<h2 class="h3">Version 1.4 Released</h2>
+<div class="section">
+<p>
+		  Version 1.4 of the Java library has been released. 
+		  The main changes for this version are:
+		</p>
+<ul>
+          
+<li>Implementation of the standard API JSR105</li>
+          
+<li>Rewritten c14n that increases performance for signature 
+          with node-set transformations.</li>
+          
+<li>Memory footprint reduction and several bugfixes</li>
+         
+</ul>
+<p> Refer to the 
+		  <a href="../changes.html">changelog</a> for more information.
+		</p>
+</div>
+    
+<a name="N1002A"></a><a name="Overview+of+the+Java+Library"></a>
+<h2 class="h3">Overview of the Java Library</h2>
+<div class="section">
+<p>
+	The Apache-XML-Security-J 1.4 supports
+	<a class="external" href="http://www.w3c.org/TR/2002/REC-xmldsig-core-20020212/">XML-Signature Syntax and Processing,  W3C Recommendation 12 February 2002
+	</a> and 
+	<a class="external" href="http://www.w3c.org/TR/2002/REC-xmlenc-core-20021210/">XML Encryption Syntax and Processing, W3C Recommendation 10 December 2002
+	</a>
+      
+</p>
+<p>
+	As of version 1.4, the Java library supports the standard Java API
+	<a class="external" href="http://jcp.org/jsr/detail/105.jsp">
+	  JSR-105: XML Digital Signature APIs
+	</a> for creating and validating XML Signatures. A standard Java
+	API for XML Encryption 
+	<a class="external" href="http://jcp.org/jsr/detail/106.jsp">
+	  JSR-106: XML Digital Encryption APIs
+	</a> is in progress and is not final, so this
+	API is not yet supported. You can continue to use the existing
+	non-standard APIs in the Java Library (there are no plans
+	to discontinue or deprecate them), but you should consider moving
+	to the standard APIs.
+      </p>
+</div>
+    
+<a name="N10047"></a><a name="Old+News"></a>
+<h2 class="h3">Old News</h2>
+<div class="section">
+<p>
+        Version 1.3 released on 28 October 2005. Improves performance and 
+	memory usage over 1.2, and includes several bugfixes.
+      </p>
+<p>
+        Version 1.2.1 released on 28 February 2005. It is a bugfix version 
+	over 1.2 and it is recomended to upgrade to this version. 
+      </p>
+<p>
+        Version 1.2 released on 11 December 2004. Improves the performance and 
+	memory usage over 1.1 release together with an easier integration of 
+	JCE providers.
+      </p>
+<p>
+	Version 1.1 released on 7 April 2004. Includes a beta implementation
+	of XML Encryption together with minor bug fixes for the XML Signature
+	code.
+      </p>
+</div>
+    
+<a name="N1005A"></a><a name="JDK+1.4+issues"></a>
+<h2 class="h3">JDK 1.4 issues</h2>
+<div class="section">
+<p>
+	If you use JDK 1.4 and want to use this software, be sure that Xalan is
+	properly installed. Check the <a target="_top" href="../Java/installation.html">installation guide</a>!!!
+      </p>
+<p>
+	I have so many complaints from people who argue that the software
+	throws exceptions during running the examples or during unit
+	testing. This package NEEDS a Xalan version after 2.2D13 (and SUN
+	shipped his JDK 1.4.0 final with a Xalan beta!). I started integrating
+	the installation guide into the exception messages cause it seems that
+	people don't have a look at the installation guide. 
+      </p>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<div id="logos">
+<a href="http://validator.w3.org/check/referer"><img style="height: 31px; width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/"><img style="height: 31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" src="../skin/images/vcss.png" class="logoImage"></a><a href="http://xml.apache.org/forrest/"><img border="0" title="Built with Apache Forrest" alt="Built with Apache Forrest - logo" src="../images/built-with-forrest-button.png" style="width: 88px;height: 31px;"></a>
+</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/installation.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/installation.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/installation.html (added)
+++ xml/site/targets/security/Java/installation.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,445 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Installation - Java</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Installation</div>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Installation - Java</h1> 
+    
+<a name="N1000D"></a><a name="Using+JDK+1.4.0"></a>
+<h2 class="h3">Using JDK 1.4.0</h2>
+<div class="section">
+<p>
+	After SUN released the 
+	<a class="external" href="http://java.sun.com/j2se/1.4/index.html">
+	  Java (TM) 2 Platform Standard Edition v1.4.0
+	</a>, the xml-security package stopped working. This is a 
+	<a class="external" href="http://developer.java.sun.com/developer/bugParade/bugs/4615582.html">
+	  known
+	</a> 
+	problem: SUN packaged a beta of Xalan into the JDK 1.4.0, but the
+	xml-security package requires a stable version of Xalan (v2.2.0 or
+	later). To fix the problem, you have to put the xalan.jar into a
+	special directory in your JDK:
+	<span class="codefrag">j2sdk1.4.0/jre/lib/endorsed/xalan.jar</span> . If you installed
+	an out-of-the-box JDK1.4 (e.g. on Windows 2000), the "endorsed"
+	directory does not exist: you'll have to create it by hand. 
+      </p>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">
+	Putting this JAR to another location like <span class="codefrag">lib/ext</span> WILL
+	NOT WORK.
+      </div>
+</div>
+<p>
+	For more on that, you can also check the 
+	<a class="external" href="http://xml.apache.org/~edwingo/jaxp-faq.html#override">
+	  Unofficial JAXP FAQ
+	</a>.
+      </p>
+</div>
+
+    
+<a name="N1002F"></a><a name="Prerequisites"></a>
+<h2 class="h3">Prerequisites</h2>
+<div class="section">
+<p>
+	Make sure you get the Jakarta Ant Tool from 
+	<a class="external" href="http://jakarta.apache.org/ant/index.html">http://jakarta.apache.org/ant/</a>
+      
+</p>
+</div>
+
+    
+<a name="N1003D"></a><a name="Getting+the+source"></a>
+<h2 class="h3">Getting the source</h2>
+<div class="section">
+<p>
+	You can download the sources via WWW from the download page
+	at 
+	<a target="_top" href="../download.html">
+	  http://xml.apache.org/security/download.html
+	</a>
+      
+</p>
+<p>
+	This project's Subversion repository can be checked out anonymously
+	via HTTP as follows. You will need a Subversion client. 
+      </p>
+<pre class="code">svn checkout https://svn.apache.org/repos/asf/xml/security/trunk xml-security
+      </pre>
+<p>This will check out the code into a subdirectory named "xml-security". 
+	 The checkout will contain both the Java and the C++ source.
+      </p>
+<p>
+	A HTTP interface to browse the sources online is available via 
+	<a class="external" href="http://svn.apache.org/viewvc/xml/security/trunk/">http://svn.apache.org/viewvc/xml/security/trunk/</a>
+      
+</p>
+</div>
+    
+    
+<a name="N1005C"></a><a name="Compiling+the+source"></a>
+<h2 class="h3">Compiling the source</h2>
+<div class="section">
+<p>
+	At the command prompt type <span class="codefrag">ant test</span>. If you want to 
+	use jikes instead of your default java compiler locate the <span class="codefrag">build.xml</span>
+	file and replace the line
+      </p>
+<pre class="code">&lt;property name="build.compiler" value="classic"/&gt;</pre>
+<p>
+	with
+      </p>
+<pre class="code">&lt;property name="build.compiler" value="jikes"/&gt;</pre>
+</div>
+    
+<!-- Uncommented in the original docs 
+    <section> 
+      <title>Unpacking the files</title> 
+      <p>
+	&packagename; is packaged as a ZIP file for all
+	platforms and operating systems.  You can run the Java
+	<ref>jar</ref> command to unpack the distribution.
+      </p>
+      <ul>
+	<li>jar xf &packagename;-bin.&packageversion;.zip</li>
+	<li>jar xf &packagename;-src.&packageversion;.zip</li>
+	<li>This command creates a "&packagedirectory;" sub-directory in the
+	  current directory containing all the files.</li>
+      </ul>
+    </section>
+    
+    <section> 
+      <title>Files in the binary package release</title>
+      <table>
+	<tr><td>LICENSE</td><td>License for &packagename;</td></tr>
+	<tr><td>Readme.html</td><td>Web page redirect to docs/html/index.html</td></tr>
+	<tr><td>xerces.jar</td><td>Jar file containing all the parser class files</td></tr>
+	<tr><td>xercesSamples.jar</td><td>Jar file containing all sample class files</td></tr>
+	<tr><td>data/</td><td>Directory containing sample XML data files</td></tr>
+	<tr><td>doc/html/</td><td>Directory containing documentation</td></tr>
+	<tr><td>doc/html/api/</td><td>Directory containing Javadoc API</td></tr>
+      </table>
+      <note>To use &packagename; you do not need the source files.</note>
+    </section>
+-->
+    
+<a name="N10079"></a><a name="Testing+the+distibution"></a>
+<h2 class="h3">Testing the distibution</h2>
+<div class="section">
+<p>
+	The first way to ensure that everything is in place is to run the unit
+	tests. This is simply done by typing <span class="codefrag">ant test</span>. This starts
+	the included JUnit test cases. Actually, we do not have complete test
+	coverage, but as a first start, it works.
+      </p>
+</div>
+
+    
+<a name="N10086"></a><a name="Playing+around+with+the+examples+"></a>
+<h2 class="h3">Playing around with the examples </h2>
+<div class="section">
+<p>
+	To see how the distribution works, simply run <span class="codefrag">ant
+	  mega-sample</span> to let ant execute several examples from the
+	<span class="codefrag">src_samples/</span> directory. 
+      </p>
+</div>
+    
+<a name="N10096"></a><a name="Files+in+the+source+package+release"></a>
+<h2 class="h3">Files in the source package release</h2>
+<div class="section">
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">build.xml</td>
+	  <td colspan="1" rowspan="1">Top level <a class="external" href="http://jakarta.apache.org/ant/index.html">Ant</a> Makefile -- read README
+	    file before building</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">LICENSE.txt</td>
+	  <td colspan="1" rowspan="1">License for the software</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">README</td>
+	  <td colspan="1" rowspan="1">Build instructions</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">Readme.html</td>
+	  <td colspan="1" rowspan="1">Web page redirect required for building documentation</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">STATUS</td>
+	  <td colspan="1" rowspan="1">Current source code status information</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">data/</td>
+	  <td colspan="1" rowspan="1">Directory containing sample data files and test vectors for the unit tests</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">doc/xml/</td>
+	  <td colspan="1" rowspan="1">Directory containing documentation, in XML form</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">src/</td>
+	  <td colspan="1" rowspan="1">Directory containing source code for the core library</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">src_samples/</td>
+	  <td colspan="1" rowspan="1">Directory containing source code for samples</td>
+	
+</tr>
+	
+<tr>
+	  
+<td colspan="1" rowspan="1">src_unitTests/</td>
+	  <td colspan="1" rowspan="1">Directory containing source code for unit tests</td>
+	
+</tr>
+      
+</table>
+</div>
+
+    
+<a name="N10126"></a><a name="Where+is+my+JCE%3F"></a>
+<h2 class="h3">Where is my JCE?</h2>
+<div class="section">
+<p>
+	There is <em>no</em> JCE bundled together with this
+	distribution. Living in Germany, I had no problem to include the JCE in
+	this software package but then I realized that the Apache Project is
+	hosted in the US where some export restrictions apply to the
+	cryptographic primitives. 
+      </p>
+<p>
+	Well, how do we solve this problem? The nice guys from the <a class="external" href="http://www.bouncycastle.org/">Bouncy Castle</a> where so
+	helpful to supply the JAR that you need to create HMAC integrity checks
+	on their web site. When you use the ant makefile <span class="codefrag">build.xml</span>
+	and simply say <span class="codefrag">ant compile</span> or <span class="codefrag">ant get-jce</span>,
+	<span class="codefrag">ant</span> tries to fetch this JAR from the australian
+	server. After that step, the compilation works completely. 
+      </p>
+<p></p>
+<p>
+	The ant make tools initiates an automated download of the BouncyCastle
+	JCE. The file is downloaded into the libs/ directory and a "bc-" is
+	prepended to the filename. This is done because we want the provider
+	name (bc means BouncyCastle) being visible in the JAR's filename. 
+      </p>
+<p></p>
+<p>
+	If you are a little paranoid like all security people and don't want
+	ant to make automated downloads or your firewall doesn't permit it
+	(preventing programs "phoning home"), look in the
+	<span class="codefrag">./build.xml</span> file for the properties called
+      </p>
+<p></p>
+<pre class="code">
+	&lt;property name="jce.download.file" value="jce-jdk13-124.jar /&gt;
+	&lt;property name="jce.download" 
+	          value="http://www.bouncycastle.org/download/${jce.download.file}" /&gt;
+	&lt;property name="lib.jce" value="${libs}/bc-${jce.download.file}" /&gt;
+	</pre>
+<p>
+	Here you can see that the file 
+	<a class="external" href="http://www.bouncycastle.org/download/jce-jdk13-124.jar">jce-jdk13-124.jar</a>
+	 is downloaded and stored in the location <span class="codefrag">./libs/bc-jce-jdk13-124.jar</span>
+      
+</p>
+<p>
+	If you do this by hand (pointing you favourite web browser and download
+	it yourself), simply put a "<span class="codefrag">bc-</span>" in front of the filename
+	and put it to <span class="codefrag">./libs/</span>, then ant won't try to make a
+	download.
+      </p>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/interop.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/interop.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/interop.html (added)
+++ xml/site/targets/security/Java/interop.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,251 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Java Interoperability</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Interoperability</div>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/resolver.html">Resolvermania</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Java Interoperability</h1> 
+    
+<a name="N1000D"></a><a name="Problems"></a>
+<h2 class="h3">Problems</h2>
+<div class="section">
+<p>In Version v1.0.4, there is one test case which fails (interop test
+	for exclusive c14n). This is related to very esoteric node sets (The Y4
+	test vector from 
+	<a class="external" href="http://www.w3.org/Signature/2002/02/01-exc-c14n-interop.html">
+	  the interop matrix
+	</a>). 
+      </p>
+</div>
+    
+<a name="N1001B"></a><a name="Interoperability+issues"></a>
+<h2 class="h3">Interoperability issues</h2>
+<div class="section">
+<p>
+	As it can be seen on the 
+	<a class="external" href="http://www.w3c.org/Signature">working group homepage</a>,
+	there are some interoperability reports, namely for 
+	<a class="external" href="http://www.w3.org/Signature/2000/10/10-c14n-interop.html">
+	  Canonical XML
+	</a>, 
+	<a class="external" href="http://www.w3.org/Signature/2002/02/01-exc-c14n-interop.html">
+	  Exclusive Canonical XML
+	</a> 
+	and 
+	<a class="external" href="http://www.w3.org/TR/xmldsig-core/2001/04/05-xmldsig-interop.html">
+	  XML Signature
+	</a>.
+      </p>
+<p>
+	Interoperability depends heavily on test vectors, this means that
+	implementation A has to check whether the signatures from
+	implementation B can be verified. For this purpose, we have a
+	collection of different test vectors in our <span class="codefrag">data/</span>
+	directory. The directory includes test vectors from   
+      </p>
+<ul>
+	
+<li>
+<a class="external" href="http://www.baltimore.com/keytools/xml/index.html">
+	    Baltimore KeyTools XML</a>
+	
+</li>
+	
+<li>
+<a class="external" href="http://jcewww.iaik.at/products/ixsil/index.php">IAIK IXSIL</a>
+</li>
+	
+<li>
+<a class="external" href="http://www.rsasecurity.com/products/bsafe/certj.html">
+	    RSA Security Cert-J</a>
+	
+</li>
+	
+<li>The vectors from the 
+	  <a class="external" href="http://www.alphaworks.ibm.com/tech/xmlsecuritysuite">
+	    IBM alphaWorks XML Security suite
+	  </a> could not been included in this distribution because of
+	  licensing issues. For some reasons which I do not understand, they
+	  copyrighted their test signatures which they have bundled with
+	  xss4j. If you want to include interop testing against IBM in your
+	  unit tests, simply do the following:
+	  Download <span class="codefrag">xss4j-20030127.zip</span> from the 
+	  <a class="external" href="http://www.alphaworks.ibm.com/aw.nsf/download/xmlsecuritysuite">
+	    alphaWorks download page
+	  </a>. 
+	  Copy all files from the <span class="codefrag">xss4j-20030127.zip#/xss4j/data</span>
+	  directory into the
+	  <span class="codefrag">xml-security/data/com/ibm/xss4j-20030127/</span>
+	  directory. If the 
+	  <a target="_top" href="api/org/apache/xml/security/test/InteropTest.html">
+	    Interop
+	  </a> class finds these files, the 
+	  <span class="codefrag">org.apache.xml.security.test.interop.IBMTest</span> class is
+	  also executed during unit interop tests. 
+	</li>
+      
+</ul>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: xml/site/targets/security/Java/resolver.html
URL: http://svn.apache.org/viewvc/xml/site/targets/security/Java/resolver.html?view=auto&rev=498968
==============================================================================
--- xml/site/targets/security/Java/resolver.html (added)
+++ xml/site/targets/security/Java/resolver.html Tue Jan 23 01:42:12 2007
@@ -0,0 +1,324 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Resolver-Mania</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http:///xml.apache.org"><img class="logoImage" alt="Apache XML" src="../images/group-logo.gif"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/security"><img class="logoImage" alt="Apache XML Security" src="../images/project-logo.gif"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org/security" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../Java/index.html">Java</a>
+</li>
+<li>
+<a class="base-not-selected" href="../c/index.html">C++</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript" language="JavaScript"><!--
+              document.write("Published: " + document.lastModified);
+              //  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+             
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Java</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="../Java/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/installation.html">Installation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/examples.html">Examples</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/api.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../Java/interop.html">Interoperability</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://lsd.student.utwente.nl/gump/xml-security/xml-security.html">Gump results</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Resolvermania</div>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<h1>Resolver-Mania</h1> 
+    
+<a name="N1000D"></a><a name="Why+do+we+need+all+these+resolvers%3F"></a>
+<h2 class="h3">Why do we need all these resolvers?</h2>
+<div class="section">
+<p>
+	For security and comfort reasons. In the XML Security package, there
+	exist many kinds of Resolvers for different purposes. Resolvers in this
+	package do the same job as an EntityResolver in the SAX package:
+	retrieve information from the apropriate location and give it to the
+	parser/software who needs it. The reason for offering these different
+	Resolvers is that it should be under complete control of the
+	application which connections to the network are made. In the security
+	area, it wouldn't be a good idea to imediately fetch some documents
+	from the web or make other connections only because you want to verify
+	a Signature. This resolver framework gives the application developer
+	the ability to have total control about the interface from the library
+	to the rest of the world. 
+      </p>
+</div>
+    
+<a name="N10017"></a><a name="Types+of+resolvers"></a>
+<h2 class="h3">Types of resolvers</h2>
+<div class="section">
+<a name="N1001D"></a><a name="ResourceResolvers"></a>
+<h3 class="h4">ResourceResolvers</h3>
+<p>
+	  A 
+	  <a target="_top" href="api/org/apache/xml/security/utils/resolver/ResourceResolver.html">
+	    ResourceResolver
+	  </a> is used by a 
+	  <a target="_top" href="api/org/apache/xml/security/signature/Reference.html">
+	    Reference
+	  </a> to retrieve the signed resource from it's location. Different
+	  resolvers exist to get signed portions from the XML document in which
+	  the signature resides, to make HTTP connections or to fetch files
+	  from the local file system. <br> 
+	  The concept of a 
+	  <a target="_top" href="api/org/apache/xml/security/utils/resolver/ResourceResolver.html">
+	    ResourceResolver
+	  </a> is very similar to an org.xml.sax.EntityResolver, but in
+	  contrast to that Interface, the ResourceResolver is able to
+	  de-reference contents <em>inside</em> an XML document.  
+	</p>
+<a name="N10038"></a><a name="StorageResolver"></a>
+<h3 class="h4">StorageResolver</h3>
+<p>A 
+	  <a target="_top" href="api/org/apache/xml/security/keys/storage/StorageResolver.html">
+	    StorageResolver
+	  </a> is used by 
+	  <a target="_top" href="api/org/apache/xml/security/keys/KeyInfo.html">
+	    KeyInfo
+	  </a> and it's child objects / Elements to retrieve Certificates
+	  from storage locations. This approach is used to allow a user to
+	  customize the library for use in a specific corporate
+	  environment. It's possible to write 
+	  <a target="_top" href="api/org/apache/xml/security/keys/storage/StorageResolver.html">
+	    StorageResolver
+	  </a>s who make requests to LDAP servers or to use specificic PKI
+	  interfaces. <br>
+	  Bundled with the software come three sample 
+	  <a target="_top" href="api/org/apache/xml/security/keys/storage/StorageResolver.html">
+	    StorageResolver
+	  </a>s which can be used for common tasks:
+	</p>
+<ul>
+	  
+<li>
+	    The 
+	    <a target="_top" href="api/org/apache/xml/security/keys/storage/implementations/KeyStoreResolver.html">
+	      KeyStoreResolver
+	    </a> is able to retrieve Certificates from a JAVA KeyStore
+	    object. This 
+	    <a target="_top" href="api/org/apache/xml/security/keys/storage/implementations/KeyStoreResolver.html">
+	      KeyStoreResolver
+	    </a> is constructed from an open JAVA KeyStore.
+	  </li>
+	  
+<li>
+	    The 
+	    <a target="_top" href="api/org/apache/xml/security/keys/storage/implementations/SingleCertificateResolver.html">
+	      SingleCertificateResolver
+	    </a> resolves only to a single Certificate. The 
+	    <a target="_top" href="api/org/apache/xml/security/keys/storage/implementations/SingleCertificateResolver.html">
+	      SingleCertificateResolver
+	    </a> is constructed using this single Certificate. 
+	  </li>
+	  
+<li>
+	    The 
+	    <a target="_top" href="api/org/apache/xml/security/keys/storage/implementations/CertsInFilesystemDirectoryResolver.html">
+	      CertsInFilesystemDirectoryResolver
+	    </a> is useful for resolving to raw X.509 certificates which
+	    reside as separate files in a directory in the filesystem. Such a
+	    resolver is needed for verifying the test signatures from Merlin
+	    Huges which are bundled in a directory.
+	  </li> 
+	
+</ul>
+<p>
+	  
+<a target="_top" href="api/org/apache/xml/security/keys/storage/StorageResolver.html">
+	    StorageResolver
+	  </a>s are supplied to the KeyInfo's <span class="codefrag">addStorageResolver()</span> method.
+	</p>
+<p>
+	  Generally, a 
+	  <a target="_top" href="api/org/apache/xml/security/keys/storage/StorageResolver.html">
+	    StorageResolver
+	  </a> has only a method to return an Iterator which iterates
+	  through the available Certificates.
+	</p>
+<a name="N10085"></a><a name="KeyResolver"></a>
+<h3 class="h4">KeyResolver</h3>
+<p>
+	  A 
+	  <a target="_top" href="api/org/apache/xml/security/keys/keyresolver/KeyResolver.html">
+	    KeyResolver
+	  </a> is used by 
+	  <a target="_top" href="api/org/apache/xml/security/keys/KeyInfo.html">
+	    KeyInfo
+	  </a> to process it's child Elements. There exist two general
+	  classes of a 
+	  <a target="_top" href="api/org/apache/xml/security/keys/keyresolver/KeyResolver.html">
+	    KeyResolver
+	  </a>:
+	</p>
+<ul>
+	  
+<li>
+	    If a ds:RSAKeyValue or ds:DSAKeyValue or ds:X509Certificate is used
+	    inside the ds:KeyInfo, the resolvers can return a public key or
+	    Certificate directly without further action, because the key itself
+	    is contained inside the ds:Signature.
+	  </li>
+	  
+<li>
+	    If there is only key material identification information like a
+	    ds:KeyName or the serial number of the Certificate, the KeyResolver
+	    must use the StorageResolvers to query the available keys and
+	    certificates to find the correct one.
+	  </li>
+	
+</ul>
+<p>
+	  Of course, there are cross-dependencies: e.g. a KeyResolver named 
+	  <a target="_top" href="api/org/apache/xml/security/keys/keyresolver/implementations/RetrievalMethodResolver.html">
+	    RetrievalMethodResolver
+	  </a> uses the 
+	  <a target="_top" href="api/org/apache/xml/security/utils/resolver/ResourceResolver.html">
+	    ResourceResolver
+	  </a> framework to retrieve a public key or certificate from an
+	  arbitrary location.
+	</p>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+ Copyright &copy; 2002-2006 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message