Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bnkamalesh/verifier
A minimal, customizable Go package for Email & Mobile number verification
https://github.com/bnkamalesh/verifier
2fa-security 2factor email email-verification go golang mobile-security mobile-verification multifactor-authentication otp otp-generator sms verification verifier
Last synced: about 1 month ago
JSON representation
A minimal, customizable Go package for Email & Mobile number verification
- Host: GitHub
- URL: https://github.com/bnkamalesh/verifier
- Owner: bnkamalesh
- License: mit
- Created: 2019-10-14T04:59:23.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-14T15:27:47.000Z (over 1 year ago)
- Last Synced: 2024-06-20T10:14:53.141Z (3 months ago)
- Topics: 2fa-security, 2factor, email, email-verification, go, golang, mobile-security, mobile-verification, multifactor-authentication, otp, otp-generator, sms, verification, verifier
- Language: Go
- Homepage:
- Size: 46.9 KB
- Stars: 7
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - bnkamalesh/verifier - A minimal, customizable Go package for Email & Mobile number verification (Go)
README
[](https://travis-ci.org/bnkamalesh/verifier)
[](https://codecov.io/gh/bnkamalesh/verifier)
[](https://goreportcard.com/report/github.com/bnkamalesh/verifier)
[](https://codeclimate.com/github/bnkamalesh/verifier/maintainability)
[](http://godoc.org/github.com/bnkamalesh/verifier)
# Verifier v0.1.0
Verifier package lets you verify emails & phone numbers, with customization available at different components. There's a functional (if provided with valid configurations) sample app provided [here](https://github.com/bnkamalesh/verifier/blob/master/cmd/main.go).
## How does it work?
Verifier generates secrets with an expiry, appropriate for emails & mobile phones. In case of emails,
it generates a 256 character long random alpha-numeric string, and a 6 character long numeric string
for mobile phones.
By default, it uses [AWS SES](https://aws.amazon.com/ses/) for sending e-mails & [AWS SNS](https://aws.amazon.com/sns/) for sending SMS/text messages.
## How to customize?
You can customize the following components of verifier.
```golang
// Customize the default templates
// there should be 2 string placeholders for email body. First is the 'callback URL' and 2nd is the expiry
verifier.DefaultEmailOTPPayload = ``
// there should be 1 string placeholder for SMS body. It will be the secret itself
verifier.DefaultSMSOTPPayload = ``
// ==
vsvc, err := verifier.NewCustom(&Config{}, nil,nil,nil)
if err != nil {
log.Println(err)
return
}
// Service provider for sending emails
err := v.CustomEmailHandler(email)
if err != nil {
log.Println(err)
return
}
// ==
// Service provider for sending messages to mobile
err = v.CustomMobileHandler(mobile)
if err != nil {
log.Println(err)
return err
}
// ==
// Persistent store used by verifier for storing secrets and all the requests
err = v.CustomStore(verStore)
if err != nil {
log.Println(err)
return
}
// ==
// Using custom email & text message body
verreq, err := vsvc.NewRequest(verifier.CommTypeEmail, recipient)
if err != nil {
log.Println(err)
return
}
// callbackURL can be used inside the custom email body
callbackURL, err := verifier.EmailCallbackURL("https://example.com", verreq.Recipient, verreq.Secret)
if err != nil {
log.Println(err)
return
}
err = vsvc.NewEmailWithReq(verreq, "subject", "body")
if err != nil {
log.Println(err)
return
}
err = vsvc.NewMobileWithReq(verreq, fmt.Sprintf("%s is your OTP", verreq.Secret))
if err != nil {
log.Println(err)
return
}
// ==
```
## TODO
1. Unit tests
3. Setup a web service, which can be independently run, and consumed via APIs
## The gopher
The gopher used here was created using [Gopherize.me](https://gopherize.me/). Verifier helps you keep those scammers and bots away just like our hacker gopher!