[jboss-cvs] JBossAS SVN: r70972 - in projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en: modules and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Mar 18 19:26:19 EDT 2008
Author: darran.lofthouse at jboss.com
Date: 2008-03-18 19:26:19 -0400 (Tue, 18 Mar 2008)
New Revision: 70972
Added:
projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/introduction.xml
projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/references.xml
Modified:
projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/master.xml
Log:
[SECURITY-154] Documentation introduction.
Modified: projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/master.xml
===================================================================
--- projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/master.xml 2008-03-18 23:03:43 UTC (rev 70971)
+++ projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/master.xml 2008-03-18 23:26:19 UTC (rev 70972)
@@ -1,46 +1,54 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
- "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book lang="en">
- <bookinfo>
- <title>User Guide for JBoss SPNEGO-Negotiation</title>
- <subtitle>A Guide for Administrators</subtitle>
- <releaseinfo>0.0.0</releaseinfo>
- <authorgroup>
- <author>
- <firstname>Darran</firstname>
- <othername>A.</othername>
- <surname>Lofthouse</surname>
- </author>
- </authorgroup>
- </bookinfo>
+ <bookinfo>
+ <title>User Guide for JBoss Negotiation</title>
- <toc></toc>
+ <subtitle>A Guide for Administrators</subtitle>
- <preface id="target" revision="1">
- <title>Target Audience</title>
+ <releaseinfo>0.0.0</releaseinfo>
- <para>This guide is aimed at administrators who want to use the JBoss SPNEGO authenticator to implement silent authentication.
- </para>
- </preface>
+ <authorgroup>
+ <author>
+ <firstname>Darran</firstname>
- <preface id="preface" revision="1">
- <title>Preface</title>
+ <othername>A.</othername>
- <para>Commercial development support, production support and training for
- the SPNEGO authentication is available through
- <ulink url="http://www.jboss.com">JBoss Inc.</ulink>
- The JBoss XACML is a project of JBoss Security in the JEMS product suite.
- </para>
+ <surname>Lofthouse</surname>
+ </author>
+ </authorgroup>
+ </bookinfo>
- <para>Authors:
- <itemizedlist spacing="compact">
- <listitem>
- <para>Darran Lofthouse - SPNEGO authenticator developer.</para>
- </listitem>
- </itemizedlist>
- </para>
- </preface>
+ <toc></toc>
+ <preface id="target" revision="1">
+ <title>Target Audience</title>
-</book>
+ <para>This guide is aimed at administrators who want to use the JBoss
+ Negotiation authenticator to implement silent SPNEGO
+ authentication.</para>
+ </preface>
+
+ <preface id="preface" revision="1">
+ <title>Preface</title>
+
+ <para>Commercial development support, production support and training for
+ JBoss Negotiation is available through <ulink
+ url="http://www.jboss.com">JBoss Inc.</ulink> JBoss Negotiation is a
+ project of JBoss Security in the JEMS product suite.</para>
+
+ <para>Authors: <itemizedlist spacing="compact">
+ <listitem>
+ <para>Darran Lofthouse - Negotiation authenticator developer.</para>
+ </listitem>
+ </itemizedlist></para>
+ </preface>
+
+ <xi:include href="modules/introduction.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" xml:base="./" />
+
+ <xi:include href="modules/references.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xpointer="element(/1)" />
+</book>
\ No newline at end of file
Added: projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/introduction.xml
===================================================================
--- projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/introduction.xml (rev 0)
+++ projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/introduction.xml 2008-03-18 23:26:19 UTC (rev 70972)
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="introduction">
+ <title>Introduction to JBoss Negotiation</title>
+
+ <para>The JBoss Negotiation project provides a set of components to bring
+ '<emphasis role="bold">S</emphasis>imple and <emphasis
+ role="bold">P</emphasis>rotected GSSAPI <emphasis
+ role="bold">Nego</emphasis>tiation Mechanism' or SPNEGO to JBoss.</para>
+
+ <para>SPNEGO authentication allows a user already authenticated to a
+ <emphasis role="bold">K</emphasis>erberos <emphasis
+ role="bold">D</emphasis>omain <emphasis role="bold">C</emphasis>ontroller /
+ KDC to silently authenticate to remote services without being prompted for
+ further usernames and passwords. In addition to this the users credentials
+ can be delegate to the remote system allowing the remote system to contact
+ further systems as the user.</para>
+
+ <para>Many web browsers provide support for SPNEGO authentication, this
+ document focuses on <trademark>Microsoft Internet Explorer</trademark> and
+ Mozilla Firefox. There are also a number of kerberos domain controllers
+ available, this documentation focusses on <trademark>Microsoft Active
+ Directory</trademark> and the MIT KDC implementation. Contributions for
+ documentation on other web browsers and KDCs would be welcome.</para>
+
+ <para></para>
+
+ <sect1>
+ <title>Components</title>
+
+ <para>The JBoss Negotiation project provides the following components:
+ -</para>
+
+ <para></para>
+
+ <itemizedlist>
+ <listitem>
+ <para>SPNEGO Authenticator and Login Module</para>
+
+ <para>The authentication process is handled by a Tomcat Authenticator
+ that and a JAAS login module, this combination achieves the
+ integration with JBoss security.</para>
+ </listitem>
+
+ <listitem>
+ <para>Negotiation Toolkit</para>
+
+ <para>This is a couple of utilities and a web application that can be
+ used to test various aspects of your negotiation configuration to
+ enable you to verify that the required steps are working correctly and
+ to debug where failures may be occuring.</para>
+ </listitem>
+
+ <listitem>
+ <para>Configuration Project</para>
+
+ <para>This project allow you to specify a couple of properties within
+ a property file and the build script contained within the project will
+ configure and deploy your security configuration automatically - after
+ this is deployed all you will need to do it deploy your web
+ application configured to use the SPNEGO authenticator and set the
+ correct security domain.</para>
+ </listitem>
+ </itemizedlist>
+ </sect1>
+
+ <sect1>
+ <para />
+ </sect1>
+</chapter>
\ No newline at end of file
Property changes on: projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/introduction.xml
___________________________________________________________________
Name: svn:keywords
+ Id Revision
Name: svn:eol-style
+ LF
Added: projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/references.xml
===================================================================
--- projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/references.xml (rev 0)
+++ projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/references.xml 2008-03-18 23:26:19 UTC (rev 70972)
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<chapter id="reference">
+ <title>References</title>
+
+ <para>For further reading please see the following reference
+ information.</para>
+
+ <para></para>
+
+ <para><ulink url="???"><ulink
+ url="http://tools.ietf.org/html/rfc4178">RFC4178 The Simple and Protected
+ GSS-API Negotiation Mechanism</ulink></ulink> <ulink
+ url="http://tools.ietf.org/html/rfc4178">http://tools.ietf.org/html/rfc4178</ulink></para>
+
+ <para></para>
+</chapter>
\ No newline at end of file
Property changes on: projects/security/security-negotiation/trunk/docs/userguide/src/docbkx/en/modules/references.xml
___________________________________________________________________
Name: svn:keywords
+ Id Revision
Name: svn:eol-style
+ LF
More information about the jboss-cvs-commits
mailing list