[Neuclear-develop] neuclear-id/xdocs bdg.xml,1.2,1.3 installation.xml,1.3,1.4

[<pe...@us...>]

Update of /cvsroot/neuclear/neuclear-id/xdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv16140/xdocs

Modified Files:
	bdg.xml installation.xml 
Log Message:
IdentityCreator is now the default class of the uber jar.
It has many new features such as:
- Self signed certificates
- Unsigned Certificates (for external signing)
- Signing of Externally generated Certificates
- Command Line verification of an Identity name

CachedSource now supports freshness. It needs to be tested a bit more thoroughly
though.

Documentation including the bdg has been updated to reflect these changes.



Index: bdg.xml
===================================================================
RCS file: /cvsroot/neuclear/neuclear-id/xdocs/bdg.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** bdg.xml	9 Dec 2003 16:42:02 -0000	1.2
--- bdg.xml	9 Dec 2003 23:41:45 -0000	1.3
***************
*** 90,98 ****
                  sign it. Lets run it with our ID and receiver we decided on earlier.
              </p>
!             <source>
! java -jar neuclear-id-0.8-SNAPSHOT-uber.jar <b>neu://yourdomain.com mailto:ad...@yo...</b>
! Creating neu://yourdomain.com
! Signing: neu://yourdomain.com
! Saving to: _NEUID/yourdomain.com/root.id            </source>
              <p>
                  The program asks you for the passphrases for both the keystore and your key. Enter them exactly like you did
--- 90,100 ----
                  sign it. Lets run it with our ID and receiver we decided on earlier.
              </p>
!             <source>$ java -jar neuclear-id-0.8-SNAPSHOT-uber.jar --name neu://yourdomain.com --receiver mailto:ad...@yo...
! Please enter passphrase for: KeyStore Passphrase for~/.keystore
! :
! Signing by neu://yourdomain.com ...
! Please enter passphrase for: neu://yourdomain.com
! :
! Outputting to: _NEUID/yourdomain.com/root.id</source>
              <p>
                  The program asks you for the passphrases for both the keystore and your key. Enter them exactly like you did
***************
*** 113,125 ****
          <section name="Test your Identity">
              <p>
!                 Now lets write a little tiny bit of code to show what we can do:
              </p>
!             <source>// Lets get hold of your Identity:
! Identity me=NSResolver.resolveIdentity("<b>neu://yourdomain.com</b>");
! System.out.println(me.getName());</source>
              <p>
!                 Type this snippet into a main method in some class in your favorite IDE. Add the neuclear jar file you downloaded before to
!                 your classpath and run it.
!                 If it didnt throw any exceptions you have just resolved your first Identity through the NeuClear ID system.
              </p>
          </section>
--- 115,129 ----
          <section name="Test your Identity">
              <p>
!                 To verify an Identity type the following in your command prompt:
              </p>
!             <source>$ java -jar neuclear-id-0.8-SNAPSHOT-uber.jar --verify neu://pelle@neuclear.org
! Resolving and Verifying: neu://pelle@neuclear.org
! Signed Object: neu://pelle@neuclear.org is verified
! was signed at: 2003-12-09T10:00:42,466EST
! Is of type: org.neuclear.id.Identity
! repository: http://neuclear.org/_NEUID
! signer: http://localhost:11870/Signer</source>
              <p>
!                 Try it with your new identity that you created above.
              </p>
          </section>
***************
*** 184,192 ****
                   that we are asked for the root identity's passphrase and not the one of the sub identity.
               </p>
!              <source>
!  java -jar neuclear-id-0.8-SNAPSHOT-uber.jar <b>neu://bob@yourdomain.com mailto:bo...@yo...</b>
!  Creating neu://bob@yourdomain.com
!  Signing: neu://bob@yourdomain.com
!  Saving to: _NEUID/yourdomain.com/@bob/root.id            </source>
              <p>
                  Now all that remains is to copy it to your web server exactly like you did above and your new sub identity is
--- 188,198 ----
                   that we are asked for the root identity's passphrase and not the one of the sub identity.
               </p>
!             <source>$ java -jar neuclear-id-0.8-SNAPSHOT-uber.jar --name neu://bob@yourdomain.com --receiver mailto:bo...@yo...
! Please enter passphrase for: KeyStore Passphrase for~/.keystore
! :
! Signing by neu://yourdomain.com ...
! Please enter passphrase for: neu://yourdomain.com
! :
! Outputting to: _NEUID/yourdomain.com/@bob/root.id</source>
              <p>
                  Now all that remains is to copy it to your web server exactly like you did above and your new sub identity is

Index: installation.xml
===================================================================
RCS file: /cvsroot/neuclear/neuclear-id/xdocs/installation.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** installation.xml	9 Dec 2003 16:42:02 -0000	1.3
--- installation.xml	9 Dec 2003 23:41:45 -0000	1.4
***************
*** 16,20 ****
                   Download the <a href="http://neuclear.org/maven/neuclear-id/jars/neuclear-id-0.8-SNAPSHOT-uber.jar">NeuClear ID Executable</a>.
                   Excuse the long and ugly name, we will package it nicer later on. Currently this tool allows you to create a certificate and
!                  sign it. The jar file also contains all the required libraries and should be suitable for adding to your favorite IDE's classpath.
               </p>
  
--- 16,21 ----
                   Download the <a href="http://neuclear.org/maven/neuclear-id/jars/neuclear-id-0.8-SNAPSHOT-uber.jar">NeuClear ID Executable</a>.
                   Excuse the long and ugly name, we will package it nicer later on. Currently this tool allows you to create a certificate and
!                  sign it. The jar file also contains all the required libraries and should be suitable for unpacking and
!                 adding to your favorite IDE's classpath.
               </p>