README
¶
caddy-manageusers
Caddy plugin designed to work with http.login (loginsrv) plugin. Allow creation, update, deletion of users in .htpasswd file and user-file. Based on https://github.com/foomo/htpasswd for htpasswd management.
Setup
Add a directive in your Caddyfile : manageusers /[route to access API] [.htpasswd file name] [optional : users.json file]
Example : manageusers /manageusers .htpasswd users.json
Usage
Retrieve user list
GET http://[hostname:port]/manageusers HTTP/1.1
Add or alter an user
POST http://[hostname:port]/manageusers HTTP/1.1
content-type: application/json
{
"username": "user",
"password": "pwd",
"origin": "htpasswd",
"role": "user",
"name": "Us",
"surname": "ER"
}
Delete an user
DELETE http://[hostname:port]/manageusers/[username] HTTP/1.1
NB
The user-file is not dynamically reloaded when an user is added or deleted on windows systems, it is ok with linux systems. The loginsrv (http.login) plugin is supposed to work with a yaml file, but since json is valid yaml, it works flawlessly. The user management route must be protected by jwt to disable unwanted users creation (which is a major security flaw).
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func WriteUserInfoFile ¶
WriteUserInfoFile write user infos into file
Types ¶
type Claims ¶
type Claims struct {
Role string `json:"role"`
Name string `json:"name"`
Surname string `json:"surname"`
}
Claims struct
type PwdHandler ¶
type PwdHandler struct {
Next httpserver.Handler
Config Config
}
PwdHandler type
func (PwdHandler) ServeHTTP ¶
func (h PwdHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error)
Source Files