<?xml version="1.0" encoding="UTF-8"?>
<!--
  ! CCPL HEADER START
  !
  ! This work is licensed under the Creative Commons
  ! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
  ! To view a copy of this license, visit
  ! http://creativecommons.org/licenses/by-nc-nd/3.0/
  ! or send a letter to Creative Commons, 444 Castro Street,
  ! Suite 900, Mountain View, California, 94041, USA.
  !
  ! You can also obtain a copy of the license at
  ! src/main/resources/legal-notices/CC-BY-NC-ND.txt.
  ! See the License for the specific language governing permissions
  ! and limitations under the License.
  !
  ! If applicable, add the following below this CCPL HEADER, with the fields
  ! enclosed by brackets "[]" replaced with your own identifying information:
  !      Portions Copyright [yyyy] [name of copyright owner]
  !
  ! CCPL HEADER END
  !
  !      Copyright 2011-2012 ForgeRock AS
  !    
-->
<book xml:id='dev-guide'
 xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'
 xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
 xsi:schemaLocation='http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd'
 xmlns:xlink='http://www.w3.org/1999/xlink'
 xmlns:xinclude='http://www.w3.org/2001/XInclude'>
 <info>
  <title>OpenAM <?eval ${serverDocTargetVersion}?> Developer's Guide</title>
  <abstract>
   <para>Guide to developing OpenAM client applications and service providers.
   OpenAM provides open source Authentication, Authorization, Entitlement and
   Federation software.</para>
  </abstract>
  <copyright>
   <year>2011-2012</year>
   <holder>ForgeRock AS</holder>
  </copyright>
  <authorgroup>
   <author>
    <personname>
     <firstname>Mark</firstname><surname>Craig</surname>
    </personname>
   </author>
  </authorgroup>
  <xinclude:include href="../legal.xml" />
  <date><?dbtimestamp format="B d, Y"?></date>
 </info>

 <toc />
 
 <xinclude:include href="preface.xml" />

 <xinclude:include href='chap-api-overview.xml' />
 <!-- TODO: Build a full list of what to include in this chapter.
 <xinclude:include href='chap-best-practices.xml' />
 -->

 <xinclude:include href='chap-client-dev.xml' />
 <xinclude:include href='chap-rest.xml' />
 <xinclude:include href='chap-jdk.xml' />
 <xinclude:include href='chap-authentication.xml' />
 <xinclude:include href='chap-session.xml' />
 <xinclude:include href='chap-policy-decisions.xml' />
 <!-- TODO: Finish XACML request chapter after debugging sample client setup
 <xinclude:include href='chap-xacml.xml' />
 -->
 <xinclude:include href='chap-fedlet-java.xml' />
 <xinclude:include href='chap-fedlet-dotnet.xml' />
 <!-- TODO: Show some basic uses of the SAML 2.0 and WS-Federation APIs
 <xinclude:include href='chap-samlv2.xml' />
 <xinclude:include href='chap-ws-federation.xml' />
  -->
 <!-- Nothing to do but configure an OAuth auth module per client
 <xinclude:include href='chap-oauth.xml' />
 -->
 <!-- OpenID is currently an extension on trunk.
 <xinclude:include href='chap-openid.xml' />
 -->
 <xinclude:include href='chap-csdk.xml' />

 <xinclude:include href='chap-extending.xml' />
 <xinclude:include href='chap-custom-attr.xml' />
 <xinclude:include href='chap-auth-spi.xml' />
 <xinclude:include href='chap-post-auth.xml' />
 <xinclude:include href='chap-policy-spi.xml' />
 <xinclude:include href='chap-identity-repo-spi.xml' />
 <!-- TODO: Chapter on integrating a custom service
 <xinclude:include href='chap-sms-spi.xml' />
 -->
 <!-- TODO: Chapter on building a custom web agent with the C SDK
 <xinclude:include href='chap-custom-web-agent.xml' />
 -->

<!-- TODO: Add the C API Reference pages
 <reference>
  <title>OpenAM C API Reference</title>
  
  <refentry>
   <refmeta>
    <refentrytitle>TODO</refentrytitle>
    <manvolnum>3</manvolnum>
   </refmeta>
   <refnamediv>
    <refname>TODO</refname>
    <refpurpose>TODO</refpurpose>
   </refnamediv>
   <refsynopsisdiv>
    <synopsis>TODO</synopsis>
   </refsynopsisdiv>
   <refsect1>
    <title>Description</title><para>TODO</para>
   </refsect1>
  </refentry>
 </reference>
 -->
 
 <index />
 <?dbhtml-include href="../ga.html"?>
</book>

