From 62324b95d14b880415c9dc6da0fdb0e7024cc175 Mon Sep 17 00:00:00 2001
From: Pedro Igor <pedroigor@gmail.com>
Date: Fri, 3 Jun 2016 20:49:26 -0300
Subject: [PATCH] Servlet security quickstart

---
 SUMMARY.adoc                                  |   1 +
 images/pep-pattern-diagram.png                | Bin 0 -> 22852 bytes
 images/servlet-authz-app-structure.png        | Bin 0 -> 22270 bytes
 topics/enforcer/jaxrs-enforcer.adoc           |   1 -
 topics/enforcer/overview.adoc                 |   8 +-
 topics/getting-started/getting-started.adoc   |   4 +-
 .../hello-world-create-realm.adoc             | 202 --------
 .../hello-world-entitlement.adoc              |   1 -
 .../hello-world-servlet-authz.adoc            | 456 ++++++++++++++++++
 topics/getting-started/hello-world.adoc       |   8 +-
 10 files changed, 474 insertions(+), 207 deletions(-)
 create mode 100644 images/pep-pattern-diagram.png
 create mode 100644 images/servlet-authz-app-structure.png
 delete mode 100755 topics/enforcer/jaxrs-enforcer.adoc
 delete mode 100755 topics/getting-started/hello-world-create-realm.adoc
 delete mode 100755 topics/getting-started/hello-world-entitlement.adoc
 create mode 100755 topics/getting-started/hello-world-servlet-authz.adoc

diff --git a/SUMMARY.adoc b/SUMMARY.adoc
index bec52f8634..50e174ff17 100755
--- a/SUMMARY.adoc
+++ b/SUMMARY.adoc
@@ -5,6 +5,7 @@
   .. link:topics/overview/terminology.adoc[Terminology]
  . link:topics/getting-started/getting-started.adoc[Getting Started]
  .. link:topics/getting-started/hello-world.adoc[Hello Authorization World]
+ .. link:topics/getting-started/hello-world-servlet-authz.adoc[Securing a Servlet Application]
  . link:topics/resource-server/overview.adoc[Managing Resource Servers]
  .. link:topics/resource-server/view.adoc[Viewing Resource Servers]
  .. link:topics/resource-server/create.adoc[Creating Resource Servers]
diff --git a/images/pep-pattern-diagram.png b/images/pep-pattern-diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e019cce8873ba2b2ac8d4a1ec0c1ef957594da1
GIT binary patch
literal 22852
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
Tco*1?Or$8M`l{lEalpR;%H2?8

literal 0
HcmV?d00001

diff --git a/images/servlet-authz-app-structure.png b/images/servlet-authz-app-structure.png
new file mode 100644
index 0000000000000000000000000000000000000000..c6b1418bb34eadc81d5361837cf0adb036af2cff
GIT binary patch
literal 22270
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

literal 0
HcmV?d00001

diff --git a/topics/enforcer/jaxrs-enforcer.adoc b/topics/enforcer/jaxrs-enforcer.adoc
deleted file mode 100755
index 503f2ba8f9..0000000000
--- a/topics/enforcer/jaxrs-enforcer.adoc
+++ /dev/null
@@ -1 +0,0 @@
-== JAX-RS Policy Enforcer
\ No newline at end of file
diff --git a/topics/enforcer/overview.adoc b/topics/enforcer/overview.adoc
index 68f4036058..3320f6f29e 100755
--- a/topics/enforcer/overview.adoc
+++ b/topics/enforcer/overview.adoc
@@ -1 +1,7 @@
-== Policy Enforcers
\ No newline at end of file
+== Policy Enforcers
+
+PEP is a design pattern and as such you can implement it in different ways. {{book.project.name}} provides all the necessary means
+to implement PEPs for different platforms, environments and using different programming languages. After all, {{book.project.name}} {{book.project.module}} is
+fully RESTFUL-based, leveraging OAuth2 authorization capabilities to also support fine-grained authorization using a centralized authorization server.
+
+image:../../images/pep-pattern-diagram.png[alt="PEP Overview"]
\ No newline at end of file
diff --git a/topics/getting-started/getting-started.adoc b/topics/getting-started/getting-started.adoc
index 412b84ede0..cb0166c098 100755
--- a/topics/getting-started/getting-started.adoc
+++ b/topics/getting-started/getting-started.adoc
@@ -6,7 +6,9 @@ you to understand the basic steps to enable fine-grained authorization to an app
 [NOTE]
 This guide assume that you are able to install and boot a {{book.project.name}} Server. For more information, please follow the intrusctions https://keycloak.gitbooks.io/getting-started-tutorials/content/[here].
 
-Make sure you have a {{book.project.name}} instance up and running on http://localhost:8080/auth[http://localhost:8080/auth]. If everything is OK, you would be able to login to the
+All the guides are based on the *{{book.project.name}} Demo Distribution*. Please download it before going further with any guide.
+
+Make sure you have a {{book.project.name}} instance up and running on http://localhost:8080/auth[http://localhost:8080/auth]. If everything is OK, you should be able to login to the
 _Administration Console_ and get a page like that:
 
 image:../../images/gs-keycloak-console-page.png[alt="Keycloak Administration Console"]
\ No newline at end of file
diff --git a/topics/getting-started/hello-world-create-realm.adoc b/topics/getting-started/hello-world-create-realm.adoc
deleted file mode 100755
index 0962c385a7..0000000000
--- a/topics/getting-started/hello-world-create-realm.adoc
+++ /dev/null
@@ -1,202 +0,0 @@
-=== Creating the Hello World AuthZ Realm
-
-For this guide, we are going to create a *hello-world-authz* realm. Just import the following JSON file to create the new realm:
-
-```json
-{
-  "realm" : "hello-world-authz",
-  "enabled" : true,
-  "privateKey" : "MIIEpQIBAAKCAQEAzMhNM9HXNQWhVf1m64zS67SIyQjj+tV5GR+MqlRTWDXdo8GAWHd+alY1urRhfRoqMy4F499+8wh2REKFykNt0ng6s6wWnEaKDboS3SAUV6lybcOAkwIOCtCZj1ItddKG3m64fzxDDQrcpkbiAvw3S8KJ4UJK+pyh9iX01duSDtM/HhPawsPdY8JSMfuo1IxQ2Vxw+8RKwbbdUeew6cyYGYAeFYwA66mlM3otB0RBHh4bjwg8297+2g53TdwM2rbCHRbrorMQD3031OTyFSp7lXCtoMLWRfAFnOP/2yZWZMXbiJheC0R3sLbU7Ef0/cUbYyk4Ckfq6pcYDR+VZBF7AwIDAQABAoIBAAwa4wVnKBOIS6srmYPfBTDNsTBBCEjxiYEErmn7JhoWxQ1DCPUxyxU6F177/q9Idqoj1FFOCtEO9P6/9+ym470HQmEQkR2Xxd1d3HOZy9oKuCro3ZbTDkVxY0JnlyxZz4MihGFxDH2e4MArfHy0sAgYbdIU+x2pWKGWSMzDd/TMSOExhc/sIQAg6ljbPCLLXCPQFAncoHRyGPrkRZs6UTZi5SJuCglVa2/3G+0drDdPuA83/mwsZfIBqQgbGbFgtq5T5C6CKMkPOQ42Rcclm7kEr6riTkJRo23EO1iOJVpxzI0tbxZsJAsW7zeqv0wWRyUgVfQAje6OdsNexp5aCtECgYEA6nMHCQ9xXvufCyzpIbYGxdAGqH6m1AR5gXerHqRiGNx+8UUt/E9cy/HTOhmZDK/eC4BT9tImeF01l1oSU/+wGKfux0SeAQchBhhq8GD6jmrtgczKAfZHp0Zrht7o9qu9KE7ZNWRmY1foJN9yNYmzY6qqHEy+zNo9amcqT7UZKO8CgYEA35sp9fMpMqkJE+NEJ9Ph/t2081BEkC0DYIuETZRSi+Ek5AliWTyEkg+oisTbWzi6fMQHS7W+M1SQP6djksLQNPP+353DKgup5gtKS+K/y2xNd7fSsNmkjW1bdJJpID7WzwwmwdahHxpcnFFuEXi5FkG3Vqmtd3cD0TYL33JlRy0CgYEA0+a3eybsDy9Zpp4m8IM3R98nxW8DlimdMLlafs2QpGvWiHdAgwWwF90wTxkHzgG+raKFQVbb0npcj7mnSyiUnxRZqt2H+eHZpUq4jR76F3LpzCGui2tvg+8QDMy4vwqmYyIxDCL8r9mqRnl3HpChBPoh2oY7BahTTjKEeZpzbR0CgYEAoNnVjX+mGzNNvGi4Fo5s/BIwoPcU20IGM+Uo/0W7O7Rx/Thi7x6BnzB0ZZ7GzRA51paNSQEsGXCzc5bOIjzR2cXLisDKK+zIAxwMDhrHLWZzM7OgdGeb38DTEUBhLzkE/VwYZUgoD1+/TxOkwhy9yCzt3gGhL1cF//GJCOwZvuECgYEAgsO4rdYScgCpsyePnHsFk+YtqtdORnmttF3JFcL3w2QneXuRwg2uW2Kfz8CVphrR9eOU0tiw38w6QTHIVeyRY8qqlHtiXj6dEYz7frh/k4hI29HwFx43rRpnAnN8kBEJYBYdbjaQ35Wsqkfu1tvHJ+6fxSwvQu/TVdGp0OfilAY=",
-  "publicKey" : "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzMhNM9HXNQWhVf1m64zS67SIyQjj+tV5GR+MqlRTWDXdo8GAWHd+alY1urRhfRoqMy4F499+8wh2REKFykNt0ng6s6wWnEaKDboS3SAUV6lybcOAkwIOCtCZj1ItddKG3m64fzxDDQrcpkbiAvw3S8KJ4UJK+pyh9iX01duSDtM/HhPawsPdY8JSMfuo1IxQ2Vxw+8RKwbbdUeew6cyYGYAeFYwA66mlM3otB0RBHh4bjwg8297+2g53TdwM2rbCHRbrorMQD3031OTyFSp7lXCtoMLWRfAFnOP/2yZWZMXbiJheC0R3sLbU7Ef0/cUbYyk4Ckfq6pcYDR+VZBF7AwIDAQAB",
-  "certificate" : "MIICsTCCAZkCBgFVETX4AzANBgkqhkiG9w0BAQsFADAcMRowGAYDVQQDDBFIZWxsbyBXb3JsZCBBdXRoWjAeFw0xNjA2MDIxMzAxMzdaFw0yNjA2MDIxMzAzMTdaMBwxGjAYBgNVBAMMEUhlbGxvIFdvcmxkIEF1dGhaMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzMhNM9HXNQWhVf1m64zS67SIyQjj+tV5GR+MqlRTWDXdo8GAWHd+alY1urRhfRoqMy4F499+8wh2REKFykNt0ng6s6wWnEaKDboS3SAUV6lybcOAkwIOCtCZj1ItddKG3m64fzxDDQrcpkbiAvw3S8KJ4UJK+pyh9iX01duSDtM/HhPawsPdY8JSMfuo1IxQ2Vxw+8RKwbbdUeew6cyYGYAeFYwA66mlM3otB0RBHh4bjwg8297+2g53TdwM2rbCHRbrorMQD3031OTyFSp7lXCtoMLWRfAFnOP/2yZWZMXbiJheC0R3sLbU7Ef0/cUbYyk4Ckfq6pcYDR+VZBF7AwIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQANm5gIT/c50lwjawM686gNXpppLA928WsCOn9NIIWjSKekP8Bf9S73kf7vWcsEppm5B8rRyRxolXmzwghv74L7uVDg8Injjgj+XbPVQP+cJqWpSaMZHF7UfWe0/4M945Xcbmsl5q+m9PmrPG0AaaZhqXHcp4ehB1H+awyRqiERpJUuwZNycw2+2kjDADpsFf8hZVUd1F6ReYyOkqUyUjbL+jYTC7ZBNa7Ok+w6HCXWgkgVATAgQXJRM3w14IOc5MH/vfMCrCl/eNQLbjGl9y7u8PKwh3MXHDO2OLqtg6hOTSrOGUPJZGmGtUAl+2/R7FzoWkML/BNe2hjsL6UJwg91",
-  "requiredCredentials" : [ "password" ],
-  "roles" : {
-    "realm" : [
-      {
-        "name" : "uma_protection"
-      }
-    ]
-  },
-  "users" :
-    [
-      {
-        "username" : "alice",
-        "enabled" : true,
-        "credentials" : [ {
-          "type" : "password",
-          "value" : "password"
-          } ],
-        "clientRoles" : {
-          "hello-world-authz-service" : [ "uma_authorization" ]
-        }
-      },
-      {
-        "username" : "jdoe",
-        "enabled" : true,
-        "credentials" : [ {
-          "type" : "password",
-          "value" : "password"
-          } ],
-        "clientRoles" : {
-          "hello-world-authz-service" : [ "uma_authorization" ]
-        }
-      },
-      {
-        "username" : "service-account-hello-world-authz-service",
-        "enabled" : true,
-        "serviceAccountClientId" : "hello-world-authz-service",
-        "realmRoles" : [ "uma_protection"]
-      }
-    ],
-  "clients" : [
-    {
-      "clientId" : "hello-world-authz-service",
-      "secret" : "password",
-      "serviceAccountsEnabled" : true,
-      "enabled" : true,
-      "redirectUris" : [ "http://localhost:8080/hello-world-authz-service" ],
-      "directAccessGrantsEnabled" : true,
-      "publicClient" : false
-    }
-  ]
-}
-```
-The realm *hello-world-authz* consists of:
-
-** Two users: _alice_ and _jdoe_
-** One client application: _hello-world-authz-service_
-** One global role: _uma_protection_
-** One client role: _uma_authorization_
-
-The _hello-world-authz-service_ is the application with the resources we want to protect. In other words, it will act as a link:../overview/terminology.html[Resource Server].
-
-In {{book.project.name}} a resource server is just a regular client application with some specific characteristics. It _must_ be a *confidential* client application as defined by:
-
-```json
-"publicClient" : false
-```
-
-It must have a  *client_id*, *client_secret* and *Service Account* enabled:
-
-```json
-"clients" : [
-    {
-      "clientId" : "hello-world-authz-service",
-      "secret" : "7801be7c-437a-44ae-be34-67da32f024eb",
-      "serviceAccountsEnabled" : true,
-      ...
-    }
-]
-```
-
-And finally, an user mapping to the client's service account:
-
-```json
-{
-    "username" : "service-account-my-resource-server",
-    "enabled" : true,
-    "serviceAccountClientId" : "hello-world-authz-service",
-    "realmRoles" : [ "uma_protection"]
-}
-```
-
-In the latter case, we are also granting the *uma_protection* role to the client's service account. As you'll see, that will be necessary in order to get access to the link:../service/protection-api.html[Protection API].
-
-=== Creating a Resource Server and Protecting Resources
-
-Now that we have the *hello-world-authz* realm properly configured, we need to enable the *hello-world-authz-service* as a resource server. For that, click on the *Authorization* in the left menu bar.
-
-image:../../images/gs-keycloak-authz-page.png[alt="Keycloak Authorization Page"]
-
-To create a resource server you can click on the *Create* button.
-
-image:../../images/gs-keycloak-authz-create-rs-page.png[alt="Create Resource Server"]
-
-From that page you can create a resource server by manually filling that form or you can just import a JSON file with the configuration you want. For this guide, we'll just import a JSON file as follows:
-
-```json
-{
-  "clientId": "hello-world-authz-service",
-  "resources": [
-    {
-      "name": "Hello World Resource"
-    }
-  ],
-  "policies": [
-    {
-      "name": "Only Special Users Policy",
-      "type": "user",
-      "logic": "POSITIVE",
-      "config": {
-        "users": "[\"alice\"]"
-      }
-    },
-    {
-      "name": "Hello World Resource Permission",
-      "type": "resource",
-      "config": {
-        "resources": "[\"Hello World Resource\"]",
-        "applyPolicies": "[\"Only Special Users Policy\"]"
-      }
-    }
-  ]
-}
-
-```
-
-After importing the JSON file above, you would see a page like that:
-
-image:../../images/gs-authz-hello-rs-created-page.png[alt="Resource Server Successfully Created"]
-
-You may take some time now exploring the resource server we just created. But first, let's understand what we just created.
-
-The resource server was created based on the *hello-world-authz-service* client application, as you can see from the following configuration:
-
-```json
-{
-  "clientId": "hello-world-authz-service",
-  ...
-}
-```
-
-What we did was basically tell {{book.project.name}} that we want that client application acting as a resource server, so we can start creating the resources we want to protect as well the permissions
- and authorization policies we want to use to actually protect the resources.
-
-The purpose of this guide is keep things simple to get you started, so our newly created resource server has a single protected resource, as defined by the following configuration:
-
-```json
-{
-  ...
-  "resources": [
-    {
-      "name": "Hello World Resource"
-    }
-  ],
-  ...
-}
-```
-
-The *Hello World Resource* represents a set of one or more resources we want to protect. It can map to a single or to multiple resources in an application.
-
-In order to protect it, we need to create the authorization policies and permissions we want to apply. Policies define the conditions that must be satisfied to grant a permission. Where a
-permission is the link between a resource and the policies(or conditions) we want to enforce when someone wants to access a resource.
-
-In this example, we have a single policy *Only Special Users Policy*. This policy tells that only the specified users are allowed to access _something_ (we don't know what, yet. That is up to the permission).
-
-[NOTE]
-{{book.project.name}} provides a few link:../policy/overview.html[policy types] that you can start using out-of-the-box. There are policies for RBAC, time constraints or even rules written using JavaScript or JBoss Drools.
-
-The last step when protecting a resource is to define a permission. For that, we have defined a *Hello World Resource Permission* that links the resource we want to protect, _Hello World Resource_, with the
-policy we want to apply to that resource, _Only Special Users Policy_.
-
-```json
-{
-  "name": "Hello World Resource Permission",
-  "type": "resource",
-  "config": {
-    "resources": "[\"Hello World Resource\"]",
-    "applyPolicies": "[\"Only Special Users Policy\"]"
-  }
-}
-
-```
\ No newline at end of file
diff --git a/topics/getting-started/hello-world-entitlement.adoc b/topics/getting-started/hello-world-entitlement.adoc
deleted file mode 100755
index 52a3ed08af..0000000000
--- a/topics/getting-started/hello-world-entitlement.adoc
+++ /dev/null
@@ -1 +0,0 @@
-== Obtaining Permissions using the Entitlement API
\ No newline at end of file
diff --git a/topics/getting-started/hello-world-servlet-authz.adoc b/topics/getting-started/hello-world-servlet-authz.adoc
new file mode 100755
index 0000000000..9f878dc636
--- /dev/null
+++ b/topics/getting-started/hello-world-servlet-authz.adoc
@@ -0,0 +1,456 @@
+== Securing a Servlet Application
+
+This guide will show you how to:
+
+* Create a realm with the necessary configuration to enable fine-grained authorization to a servlet application
+* Create a resource server and the resources that must be protected
+* Create permissions, authorization policies and how to apply them to your protected resources
+* Configure the {{book.project.name}} Authorization Enforcer Filter to your servlet application
+
+The application we are using in this guide is one of the examples provided by the {{book.project.name}} Demo Distribution. You can find all the source code
+under *examples/authz/servlet-authz/*.
+
+[NOTE]
+Before going further, make sure you followed all the instructions in the link:../getting-started/getting-started.html[Getting Started] guide.
+
+=== About the Servlet Application
+
+The application we are about to create is a very simple. In a nutshell, it implements the following security requirements:
+
+* An _Administration Area_ that only administrators can access
+* An _User Premium Area_ that only users with a premium plan can access
+* A dynamic menu that is generated accordingly with the permissions issued by a {{book.project.name}} Server to an authenticated user
+
+image:../../images/servlet-authz-app-structure.png[alt="Servlet Authz Application Structure"]
+
+=== Creating the Servlet Authz Realm
+
+For this guide, we are going to create a *servlet-authz* realm. Just import the following JSON file to create the new realm:
+
+```json
+{
+  "realm": "servlet-authz",
+  "enabled": true,
+  "privateKey": "MIICXAIBAAKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQABAoGAfmO8gVhyBxdqlxmIuglbz8bcjQbhXJLR2EoS8ngTXmN1bo2L90M0mUKSdc7qF10LgETBzqL8jYlQIbt+e6TH8fcEpKCjUlyq0Mf/vVbfZSNaVycY13nTzo27iPyWQHK5NLuJzn1xvxxrUeXI6A2WFpGEBLbHjwpx5WQG9A+2scECQQDvdn9NE75HPTVPxBqsEd2z10TKkl9CZxu10Qby3iQQmWLEJ9LNmy3acvKrE3gMiYNWb6xHPKiIqOR1as7L24aTAkEAtyvQOlCvr5kAjVqrEKXalj0Tzewjweuxc0pskvArTI2Oo070h65GpoIKLc9jf+UA69cRtquwP93aZKtW06U8dQJAF2Y44ks/mK5+eyDqik3koCI08qaC8HYq2wVl7G2QkJ6sbAaILtcvD92ToOvyGyeE0flvmDZxMYlvaZnaQ0lcSQJBAKZU6umJi3/xeEbkJqMfeLclD27XGEFoPeNrmdx0q10Azp4NfJAY+Z8KRyQCR2BEG+oNitBOZ+YXF9KCpH3cdmECQHEigJhYg+ykOvr1aiZUMFT72HU0jnmQe2FVekuG+LJUt2Tm7GtMjTFoGpf0JwrVuZN39fOYAlo+nTixgeW7X8Y=",
+  "publicKey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQAB",
+  "requiredCredentials": [
+    "password"
+  ],
+  "users": [
+    {
+      "username": "alice",
+      "enabled": true,
+      "credentials": [
+        {
+          "type": "password",
+          "value": "alice"
+        }
+      ],
+      "realmRoles": [
+        "user"
+      ],
+      "clientRoles": {
+        "servlet-authz-app": [
+          "uma_authorization",
+          "kc_entitlement"
+        ]
+      }
+    },
+    {
+      "username": "jdoe",
+      "enabled": true,
+      "credentials": [
+        {
+          "type": "password",
+          "value": "jdoe"
+        }
+      ],
+      "realmRoles": [
+        "user",
+        "user_premium"
+      ],
+      "clientRoles": {
+        "servlet-authz-app": [
+          "uma_authorization",
+          "kc_entitlement"
+        ]
+      }
+    },
+    {
+      "username": "admin",
+      "enabled": true,
+      "credentials": [
+        {
+          "type": "password",
+          "value": "admin"
+        }
+      ],
+      "realmRoles": [
+        "user",
+        "admin"
+      ],
+      "clientRoles": {
+        "realm-management": [
+          "realm-admin"
+        ],
+        "servlet-authz-app": [
+          "uma_authorization",
+          "kc_entitlement"
+        ]
+      }
+    },
+    {
+      "username": "service-account-servlet-authz-app",
+      "enabled": true,
+      "serviceAccountClientId": "servlet-authz-app",
+      "realmRoles": [
+        "uma_protection"
+      ]
+    }
+  ],
+  "roles": {
+    "realm": [
+      {
+        "name": "user",
+        "description": "User privileges"
+      },
+      {
+        "name": "admin",
+        "description": "Administrator privileges"
+      },
+      {
+        "name": "user_premium",
+        "description": "User Premium privileges"
+      },
+      {
+        "name": "uma_protection",
+        "description": "Allows access to the Protection API"
+      }
+    ]
+  },
+  "clients": [
+    {
+      "clientId": "servlet-authz-app",
+      "enabled": true,
+      "publicClient": false,
+      "baseUrl": "/servlet-authz-app",
+      "adminUrl": "/servlet-authz-app",
+      "bearerOnly": false,
+      "serviceAccountsEnabled": true,
+      "redirectUris": [
+        "/servlet-authz-app/*"
+      ],
+      "secret": "secret"
+    }
+  ]
+}
+```
+=== Creating a Resource Server and Protecting Resources
+
+Now that we have the *servlet-authz* realm properly configured, we need to enable the *servlet-authz-app* as a resource server. For that, click on the *Authorization* in the left menu bar.
+
+image:../../images/gs-keycloak-authz-page.png[alt="Keycloak Authorization Page"]
+
+To create a resource server you can click on the *Create* button.
+
+image:../../images/gs-keycloak-authz-create-rs-page.png[alt="Create Resource Server"]
+
+From that page you can create a resource server by manually filling that form or you can just import a JSON file with the configuration you want. For this guide, we'll just import a JSON file as follows:
+
+```json
+{
+  "clientId": "servlet-authz-app",
+  "allowRemoteResourceManagement": true,
+  "allowEntitlements": true,
+  "policyEnforcementMode": "ENFORCING",
+  "resources": [
+    {
+      "name": "Admin Resource",
+      "uri": "/protected/admin/*",
+      "type": "http://servlet-authz/protected/admin",
+      "scopes": [
+        {
+          "name": "urn:servlet-authz:protected:admin:access"
+        }
+      ]
+    },
+    {
+      "name": "Protected Resource",
+      "uri": "/*",
+      "type": "http://servlet-authz/protected/resource",
+      "scopes": [
+        {
+          "name": "urn:servlet-authz:protected:resource:access"
+        }
+      ]
+    },
+    {
+      "name": "Premium Resource",
+      "uri": "/protected/premium/*",
+      "type": "urn:servlet-authz:protected:resource",
+      "scopes": [
+        {
+          "name": "urn:servlet-authz:protected:premium:access"
+        }
+      ]
+    },
+    {
+      "name": "Main Page",
+      "type": "urn:servlet-authz:protected:resource",
+      "scopes": [
+        {
+          "name": "urn:servlet-authz:page:main:actionForAdmin"
+        },
+        {
+          "name": "urn:servlet-authz:page:main:actionForUser"
+        },
+        {
+          "name": "urn:servlet-authz:page:main:actionForPremiumUser"
+        }
+      ]
+    }
+  ],
+  "policies": [
+    {
+      "name": "Any Admin Policy",
+      "description": "Defines that adminsitrators can do something",
+      "type": "role",
+      "config": {
+        "roles": "[\"admin\"]"
+      }
+    },
+    {
+      "name": "Any User Policy",
+      "description": "Defines that any user can do something",
+      "type": "role",
+      "config": {
+        "roles": "[\"user\"]"
+      }
+    },
+    {
+      "name": "Only Premium User Policy",
+      "description": "Defines that only premium users can do something",
+      "type": "role",
+      "logic": "POSITIVE",
+      "config": {
+        "roles": "[\"user_premium\"]"
+      }
+    },
+    {
+      "name": "All Users Policy",
+      "description": "Defines that all users can do something",
+      "type": "aggregate",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "applyPolicies": "[\"Any User Policy\",\"Any Admin Policy\",\"Only Premium User Policy\"]"
+      }
+    },
+    {
+      "name": "Premium Resource Permission",
+      "description": "A policy that defines access to premium resources",
+      "type": "resource",
+      "decisionStrategy": "UNANIMOUS",
+      "config": {
+        "resources": "[\"Premium Resource\"]",
+        "applyPolicies": "[\"Only Premium User Policy\"]"
+      }
+    },
+    {
+      "name": "Administrative Resource Permission",
+      "description": "A policy that defines access to administrative resources",
+      "type": "resource",
+      "decisionStrategy": "UNANIMOUS",
+      "config": {
+        "resources": "[\"Admin Resource\"]",
+        "applyPolicies": "[\"Any Admin Policy\"]"
+      }
+    },
+    {
+      "name": "Protected Resource Permission",
+      "description": "A policy that defines access to any protected resource",
+      "type": "resource",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "resources": "[\"Protected Resource\"]",
+        "applyPolicies": "[\"All Users Policy\"]"
+      }
+    },
+    {
+      "name": "Action 1 on Main Page Resource Permission",
+      "description": "A policy that defines access to action 1 on the main page",
+      "type": "scope",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "scopes": "[\"urn:servlet-authz:page:main:actionForAdmin\"]",
+        "applyPolicies": "[\"Any Admin Policy\"]"
+      }
+    },
+    {
+      "name": "Action 2 on Main Page Resource Permission",
+      "description": "A policy that defines access to action 2 on the main page",
+      "type": "scope",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "scopes": "[\"urn:servlet-authz:page:main:actionForUser\"]",
+        "applyPolicies": "[\"Any User Policy\"]"
+      }
+    },
+    {
+      "name": "Action 3 on Main Page Resource Permission",
+      "description": "A policy that defines access to action 3 on the main page",
+      "type": "scope",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "scopes": "[\"urn:servlet-authz:page:main:actionForPremiumUser\"]",
+        "applyPolicies": "[\"Only Premium User Policy\"]"
+      }
+    }
+  ]
+}
+```
+
+[NOTE]
+All this configuration can also be done using the {{book.project.name}} Administration Console. We are using the import tool just for demonstration purposes
+
+=== A Quick Overview of the Permissions and Policies
+
+The resource server configuration tells a lot about what we are really protecting. It is basically describing the security requirements we have discussed earlier.
+
+Fist of all, we define four resources:
+
+* Admin Resource
+* Protected Resource
+* Premium Resource
+* Main Page
+
+As the name implies, each of these resources are related with the requirements we previously discussed, representing the different areas or group of resources we want to protect.
+
+As you may notice, each of these resources (except Main Page) defines an *uri* property. This property represents the path we want to protect and they map directly, or indirectly by using a pattern,
+to the resources served by the application.
+
+Let's take the _Protected Resource_ as an example:
+
+```json
+{
+  "name": "Protected Resource",
+  "uri": "/*",
+  "type": "http://servlet-authz/protected/resource",
+  "scopes": [
+    {
+      "name": "urn:servlet-authz:protected:resource:access"
+    }
+  ]
+},
+```
+This resource represents all resources in the application, as you can see from the pattern used in the *uri* property. It also defines a single scope/action to indicate that users, if granted, can access this resource.
+
+Now, let's see what are the permissions and authorization policies configured to this resource:
+
+```json
+...
+{
+      "name": "Protected Resource Permission",
+      "description": "A policy that defines access to any protected resource",
+      "type": "resource",
+      "decisionStrategy": "AFFIRMATIVE",
+      "config": {
+        "resources": "[\"Protected Resource\"]",
+        "applyPolicies": "[\"All Users Policy\"]"
+      }
+    },
+...
+```
+
+The definition above is a permission that links the _Protected Resource_ with the policies we want to apply. In this case, we are applying a single _All Users Policy_.
+
+Policies define the conditions to be meet in order to access something. In this case, the _All Users Policy_ is composed of two other policies, a special policy type called link:../policy/aggregated-policy.html[Aggregated Policies].
+
+```json
+...
+{
+  "name": "All Users Policy",
+  "description": "Defines that all users can do something",
+  "type": "aggregate",
+  "decisionStrategy": "AFFIRMATIVE",
+  "config": {
+    "applyPolicies": "[\"Any User Policy\",\"Any Admin Policy\",\"Only Premium User Policy\"]"
+  }
+},
+...
+```
+
+{{book.project.name}} provides a few built-in policy types (and their respective policy providers) implementing different access control mechanisms (RBAC, GBAC, Rule-based, Time-based, etc) that you can use to build your own policies and permissions.
+
+Aggregated policies are very useful in order to group related policies together and make policy management less painful.
+
+=== Configuring the Keycloak Enforcement Filter
+
+Now that we have all the configuration for our resource server in place, we can configure the authorization enforcement filter to actually protected the resources.
+
+Just like any other Servlet Filter, you just need to include the following configuration in your web application descriptor (WEB-INF/web.xml):
+
+```xml
+<filter>
+    <filter-name>Keycloak Authorization Enforcer</filter-name>
+    <filter-class>org.keycloak.authorization.policy.enforcer.servlet.KeycloakAdapterEnforcementFilter</filter-class>
+</filter>
+
+<filter-mapping>
+    <filter-name>Keycloak Authorization Enforcer</filter-name>
+    <url-pattern>/*</url-pattern>
+</filter-mapping>
+```
+The *org.keycloak.authorization.policy.enforcer.servlet.KeycloakAdapterEnforcementFilter* is shipped with the {{book.project.name}} OIDC Adapters distribution. In order to make it available to
+your application at runtime, you must create a *META-INF/jboss-deployment-structure.xml* at the application root directory. If you are using maven, this file can be placed under *src/main/webapp/META-INF/jboss-deployment-structure.xml*:
+
+```xml
+<jboss-deployment-structure>
+    <deployment>
+        <dependencies>
+            <module name="org.keycloak.keycloak-authz-servlet-enforcer" services="import"/>
+            <module name="org.jboss.resteasy.resteasy-jackson2-provider" services="import"/>
+        </dependencies>
+        <exclusions>
+            <module name="org.jboss.resteasy.resteasy-jackson-provider"/>
+        </exclusions>
+    </deployment>
+</jboss-deployment-structure>
+```
+
+For last, you need to create a *META-INF/keycloak-authz.json*. If you are using Maven, this file goes inside *src/main/resources*:
+
+```json
+{
+  "client": {
+    "configurationUrl": "http://localhost:8080/auth/realms/servlet-authz/authz/uma_configuration",
+    "clientId": "servlet-authz-app",
+    "clientSecret": "secret"
+  },
+  "enforcer": {}
+}
+```
+
+=== Running and Using the Application
+
+All the source code for this application is at *${KEYCLOAK_DEMO_SERVER_DIR}/examples/authz/servlet-authz/*.
+
+There you can execute the following command to _deploy_ the application to the running server:
+
+```bash
+mvn clean package wildfly:deploy
+```
+That should be enough to get the application properly packaged and deployed to a _running_ {{book.project.name}} server.
+
+If the application was properly deployed, you can try to access it at http://localhost:8080/auth[http://localhost:8080/servlet-authz-app] and use the following credentials to login into the application:
+
+If everything is correct, you will be redirect to Keycloak login page. You can login to the application with the following credentials:
+
+* username: alice / password: alice (regular user)
+* username: jdoe / password: jdoe (premium user)
+* username: admin / password: admin (administrator)
+
+To _undeploy_ the application, please execute the following command:
+
+```bash
+mvn wildfly:undeploy
+```
\ No newline at end of file
diff --git a/topics/getting-started/hello-world.adoc b/topics/getting-started/hello-world.adoc
index cb175f4732..6075057c7f 100755
--- a/topics/getting-started/hello-world.adoc
+++ b/topics/getting-started/hello-world.adoc
@@ -10,6 +10,9 @@ This guide will show you how to:
 The purpose of this guide is to give you a generic overview of {{book.project.name}} {{book.project.module}} so you can understand
 some core concepts and start protecting your applications and services despite the platform they are running on.
 
+[NOTE]
+Before going further, make sure you followed all the instructions in the link:../getting-started/getting-started.html[Getting Started] guide.
+
 === Creating the Hello World AuthZ Realm
 
 For this guide, we are going to create a *hello-world-authz* realm. Just import the following JSON file to create the new realm:
@@ -94,7 +97,7 @@ It must have a  *client_id*, *client_secret* and *Service Account* enabled:
 "clients" : [
     {
       "clientId" : "hello-world-authz-service",
-      "secret" : "7801be7c-437a-44ae-be34-67da32f024eb",
+      "secret" : "password",
       "serviceAccountsEnabled" : true,
       ...
     }
@@ -156,6 +159,9 @@ From that page you can create a resource server by manually filling that form or
 
 ```
 
+[NOTE]
+All this configuration can also be done using the {{book.project.name}} Administration Console. We are using the import tool just for demonstration purposes
+
 After importing the JSON file above, you would see a page like that:
 
 image:../../images/gs-authz-hello-rs-created-page.png[alt="Resource Server Successfully Created"]