mirror of
https://github.com/volatiletech/authboss.git
synced 2024-11-24 08:42:17 +02:00
de1c2ed081
- Change changelog format to use keepachangelog standard - Refactor the config to be made of substructs to help organize all the pieces - Add the new interfaces to the configuration - Clean up module loading (no unnecessary reflection to create new value) - Change User interface to have a Get/SetPID not E-mail/Username, this way we don't ever have to refer to one or the other, we just always assume pid. In the case of Confirm/Recover we'll have to make a GetEmail or there won't be a way for us to get the e-mail to send to. - Delete the xsrf nonsense in the core
80 lines
2.5 KiB
Go
80 lines
2.5 KiB
Go
package authboss
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
"github.com/pkg/errors"
|
|
)
|
|
|
|
// RedirectOptions packages up all the pieces a module needs to write out a
|
|
// response.
|
|
type RedirectOptions struct {
|
|
// Success & Failure are used to set Flash messages / JSON messages
|
|
// if set. They should be mutually exclusive.
|
|
Success string
|
|
Failure string
|
|
|
|
// Code is used when it's an API request instead of 200.
|
|
Code int
|
|
|
|
// When a request should redirect a user somewhere on completion, these
|
|
// should be set. RedirectURL tells it where to go. And optionally set
|
|
// FollowRedirParam to override the RedirectURL if the form parameter defined
|
|
// by FormValueRedirect is passed in the request.
|
|
//
|
|
// Redirecting works differently whether it's an API request or not.
|
|
// If it's an API request, then it will leave the URL in a "redirect"
|
|
// parameter.
|
|
RedirectPath string
|
|
FollowRedirParam bool
|
|
}
|
|
|
|
// EmailResponseOptions controls how e-mails are rendered and sent
|
|
type EmailResponseOptions struct {
|
|
Data HTMLData
|
|
HTMLTemplate string
|
|
TextTemplate string
|
|
}
|
|
|
|
// HTTPResponder knows how to respond to an HTTP request
|
|
// Must consider:
|
|
// - Flash messages
|
|
// - XSRF handling (template data)
|
|
// - Assembling template data from various sources
|
|
//
|
|
// Authboss controller methods (like the one called in response to POST /auth/login)
|
|
// will call this method to write a response to the user.
|
|
type HTTPResponder interface {
|
|
Respond(w http.ResponseWriter, r *http.Request, code int, templateName string, data HTMLData) error
|
|
}
|
|
|
|
// HTTPRedirector redirects http requests to a different url (must handle both json and html)
|
|
// When an authboss controller wants to redirect a user to a different path, it will use
|
|
// this interface.
|
|
type HTTPRedirector interface {
|
|
Redirect(w http.ResponseWriter, r *http.Request, ro RedirectOptions) error
|
|
}
|
|
|
|
// Email renders the e-mail templates and sends it using the mailer.
|
|
func (a *Authboss) Email(w http.ResponseWriter, r *http.Request, email Email, ro EmailResponseOptions) error {
|
|
ctx := r.Context()
|
|
|
|
if len(ro.HTMLTemplate) != 0 {
|
|
htmlBody, _, err := a.Core.MailRenderer.Render(ctx, ro.HTMLTemplate, ro.Data)
|
|
if err != nil {
|
|
return errors.Wrap(err, "failed to render e-mail html body")
|
|
}
|
|
email.HTMLBody = string(htmlBody)
|
|
}
|
|
|
|
if len(ro.TextTemplate) != 0 {
|
|
textBody, _, err := a.Core.MailRenderer.Render(ctx, ro.TextTemplate, ro.Data)
|
|
if err != nil {
|
|
return errors.Wrap(err, "failed to render e-mail text body")
|
|
}
|
|
email.TextBody = string(textBody)
|
|
}
|
|
|
|
return a.Core.Mailer.Send(ctx, email)
|
|
}
|