Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oktadev/spring-boot-vue-example
Bootiful Spring Boot + Vue Example
https://github.com/oktadev/spring-boot-vue-example
bootiful java spring-boot typescript vue vuejs
Last synced: 1 day ago
JSON representation
Bootiful Spring Boot + Vue Example
- Host: GitHub
- URL: https://github.com/oktadev/spring-boot-vue-example
- Owner: oktadev
- License: apache-2.0
- Created: 2018-11-29T15:29:53.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-02-28T05:07:01.000Z (over 1 year ago)
- Last Synced: 2024-04-15T15:55:36.360Z (7 months ago)
- Topics: bootiful, java, spring-boot, typescript, vue, vuejs
- Language: Vue
- Homepage: https://developer.okta.com/blog/2018/12/03/bootiful-spring-boot-java-vue-typescript
- Size: 1.87 MB
- Stars: 22
- Watchers: 6
- Forks: 13
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Spring Boot + Vue Example
This example app shows how to create a Spring Boot API and display its data with Vue.
Please read [Bootiful Development with Spring Boot and Vue](https://developer.okta.com/blog/2018/12/03/bootiful-spring-boot-java-vue-typescript) to see how this app was created.
**Prerequisites:** [Java 11](https://jdk.java.net/11/) and [Node.js](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/oktadeveloper/spring-boot-vue-example.git
cd spring-boot-react-example
```
This will get a copy of the project installed locally. To install all of its dependencies and start each app, follow the instructions below.
To run the server, cd into the `server` folder and run:
```bash
./mvnw spring-boot:run
```
To run the client, cd into the `client` folder and run:
```bash
npm
npm start
```
The primary example (without authentication) is in the `master` branch, while the Okta integration is in the `okta` branch. To check out the Okta branch on your local machine, run the following command.
```bash
git checkout okta
```
### Create an Application in Okta
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](https://developer.okta.com/signup/) if you don’t have an account) and navigate to **Applications** > **Add Application**. Click **Single-Page App**, click **Next**, and give the app a name you’ll remember. Change all instances of `localhost:8080` to `localhost:8081` and click **Done**.
#### Server Configuration
Set the `issuer` and copy the `clientId` into `server/src/main/resources/application.properties`.
**NOTE:** The value of `{yourOktaDomain}` should be something like `dev-123456.oktapreview.com`. Make sure you don't include `-admin` in the value!
```properties
okta.oauth2.issuer=https://{yourOktaDomain}/oauth2/default
okta.oauth2.client-id={yourClientId}
```
#### Client Configuration
Set the `issuer` and copy the `clientId` into `client/src/router.ts`.
```typescript
Vue.use(OktaVuePlugin, {
issuer: 'https://{yourOktaDomain}/oauth2/default',
client_id: '{yourClientId}',
...
});
```
## Links
This example uses the following libraries provided by Okta:
* [Okta Spring Boot Starter](https://github.com/okta/okta-spring-boot)
* [Okta Vue SDK](https://github.com/okta/okta-oidc-js/tree/master/packages/okta-vue)
## Help
Please post any questions as comments on [this repo's blog post](https://developer.okta.com/blog/2018/12/03/bootiful-spring-boot-java-vue-typescript), or visit our [Okta Developer Forums](https://devforum.okta.com/). You can also email [email protected] if you would like to create a support ticket.
## License
Apache 2.0, see [LICENSE](LICENSE).