46 lines
1.8 KiB
Text
46 lines
1.8 KiB
Text
|
|
=== Downloading, Building, and Deploying Application Code
|
|
|
|
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
|
|
installed on your machine and available in your PATH before you can continue:
|
|
|
|
* Java JDK 8
|
|
* Apache Maven 3.1.1 or higher
|
|
* Git
|
|
|
|
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.
|
|
|
|
.Clone Project
|
|
[source, subs="attributes"]
|
|
----
|
|
$ git clone {quickstartRepo_link}
|
|
$ cd {quickstartRepo_dir}/app-profile-jee-vanilla
|
|
$ 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:
|
|
|
|
http://localhost:8080/vanilla
|
|
|
|
.Application Login Page
|
|
image:{project_images}/app-login-page.png[]
|
|
|
|
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
|
|
image:{project_images}/client-auth-required.png[]
|
|
|
|
|
|
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.
|