Merge pull request #3 from stianst/master

Added overview, supported platforms and what are client adapters!

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/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]
-
-

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.

topics/overview/supported-platforms.adoc

@@ -1 +1,73 @@
-== Supported Platforms
+== 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]

topics/overview/supported-protocols.adoc

@@ -1 +1,2 @@
+[[_supported_protocols]]
 == Supported Protocols

topics/overview/what-are-client-adapters.adoc

@@ -1 +1,5 @@
-== What are Client Adapters?
+== 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.