A Spring Boot example app with the following features:
- Login and registration pages
- Password reset workflows
- Group-based access control
- Thymeleaf templates
- All kinds of Spring Boot + Okta goodness
Please read Add User Authentication to Your Spring Boot App in 15 Minutes to see how this app was created.
Prerequisites: Java 8.
Okta has Authentication and User Management APIs that reduce development time with instant-on, scalable user infrastructure. Okta's intuitive API and expert support make it easy for developers to authenticate, manage, and secure users and roles in any application.
To install this example application, run the following commands:
git clone https://github.com/oktadeveloper/okta-spring-boot-app-with-auth-example.git
cd okta-spring-boot-app-with-auth-example
This will get a copy of the project installed locally. To install all of its dependencies and start the app, run:
./gradlew bootRun
You will need to create an OpenID Connect Application in Okta to get your values to perform authentication.
Log in to your Okta Developer account (or sign up if you don’t have an account) and navigate to Applications > Add Application. Click Web, click Next, and give the app a name you’ll remember. Click Done and copy the clientId
and clientSecret
into src/main/resources/application.yml
.
server:
port: 8080
spring:
resources: static-locations: "classpath:/static/"
okta:
oauth2:
issuer: https://{yourOktaDomain}/oauth2/default
clientId: {yourClientId}
clientSecret: {yourClientSecret}
rolesClaim: groups
NOTE: The value of {yourOktaDomain}
should be something like dev-123456.oktapreview
. Make sure you don't include -admin
in the value!
After modifying this file, restart your app and you should be able to authenticate with Okta.
This example uses Okta's Spring Boot Starter.
Please post any questions as comments on the blog post, or visit our Okta Developer Forums. You can also email [email protected] if you would like to create a support ticket.
Apache 2.0, see LICENSE.