Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oktadev/okta-spring-boot-react-crud-example
Simple CRUD with React and Spring Boot 3
https://github.com/oktadev/okta-spring-boot-react-crud-example
authentication crud csrf csrf-protection jpa oidc reactjs spring-boot
Last synced: about 8 hours ago
JSON representation
Simple CRUD with React and Spring Boot 3
- Host: GitHub
- URL: https://github.com/oktadev/okta-spring-boot-react-crud-example
- Owner: oktadev
- License: apache-2.0
- Created: 2018-07-12T21:24:56.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2023-08-30T05:54:59.000Z (about 1 year ago)
- Last Synced: 2024-04-15T15:55:33.480Z (7 months ago)
- Topics: authentication, crud, csrf, csrf-protection, jpa, oidc, reactjs, spring-boot
- Language: Java
- Homepage: https://developer.okta.com/blog/2022/06/17/simple-crud-react-and-spring-boot
- Size: 1.45 MB
- Stars: 281
- Watchers: 16
- Forks: 164
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JUG Tours with Spring Boot and React
This example app shows how to create a Spring Boot API and CRUD (create, read, update, and delete) its data with a React app.
Please read [Use React and Spring Boot to Build a Simple CRUD App](https://developer.okta.com/blog/2022/06/17/simple-crud-react-and-spring-boot) to see how this app was created.
**Prerequisites:** [Java 17](http://sdkman.io) and [Node.js 18+](https://nodejs.org/)
> [Okta](https://developer.okta.com/) 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.
* [Getting Started](#getting-started)
* [Links](#links)
* [Help](#help)
* [License](#license)
## Getting Started
To install this example application, run the following commands:
```bash
git clone https://github.com/oktadev/okta-spring-boot-react-crud-example.git spring-react
cd spring-react
```
This will get a copy of the project installed locally.
### Create an Application in Okta
Before you begin, you'll need a free Okta developer account. Install the [Okta CLI](https://cli.okta.com) 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 **Web** and press **Enter**.
Select **Okta Spring Boot Starter**. Accept the default Redirect URI of `http://localhost:8080/login/oauth2/code/okta` and use `http://localhost:3000,http://localhost:8080` for the Logout Redirect URI.
The Okta CLI will create an OIDC Web App in your Okta Org. It will add the redirect URIs you specified and grant access to the `Everyone` group. You will see output like the following when it's finished:
```shell
Okta application configuration has been written to:
/path/to/app/src/main/resources/application.properties
```
Open `src/main/resources/application.properties` to see the issuer and credentials for your app.
```properties
okta.oauth2.issuer=https://dev-133337.okta.com/oauth2/default
okta.oauth2.client-id=0oab8eb55Kb9jdMIr5d6
okta.oauth2.client-secret=NEVER-SHOW-SECRETS
```
NOTE: You can also use the Okta Admin Console to create your app. See [Create a Spring Boot App](https://developer.okta.com/docs/guides/sign-into-web-app-redirect/spring-boot/main/#create-an-okta-integration-for-your-app) for more information.
Run `./mvnw spring-boot:run -Pprod` and log in to your app at `http://localhost:8080`.
### Use Auth0 for OpenID Connect
If you'd rather use Auth0, that's possible too! First, you'll need to checkout the `auth0` branch of this repository.
```bash
git clone -b auth0 https://github.com/oktadev/okta-spring-boot-react-crud-example.git spring-react
cd spring-react
```
Then, install the [Auth0 CLI](https://github.com/auth0/auth0-cli) and run `auth0 login` in a terminal.
Next, run `auth0 apps create` and specify the appropriate URLs:
```bash
auth0 apps create \
--name "Spring Boot + React" \
--description "Spring Boot OIDC App" \
--type regular \
--callbacks http://localhost:8080/login/oauth2/code/okta \
--logout-urls http://localhost:3000,http://localhost:8080 \
--reveal-secrets
```
Modify your `src/main/resources/application.properties` to include your Auth0 issuer, client ID, and client secret.
```properties
# make sure to include the trailing slash for the Auth0 issuer
okta.oauth2.issuer=https:///
okta.oauth2.issuer.client-id=
okta.oauth2.issuer.client-secret=
```
NOTE: You can also use your [Auth0 dashboard](https://manage.auth0.com) to configure your application. Just make sure to use the same URLs specified above.
Run `./mvnw spring-boot:run -Pprod` and log in to your app at `http://localhost:8080`.
## Links
This example uses the following open source libraries:
* [React](https://reactjs.org/)
* [Spring Boot](https://spring.io/projects/spring-boot)
* [Spring Security](https://spring.io/projects/spring-security)
## Help
Please post any questions as comments on the [blog post](https://developer.okta.com/blog/2022/06/17/simple-crud-react-and-spring-boot), or visit our [Okta Developer Forums](https://devforum.okta.com/).
## License
Apache 2.0, see [LICENSE](LICENSE).