blob: 2e070bf7e39bf94dd6e300583b848d085d90d975 [file] [log] [blame] [view]
# Fence | [中文](README_ZH.md) [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) [![Gitter](https://img.shields.io/badge/ServiceComb-Gitter-ff69b4.svg)](https://gitter.im/ServiceCombUsers/Lobby)
This project is servicecomb-java-chassis security support. The main architecture is based on [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749) and [OpenID Connect](https://openid.net/connect/). And provides APIs for developers based on [Spring Security](https://spring.io/projects/spring-security). Please see [developers guide](docs/zh_CN/developersGuide.md) for details.
## Authentication diagram
![](docs/authentication.png)
## Authorization diagram
![](docs/authorization.png)
## Project description
This project contains authentication-server, resource server and edge service.
* Prepare
Authentication Server uses MySql database. Install database first, and initialize it by executing authentication-server\src\main\resources\sql\user.sql .
* Build and run
```
build_and_run.bat
```
Can open this file with a text editor to check what it is done.
* Demo web pages
Using admin/changeMyPassword login to the demo pages, and try operations.
```
http://localhost:9090/ui/login.html
```
* Run tests
After services are started, try
```
http://localhost:9093/v1/test/start
```
This test will token several seconds. See AuthenticationTestCase for testing details.
## Contact Us
* [issues](https://issues.apache.org/jira/browse/SCB)
* mailing list: [subscribe](mailto:dev-subscribe@servicecomb.apache.org) [view](https://lists.apache.org/list.html?dev@servicecomb.apache.org)