Welcome to the My John Deere OAuth2 Java Example.

This project gives a full native java example of:

• Getting a OAuth2 access token via OIDC (OpenId Connect)
• Using a refresh token to renew your own
• Call the MyJohnDeere APIs with your access token

Requirements

• Java 17
• A free port 9090 (you can change this)

How to start this project

• Clone this repository:
  • git clone git@github.com:JohnDeere/MyJohnDeereAPI-OAuth2-Java-Example.git
• Build the project
  • mvn package
• Start it
  • java -jar target/oauth2-example-1.0.jar
  • you may also use the start.sh shell script.
• Open a browser and go to http://localhost:9090

Using this project

• Once in the browser you will need a few things
  • A ClientId and Secret from your application on https://developer.deere.com
  • The callback for your application needs to be configured for the URL of this app. You have a few choices here:
    • In developer.deere.com you can add http://localhost:9090/callback as one of the callbacks (you can have more than one). It is NOT recommended to keep this around for production use.
    • You can make some some other URL and register it in your /etc/hosts files. This also needs to be registered in developer.deere.com
    • Please allow up to 20 minutes for any changes to be replicated.