# naruto-api-access

**Repository Path**: gaopengsui/naruto-api-access

## Basic Information

- **Project Name**: naruto-api-access
- **Description**: 基于SpringBoot、JWT封装的接口访问授权管理功能。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2021-11-10
- **Last Updated**: 2023-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# naruto

## 介绍

基于SpringBoot、JWT封装的接口访问授权管理功能。

## 软件架构

框架     | 版本
-------- | -----
SpringBoot  | 2.3.2.RELEASE
fastJson | 1.2.76
jjwt | 0.9.1

## 使用说明

#### Maven引入

```
<dependency>
  <groupId>online.inote</groupId>
  <artifactId>naruto-api-access-spring-boot-starter</artifactId>
  <version>0.0.6-RELEASE</version>
</dependency>
```

#### 配置信息

```
# Header key
naruto.security.api.access.header-key.token=token
naruto.security.api.access.cache.cache-key-prefix=NARUTO-API-ACCESS:CACHE:
# Web 配置
# 管理后台请求路径(UI & Controller)
naruto.security.api.access.admin.api.context-path=/naruto
# 运营后台登录账户
naruto.security.api.access.admin.administrator.username=admin
# 运营后台登录密码(MD5加密，详见naruto-api-access-spring-boot-sample下的测试类GenPasswordTest)
naruto.security.api.access.admin.administrator.password=cd32e063743d98827b0d663e5bbcc645

# JPA配置
# 在控制台打印SQL
spring.jpa.show-sql=true
# 每次启动项目时，数据库初始化策略
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.javax.persistence.validation.mode=none
```

注：如无特殊要求，Header部分配置可以省略，因为目前版本依赖于数据库做持久化(默认MySQL，如果使用其他数据库可手工移除相应jar包，引入对应数据库jar包即可)，使用JPA做数据库初始化，所以JPA部分需要配置。

#### API注解@ApiAccess

```
  @ApiAccess
  @PostMapping(value = "save")
  public ResultFactory<Object> save(@RequestBody String data) {
    return ResultFactory.success();
  }
```

#### 运营后台

以naruto-api-access-spring-boot-sample为例。<br>
项目启动后通过浏览器请求如下地址:http://localhost:8080/naruto-sample/naruto/naruto-ui/<br>
/naruto/naurto-ui/中/naruto是项目配置中naruto.security.api.access.admin.api.context-path对应内容，如果没有配置，默认为/naruto,naruto-ui为底层默认不可更改。

后台内容如下：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153338_d3d6a85c_627081.jpeg "Xnip2021-08-20_15-30-49.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153858_c158a17d_627081.jpeg "2.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153835_88df40df_627081.jpeg "2-1.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153912_4453f0a5_627081.jpeg "2-3.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153935_a8e62f9d_627081.jpeg "3-2.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153922_3db47c5c_627081.jpeg "3-1.jpg")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0820/153944_a53a87ca_627081.jpeg "3-3.jpg")

详见naruto-api-access-spring-boot-sample。