api_maintenance.go 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492
  1. // Copyright (C) 2019-2022 Nicola Murino
  2. //
  3. // This program is free software: you can redistribute it and/or modify
  4. // it under the terms of the GNU Affero General Public License as published
  5. // by the Free Software Foundation, version 3.
  6. //
  7. // This program is distributed in the hope that it will be useful,
  8. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. // GNU Affero General Public License for more details.
  11. //
  12. // You should have received a copy of the GNU Affero General Public License
  13. // along with this program. If not, see <https://www.gnu.org/licenses/>.
  14. package httpd
  15. import (
  16. "encoding/json"
  17. "errors"
  18. "fmt"
  19. "io"
  20. "net/http"
  21. "os"
  22. "path/filepath"
  23. "strconv"
  24. "strings"
  25. "github.com/go-chi/render"
  26. "github.com/drakkan/sftpgo/v2/internal/common"
  27. "github.com/drakkan/sftpgo/v2/internal/dataprovider"
  28. "github.com/drakkan/sftpgo/v2/internal/logger"
  29. "github.com/drakkan/sftpgo/v2/internal/util"
  30. "github.com/drakkan/sftpgo/v2/internal/vfs"
  31. )
  32. func validateBackupFile(outputFile string) (string, error) {
  33. if outputFile == "" {
  34. return "", errors.New("invalid or missing output-file")
  35. }
  36. if filepath.IsAbs(outputFile) {
  37. return "", fmt.Errorf("invalid output-file %#v: it must be a relative path", outputFile)
  38. }
  39. if strings.Contains(outputFile, "..") {
  40. return "", fmt.Errorf("invalid output-file %#v", outputFile)
  41. }
  42. outputFile = filepath.Join(dataprovider.GetBackupsPath(), outputFile)
  43. return outputFile, nil
  44. }
  45. func dumpData(w http.ResponseWriter, r *http.Request) {
  46. r.Body = http.MaxBytesReader(w, r.Body, maxRequestSize)
  47. var outputFile, outputData, indent string
  48. if _, ok := r.URL.Query()["output-file"]; ok {
  49. outputFile = strings.TrimSpace(r.URL.Query().Get("output-file"))
  50. }
  51. if _, ok := r.URL.Query()["output-data"]; ok {
  52. outputData = strings.TrimSpace(r.URL.Query().Get("output-data"))
  53. }
  54. if _, ok := r.URL.Query()["indent"]; ok {
  55. indent = strings.TrimSpace(r.URL.Query().Get("indent"))
  56. }
  57. if outputData != "1" {
  58. var err error
  59. outputFile, err = validateBackupFile(outputFile)
  60. if err != nil {
  61. sendAPIResponse(w, r, err, "", http.StatusBadRequest)
  62. return
  63. }
  64. err = os.MkdirAll(filepath.Dir(outputFile), 0700)
  65. if err != nil {
  66. logger.Error(logSender, "", "dumping data error: %v, output file: %#v", err, outputFile)
  67. sendAPIResponse(w, r, err, "", getRespStatus(err))
  68. return
  69. }
  70. logger.Debug(logSender, "", "dumping data to: %#v", outputFile)
  71. }
  72. backup, err := dataprovider.DumpData()
  73. if err != nil {
  74. logger.Error(logSender, "", "dumping data error: %v, output file: %#v", err, outputFile)
  75. sendAPIResponse(w, r, err, "", getRespStatus(err))
  76. return
  77. }
  78. if outputData == "1" {
  79. w.Header().Set("Content-Disposition", "attachment; filename=\"sftpgo-backup.json\"")
  80. render.JSON(w, r, backup)
  81. return
  82. }
  83. var dump []byte
  84. if indent == "1" {
  85. dump, err = json.MarshalIndent(backup, "", " ")
  86. } else {
  87. dump, err = json.Marshal(backup)
  88. }
  89. if err == nil {
  90. err = os.WriteFile(outputFile, dump, 0600)
  91. }
  92. if err != nil {
  93. logger.Warn(logSender, "", "dumping data error: %v, output file: %#v", err, outputFile)
  94. sendAPIResponse(w, r, err, "", getRespStatus(err))
  95. return
  96. }
  97. logger.Debug(logSender, "", "dumping data completed, output file: %#v, error: %v", outputFile, err)
  98. sendAPIResponse(w, r, err, "Data saved", http.StatusOK)
  99. }
  100. func loadDataFromRequest(w http.ResponseWriter, r *http.Request) {
  101. r.Body = http.MaxBytesReader(w, r.Body, MaxRestoreSize)
  102. claims, err := getTokenClaims(r)
  103. if err != nil || claims.Username == "" {
  104. sendAPIResponse(w, r, err, "Invalid token claims", http.StatusBadRequest)
  105. return
  106. }
  107. _, scanQuota, mode, err := getLoaddataOptions(r)
  108. if err != nil {
  109. sendAPIResponse(w, r, err, "", http.StatusBadRequest)
  110. return
  111. }
  112. content, err := io.ReadAll(r.Body)
  113. if err != nil || len(content) == 0 {
  114. if len(content) == 0 {
  115. err = util.NewValidationError("request body is required")
  116. }
  117. sendAPIResponse(w, r, err, "", getRespStatus(err))
  118. return
  119. }
  120. if err := restoreBackup(content, "", scanQuota, mode, claims.Username, util.GetIPFromRemoteAddress(r.RemoteAddr), claims.Role); err != nil {
  121. sendAPIResponse(w, r, err, "", getRespStatus(err))
  122. }
  123. sendAPIResponse(w, r, err, "Data restored", http.StatusOK)
  124. }
  125. func loadData(w http.ResponseWriter, r *http.Request) {
  126. r.Body = http.MaxBytesReader(w, r.Body, maxRequestSize)
  127. claims, err := getTokenClaims(r)
  128. if err != nil || claims.Username == "" {
  129. sendAPIResponse(w, r, err, "Invalid token claims", http.StatusBadRequest)
  130. return
  131. }
  132. inputFile, scanQuota, mode, err := getLoaddataOptions(r)
  133. if err != nil {
  134. sendAPIResponse(w, r, err, "", http.StatusBadRequest)
  135. return
  136. }
  137. if !filepath.IsAbs(inputFile) {
  138. sendAPIResponse(w, r, fmt.Errorf("invalid input_file %#v: it must be an absolute path", inputFile), "", http.StatusBadRequest)
  139. return
  140. }
  141. fi, err := os.Stat(inputFile)
  142. if err != nil {
  143. sendAPIResponse(w, r, err, "", getRespStatus(err))
  144. return
  145. }
  146. if fi.Size() > MaxRestoreSize {
  147. sendAPIResponse(w, r, err, fmt.Sprintf("Unable to restore input file: %#v size too big: %v/%v bytes",
  148. inputFile, fi.Size(), MaxRestoreSize), http.StatusBadRequest)
  149. return
  150. }
  151. content, err := os.ReadFile(inputFile)
  152. if err != nil {
  153. sendAPIResponse(w, r, err, "", getRespStatus(err))
  154. return
  155. }
  156. if err := restoreBackup(content, inputFile, scanQuota, mode, claims.Username, util.GetIPFromRemoteAddress(r.RemoteAddr), claims.Role); err != nil {
  157. sendAPIResponse(w, r, err, "", getRespStatus(err))
  158. }
  159. sendAPIResponse(w, r, err, "Data restored", http.StatusOK)
  160. }
  161. func restoreBackup(content []byte, inputFile string, scanQuota, mode int, executor, ipAddress, role string) error {
  162. dump, err := dataprovider.ParseDumpData(content)
  163. if err != nil {
  164. return util.NewValidationError(fmt.Sprintf("unable to parse backup content: %v", err))
  165. }
  166. if err = RestoreRoles(dump.Roles, inputFile, mode, executor, ipAddress, role); err != nil {
  167. return err
  168. }
  169. if err = RestoreFolders(dump.Folders, inputFile, mode, scanQuota, executor, ipAddress, role); err != nil {
  170. return err
  171. }
  172. if err = RestoreGroups(dump.Groups, inputFile, mode, executor, ipAddress, role); err != nil {
  173. return err
  174. }
  175. if err = RestoreUsers(dump.Users, inputFile, mode, scanQuota, executor, ipAddress, role); err != nil {
  176. return err
  177. }
  178. if err = RestoreAdmins(dump.Admins, inputFile, mode, executor, ipAddress, role); err != nil {
  179. return err
  180. }
  181. if err = RestoreAPIKeys(dump.APIKeys, inputFile, mode, executor, ipAddress, role); err != nil {
  182. return err
  183. }
  184. if err = RestoreShares(dump.Shares, inputFile, mode, executor, ipAddress, role); err != nil {
  185. return err
  186. }
  187. if err = RestoreEventActions(dump.EventActions, inputFile, mode, executor, ipAddress, role); err != nil {
  188. return err
  189. }
  190. if err = RestoreEventRules(dump.EventRules, inputFile, mode, executor, ipAddress, role); err != nil {
  191. return err
  192. }
  193. logger.Debug(logSender, "", "backup restored, users: %d, folders: %d, admins: %d",
  194. len(dump.Users), len(dump.Folders), len(dump.Admins))
  195. return nil
  196. }
  197. func getLoaddataOptions(r *http.Request) (string, int, int, error) {
  198. var inputFile string
  199. var err error
  200. scanQuota := 0
  201. restoreMode := 0
  202. if _, ok := r.URL.Query()["input-file"]; ok {
  203. inputFile = strings.TrimSpace(r.URL.Query().Get("input-file"))
  204. }
  205. if _, ok := r.URL.Query()["scan-quota"]; ok {
  206. scanQuota, err = strconv.Atoi(r.URL.Query().Get("scan-quota"))
  207. if err != nil {
  208. err = fmt.Errorf("invalid scan_quota: %v", err)
  209. return inputFile, scanQuota, restoreMode, err
  210. }
  211. }
  212. if _, ok := r.URL.Query()["mode"]; ok {
  213. restoreMode, err = strconv.Atoi(r.URL.Query().Get("mode"))
  214. if err != nil {
  215. err = fmt.Errorf("invalid mode: %v", err)
  216. return inputFile, scanQuota, restoreMode, err
  217. }
  218. }
  219. return inputFile, scanQuota, restoreMode, err
  220. }
  221. // RestoreFolders restores the specified folders
  222. func RestoreFolders(folders []vfs.BaseVirtualFolder, inputFile string, mode, scanQuota int, executor, ipAddress, role string) error {
  223. for _, folder := range folders {
  224. folder := folder // pin
  225. f, err := dataprovider.GetFolderByName(folder.Name)
  226. if err == nil {
  227. if mode == 1 {
  228. logger.Debug(logSender, "", "loaddata mode 1, existing folder %#v not updated", folder.Name)
  229. continue
  230. }
  231. folder.ID = f.ID
  232. folder.Name = f.Name
  233. err = dataprovider.UpdateFolder(&folder, f.Users, f.Groups, executor, ipAddress, role)
  234. logger.Debug(logSender, "", "restoring existing folder %#v, dump file: %#v, error: %v", folder.Name, inputFile, err)
  235. } else {
  236. folder.Users = nil
  237. err = dataprovider.AddFolder(&folder, executor, ipAddress, role)
  238. logger.Debug(logSender, "", "adding new folder %#v, dump file: %#v, error: %v", folder.Name, inputFile, err)
  239. }
  240. if err != nil {
  241. return fmt.Errorf("unable to restore folder %#v: %w", folder.Name, err)
  242. }
  243. if scanQuota >= 1 {
  244. if common.QuotaScans.AddVFolderQuotaScan(folder.Name) {
  245. logger.Debug(logSender, "", "starting quota scan for restored folder: %#v", folder.Name)
  246. go doFolderQuotaScan(folder) //nolint:errcheck
  247. }
  248. }
  249. }
  250. return nil
  251. }
  252. // RestoreShares restores the specified shares
  253. func RestoreShares(shares []dataprovider.Share, inputFile string, mode int, executor,
  254. ipAddress, role string,
  255. ) error {
  256. for _, share := range shares {
  257. share := share // pin
  258. share.IsRestore = true
  259. s, err := dataprovider.ShareExists(share.ShareID, "")
  260. if err == nil {
  261. if mode == 1 {
  262. logger.Debug(logSender, "", "loaddata mode 1, existing share %#v not updated", share.ShareID)
  263. continue
  264. }
  265. share.ID = s.ID
  266. err = dataprovider.UpdateShare(&share, executor, ipAddress, role)
  267. logger.Debug(logSender, "", "restoring existing share %#v, dump file: %#v, error: %v", share.ShareID, inputFile, err)
  268. } else {
  269. err = dataprovider.AddShare(&share, executor, ipAddress, role)
  270. logger.Debug(logSender, "", "adding new share %#v, dump file: %#v, error: %v", share.ShareID, inputFile, err)
  271. }
  272. if err != nil {
  273. return fmt.Errorf("unable to restore share %#v: %w", share.ShareID, err)
  274. }
  275. }
  276. return nil
  277. }
  278. // RestoreEventActions restores the specified event actions
  279. func RestoreEventActions(actions []dataprovider.BaseEventAction, inputFile string, mode int, executor, ipAddress, role string) error {
  280. for _, action := range actions {
  281. action := action // pin
  282. a, err := dataprovider.EventActionExists(action.Name)
  283. if err == nil {
  284. if mode == 1 {
  285. logger.Debug(logSender, "", "loaddata mode 1, existing event action %q not updated", a.Name)
  286. continue
  287. }
  288. action.ID = a.ID
  289. err = dataprovider.UpdateEventAction(&action, executor, ipAddress, role)
  290. logger.Debug(logSender, "", "restoring event action %q, dump file: %q, error: %v", action.Name, inputFile, err)
  291. } else {
  292. err = dataprovider.AddEventAction(&action, executor, ipAddress, role)
  293. logger.Debug(logSender, "", "adding new event action %q, dump file: %q, error: %v", action.Name, inputFile, err)
  294. }
  295. if err != nil {
  296. return fmt.Errorf("unable to restore event action %q: %w", action.Name, err)
  297. }
  298. }
  299. return nil
  300. }
  301. // RestoreEventRules restores the specified event rules
  302. func RestoreEventRules(rules []dataprovider.EventRule, inputFile string, mode int, executor, ipAddress, role string) error {
  303. for _, rule := range rules {
  304. rule := rule // pin
  305. r, err := dataprovider.EventRuleExists(rule.Name)
  306. if err == nil {
  307. if mode == 1 {
  308. logger.Debug(logSender, "", "loaddata mode 1, existing event rule %q not updated", r.Name)
  309. continue
  310. }
  311. rule.ID = r.ID
  312. err = dataprovider.UpdateEventRule(&rule, executor, ipAddress, role)
  313. logger.Debug(logSender, "", "restoring event rule %q, dump file: %q, error: %v", rule.Name, inputFile, err)
  314. } else {
  315. err = dataprovider.AddEventRule(&rule, executor, ipAddress, role)
  316. logger.Debug(logSender, "", "adding new event rule %q, dump file: %q, error: %v", rule.Name, inputFile, err)
  317. }
  318. if err != nil {
  319. return fmt.Errorf("unable to restore event rule %q: %w", rule.Name, err)
  320. }
  321. }
  322. return nil
  323. }
  324. // RestoreAPIKeys restores the specified API keys
  325. func RestoreAPIKeys(apiKeys []dataprovider.APIKey, inputFile string, mode int, executor, ipAddress, role string) error {
  326. for _, apiKey := range apiKeys {
  327. apiKey := apiKey // pin
  328. if apiKey.Key == "" {
  329. logger.Warn(logSender, "", "cannot restore empty API key")
  330. return fmt.Errorf("cannot restore an empty API key: %+v", apiKey)
  331. }
  332. k, err := dataprovider.APIKeyExists(apiKey.KeyID)
  333. if err == nil {
  334. if mode == 1 {
  335. logger.Debug(logSender, "", "loaddata mode 1, existing API key %#v not updated", apiKey.KeyID)
  336. continue
  337. }
  338. apiKey.ID = k.ID
  339. err = dataprovider.UpdateAPIKey(&apiKey, executor, ipAddress, role)
  340. logger.Debug(logSender, "", "restoring existing API key %#v, dump file: %#v, error: %v", apiKey.KeyID, inputFile, err)
  341. } else {
  342. err = dataprovider.AddAPIKey(&apiKey, executor, ipAddress, role)
  343. logger.Debug(logSender, "", "adding new API key %#v, dump file: %#v, error: %v", apiKey.KeyID, inputFile, err)
  344. }
  345. if err != nil {
  346. return fmt.Errorf("unable to restore API key %#v: %w", apiKey.KeyID, err)
  347. }
  348. }
  349. return nil
  350. }
  351. // RestoreAdmins restores the specified admins
  352. func RestoreAdmins(admins []dataprovider.Admin, inputFile string, mode int, executor, ipAddress, role string) error {
  353. for _, admin := range admins {
  354. admin := admin // pin
  355. a, err := dataprovider.AdminExists(admin.Username)
  356. if err == nil {
  357. if mode == 1 {
  358. logger.Debug(logSender, "", "loaddata mode 1, existing admin %#v not updated", a.Username)
  359. continue
  360. }
  361. admin.ID = a.ID
  362. admin.Username = a.Username
  363. err = dataprovider.UpdateAdmin(&admin, executor, ipAddress, role)
  364. logger.Debug(logSender, "", "restoring existing admin %#v, dump file: %#v, error: %v", admin.Username, inputFile, err)
  365. } else {
  366. err = dataprovider.AddAdmin(&admin, executor, ipAddress, role)
  367. logger.Debug(logSender, "", "adding new admin %#v, dump file: %#v, error: %v", admin.Username, inputFile, err)
  368. }
  369. if err != nil {
  370. return fmt.Errorf("unable to restore admin %#v: %w", admin.Username, err)
  371. }
  372. }
  373. return nil
  374. }
  375. // RestoreRoles restores the specified roles
  376. func RestoreRoles(roles []dataprovider.Role, inputFile string, mode int, executor, ipAddress, executorRole string) error {
  377. for _, role := range roles {
  378. role := role // pin
  379. r, err := dataprovider.RoleExists(role.Name)
  380. if err == nil {
  381. if mode == 1 {
  382. logger.Debug(logSender, "", "loaddata mode 1, existing role %q not updated", r.Name)
  383. continue
  384. }
  385. role.ID = r.ID
  386. err = dataprovider.UpdateRole(&role, executor, ipAddress, executorRole)
  387. logger.Debug(logSender, "", "restoring existing role: %q, dump file: %#v, error: %v", role.Name, inputFile, err)
  388. } else {
  389. err = dataprovider.AddRole(&role, executor, ipAddress, executorRole)
  390. logger.Debug(logSender, "", "adding new role: %q, dump file: %q, error: %v", role.Name, inputFile, err)
  391. }
  392. if err != nil {
  393. return fmt.Errorf("unable to restore role %#v: %w", role.Name, err)
  394. }
  395. }
  396. return nil
  397. }
  398. // RestoreGroups restores the specified groups
  399. func RestoreGroups(groups []dataprovider.Group, inputFile string, mode int, executor, ipAddress, role string) error {
  400. for _, group := range groups {
  401. group := group // pin
  402. g, err := dataprovider.GroupExists(group.Name)
  403. if err == nil {
  404. if mode == 1 {
  405. logger.Debug(logSender, "", "loaddata mode 1, existing group %#v not updated", g.Name)
  406. continue
  407. }
  408. group.ID = g.ID
  409. group.Name = g.Name
  410. err = dataprovider.UpdateGroup(&group, g.Users, executor, ipAddress, role)
  411. logger.Debug(logSender, "", "restoring existing group: %#v, dump file: %#v, error: %v", group.Name, inputFile, err)
  412. } else {
  413. err = dataprovider.AddGroup(&group, executor, ipAddress, role)
  414. logger.Debug(logSender, "", "adding new group: %#v, dump file: %#v, error: %v", group.Name, inputFile, err)
  415. }
  416. if err != nil {
  417. return fmt.Errorf("unable to restore group %#v: %w", group.Name, err)
  418. }
  419. }
  420. return nil
  421. }
  422. // RestoreUsers restores the specified users
  423. func RestoreUsers(users []dataprovider.User, inputFile string, mode, scanQuota int, executor, ipAddress, role string) error {
  424. for _, user := range users {
  425. user := user // pin
  426. u, err := dataprovider.UserExists(user.Username, "")
  427. if err == nil {
  428. if mode == 1 {
  429. logger.Debug(logSender, "", "loaddata mode 1, existing user %#v not updated", u.Username)
  430. continue
  431. }
  432. user.ID = u.ID
  433. user.Username = u.Username
  434. err = dataprovider.UpdateUser(&user, executor, ipAddress, role)
  435. logger.Debug(logSender, "", "restoring existing user: %#v, dump file: %#v, error: %v", user.Username, inputFile, err)
  436. if mode == 2 && err == nil {
  437. disconnectUser(user.Username)
  438. }
  439. } else {
  440. err = dataprovider.AddUser(&user, executor, ipAddress, role)
  441. logger.Debug(logSender, "", "adding new user: %#v, dump file: %#v, error: %v", user.Username, inputFile, err)
  442. }
  443. if err != nil {
  444. return fmt.Errorf("unable to restore user %#v: %w", user.Username, err)
  445. }
  446. if scanQuota == 1 || (scanQuota == 2 && user.HasQuotaRestrictions()) {
  447. if common.QuotaScans.AddUserQuotaScan(user.Username, user.Role) {
  448. logger.Debug(logSender, "", "starting quota scan for restored user: %#v", user.Username)
  449. go doUserQuotaScan(user) //nolint:errcheck
  450. }
  451. }
  452. }
  453. return nil
  454. }