Native Java Examples: Micronaut, Quarkus, Spring Boot, and Helidon
This repository contains example OAuth 2.0 resource servers built with Micronaut, Quarkus, and Spring Boot. If you'd like to see how they were built, please read Build Native Java Apps with Micronaut, Quarkus, and Spring Boot.
This project also contains a Helidon example. You can read about how it was built and how it compares in Build REST APIs and Native Java Apps with Helidon.
Prerequisites: Java 17 with GraalVM, HTTPie, and Docker (optional).
Getting Started
First, clone this repository:
git clone https://github.com/oktadev/native-java-examples.gitYou will need a JDK with GraalVM and its native-image compiler. Using SDKMAN, run the following command and set it as the default:
sdk install java 22.3.r17-grlNext, you'll need a free Okta developer account. Install the Okta CLI and run okta register to sign up for a new account. If you already have an account, run okta login. Then, run okta apps create. Select the default app name, or change it as you see fit. Choose Single-Page App and press Enter.
Use https://oidcdebugger.com/debug for the Redirect URI and accept the default Logout Redirect URI of https://oidcdebugger.com/.
Take note of the clientId and issuer values. You'll need those to get an access token and to configure each framework for JWT authentication.
Change the following files for each framework to match your Okta domain:
- Micronaut:
micronaut/src/main/resources/application.yml - Quarkus:
quarkus/src/main/resources/application.properties - Spring Boot:
spring-boot/src/main/resources/application.properties - Helidon:
helidon/src/main/resources/META-INF/microprofile-config.properties
You can start each app using Maven. Note that you will only be able to start one at a time since they all run on port 8080.
- Micronaut:
./mvnw mn:run - Quarkus:
./mvnw quarkus:dev - Spring Boot:
./mvnw spring-boot:run - Helidon:
mvn package && java -jar target/helidon.jar
Then, you can test them with an access token and HTTPie.
You can generate an access token using OpenID Connect Debugger. First, you must configure your application on Okta to use OpenID Connect's implicit flow.
Run okta login and open the resulting URL in your browser. Go to the Applications section and select the application you created with the CLI. Edit its General Settings and add Implicit (Hybrid) as an allowed grant type, with access token enabled. Click Save and copy the client ID for the next step.
Now, navigate to the OpenID Connect Debugger website. Fill in your client ID, and use https://{yourOktaDomain}/oauth2/default/v1/authorize for the Authorize URI. The state field must be filled but can contain any characters. Select token for the response type. Click Send Request to continue.
Once you have an access token, set it as a TOKEN environment variable in a terminal window.
TOKEN=eyJraWQiOiJYa2pXdjMzTDRBYU1ZSzNGM...Use HTTPie to pass the JWT in as a bearer token in the Authorization header.
http :8080/hello Authorization:"Bearer $TOKEN"You should see your email address printed to your terminal.
You can also build and run each example as a native app.
- Micronaut:
./mvnw package -Dpackaging=native-image - Quarkus:
./mvnw package -Pnative - Spring Boot:
./mvnw package -Pnative(if you'd rather use Docker:./mvnw spring-boot:build-image) - Helidon:
mvn package -Pnative-image
Then, start each app as a native executable.
- Micronaut:
./target/app - Quarkus:
./target/quarkus-1.0.0-SNAPSHOT-runner - Spring Boot:
./target/demo(if Docker:docker run -p 8080:8080 demo:0.0.1-SNAPSHOT) - Helidon:
./target/helidon
Please read Build Native Java Apps with Micronaut, Quarkus, and Spring Boot for performance numbers and analysis. To see how Helidon compares, see Build REST APIs and Native Java Apps with Helidon.
Links
This example uses the following open source libraries:
Help
Please post any questions as comments on this example's blog post, or on the Okta Developer Forums.
License
Apache 2.0, see LICENSE.