users.go 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101
  1. package controllers
  2. import (
  3. "context"
  4. "encoding/json"
  5. "errors"
  6. "fmt"
  7. "net/http"
  8. "net/url"
  9. "strings"
  10. "github.com/gorilla/mux"
  11. "github.com/gravitl/netmaker/database"
  12. "github.com/gravitl/netmaker/logger"
  13. "github.com/gravitl/netmaker/logic"
  14. "github.com/gravitl/netmaker/models"
  15. "github.com/gravitl/netmaker/mq"
  16. proAuth "github.com/gravitl/netmaker/pro/auth"
  17. "github.com/gravitl/netmaker/pro/email"
  18. proLogic "github.com/gravitl/netmaker/pro/logic"
  19. "github.com/gravitl/netmaker/servercfg"
  20. "golang.org/x/exp/slog"
  21. )
  22. func UserHandlers(r *mux.Router) {
  23. r.HandleFunc("/api/oauth/login", proAuth.HandleAuthLogin).Methods(http.MethodGet)
  24. r.HandleFunc("/api/oauth/callback", proAuth.HandleAuthCallback).Methods(http.MethodGet)
  25. r.HandleFunc("/api/oauth/headless", proAuth.HandleHeadlessSSO)
  26. r.HandleFunc("/api/oauth/register/{regKey}", proAuth.RegisterHostSSO).Methods(http.MethodGet)
  27. // User Role Handlers
  28. r.HandleFunc("/api/v1/users/role", logic.SecurityCheck(true, http.HandlerFunc(getRole))).Methods(http.MethodGet)
  29. r.HandleFunc("/api/v1/users/role", logic.SecurityCheck(true, http.HandlerFunc(createRole))).Methods(http.MethodPost)
  30. r.HandleFunc("/api/v1/users/role", logic.SecurityCheck(true, http.HandlerFunc(updateRole))).Methods(http.MethodPut)
  31. r.HandleFunc("/api/v1/users/role", logic.SecurityCheck(true, http.HandlerFunc(deleteRole))).Methods(http.MethodDelete)
  32. // User Group Handlers
  33. r.HandleFunc("/api/v1/users/groups", logic.SecurityCheck(true, http.HandlerFunc(listUserGroups))).Methods(http.MethodGet)
  34. r.HandleFunc("/api/v1/users/group", logic.SecurityCheck(true, http.HandlerFunc(getUserGroup))).Methods(http.MethodGet)
  35. r.HandleFunc("/api/v1/users/group", logic.SecurityCheck(true, http.HandlerFunc(createUserGroup))).Methods(http.MethodPost)
  36. r.HandleFunc("/api/v1/users/group", logic.SecurityCheck(true, http.HandlerFunc(updateUserGroup))).Methods(http.MethodPut)
  37. r.HandleFunc("/api/v1/users/group", logic.SecurityCheck(true, http.HandlerFunc(deleteUserGroup))).Methods(http.MethodDelete)
  38. // User Invite Handlers
  39. r.HandleFunc("/api/v1/users/invite", userInviteVerify).Methods(http.MethodGet)
  40. r.HandleFunc("/api/v1/users/invite-signup", userInviteSignUp).Methods(http.MethodPost)
  41. r.HandleFunc("/api/v1/users/invite", logic.SecurityCheck(true, http.HandlerFunc(inviteUsers))).Methods(http.MethodPost)
  42. r.HandleFunc("/api/v1/users/invites", logic.SecurityCheck(true, http.HandlerFunc(listUserInvites))).Methods(http.MethodGet)
  43. r.HandleFunc("/api/v1/users/invite", logic.SecurityCheck(true, http.HandlerFunc(deleteUserInvite))).Methods(http.MethodDelete)
  44. r.HandleFunc("/api/v1/users/invites", logic.SecurityCheck(true, http.HandlerFunc(deleteAllUserInvites))).Methods(http.MethodDelete)
  45. r.HandleFunc("/api/users_pending", logic.SecurityCheck(true, http.HandlerFunc(getPendingUsers))).Methods(http.MethodGet)
  46. r.HandleFunc("/api/users_pending", logic.SecurityCheck(true, http.HandlerFunc(deleteAllPendingUsers))).Methods(http.MethodDelete)
  47. r.HandleFunc("/api/users_pending/user/{username}", logic.SecurityCheck(true, http.HandlerFunc(deletePendingUser))).Methods(http.MethodDelete)
  48. r.HandleFunc("/api/users_pending/user/{username}", logic.SecurityCheck(true, http.HandlerFunc(approvePendingUser))).Methods(http.MethodPost)
  49. r.HandleFunc("/api/users/{username}/remote_access_gw/{remote_access_gateway_id}", logic.SecurityCheck(true, http.HandlerFunc(attachUserToRemoteAccessGw))).Methods(http.MethodPost)
  50. r.HandleFunc("/api/users/{username}/remote_access_gw/{remote_access_gateway_id}", logic.SecurityCheck(true, http.HandlerFunc(removeUserFromRemoteAccessGW))).Methods(http.MethodDelete)
  51. r.HandleFunc("/api/users/{username}/remote_access_gw", logic.SecurityCheck(false, logic.ContinueIfUserMatch(http.HandlerFunc(getUserRemoteAccessGwsV1)))).Methods(http.MethodGet)
  52. r.HandleFunc("/api/users/ingress/{ingress_id}", logic.SecurityCheck(true, http.HandlerFunc(ingressGatewayUsers))).Methods(http.MethodGet)
  53. }
  54. // swagger:route POST /api/v1/users/invite-signup user userInviteSignUp
  55. //
  56. // user signup via invite.
  57. //
  58. // Schemes: https
  59. //
  60. // Responses:
  61. // 200: ReturnSuccessResponse
  62. func userInviteSignUp(w http.ResponseWriter, r *http.Request) {
  63. email, _ := url.QueryUnescape(r.URL.Query().Get("email"))
  64. code, _ := url.QueryUnescape(r.URL.Query().Get("invite_code"))
  65. in, err := logic.GetUserInvite(email)
  66. if err != nil {
  67. logger.Log(0, "failed to fetch users: ", err.Error())
  68. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  69. return
  70. }
  71. if code != in.InviteCode {
  72. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("invalid invite code"), "badrequest"))
  73. return
  74. }
  75. // check if user already exists
  76. _, err = logic.GetUser(email)
  77. if err == nil {
  78. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("user already exists"), "badrequest"))
  79. return
  80. }
  81. var user models.User
  82. err = json.NewDecoder(r.Body).Decode(&user)
  83. if err != nil {
  84. logger.Log(0, user.UserName, "error decoding request body: ",
  85. err.Error())
  86. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  87. return
  88. }
  89. if user.UserName != email {
  90. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("username not matching with invite"), "badrequest"))
  91. return
  92. }
  93. if user.Password == "" {
  94. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("password cannot be empty"), "badrequest"))
  95. return
  96. }
  97. user.UserGroups = in.UserGroups
  98. user.PlatformRoleID = models.UserRoleID(in.PlatformRoleID)
  99. if user.PlatformRoleID == "" {
  100. user.PlatformRoleID = models.ServiceUser
  101. }
  102. user.NetworkRoles = in.NetworkRoles
  103. err = logic.CreateUser(&user)
  104. if err != nil {
  105. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  106. return
  107. }
  108. // delete invite
  109. logic.DeleteUserInvite(email)
  110. logic.DeletePendingUser(email)
  111. w.Header().Set("Access-Control-Allow-Origin", "*")
  112. logic.ReturnSuccessResponse(w, r, "created user successfully "+email)
  113. }
  114. // swagger:route GET /api/v1/users/invite user userInviteVerify
  115. //
  116. // verfies user invite.
  117. //
  118. // Schemes: https
  119. //
  120. // Responses:
  121. // 200: ReturnSuccessResponse
  122. func userInviteVerify(w http.ResponseWriter, r *http.Request) {
  123. email, _ := url.QueryUnescape(r.URL.Query().Get("email"))
  124. code, _ := url.QueryUnescape(r.URL.Query().Get("invite_code"))
  125. err := logic.ValidateAndApproveUserInvite(email, code)
  126. if err != nil {
  127. logger.Log(0, "failed to fetch users: ", err.Error())
  128. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  129. return
  130. }
  131. logic.ReturnSuccessResponse(w, r, "invite is valid")
  132. }
  133. // swagger:route POST /api/v1/users/invite user inviteUsers
  134. //
  135. // invite users.
  136. //
  137. // Schemes: https
  138. //
  139. // Security:
  140. // oauth
  141. //
  142. // Responses:
  143. // 200: userBodyResponse
  144. func inviteUsers(w http.ResponseWriter, r *http.Request) {
  145. var inviteReq models.InviteUsersReq
  146. err := json.NewDecoder(r.Body).Decode(&inviteReq)
  147. if err != nil {
  148. slog.Error("error decoding request body", "error",
  149. err.Error())
  150. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  151. return
  152. }
  153. callerUserName := r.Header.Get("user")
  154. if r.Header.Get("ismaster") != "yes" {
  155. caller, err := logic.GetUser(callerUserName)
  156. if err != nil {
  157. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "notfound"))
  158. return
  159. }
  160. if inviteReq.PlatformRoleID == models.SuperAdminRole.String() {
  161. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("super admin cannot be invited"), "badrequest"))
  162. return
  163. }
  164. if inviteReq.PlatformRoleID == "" {
  165. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("platform role id cannot be empty"), "badrequest"))
  166. return
  167. }
  168. if (inviteReq.PlatformRoleID == models.AdminRole.String() ||
  169. inviteReq.PlatformRoleID == models.SuperAdminRole.String()) && caller.PlatformRoleID != models.SuperAdminRole {
  170. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("only superadmin can invite admin users"), "forbidden"))
  171. return
  172. }
  173. }
  174. //validate Req
  175. err = proLogic.IsGroupsValid(inviteReq.UserGroups)
  176. if err != nil {
  177. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  178. return
  179. }
  180. err = proLogic.IsNetworkRolesValid(inviteReq.NetworkRoles)
  181. if err != nil {
  182. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  183. return
  184. }
  185. // check platform role
  186. _, err = logic.GetRole(models.UserRoleID(inviteReq.PlatformRoleID))
  187. if err != nil {
  188. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  189. return
  190. }
  191. for _, inviteeEmail := range inviteReq.UserEmails {
  192. // check if user with email exists, then ignore
  193. _, err := logic.GetUser(inviteeEmail)
  194. if err == nil {
  195. // user exists already, so ignore
  196. continue
  197. }
  198. invite := models.UserInvite{
  199. Email: inviteeEmail,
  200. PlatformRoleID: inviteReq.PlatformRoleID,
  201. UserGroups: inviteReq.UserGroups,
  202. NetworkRoles: inviteReq.NetworkRoles,
  203. InviteCode: logic.RandomString(8),
  204. }
  205. frontendURL := strings.TrimSuffix(servercfg.GetFrontendURL(), "/")
  206. if frontendURL == "" {
  207. frontendURL = fmt.Sprintf("https://dashboard.%s", servercfg.GetNmBaseDomain())
  208. }
  209. u, err := url.Parse(fmt.Sprintf("%s/invite?email=%s&invite_code=%s",
  210. frontendURL, url.QueryEscape(invite.Email), url.QueryEscape(invite.InviteCode)))
  211. if err != nil {
  212. slog.Error("failed to parse to invite url", "error", err)
  213. return
  214. }
  215. invite.InviteURL = u.String()
  216. err = logic.InsertUserInvite(invite)
  217. if err != nil {
  218. slog.Error("failed to insert invite for user", "email", invite.Email, "error", err)
  219. }
  220. // notify user with magic link
  221. go func(invite models.UserInvite) {
  222. // Set E-Mail body. You can set plain text or html with text/html
  223. e := email.UserInvitedMail{
  224. BodyBuilder: &email.EmailBodyBuilderWithH1HeadlineAndImage{},
  225. InviteURL: invite.InviteURL,
  226. }
  227. n := email.Notification{
  228. RecipientMail: invite.Email,
  229. }
  230. err = email.GetClient().SendEmail(context.Background(), n, e)
  231. if err != nil {
  232. slog.Error("failed to send email invite", "user", invite.Email, "error", err)
  233. }
  234. }(invite)
  235. }
  236. }
  237. // swagger:route GET /api/v1/users/invites user listUserInvites
  238. //
  239. // lists all pending invited users.
  240. //
  241. // Schemes: https
  242. //
  243. // Security:
  244. // oauth
  245. //
  246. // Responses:
  247. // 200: ReturnSuccessResponseWithJson
  248. func listUserInvites(w http.ResponseWriter, r *http.Request) {
  249. usersInvites, err := logic.ListUserInvites()
  250. if err != nil {
  251. logger.Log(0, "failed to fetch users: ", err.Error())
  252. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  253. return
  254. }
  255. logic.ReturnSuccessResponseWithJson(w, r, usersInvites, "fetched pending user invites")
  256. }
  257. // swagger:route DELETE /api/v1/users/invite user deleteUserInvite
  258. //
  259. // delete pending invite.
  260. //
  261. // Schemes: https
  262. //
  263. // Security:
  264. // oauth
  265. //
  266. // Responses:
  267. // 200: ReturnSuccessResponse
  268. func deleteUserInvite(w http.ResponseWriter, r *http.Request) {
  269. email, _ := url.QueryUnescape(r.URL.Query().Get("invitee_email"))
  270. err := logic.DeleteUserInvite(email)
  271. if err != nil {
  272. logger.Log(0, "failed to delete user invite: ", email, err.Error())
  273. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  274. return
  275. }
  276. logic.ReturnSuccessResponse(w, r, "deleted user invite")
  277. }
  278. // swagger:route DELETE /api/v1/users/invites user deleteAllUserInvites
  279. //
  280. // deletes all pending invites.
  281. //
  282. // Schemes: https
  283. //
  284. // Security:
  285. // oauth
  286. //
  287. // Responses:
  288. // 200: ReturnSuccessResponse
  289. func deleteAllUserInvites(w http.ResponseWriter, r *http.Request) {
  290. err := database.DeleteAllRecords(database.USER_INVITES_TABLE_NAME)
  291. if err != nil {
  292. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("failed to delete all pending user invites "+err.Error()), "internal"))
  293. return
  294. }
  295. logic.ReturnSuccessResponse(w, r, "cleared all pending user invites")
  296. }
  297. // swagger:route GET /api/v1/user/groups user listUserGroups
  298. //
  299. // Get all user groups.
  300. //
  301. // Schemes: https
  302. //
  303. // Security:
  304. // oauth
  305. //
  306. // Responses:
  307. // 200: userBodyResponse
  308. func listUserGroups(w http.ResponseWriter, r *http.Request) {
  309. groups, err := proLogic.ListUserGroups()
  310. if err != nil {
  311. logic.ReturnErrorResponse(w, r, models.ErrorResponse{
  312. Code: http.StatusInternalServerError,
  313. Message: err.Error(),
  314. })
  315. return
  316. }
  317. logic.ReturnSuccessResponseWithJson(w, r, groups, "successfully fetched user groups")
  318. }
  319. // swagger:route GET /api/v1/user/group user getUserGroup
  320. //
  321. // Get user group.
  322. //
  323. // Schemes: https
  324. //
  325. // Security:
  326. // oauth
  327. //
  328. // Responses:
  329. // 200: userBodyResponse
  330. func getUserGroup(w http.ResponseWriter, r *http.Request) {
  331. gid, _ := url.QueryUnescape(r.URL.Query().Get("group_id"))
  332. if gid == "" {
  333. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("group id is required"), "badrequest"))
  334. return
  335. }
  336. group, err := proLogic.GetUserGroup(models.UserGroupID(gid))
  337. if err != nil {
  338. logic.ReturnErrorResponse(w, r, models.ErrorResponse{
  339. Code: http.StatusInternalServerError,
  340. Message: err.Error(),
  341. })
  342. return
  343. }
  344. logic.ReturnSuccessResponseWithJson(w, r, group, "successfully fetched user group")
  345. }
  346. // swagger:route POST /api/v1/user/group user createUserGroup
  347. //
  348. // Create user groups.
  349. //
  350. // Schemes: https
  351. //
  352. // Security:
  353. // oauth
  354. //
  355. // Responses:
  356. // 200: userBodyResponse
  357. func createUserGroup(w http.ResponseWriter, r *http.Request) {
  358. var userGroupReq models.CreateGroupReq
  359. err := json.NewDecoder(r.Body).Decode(&userGroupReq)
  360. if err != nil {
  361. slog.Error("error decoding request body", "error",
  362. err.Error())
  363. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  364. return
  365. }
  366. err = proLogic.ValidateCreateGroupReq(userGroupReq.Group)
  367. if err != nil {
  368. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  369. return
  370. }
  371. err = proLogic.CreateUserGroup(userGroupReq.Group)
  372. if err != nil {
  373. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  374. return
  375. }
  376. for _, userID := range userGroupReq.Members {
  377. user, err := logic.GetUser(userID)
  378. if err != nil {
  379. continue
  380. }
  381. if len(user.UserGroups) == 0 {
  382. user.UserGroups = make(map[models.UserGroupID]struct{})
  383. }
  384. user.UserGroups[userGroupReq.Group.ID] = struct{}{}
  385. logic.UpsertUser(*user)
  386. }
  387. logic.ReturnSuccessResponseWithJson(w, r, userGroupReq.Group, "created user group")
  388. }
  389. // swagger:route PUT /api/v1/user/group user updateUserGroup
  390. //
  391. // Update user group.
  392. //
  393. // Schemes: https
  394. //
  395. // Security:
  396. // oauth
  397. //
  398. // Responses:
  399. // 200: userBodyResponse
  400. func updateUserGroup(w http.ResponseWriter, r *http.Request) {
  401. var userGroup models.UserGroup
  402. err := json.NewDecoder(r.Body).Decode(&userGroup)
  403. if err != nil {
  404. slog.Error("error decoding request body", "error",
  405. err.Error())
  406. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  407. return
  408. }
  409. // fetch curr group
  410. currUserG, err := proLogic.GetUserGroup(userGroup.ID)
  411. if err != nil {
  412. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  413. return
  414. }
  415. err = proLogic.ValidateUpdateGroupReq(userGroup)
  416. if err != nil {
  417. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  418. return
  419. }
  420. err = proLogic.UpdateUserGroup(userGroup)
  421. if err != nil {
  422. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  423. return
  424. }
  425. // reset configs for service user
  426. go proLogic.UpdatesUserGwAccessOnGrpUpdates(currUserG.NetworkRoles, userGroup.NetworkRoles)
  427. logic.ReturnSuccessResponseWithJson(w, r, userGroup, "updated user group")
  428. }
  429. // swagger:route DELETE /api/v1/user/group user deleteUserGroup
  430. //
  431. // delete user group.
  432. //
  433. // Schemes: https
  434. //
  435. // Security:
  436. // oauth
  437. //
  438. // Responses:
  439. // 200: userBodyResponse
  440. //
  441. // @Summary Delete user group.
  442. // @Router /api/v1/user/group [delete]
  443. // @Tags Users
  444. // @Param group_id param string true "group id required to delete the role"
  445. // @Success 200 {string} string
  446. // @Failure 500 {object} models.ErrorResponse
  447. func deleteUserGroup(w http.ResponseWriter, r *http.Request) {
  448. gid, _ := url.QueryUnescape(r.URL.Query().Get("group_id"))
  449. if gid == "" {
  450. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("role is required"), "badrequest"))
  451. return
  452. }
  453. userG, err := proLogic.GetUserGroup(models.UserGroupID(gid))
  454. if err != nil {
  455. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("role is required"), "badrequest"))
  456. return
  457. }
  458. err = proLogic.DeleteUserGroup(models.UserGroupID(gid))
  459. if err != nil {
  460. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  461. return
  462. }
  463. go proLogic.UpdatesUserGwAccessOnGrpUpdates(userG.NetworkRoles, make(map[models.NetworkID]map[models.UserRoleID]struct{}))
  464. logic.ReturnSuccessResponseWithJson(w, r, nil, "deleted user group")
  465. }
  466. // @Summary lists all user roles.
  467. // @Router /api/v1/user/roles [get]
  468. // @Tags Users
  469. // @Param role_id param string true "roleid required to get the role details"
  470. // @Success 200 {object} []models.UserRolePermissionTemplate
  471. // @Failure 500 {object} models.ErrorResponse
  472. func ListRoles(w http.ResponseWriter, r *http.Request) {
  473. platform, _ := url.QueryUnescape(r.URL.Query().Get("platform"))
  474. var roles []models.UserRolePermissionTemplate
  475. var err error
  476. if platform == "true" {
  477. roles, err = logic.ListPlatformRoles()
  478. } else {
  479. roles, err = proLogic.ListNetworkRoles()
  480. }
  481. if err != nil {
  482. logic.ReturnErrorResponse(w, r, models.ErrorResponse{
  483. Code: http.StatusInternalServerError,
  484. Message: err.Error(),
  485. })
  486. return
  487. }
  488. logic.ReturnSuccessResponseWithJson(w, r, roles, "successfully fetched user roles permission templates")
  489. }
  490. // @Summary Get user role permission template.
  491. // @Router /api/v1/user/role [get]
  492. // @Tags Users
  493. // @Param role_id param string true "roleid required to get the role details"
  494. // @Success 200 {object} models.UserRolePermissionTemplate
  495. // @Failure 500 {object} models.ErrorResponse
  496. func getRole(w http.ResponseWriter, r *http.Request) {
  497. rid, _ := url.QueryUnescape(r.URL.Query().Get("role_id"))
  498. if rid == "" {
  499. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("role is required"), "badrequest"))
  500. return
  501. }
  502. role, err := logic.GetRole(models.UserRoleID(rid))
  503. if err != nil {
  504. logic.ReturnErrorResponse(w, r, models.ErrorResponse{
  505. Code: http.StatusInternalServerError,
  506. Message: err.Error(),
  507. })
  508. return
  509. }
  510. logic.ReturnSuccessResponseWithJson(w, r, role, "successfully fetched user role permission templates")
  511. }
  512. // @Summary Create user role permission template.
  513. // @Router /api/v1/user/role [post]
  514. // @Tags Users
  515. // @Param body models.UserRolePermissionTemplate true "user role template"
  516. // @Success 200 {object} models.UserRolePermissionTemplate
  517. // @Failure 500 {object} models.ErrorResponse
  518. func createRole(w http.ResponseWriter, r *http.Request) {
  519. var userRole models.UserRolePermissionTemplate
  520. err := json.NewDecoder(r.Body).Decode(&userRole)
  521. if err != nil {
  522. slog.Error("error decoding request body", "error",
  523. err.Error())
  524. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  525. return
  526. }
  527. err = proLogic.ValidateCreateRoleReq(&userRole)
  528. if err != nil {
  529. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  530. return
  531. }
  532. userRole.Default = false
  533. userRole.GlobalLevelAccess = make(map[models.RsrcType]map[models.RsrcID]models.RsrcPermissionScope)
  534. err = proLogic.CreateRole(userRole)
  535. if err != nil {
  536. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  537. return
  538. }
  539. logic.ReturnSuccessResponseWithJson(w, r, userRole, "created user role")
  540. }
  541. // @Summary Update user role permission template.
  542. // @Router /api/v1/user/role [put]
  543. // @Tags Users
  544. // @Param body models.UserRolePermissionTemplate true "user role template"
  545. // @Success 200 {object} userBodyResponse
  546. // @Failure 500 {object} models.ErrorResponse
  547. func updateRole(w http.ResponseWriter, r *http.Request) {
  548. var userRole models.UserRolePermissionTemplate
  549. err := json.NewDecoder(r.Body).Decode(&userRole)
  550. if err != nil {
  551. slog.Error("error decoding request body", "error",
  552. err.Error())
  553. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  554. return
  555. }
  556. currRole, err := logic.GetRole(userRole.ID)
  557. if err != nil {
  558. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  559. return
  560. }
  561. err = proLogic.ValidateUpdateRoleReq(&userRole)
  562. if err != nil {
  563. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  564. return
  565. }
  566. userRole.GlobalLevelAccess = make(map[models.RsrcType]map[models.RsrcID]models.RsrcPermissionScope)
  567. err = proLogic.UpdateRole(userRole)
  568. if err != nil {
  569. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  570. return
  571. }
  572. // reset configs for service user
  573. go proLogic.UpdatesUserGwAccessOnRoleUpdates(currRole.NetworkLevelAccess, userRole.NetworkLevelAccess, string(userRole.NetworkID))
  574. logic.ReturnSuccessResponseWithJson(w, r, userRole, "updated user role")
  575. }
  576. // @Summary Delete user role permission template.
  577. // @Router /api/v1/user/role [delete]
  578. // @Tags Users
  579. // @Param role_id param string true "roleid required to delete the role"
  580. // @Success 200 {string} string
  581. // @Failure 500 {object} models.ErrorResponse
  582. func deleteRole(w http.ResponseWriter, r *http.Request) {
  583. rid, _ := url.QueryUnescape(r.URL.Query().Get("role_id"))
  584. if rid == "" {
  585. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("role is required"), "badrequest"))
  586. return
  587. }
  588. role, err := logic.GetRole(models.UserRoleID(rid))
  589. if err != nil {
  590. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("role is required"), "badrequest"))
  591. return
  592. }
  593. err = proLogic.DeleteRole(models.UserRoleID(rid), false)
  594. if err != nil {
  595. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  596. return
  597. }
  598. go proLogic.UpdatesUserGwAccessOnRoleUpdates(role.NetworkLevelAccess, make(map[models.RsrcType]map[models.RsrcID]models.RsrcPermissionScope), role.NetworkID.String())
  599. logic.ReturnSuccessResponseWithJson(w, r, nil, "deleted user role")
  600. }
  601. // @Summary Attach user to a remote access gateway
  602. // @Router /api/users/{username}/remote_access_gw/{remote_access_gateway_id} [post]
  603. // @Tags PRO
  604. // @Accept json
  605. // @Produce json
  606. // @Param username path string true "Username"
  607. // @Param remote_access_gateway_id path string true "Remote Access Gateway ID"
  608. // @Success 200 {object} models.ReturnUser
  609. // @Failure 400 {object} models.ErrorResponse
  610. // @Failure 500 {object} models.ErrorResponse
  611. func attachUserToRemoteAccessGw(w http.ResponseWriter, r *http.Request) {
  612. // set header.
  613. w.Header().Set("Content-Type", "application/json")
  614. var params = mux.Vars(r)
  615. username := params["username"]
  616. remoteGwID := params["remote_access_gateway_id"]
  617. if username == "" || remoteGwID == "" {
  618. logic.ReturnErrorResponse(
  619. w,
  620. r,
  621. logic.FormatError(
  622. errors.New("required params `username` and `remote_access_gateway_id`"),
  623. "badrequest",
  624. ),
  625. )
  626. return
  627. }
  628. user, err := logic.GetUser(username)
  629. if err != nil {
  630. slog.Error("failed to fetch user: ", "username", username, "error", err.Error())
  631. logic.ReturnErrorResponse(
  632. w,
  633. r,
  634. logic.FormatError(
  635. fmt.Errorf("failed to fetch user %s, error: %v", username, err),
  636. "badrequest",
  637. ),
  638. )
  639. return
  640. }
  641. if user.PlatformRoleID == models.AdminRole || user.PlatformRoleID == models.SuperAdminRole {
  642. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("superadmins/admins have access to all gateways"), "badrequest"))
  643. return
  644. }
  645. node, err := logic.GetNodeByID(remoteGwID)
  646. if err != nil {
  647. slog.Error("failed to fetch gateway node", "nodeID", remoteGwID, "error", err)
  648. logic.ReturnErrorResponse(
  649. w,
  650. r,
  651. logic.FormatError(
  652. fmt.Errorf("failed to fetch remote access gateway node, error: %v", err),
  653. "badrequest",
  654. ),
  655. )
  656. return
  657. }
  658. if !node.IsIngressGateway {
  659. logic.ReturnErrorResponse(
  660. w,
  661. r,
  662. logic.FormatError(fmt.Errorf("node is not a remote access gateway"), "badrequest"),
  663. )
  664. return
  665. }
  666. if user.RemoteGwIDs == nil {
  667. user.RemoteGwIDs = make(map[string]struct{})
  668. }
  669. user.RemoteGwIDs[node.ID.String()] = struct{}{}
  670. err = logic.UpsertUser(*user)
  671. if err != nil {
  672. slog.Error("failed to update user's gateways", "user", username, "error", err)
  673. logic.ReturnErrorResponse(
  674. w,
  675. r,
  676. logic.FormatError(
  677. fmt.Errorf("failed to fetch remote access gateway node,error: %v", err),
  678. "badrequest",
  679. ),
  680. )
  681. return
  682. }
  683. json.NewEncoder(w).Encode(logic.ToReturnUser(*user))
  684. }
  685. // @Summary Remove user from a remote access gateway
  686. // @Router /api/users/{username}/remote_access_gw/{remote_access_gateway_id} [delete]
  687. // @Tags PRO
  688. // @Accept json
  689. // @Produce json
  690. // @Param username path string true "Username"
  691. // @Param remote_access_gateway_id path string true "Remote Access Gateway ID"
  692. // @Success 200 {object} models.ReturnUser
  693. // @Failure 400 {object} models.ErrorResponse
  694. // @Failure 500 {object} models.ErrorResponse
  695. func removeUserFromRemoteAccessGW(w http.ResponseWriter, r *http.Request) {
  696. // set header.
  697. w.Header().Set("Content-Type", "application/json")
  698. var params = mux.Vars(r)
  699. username := params["username"]
  700. remoteGwID := params["remote_access_gateway_id"]
  701. if username == "" || remoteGwID == "" {
  702. logic.ReturnErrorResponse(
  703. w,
  704. r,
  705. logic.FormatError(
  706. errors.New("required params `username` and `remote_access_gateway_id`"),
  707. "badrequest",
  708. ),
  709. )
  710. return
  711. }
  712. user, err := logic.GetUser(username)
  713. if err != nil {
  714. logger.Log(0, username, "failed to fetch user: ", err.Error())
  715. logic.ReturnErrorResponse(
  716. w,
  717. r,
  718. logic.FormatError(
  719. fmt.Errorf("failed to fetch user %s, error: %v", username, err),
  720. "badrequest",
  721. ),
  722. )
  723. return
  724. }
  725. delete(user.RemoteGwIDs, remoteGwID)
  726. go func(user models.User, remoteGwID string) {
  727. extclients, err := logic.GetAllExtClients()
  728. if err != nil {
  729. slog.Error("failed to fetch extclients", "error", err)
  730. return
  731. }
  732. for _, extclient := range extclients {
  733. if extclient.OwnerID == user.UserName && remoteGwID == extclient.IngressGatewayID {
  734. err = logic.DeleteExtClientAndCleanup(extclient)
  735. if err != nil {
  736. slog.Error("failed to delete extclient",
  737. "id", extclient.ClientID, "owner", user.UserName, "error", err)
  738. } else {
  739. if err := mq.PublishDeletedClientPeerUpdate(&extclient); err != nil {
  740. slog.Error("error setting ext peers: " + err.Error())
  741. }
  742. }
  743. }
  744. }
  745. if servercfg.IsDNSMode() {
  746. logic.SetDNS()
  747. }
  748. }(*user, remoteGwID)
  749. err = logic.UpsertUser(*user)
  750. if err != nil {
  751. slog.Error("failed to update user gateways", "user", username, "error", err)
  752. logic.ReturnErrorResponse(
  753. w,
  754. r,
  755. logic.FormatError(
  756. errors.New("failed to fetch remote access gaetway node "+err.Error()),
  757. "badrequest",
  758. ),
  759. )
  760. return
  761. }
  762. json.NewEncoder(w).Encode(logic.ToReturnUser(*user))
  763. }
  764. // @Summary Get Users Remote Access Gw.
  765. // @Router /api/users/{username}/remote_access_gw [get]
  766. // @Tags Users
  767. // @Param username path string true "Username to fetch all the gateways with access"
  768. // @Success 200 {object} map[string][]models.UserRemoteGws
  769. // @Failure 500 {object} models.ErrorResponse
  770. func getUserRemoteAccessGwsV1(w http.ResponseWriter, r *http.Request) {
  771. // set header.
  772. w.Header().Set("Content-Type", "application/json")
  773. var params = mux.Vars(r)
  774. username := params["username"]
  775. if username == "" {
  776. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("required params username"), "badrequest"))
  777. return
  778. }
  779. user, err := logic.GetUser(username)
  780. if err != nil {
  781. logger.Log(0, username, "failed to fetch user: ", err.Error())
  782. logic.ReturnErrorResponse(w, r, logic.FormatError(fmt.Errorf("failed to fetch user %s, error: %v", username, err), "badrequest"))
  783. return
  784. }
  785. remoteAccessClientID := r.URL.Query().Get("remote_access_clientid")
  786. var req models.UserRemoteGwsReq
  787. if remoteAccessClientID == "" {
  788. err := json.NewDecoder(r.Body).Decode(&req)
  789. if err != nil {
  790. slog.Error("error decoding request body: ", "error", err)
  791. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  792. return
  793. }
  794. }
  795. reqFromMobile := r.URL.Query().Get("from_mobile") == "true"
  796. if req.RemoteAccessClientID == "" && remoteAccessClientID == "" {
  797. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("remote access client id cannot be empty"), "badrequest"))
  798. return
  799. }
  800. if req.RemoteAccessClientID == "" {
  801. req.RemoteAccessClientID = remoteAccessClientID
  802. }
  803. userGws := make(map[string][]models.UserRemoteGws)
  804. allextClients, err := logic.GetAllExtClients()
  805. if err != nil {
  806. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  807. return
  808. }
  809. userGwNodes := proLogic.GetUserRAGNodes(*user)
  810. for _, extClient := range allextClients {
  811. node, ok := userGwNodes[extClient.IngressGatewayID]
  812. if !ok {
  813. continue
  814. }
  815. if extClient.RemoteAccessClientID == req.RemoteAccessClientID && extClient.OwnerID == username {
  816. host, err := logic.GetHost(node.HostID.String())
  817. if err != nil {
  818. continue
  819. }
  820. network, err := logic.GetNetwork(node.Network)
  821. if err != nil {
  822. slog.Error("failed to get node network", "error", err)
  823. }
  824. gws := userGws[node.Network]
  825. extClient.AllowedIPs = logic.GetExtclientAllowedIPs(extClient)
  826. gws = append(gws, models.UserRemoteGws{
  827. GwID: node.ID.String(),
  828. GWName: host.Name,
  829. Network: node.Network,
  830. GwClient: extClient,
  831. Connected: true,
  832. IsInternetGateway: node.IsInternetGateway,
  833. GwPeerPublicKey: host.PublicKey.String(),
  834. GwListenPort: logic.GetPeerListenPort(host),
  835. Metadata: node.Metadata,
  836. AllowedEndpoints: getAllowedRagEndpoints(&node, host),
  837. NetworkAddresses: []string{network.AddressRange, network.AddressRange6},
  838. })
  839. userGws[node.Network] = gws
  840. delete(userGwNodes, node.ID.String())
  841. }
  842. }
  843. // add remaining gw nodes to resp
  844. for gwID := range userGwNodes {
  845. node, err := logic.GetNodeByID(gwID)
  846. if err != nil {
  847. continue
  848. }
  849. if !node.IsIngressGateway {
  850. continue
  851. }
  852. if node.PendingDelete {
  853. continue
  854. }
  855. host, err := logic.GetHost(node.HostID.String())
  856. if err != nil {
  857. continue
  858. }
  859. network, err := logic.GetNetwork(node.Network)
  860. if err != nil {
  861. slog.Error("failed to get node network", "error", err)
  862. }
  863. gws := userGws[node.Network]
  864. gws = append(gws, models.UserRemoteGws{
  865. GwID: node.ID.String(),
  866. GWName: host.Name,
  867. Network: node.Network,
  868. IsInternetGateway: node.IsInternetGateway,
  869. GwPeerPublicKey: host.PublicKey.String(),
  870. GwListenPort: logic.GetPeerListenPort(host),
  871. Metadata: node.Metadata,
  872. AllowedEndpoints: getAllowedRagEndpoints(&node, host),
  873. NetworkAddresses: []string{network.AddressRange, network.AddressRange6},
  874. })
  875. userGws[node.Network] = gws
  876. }
  877. if reqFromMobile {
  878. // send resp in array format
  879. userGwsArr := []models.UserRemoteGws{}
  880. for _, userGwI := range userGws {
  881. userGwsArr = append(userGwsArr, userGwI...)
  882. }
  883. logic.ReturnSuccessResponseWithJson(w, r, userGwsArr, "fetched gateways for user"+username)
  884. return
  885. }
  886. slog.Debug("returned user gws", "user", username, "gws", userGws)
  887. w.WriteHeader(http.StatusOK)
  888. json.NewEncoder(w).Encode(userGws)
  889. }
  890. // @Summary List users attached to an remote access gateway
  891. // @Router /api/nodes/{network}/{nodeid}/ingress/users [get]
  892. // @Tags PRO
  893. // @Accept json
  894. // @Produce json
  895. // @Param ingress_id path string true "Ingress Gateway ID"
  896. // @Success 200 {array} models.IngressGwUsers
  897. // @Failure 400 {object} models.ErrorResponse
  898. // @Failure 500 {object} models.ErrorResponse
  899. func ingressGatewayUsers(w http.ResponseWriter, r *http.Request) {
  900. w.Header().Set("Content-Type", "application/json")
  901. var params = mux.Vars(r)
  902. ingressID := params["ingress_id"]
  903. node, err := logic.GetNodeByID(ingressID)
  904. if err != nil {
  905. slog.Error("failed to get ingress node", "error", err)
  906. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "badrequest"))
  907. return
  908. }
  909. gwUsers, err := logic.GetIngressGwUsers(node)
  910. if err != nil {
  911. slog.Error(
  912. "failed to get users on ingress gateway",
  913. "nodeid",
  914. ingressID,
  915. "network",
  916. node.Network,
  917. "user",
  918. r.Header.Get("user"),
  919. "error",
  920. err,
  921. )
  922. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  923. return
  924. }
  925. w.WriteHeader(http.StatusOK)
  926. json.NewEncoder(w).Encode(gwUsers)
  927. }
  928. func getAllowedRagEndpoints(ragNode *models.Node, ragHost *models.Host) []string {
  929. endpoints := []string{}
  930. if len(ragHost.EndpointIP) > 0 {
  931. endpoints = append(endpoints, ragHost.EndpointIP.String())
  932. }
  933. if len(ragHost.EndpointIPv6) > 0 {
  934. endpoints = append(endpoints, ragHost.EndpointIPv6.String())
  935. }
  936. if servercfg.IsPro {
  937. for _, ip := range ragNode.AdditionalRagIps {
  938. endpoints = append(endpoints, ip.String())
  939. }
  940. }
  941. return endpoints
  942. }
  943. // @Summary Get all pending users
  944. // @Router /api/users_pending [get]
  945. // @Tags Users
  946. // @Success 200 {array} models.User
  947. // @Failure 500 {object} models.ErrorResponse
  948. func getPendingUsers(w http.ResponseWriter, r *http.Request) {
  949. // set header.
  950. w.Header().Set("Content-Type", "application/json")
  951. users, err := logic.ListPendingUsers()
  952. if err != nil {
  953. logger.Log(0, "failed to fetch users: ", err.Error())
  954. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  955. return
  956. }
  957. logic.SortUsers(users[:])
  958. logger.Log(2, r.Header.Get("user"), "fetched pending users")
  959. json.NewEncoder(w).Encode(users)
  960. }
  961. // @Summary Approve a pending user
  962. // @Router /api/users_pending/user/{username} [post]
  963. // @Tags Users
  964. // @Param username path string true "Username of the pending user to approve"
  965. // @Success 200 {string} string
  966. // @Failure 500 {object} models.ErrorResponse
  967. func approvePendingUser(w http.ResponseWriter, r *http.Request) {
  968. // set header.
  969. w.Header().Set("Content-Type", "application/json")
  970. var params = mux.Vars(r)
  971. username := params["username"]
  972. users, err := logic.ListPendingUsers()
  973. if err != nil {
  974. logger.Log(0, "failed to fetch users: ", err.Error())
  975. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  976. return
  977. }
  978. for _, user := range users {
  979. if user.UserName == username {
  980. var newPass, fetchErr = logic.FetchPassValue("")
  981. if fetchErr != nil {
  982. logic.ReturnErrorResponse(w, r, logic.FormatError(fetchErr, "internal"))
  983. return
  984. }
  985. if err = logic.CreateUser(&models.User{
  986. UserName: user.UserName,
  987. Password: newPass,
  988. PlatformRoleID: models.ServiceUser,
  989. }); err != nil {
  990. logic.ReturnErrorResponse(w, r, logic.FormatError(fmt.Errorf("failed to create user: %s", err), "internal"))
  991. return
  992. }
  993. err = logic.DeletePendingUser(username)
  994. if err != nil {
  995. logic.ReturnErrorResponse(w, r, logic.FormatError(fmt.Errorf("failed to delete pending user: %s", err), "internal"))
  996. return
  997. }
  998. break
  999. }
  1000. }
  1001. logic.ReturnSuccessResponse(w, r, "approved "+username)
  1002. }
  1003. // @Summary Delete a pending user
  1004. // @Router /api/users_pending/user/{username} [delete]
  1005. // @Tags Users
  1006. // @Param username path string true "Username of the pending user to delete"
  1007. // @Success 200 {string} string
  1008. // @Failure 500 {object} models.ErrorResponse
  1009. func deletePendingUser(w http.ResponseWriter, r *http.Request) {
  1010. // set header.
  1011. w.Header().Set("Content-Type", "application/json")
  1012. var params = mux.Vars(r)
  1013. username := params["username"]
  1014. users, err := logic.ListPendingUsers()
  1015. if err != nil {
  1016. logger.Log(0, "failed to fetch users: ", err.Error())
  1017. logic.ReturnErrorResponse(w, r, logic.FormatError(err, "internal"))
  1018. return
  1019. }
  1020. for _, user := range users {
  1021. if user.UserName == username {
  1022. err = logic.DeletePendingUser(username)
  1023. if err != nil {
  1024. logic.ReturnErrorResponse(w, r, logic.FormatError(fmt.Errorf("failed to delete pending user: %s", err), "internal"))
  1025. return
  1026. }
  1027. break
  1028. }
  1029. }
  1030. logic.ReturnSuccessResponse(w, r, "deleted pending "+username)
  1031. }
  1032. // @Summary Delete all pending users
  1033. // @Router /api/users_pending [delete]
  1034. // @Tags Users
  1035. // @Success 200 {string} string
  1036. // @Failure 500 {object} models.ErrorResponse
  1037. func deleteAllPendingUsers(w http.ResponseWriter, r *http.Request) {
  1038. // set header.
  1039. err := database.DeleteAllRecords(database.PENDING_USERS_TABLE_NAME)
  1040. if err != nil {
  1041. logic.ReturnErrorResponse(w, r, logic.FormatError(errors.New("failed to delete all pending users "+err.Error()), "internal"))
  1042. return
  1043. }
  1044. logic.ReturnSuccessResponse(w, r, "cleared all pending users")
  1045. }