users - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #llm #docker #windows #awesome #kubernetes #awesome-list #pytorch #ios #openai #open-source

users

(★ 102)

Common Web User Workflows in Go

File Explorer

Download Latest Version (.zip)

- FUNDING.yml
- changeinfos.gohtml
- error_currentpasswordnotprovided.gohtml
- error_currentpasswordwrong.gohtml
- error_expireduser.gohtml
- error_invalidemail.gohtml
- error_invalidpassword.gohtml
- error_passwordsdontmatch.gohtml
- error_resettokenexpired.gohtml
- error_resettokennotfound.gohtml
- error_verificationidexpired.gohtml
- error_verificationidnotfound.gohtml
- error_verificationincomplete.gohtml
- error_wronglogin.gohtml
- footer.gohtml
- forgottenpassword.gohtml
- header.gohtml
- infoschanged.gohtml
- login.gohtml
- passwordreset.gohtml
- programerror.gohtml
- resetlinksent.gohtml
- resetpassword.gohtml
- signup.gohtml
- verificationsent.gohtml
- verified.gohtml
- footer.tmpl
- header.tmpl
- reset_existing.tmpl
- reset_unknown.tmpl
- verification_changed.tmpl
- verification_existing.tmpl
- verification_new.tmpl
- changeinfos.gohtml
- error_currentpasswordnotprovided.gohtml
- error_currentpasswordwrong.gohtml
- error_expireduser.gohtml
- error_invalidemail.gohtml
- error_invalidpassword.gohtml
- error_passwordsdontmatch.gohtml
- error_resettokenexpired.gohtml
- error_resettokennotfound.gohtml
- error_verificationidexpired.gohtml
- error_verificationidnotfound.gohtml
- error_verificationincomplete.gohtml
- error_wronglogin.gohtml
- footer.gohtml
- footer.tmpl
- forgottenpassword.gohtml
- header.gohtml
- header.tmpl
- infoschanged.gohtml
- login.gohtml
- passwordreset.gohtml
- programerror.gohtml
- reset_existing.tmpl
- reset_unknown.tmpl
- resetlinksent.gohtml
- resetpassword.gohtml
- signup.gohtml
- verification_changed.tmpl
- verification_existing.tmpl
- verification_new.tmpl
- verificationsent.gohtml
- verified.gohtml
change.go
change_test.go
config.go
doc.go
helpers_test.go
html.go
LICENSE.txt
loginout.go
loginout_test.go
mail.go
password.go
password_test.go
README.md
signup.go
signup_test.go
user.go
users.go
users.png
users_test.go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A Go Package for Common User Workflows

[![Godoc Reference](https://img.shields.io/badge/godoc-reference-blue.svg)](https://godoc.org/github.com/rivo/users)
[![Go Report](https://img.shields.io/badge/go%20report-A%2B-brightgreen.svg)](https://goreportcard.com/report/github.com/rivo/users)

This Go package provides `net/http` handlers for the following functions:

- Signing up for a new user account
- Logging in and out
- Checking login status
- Resetting forgotten passwords
- Changing email and password

![Forms of the github.com/rivo/users package](https://raw.githubusercontent.com/rivo/users/master/users.png)

Special emphasis is placed on reducing the risk of someone hijacking user accounts. This is achieved by enforcing a certain user structure and following certain procedures:

- Users are identified by their email address.
- New or changed email addresses must be verified by clicking on a link emailed to that address.
- Users authenticate by entering their email address and a password.
- Password strength checks (based on NIST recommendations).
- Forgotten passwords are reset by clicking on a link emailed to the user.
- It uses [github.com/rivo/sessions](https://github.com/rivo/sessions) (cookie-based web sessions).

## Installation

```
go get github.com/rivo/users
```

## Simple Example

The `users.Main()` function registers all handlers and starts an HTTP server:

```go
if err := users.Main(); err != nil {
  panic(err)
}
```

Alternatively, register the handlers and start the server yourself:

```go
http.HandleFunc(users.Config.RouteSignUp, users.SignUp)
http.HandleFunc(users.Config.RouteVerify, users.Verify)
http.HandleFunc(users.Config.RouteLogIn, users.LogIn)
http.HandleFunc(users.Config.RouteLogOut, users.LogOut)
http.HandleFunc(users.Config.RouteForgottenPassword, users.ForgottenPassword)
http.HandleFunc(users.Config.RouteResetPassword, users.ResetPassword)
http.HandleFunc(users.Config.RouteChange, users.Change)

if err := http.ListenAndServe(users.Config.ServerAddr, nil); err != nil {
  panic(err)
}
```

If you use these handlers as they are, you will need access to an SMTP mail server (for email verification and password reset emails).

For pages behind the login, you can use the `users.IsLoggedIn()` function in your own handler:

```go
user, _, _ := users.IsLoggedIn(response, request)
if user == nil {
  users.RenderProgramError(response, request, "You must be logged in", "", nil)
  return
}
fmt.Fprintf(response, "You are logged in: %s", user.GetEmail())
```

## Configuration

This package uses Golang HTML templates for the various pages and text templates for the various emails sent to the user. Basic templates are provided which can be customized to your needs. Internationalization is supported via the "lang" browser cookie.

The `users.User` type is an interface. Bring your own user model.

The `users.Config` struct provides a number of fields with sensible defaults but which may be customized for your application. Refer to the [Godoc documentation](http://godoc.org/github.com/rivo/users#pkg-variables) for details.

No specific database backend is assumed. The functions to load and save users default to a RAM-based solution but can be customized to access your individual database.

## Documentation

See http://godoc.org/github.com/rivo/users for the documentation.

See also the https://github.com/rivo/users/wiki for more examples and explanations.

## Your Feedback

Add your issue here on GitHub. Feel free to get in touch if you have any questions.

## Release Notes

- v0.2 (2017-12-04)
  - Changed signature of LoggedIn(), simpler handling
- v0.1 (2017-11-17)
  - First release.