1 changed files with 72 additions and 0 deletions
@ -0,0 +1,72 @@
@@ -0,0 +1,72 @@
|
||||
image::https://badges.gitter.im/Join%20Chat.svg[Gitter,link=https://gitter.im/spring-projects/spring-security?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge] |
||||
|
||||
image:https://travis-ci.org/spring-projects-experimental/spring-authorization-server.svg?branch=master["Build Status", link="https://travis-ci.org/spring-projects-experimental/spring-authorization-server"] |
||||
|
||||
= Spring Authorization Server |
||||
|
||||
Spring Authorization Server is a community-driven project led by the https://spring.io/projects/spring-security/[Spring Security] team and is focused on delivering https://tools.ietf.org/html/rfc6749#section-1.1[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 https://spring.io/projects/spring-security-oauth/[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 link:CODE_OF_CONDUCT.adoc[code of conduct]. |
||||
By participating, you are expected to uphold this code. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io. |
||||
|
||||
== Downloading Artifacts |
||||
See https://github.com/spring-projects/spring-framework/wiki/Downloading-Spring-artifacts[downloading Spring artifacts] for Maven repository information. |
||||
|
||||
== Documentation |
||||
Be sure to read the https://docs.spring.io/spring-security/site/docs/current/reference/html5/[Spring Security Reference], as well as the https://docs.spring.io/spring-security/site/docs/current/reference/html5/#oauth2[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 https://docs.spring.io/spring-security/site/docs/current/api/[Spring Security API Documentation]. |
||||
|
||||
== Quick Start |
||||
We recommend that you review the https://tools.ietf.org/html/rfc6749[OAuth 2.0 Authorization Framework] to gain a deep understanding of the framework. |
||||
|
||||
The https://oauth.net/2/[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 https://gradle.org[Gradle]-based build system. |
||||
In the instructions below, https://vimeo.com/34436402[`./gradlew`] is invoked from the root of the source tree and serves as |
||||
a cross-platform, self-contained bootstrap mechanism for the build. |
||||
|
||||
=== Prerequisites |
||||
https://help.github.com/set-up-git-redirect[Git] and the https://www.oracle.com/technetwork/java/javase/downloads[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 |
||||
[indent=0] |
||||
---- |
||||
git clone git@github.com:spring-projects-experimental/spring-authorization-server.git |
||||
|
||||
---- |
||||
|
||||
=== Install all spring-\* jars into your local Maven cache |
||||
[indent=0] |
||||
---- |
||||
./gradlew install |
||||
---- |
||||
|
||||
=== Compile and test; build all jars, distribution zips, and docs |
||||
[indent=0] |
||||
---- |
||||
./gradlew build |
||||
---- |
||||
|
||||
Discover more commands with `./gradlew tasks`. |
||||
|
||||
== Getting Support |
||||
Check out the https://stackoverflow.com/questions/tagged/spring-security[Spring Security tags on Stack Overflow]. |
||||
https://spring.io/services[Commercial support] is available too. |
||||
|
||||
== Contributing |
||||
https://help.github.com/articles/creating-a-pull-request[Pull requests] are welcome; see the link:CONTRIBUTING.adoc[contributor guidelines] for details. |
||||
|
||||
== License |
||||
Spring Authorization Server is Open Source software released under the |
||||
https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license]. |
||||
Loading…
Reference in new issue