<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
                         "http://www.docbook.org/xml/4.4/docbookx.dtd"
        [
                <!ENTITY License SYSTEM "modules/License.xml">
                <!ENTITY Overview SYSTEM "modules/Overview.xml">
                <!ENTITY Installation SYSTEM "modules/server-installation.xml">
                <!ENTITY OpenShift SYSTEM "modules/openshift.xml">
                <!ENTITY AdapterConfig SYSTEM "modules/adapter-config.xml">
                <!ENTITY JBossAdapter SYSTEM "modules/jboss-adapter.xml">
                <!ENTITY SocialConfig SYSTEM "modules/social-config.xml">
                <!ENTITY SocialFacebook SYSTEM "modules/social-facebook.xml">
                <!ENTITY SocialGitHub SYSTEM "modules/social-github.xml">
                <!ENTITY SocialGoogle SYSTEM "modules/social-google.xml">
                <!ENTITY SocialTwitter SYSTEM "modules/social-twitter.xml">
                <!ENTITY SocialProviderSPI SYSTEM "modules/social-spi.xml">
                <!ENTITY Themes SYSTEM "modules/themes.xml">
                <!ENTITY Migration SYSTEM "modules/MigrationFromOlderVersions.xml">
                <!ENTITY Email SYSTEM "modules/email.xml">
                <!ENTITY Roles SYSTEM "modules/roles.xml">
                ]>

<book>

   <bookinfo>
      <title>Keycloak Reference Guide</title>
      <subtitle>SSO for Web Apps and REST Services</subtitle>
      <releaseinfo>1.0-alpha-3</releaseinfo>
   </bookinfo>

   <toc/>

   <preface id="preface" revision="1">
      <title>Preface</title>
      <para>
         In some of the example listings, what is meant to be displayed on one line does not fit
         inside the available page width. These lines have been broken up. A '\' at the end of a
         line means that a break has been introduced to fit in the page, with the following lines
         indented. So:
         <programlisting>
            Let's pretend to have an extremely \
            long line that \
            does not fit
            This one is short
         </programlisting>
         Is really:
         <programlisting>
            Let's pretend to have an extremely long line that does not fit
            This one is short
         </programlisting>
      </para>
   </preface>

    &License;
    &Overview;
    &Installation;
    &OpenShift;
    <chapter>
        <title>Adapters</title>
        <para>
            Keycloak can secure a wide variety of application types.  This section defines which application
            types are supported and how to configure and install them so that you can use Keycloak to secure
            your applications.
        </para>
        &AdapterConfig;
        &JBossAdapter;
    </chapter>

    <chapter>
        <title>Social</title>
        <para>
            Keycloak makes it easy to let users log in to your application using an existing account with a social network.
            Currently Facebook, Google and Twitter is supported with more planned for the future. There's also a Social
            Provider SPI that makes it relatively simple to add additional social networks.
        </para>
        &SocialConfig;
        &SocialFacebook;
        &SocialGitHub;
        &SocialGoogle;
        &SocialTwitter;
        &SocialProviderSPI;
    </chapter>

    &Themes;

    <chapter>
        <title>Email</title>
        <para>
            Keycloak sends emails to users to verify their email address. Emails are also used to allow users to
            safely restore their username and passwords.
        </para>
        &Email;
    </chapter>
    &Roles;
    &Migration;

</book>


