396 lines
13 KiB
Go
396 lines
13 KiB
Go
package handler
|
|
|
|
import (
|
|
"blackforestbytes.com/simplecloudnotifier/api/apierr"
|
|
"blackforestbytes.com/simplecloudnotifier/api/ginresp"
|
|
"blackforestbytes.com/simplecloudnotifier/logic"
|
|
"blackforestbytes.com/simplecloudnotifier/models"
|
|
"database/sql"
|
|
"errors"
|
|
"gogs.mikescher.com/BlackForestBytes/goext/ginext"
|
|
"gogs.mikescher.com/BlackForestBytes/goext/langext"
|
|
"net/http"
|
|
)
|
|
|
|
// ListUserKeys swaggerdoc
|
|
//
|
|
// @Summary List keys of the user
|
|
// @Description The request must be done with an ADMIN key, the returned keys are without their token.
|
|
// @ID api-tokenkeys-list
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
//
|
|
// @Success 200 {object} handler.ListUserKeys.response
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys [GET]
|
|
func (h APIHandler) ListUserKeys(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
}
|
|
type response struct {
|
|
Keys []models.KeyToken `json:"keys"`
|
|
}
|
|
|
|
var u uri
|
|
ctx, g, errResp := pctx.URI(&u).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockRead, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
if permResp := ctx.CheckPermissionUserAdmin(u.UserID); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
toks, err := h.database.ListKeyTokens(ctx, u.UserID)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to query keys", err)
|
|
}
|
|
|
|
return finishSuccess(ginext.JSON(http.StatusOK, response{Keys: toks}))
|
|
|
|
})
|
|
}
|
|
|
|
// GetCurrentUserKey swaggerdoc
|
|
//
|
|
// @Summary Get the key currently used by this request
|
|
// @Description Can be done with keys of any permission - the returned key does not include its token.
|
|
// @ID api-tokenkeys-get-current
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
// @Param kid path string true "TokenKeyID"
|
|
//
|
|
// @Success 200 {object} models.KeyToken
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys/current [GET]
|
|
func (h APIHandler) GetCurrentUserKey(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
}
|
|
|
|
var u uri
|
|
ctx, g, errResp := pctx.URI(&u).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockRead, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
if permResp := ctx.CheckPermissionAny(); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
tokid := ctx.GetPermissionKeyTokenID()
|
|
if tokid == nil {
|
|
return ginresp.APIError(g, 400, apierr.USER_AUTH_FAILED, "Missing KeyTokenID in context", nil)
|
|
}
|
|
|
|
keytoken, err := h.database.GetKeyToken(ctx, u.UserID, *tokid)
|
|
if errors.Is(err, sql.ErrNoRows) {
|
|
return ginresp.APIError(g, 404, apierr.KEY_NOT_FOUND, "Key not found", err)
|
|
}
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to query client", err)
|
|
}
|
|
|
|
return finishSuccess(ginext.JSONWithFilter(http.StatusOK, keytoken, "INCLUDE_TOKEN"))
|
|
|
|
})
|
|
}
|
|
|
|
// GetUserKey swaggerdoc
|
|
//
|
|
// @Summary Get a single key
|
|
// @Description The request must be done with an ADMIN key, the returned key does not include its token.
|
|
// @ID api-tokenkeys-get
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
// @Param kid path string true "TokenKeyID"
|
|
//
|
|
// @Success 200 {object} models.KeyToken
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys/{kid} [GET]
|
|
func (h APIHandler) GetUserKey(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
KeyID models.KeyTokenID `uri:"kid" binding:"entityid"`
|
|
}
|
|
|
|
var u uri
|
|
ctx, g, errResp := pctx.URI(&u).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockRead, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
if permResp := ctx.CheckPermissionUserAdmin(u.UserID); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
keytoken, err := h.database.GetKeyToken(ctx, u.UserID, u.KeyID)
|
|
if errors.Is(err, sql.ErrNoRows) {
|
|
return ginresp.APIError(g, 404, apierr.KEY_NOT_FOUND, "Key not found", err)
|
|
}
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to query client", err)
|
|
}
|
|
|
|
return finishSuccess(ginext.JSON(http.StatusOK, keytoken))
|
|
|
|
})
|
|
}
|
|
|
|
// UpdateUserKey swaggerdoc
|
|
//
|
|
// @Summary Update a key
|
|
// @ID api-tokenkeys-update
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
// @Param kid path string true "TokenKeyID"
|
|
//
|
|
// @Param post_body body handler.UpdateUserKey.body false " "
|
|
//
|
|
// @Success 200 {object} models.KeyToken
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys/{kid} [PATCH]
|
|
func (h APIHandler) UpdateUserKey(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
KeyID models.KeyTokenID `uri:"kid" binding:"entityid"`
|
|
}
|
|
type body struct {
|
|
Name *string `json:"name"`
|
|
AllChannels *bool `json:"all_channels"`
|
|
Channels *[]models.ChannelID `json:"channels"`
|
|
Permissions *string `json:"permissions"`
|
|
}
|
|
|
|
var u uri
|
|
var b body
|
|
ctx, g, errResp := pctx.URI(&u).Body(&b).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockReadWrite, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
if permResp := ctx.CheckPermissionUserAdmin(u.UserID); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
keytoken, err := h.database.GetKeyToken(ctx, u.UserID, u.KeyID)
|
|
if errors.Is(err, sql.ErrNoRows) {
|
|
return ginresp.APIError(g, 404, apierr.KEY_NOT_FOUND, "Key not found", err)
|
|
}
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to query client", err)
|
|
}
|
|
|
|
if b.Name != nil {
|
|
err := h.database.UpdateKeyTokenName(ctx, u.KeyID, *b.Name)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to update name", err)
|
|
}
|
|
keytoken.Name = *b.Name
|
|
}
|
|
|
|
if b.Permissions != nil {
|
|
if keytoken.KeyTokenID == *ctx.GetPermissionKeyTokenID() {
|
|
return ginresp.APIError(g, 400, apierr.CANNOT_SELFUPDATE_KEY, "Cannot update the currently used key", err)
|
|
}
|
|
|
|
permlist := models.ParseTokenPermissionList(*b.Permissions)
|
|
err := h.database.UpdateKeyTokenPermissions(ctx, u.KeyID, permlist)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to update permissions", err)
|
|
}
|
|
keytoken.Permissions = permlist
|
|
}
|
|
|
|
if b.AllChannels != nil {
|
|
if keytoken.KeyTokenID == *ctx.GetPermissionKeyTokenID() {
|
|
return ginresp.APIError(g, 400, apierr.CANNOT_SELFUPDATE_KEY, "Cannot update the currently used key", err)
|
|
}
|
|
|
|
err := h.database.UpdateKeyTokenAllChannels(ctx, u.KeyID, *b.AllChannels)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to update all_channels", err)
|
|
}
|
|
keytoken.AllChannels = *b.AllChannels
|
|
}
|
|
|
|
if b.Channels != nil {
|
|
if keytoken.KeyTokenID == *ctx.GetPermissionKeyTokenID() {
|
|
return ginresp.APIError(g, 400, apierr.CANNOT_SELFUPDATE_KEY, "Cannot update the currently used key", err)
|
|
}
|
|
|
|
err := h.database.UpdateKeyTokenChannels(ctx, u.KeyID, *b.Channels)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to update channels", err)
|
|
}
|
|
keytoken.Channels = *b.Channels
|
|
}
|
|
|
|
return finishSuccess(ginext.JSON(http.StatusOK, keytoken))
|
|
|
|
})
|
|
}
|
|
|
|
// CreateUserKey swaggerdoc
|
|
//
|
|
// @Summary Create a new key
|
|
// @ID api-tokenkeys-create
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
//
|
|
// @Param post_body body handler.CreateUserKey.body false " "
|
|
//
|
|
// @Success 200 {object} models.KeyToken
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys [POST]
|
|
func (h APIHandler) CreateUserKey(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
}
|
|
type body struct {
|
|
Name string `json:"name" binding:"required"`
|
|
Permissions string `json:"permissions" binding:"required"`
|
|
AllChannels *bool `json:"all_channels"`
|
|
Channels *[]models.ChannelID `json:"channels"`
|
|
}
|
|
|
|
var u uri
|
|
var b body
|
|
ctx, g, errResp := pctx.URI(&u).Body(&b).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockReadWrite, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
channels := langext.Coalesce(b.Channels, make([]models.ChannelID, 0))
|
|
|
|
var allChan bool
|
|
if b.AllChannels == nil && b.Channels != nil {
|
|
allChan = false
|
|
} else if b.AllChannels == nil && b.Channels == nil {
|
|
allChan = true
|
|
} else {
|
|
allChan = *b.AllChannels
|
|
}
|
|
|
|
for _, c := range channels {
|
|
if err := c.Valid(); err != nil {
|
|
return ginresp.APIError(g, 400, apierr.INVALID_BODY_PARAM, "Invalid ChannelID", err)
|
|
}
|
|
}
|
|
|
|
if permResp := ctx.CheckPermissionUserAdmin(u.UserID); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
token := h.app.GenerateRandomAuthKey()
|
|
|
|
perms := models.ParseTokenPermissionList(b.Permissions)
|
|
|
|
keytok, err := h.database.CreateKeyToken(ctx, b.Name, *ctx.GetPermissionUserID(), allChan, channels, perms, token)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to create keytoken in db", err)
|
|
}
|
|
|
|
return finishSuccess(ginext.JSONWithFilter(http.StatusOK, keytok, "INCLUDE_TOKEN"))
|
|
|
|
})
|
|
}
|
|
|
|
// DeleteUserKey swaggerdoc
|
|
//
|
|
// @Summary Delete a key
|
|
// @Description Cannot be used to delete the key used in the request itself
|
|
// @ID api-tokenkeys-delete
|
|
// @Tags API-v2
|
|
//
|
|
// @Param uid path string true "UserID"
|
|
// @Param kid path string true "TokenKeyID"
|
|
//
|
|
// @Success 200 {object} models.KeyToken
|
|
// @Failure 400 {object} ginresp.apiError "supplied values/parameters cannot be parsed / are invalid"
|
|
// @Failure 401 {object} ginresp.apiError "user is not authorized / has missing permissions"
|
|
// @Failure 404 {object} ginresp.apiError "message not found"
|
|
// @Failure 500 {object} ginresp.apiError "internal server error"
|
|
//
|
|
// @Router /api/v2/users/{uid}/keys/{kid} [DELETE]
|
|
func (h APIHandler) DeleteUserKey(pctx ginext.PreContext) ginext.HTTPResponse {
|
|
type uri struct {
|
|
UserID models.UserID `uri:"uid" binding:"entityid"`
|
|
KeyID models.KeyTokenID `uri:"kid" binding:"entityid"`
|
|
}
|
|
|
|
var u uri
|
|
ctx, g, errResp := pctx.URI(&u).Start()
|
|
if errResp != nil {
|
|
return *errResp
|
|
}
|
|
defer ctx.Cancel()
|
|
|
|
return h.app.DoRequest(ctx, g, models.TLockReadWrite, func(ctx *logic.AppContext, finishSuccess func(r ginext.HTTPResponse) ginext.HTTPResponse) ginext.HTTPResponse {
|
|
|
|
if permResp := ctx.CheckPermissionUserAdmin(u.UserID); permResp != nil {
|
|
return *permResp
|
|
}
|
|
|
|
client, err := h.database.GetKeyToken(ctx, u.UserID, u.KeyID)
|
|
if errors.Is(err, sql.ErrNoRows) {
|
|
return ginresp.APIError(g, 404, apierr.KEY_NOT_FOUND, "Key not found", err)
|
|
}
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to query client", err)
|
|
}
|
|
|
|
if u.KeyID == *ctx.GetPermissionKeyTokenID() {
|
|
return ginresp.APIError(g, 400, apierr.CANNOT_SELFDELETE_KEY, "Cannot delete the currently used key", err)
|
|
}
|
|
|
|
err = h.database.DeleteKeyToken(ctx, u.KeyID)
|
|
if err != nil {
|
|
return ginresp.APIError(g, 500, apierr.DATABASE_ERROR, "Failed to delete client", err)
|
|
}
|
|
|
|
return finishSuccess(ginext.JSON(http.StatusOK, client))
|
|
|
|
})
|
|
}
|