girisahaa / spring-authorization-server

A community-driven project led by the Spring Security team and is focused on delivering Authorization Server support to the Spring community

Spring Authorization Server

Spring Authorization Server is a community-driven project led by the Spring Security team and is focused on delivering OAuth 2.0 Authorization Server support to the Spring community.

The project will start in Spring’s experimental projects as an independent project so that it can evolve more rapidly.

The ultimate goal of this project is to replace the Authorization Server support provided by Spring Security OAuth.

With the much needed help from our community, this project will grow in the same way that the original Spring Security OAuth project did.

Code of Conduct

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected].

Downloading Artifacts

See downloading Spring artifacts for Maven repository information.

Documentation

Be sure to read the Spring Security Reference, as well as the OAuth 2.0 Reference, which describes the Client and Resource Server features available.

Extensive JavaDoc for the Spring Security code is also available in the Spring Security API Documentation.

Quick Start

We recommend that you review the OAuth 2.0 Authorization Framework to gain a deep understanding of the framework.

The OAuth 2.0 website, maintained by Aaron Parecki, provides links to learning resources as well as the various extension specifications.

Building from Source

Spring Authorization Server uses a Gradle-based build system. In the instructions below, ./gradlew is invoked from the root of the source tree and serves as a cross-platform, self-contained bootstrap mechanism for the build.

Prerequisites

Git and the JDK8 build.

Be sure that your JAVA_HOME environment variable points to the jdk1.8.0 folder extracted from the JDK download.

Check out sources

git clone [email protected]:spring-projects-experimental/spring-authorization-server.git

Install all spring-\* jars into your local Maven cache

./gradlew install

Compile and test; build all jars, distribution zips, and docs

./gradlew build

Discover more commands with ./gradlew tasks.

Getting Support

Check out the Spring Security tags on Stack Overflow. Commercial support is available too.

Contributing

Pull requests are welcome; see the contributor guidelines for details.

License

Spring Authorization Server is Open Source software released under the Apache 2.0 license.