xavierchen/stormpath-sdk-java

Official Java SDK for the Stormpath User Management REST API

Stormpath is Joining Okta

We are incredibly excited to announce that Stormpath is joining forces with Okta. Please visit the Migration FAQs for a detailed look at what this means for Stormpath users.

We're available to answer all questions at [email protected].

Stormpath Java SDK

An advanced, reliable and easy-to-use user management API, built by Java security experts

Stormpath is a complete user management API. This library gives your Java app access to all of Stormpath's features:

• Robust authentication and authorization.
• Schemaless user data and profiles.
• A hosted login subdomain, for easy Single Sign-On across your apps.
• Social login with Facebook and Google OAuth.
• Secure API key authentication for your service.
• Servlet support for Java web applications.

If you have feedback about this library, please get in touch and share your thoughts! [email protected]

Documentation

Stormpath offers deep documentation and support for Java.

• Official Stormpath Docs
• API Docs for Java
• Stormpath Java Product Guide
• Stormpath Servlet Plugin for Java Webapps
• Spring Boot Stormpath Web Starter

Please email [email protected] with any errors or issues with the documentation.

Links

Below are some resources you might find useful!

• Java Quickstart to get started.
• Java WebApp Quickstart
• Spring Boot Webapp Quickstart
• Stormpath Java SDK
• Stormpath Servlet Plugin for Java Webapps
• Spring Boot Stormpath Web Starter

Spring Support

• Spring Boot Stormpath Web Starter
• Example Stormpath Spring App
• Example Stormpath Spring Web App
• Example Stormpath Spring Boot App
• Example Stormpath Spring Boot Web App

Spring Security Support

• Stormpath Spring Security Plugin
• Stormpath Spring Security Sample App

Apache Shiro Support

• Stormpath-Shiro Plugin
• Stormpath-Shiro Sample Webapp
• Shiro Webapp Tutorial

API Authentication with Stormpath

• API Authentication for Jersey Applications - Tutorial

Quickstart

Any Java application can use our general Stormpath Java API Quickstart to get started.

We also have a Java WebApp Quickstart for the Stormpath Servlet Plugin - a drop-in plugin for web applications deployed to a Servlet container, like Tomcat or Jetty.

If you're building a Spring Boot application, the Spring Boot Webapp Quickstart will get you up and running quickly.

Deploy our Spring Boot Example to Heroku

Build Instructions

This project requires Maven 3.2.1 and JDK 7 to build. Run the following:

> mvn install

Release changes are viewable in the change log

Contributing

Contributions, bug reports and issues are very welcome. Stormpath regularly maintains this repository, and are quick to review pull requests and accept changes!

You can make your own contributions by forking the develop branch of this repository, making your changes, and issuing pull request on the develop branch.

Copyright

Copyright © 2013-2015 Stormpath, Inc. and contributors.

This project is open-source via the Apache 2.0 License.

For all additional information, please see the full Project Documentation.