keycloak-scim/getting_started/topics/secure-jboss-app/download-quickstarts.adoc

47 lines
1.8 KiB
Text
Raw Normal View History

2016-05-11 02:48:33 +00:00
=== Downloading, Building, and Deploying Application Code
2016-05-11 02:48:33 +00:00
2017-08-28 12:50:14 +00:00
The project and code for the application you are going to secure is available in link:{quickstartRepo_link}[{quickstartRepo_name}]. You will need the following
2016-05-11 02:48:33 +00:00
installed on your machine and available in your PATH before you can continue:
* Java JDK 8
* Apache Maven 3.1.1 or higher
* Git
2016-05-11 02:48:33 +00:00
2017-08-30 11:46:49 +00:00
ifeval::[{project_community}==true]
You can obtain the code by cloning the repository at {quickstartRepo_link}. The quickstarts are designed to work with the most recent Keycloak release.
endif::[]
ifeval::[{project_product}==true]
You can obtain the code by cloning the repository at {quickstartRepo_link}. Use the branch matching the version of {project_name} in use.
endif::[]
Follow these steps to download the code, build it, and deploy it. Make sure your {appserver_name} application server is started before you run these steps.
2016-05-11 02:48:33 +00:00
2016-06-02 09:46:44 +00:00
.Clone Project
2016-06-09 10:09:53 +00:00
[source, subs="attributes"]
2016-05-11 02:48:33 +00:00
----
2017-08-28 12:50:14 +00:00
$ git clone {quickstartRepo_link}
$ cd {quickstartRepo_dir}/app-profile-jee-vanilla
2016-05-11 02:48:33 +00:00
$ mvn clean wildfly:deploy
----
You should see some text scroll down in the application server console window. After the application is successfully deployed go to:
2016-05-11 02:48:33 +00:00
http://localhost:8080/vanilla
.Application Login Page
2017-08-28 12:50:14 +00:00
image:{project_images}/app-login-page.png[]
2016-05-11 02:48:33 +00:00
If you open up the application's _web.xml_ file you would see that the application is secured via `BASIC` authentication.
If you click on the login button on the login page, the browser
will pop up a BASIC auth login dialog.
.Application Login Dialog
2017-08-28 12:50:14 +00:00
image:{project_images}/client-auth-required.png[]
2016-05-11 02:48:33 +00:00
The application is not secured by any identity provider, so anything you enter in the dialog box will result in a `Forbidden` message being
sent back by the server. The next section describes how you can take this deployed application and secure it.