Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oopsguy/kaptcha-spring-boot
Kaptcha Spring Boot Starter help you use Google Kaptcha with Spring Boot easier. 一个简单封装了 Kaptcha 验证码库的 Spring Boot Starter
https://github.com/oopsguy/kaptcha-spring-boot
captcha java kaptcha security spring spring-boot springboot starter verify yaml
Last synced: 7 days ago
JSON representation
Kaptcha Spring Boot Starter help you use Google Kaptcha with Spring Boot easier. 一个简单封装了 Kaptcha 验证码库的 Spring Boot Starter
- Host: GitHub
- URL: https://github.com/oopsguy/kaptcha-spring-boot
- Owner: oopsguy
- License: mit
- Created: 2018-11-06T09:14:01.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-05-13T12:42:56.000Z (over 5 years ago)
- Last Synced: 2023-07-01T20:37:29.244Z (over 1 year ago)
- Topics: captcha, java, kaptcha, security, spring, spring-boot, springboot, starter, verify, yaml
- Language: Java
- Homepage:
- Size: 186 KB
- Stars: 19
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kaptcha Spring Boot Starter
Kaptcha Spring Boot Starter can help you use [Google Kaptcha](http://code.google.com/p/kaptcha/) with [Spring Boot](https://github.com/spring-projects/spring-boot) easier.
- [中文文档](README_zh-CN.md)
## Usage
Add `kaptcha-spring-boot-starter` dependency to your `pom.xml` file.
```xml
com.oopsguy.kaptcha
kaptcha-spring-boot-starter
1.0.0-beta-2
```
## Properties
You can use properties to custom captcha without Java code:
```yaml
kaptcha:
border:
enabled: true
color: '200,200,200'
thickness: 1
noise:
color: '239,166,131'
# you can specify your own implementation
impl:
obscurificator:
impl:
producer:
impl:
background:
impl:
color-from: '255,0,0'
color-to: '255,0,0'
text-producer:
impl:
character:
string: '01234567890ABCDEF'
length: 4
space: 10
font:
names:
color: '255,255,255'
size: 46
word:
impl:
image:
width: 200
height: 60
# You can configure multiple captcha
# and configure properties for them individually
items:
home:
path: /home/captcha
session:
key: homeCaptcha
background:
color-from: '255,255,255'
color-to: '255,255,255'
text-producer:
font:
color: '68,155,44'
# more items ...
```
## Examples
### YAML
The following use yaml to configure common kaptcha properties
and define two kaptcha servlets(`home` and `admin`),
you can configure them in your `application.yml`:
```yaml
server:
port: 8080
kaptcha:
border:
enbaled: true
image:
height: 60
width: 160
items:
# home captcha
home:
path: /home/capthca
text-producer:
font:
size: 16
image:
height: 40
# admin captcha
admin:
path: /admin/capthca
text-producer:
character:
length: 4
```
Then browse [http://localhost:8080/home/capthca](http://localhost:8080/home/capthca) and [http://localhost:8080/admin/capthca](http://localhost:8080/admin/capthca)
### Java Code
You can also inject a `Producer` bean directly by annotation to generate captcha.
```java
@Controller
@RequestMapping("/sys")
class SystemController {
@Resource
private Producer captchaProducer;
@GetMapping("/captcha")
public void getKaptchaImage(HttpServletRequest request, HttpServletResponse response) throws Exception {
response.setDateHeader("Expires", 0);
response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
response.addHeader("Cache-Control", "post-check=0, pre-check=0");
response.setHeader("Pragma", "no-cache");
response.setContentType("image/jpeg");
String capText = captchaProducer.createText();
// Save the captcha code to the session
request.getSession().setAttribute("captchaCode", capText);
BufferedImage bi = captchaProducer.createImage(capText);
ServletOutputStream out = response.getOutputStream();
ImageIO.write(bi, "jpg", out);
try {
out.flush();
} finally {
out.close();
}
}
}
```
For more examples, please see [kaptcha-spring-boot-starter-example](https://github.com/oopsguy/kaptcha-spring-boot/tree/master/kaptcha-spring-boot-starter-example)
## Notice
If you custom your own `Producer` bean, it will replace the default.
## License
MIT License