From 13f2ef4338ede17c19fbdecb554062c150c03b46 Mon Sep 17 00:00:00 2001
From: Stian Thorgersen <stianst@gmail.com>
Date: Thu, 2 Jun 2016 11:54:46 +0200
Subject: [PATCH] Added overview, supported platforms and what are client
 adapters!

---
 SUMMARY.adoc                                  | 19 +----
 topics/overview/overview.adoc                 |  7 ++
 topics/overview/supported-platforms.adoc      | 74 ++++++++++++++++++-
 topics/overview/supported-protocols.adoc      |  1 +
 topics/overview/what-are-client-adapters.adoc |  6 +-
 5 files changed, 87 insertions(+), 20 deletions(-)

diff --git a/SUMMARY.adoc b/SUMMARY.adoc
index 7dab10a63b..539a24f8be 100755
--- a/SUMMARY.adoc
+++ b/SUMMARY.adoc
@@ -30,21 +30,4 @@
 
    .. link:topics/oidc/oidc-generic.adoc[Other OpenID Connect libraries]
 
- . link:topics/saml/saml-overview.adoc[SAML]
-
-
-// . link:topics/oidc.adoc[OpenID Connect Client Adapters]
-
-//
-//
-//{% if book.community %}
-//
-//
-//{% endif %}
-// .. link:topics/installed-applications.adoc[Installed Applications]
-//
-//
-//
-// . link:topics/saml.adoc[SAML Client Adapters]
-
-
+ . link:topics/saml/saml-overview.adoc[SAML]
\ No newline at end of file
diff --git a/topics/overview/overview.adoc b/topics/overview/overview.adoc
index e69de29bb2..ea74de3034 100644
--- a/topics/overview/overview.adoc
+++ b/topics/overview/overview.adoc
@@ -0,0 +1,7 @@
+== Overview
+
+{{book.project.name}} supports both OpenID Connect (an extension to OAuth 2.0) and SAML 2.0. When securing clients and services the first thing you need to
+decide is which of the two you are going to use. If you want you can also choose to secure some with OpenID Connect and others with SAML.
+
+To secure clients and services you are also going to need an adapter or library for the protocol you've selected. {{book.project.name}} comes with its own
+adapters for selected platforms, but it is also possible to use generic OpenID Connect Resource Provider and SAML Service Provider libraries.
\ No newline at end of file
diff --git a/topics/overview/supported-platforms.adoc b/topics/overview/supported-platforms.adoc
index 5273140c31..3590ed4b3e 100644
--- a/topics/overview/supported-platforms.adoc
+++ b/topics/overview/supported-platforms.adoc
@@ -1 +1,73 @@
-== Supported Platforms
\ No newline at end of file
+== Supported Platforms
+
+=== OpenID Connect
+
+==== Java
+* link:oidc/java/jboss-adapters.html[JBoss EAP]
+{% if book.community %}
+  * link:oidc/java/jboss-adapters.html[WildFly]
+{% endif %}
+* link:oidc/java/fuse-adapter.html[Fuse]
+{% if book.community %}
+  * link:oidc/java/tomcat-adapter.html[Tomcat]
+  * link:oidc/java/jetty-adapter.html[Jetty]
+{% endif %}
+* link:oidc/java/servlet-filter-adapter.html[Servlet Filter]
+{% if book.community %}
+  * link:oidc/java/spring-adapter.html[Spring Security] (community)
+  * link:oidc/java/spring-boot-adapter.html[Spring Boot] (community)
+{% endif %}
+
+==== JavaScript (client-side)
+* link:oidc/javascript-adapter.html[JavaScript]
+
+=== Apache Cordova
+* link:oidc/javascript-adapter.html[JavaScript]
+
+{% if book.community %}
+==== Node.js
+* https://github.com/keycloak/keycloak-nodejs-connect[{{book.project.title}} Connect] (community)
+* https://github.com/keycloak/keycloak-nodejs-connect[{{book.project.title}} Auth Utils] (community)
+{% endif %}
+
+{% if book.community %}
+=== C#
+* https://github.com/dylanplecki/KeycloakOwinAuthentication[OWIN] (community)
+{% endif %}
+
+{% if book.community %}
+=== Python
+* https://pypi.python.org/pypi/python-openid/[python-openid] (generic)
+{% endif %}
+
+{% if book.community %}
+=== Android
+* https://github.com/openid/AppAuth-Android[AppAuth] (generic)
+* https://github.com/aerogear/aerogear-android-authz[AeroGear] (generic)
+{% endif %}
+
+{% if book.community %}
+=== iOS
+* https://github.com/openid/AppAuth-iOS[AppAuth] (generic)
+* https://github.com/aerogear/aerogear-ios-oauth2[AeroGear] (generic)
+{% endif %}
+
+{% if book.community %}
+==== Apache HTTP Server
+* https://github.com/pingidentity/mod_auth_openidc[mod_auth_openidc]
+{% endif %}
+
+=== SAML
+
+==== Java
+
+* link:oidc/java/jboss-adapters.html[JBoss EAP]
+{% if book.community %}
+* link:oidc/java/jboss-adapters.html[WildFly]
+* link:oidc/java/tomcat-adapter.html[Tomcat]
+* link:oidc/java/jetty-adapter.html[Jetty]
+{% endif %}
+
+==== Apache HTTP Server
+
+* https://github.com/UNINETT/mod_auth_mellon[mod_auth_mellon]
\ No newline at end of file
diff --git a/topics/overview/supported-protocols.adoc b/topics/overview/supported-protocols.adoc
index 77dd3dafeb..91becb0a40 100644
--- a/topics/overview/supported-protocols.adoc
+++ b/topics/overview/supported-protocols.adoc
@@ -1 +1,2 @@
+[[_supported_protocols]]
 == Supported Protocols
\ No newline at end of file
diff --git a/topics/overview/what-are-client-adapters.adoc b/topics/overview/what-are-client-adapters.adoc
index bdce346c57..ba7c381349 100644
--- a/topics/overview/what-are-client-adapters.adoc
+++ b/topics/overview/what-are-client-adapters.adoc
@@ -1 +1,5 @@
-== What are Client Adapters?
\ No newline at end of file
+== What are Client Adapters?
+
+{{book.project.name}} client adapters are libraries that makes it very easy to secure applications and services with {{book.project.name}}. We call them
+adapters rather than libraries as they provide a tight integration to the underlying platform and framework. This makes our adapters easy to use and they
+require less boilerplate code than what is typically required by a library.
\ No newline at end of file