api.go 8.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237
  1. package api
  2. import (
  3. "github.com/go-macaron/binding"
  4. "github.com/grafana/grafana/pkg/api/avatar"
  5. "github.com/grafana/grafana/pkg/api/dtos"
  6. "github.com/grafana/grafana/pkg/middleware"
  7. m "github.com/grafana/grafana/pkg/models"
  8. "gopkg.in/macaron.v1"
  9. )
  10. // Register adds http routes
  11. func Register(r *macaron.Macaron) {
  12. reqSignedIn := middleware.Auth(&middleware.AuthOptions{ReqSignedIn: true})
  13. reqGrafanaAdmin := middleware.Auth(&middleware.AuthOptions{ReqSignedIn: true, ReqGrafanaAdmin: true})
  14. reqEditorRole := middleware.RoleAuth(m.ROLE_EDITOR, m.ROLE_ADMIN)
  15. reqOrgAdmin := middleware.RoleAuth(m.ROLE_ADMIN)
  16. quota := middleware.Quota
  17. bind := binding.Bind
  18. // not logged in views
  19. r.Get("/", reqSignedIn, Index)
  20. r.Get("/logout", Logout)
  21. r.Post("/login", quota("session"), bind(dtos.LoginCommand{}), wrap(LoginPost))
  22. r.Get("/login/:name", quota("session"), OAuthLogin)
  23. r.Get("/login", LoginView)
  24. r.Get("/invite/:code", Index)
  25. // authed views
  26. r.Get("/profile/", reqSignedIn, Index)
  27. r.Get("/org/", reqSignedIn, Index)
  28. r.Get("/org/new", reqSignedIn, Index)
  29. r.Get("/datasources/", reqSignedIn, Index)
  30. r.Get("/datasources/edit/*", reqSignedIn, Index)
  31. r.Get("/org/users/", reqSignedIn, Index)
  32. r.Get("/org/apikeys/", reqSignedIn, Index)
  33. r.Get("/dashboard/import/", reqSignedIn, Index)
  34. r.Get("/admin/settings", reqGrafanaAdmin, Index)
  35. r.Get("/admin/users", reqGrafanaAdmin, Index)
  36. r.Get("/admin/users/create", reqGrafanaAdmin, Index)
  37. r.Get("/admin/users/edit/:id", reqGrafanaAdmin, Index)
  38. r.Get("/admin/orgs", reqGrafanaAdmin, Index)
  39. r.Get("/admin/orgs/edit/:id", reqGrafanaAdmin, Index)
  40. r.Get("/admin/stats", reqGrafanaAdmin, Index)
  41. r.Get("/plugins", reqSignedIn, Index)
  42. r.Get("/plugins/:id/edit", reqSignedIn, Index)
  43. r.Get("/plugins/:id/page/:page", reqSignedIn, Index)
  44. r.Get("/dashboard/*", reqSignedIn, Index)
  45. r.Get("/dashboard-solo/*", reqSignedIn, Index)
  46. r.Get("/playlists/", reqSignedIn, Index)
  47. r.Get("/playlists/*", reqSignedIn, Index)
  48. // sign up
  49. r.Get("/signup", Index)
  50. r.Get("/api/user/signup/options", wrap(GetSignUpOptions))
  51. r.Post("/api/user/signup", quota("user"), bind(dtos.SignUpForm{}), wrap(SignUp))
  52. r.Post("/api/user/signup/step2", bind(dtos.SignUpStep2Form{}), wrap(SignUpStep2))
  53. // invited
  54. r.Get("/api/user/invite/:code", wrap(GetInviteInfoByCode))
  55. r.Post("/api/user/invite/complete", bind(dtos.CompleteInviteForm{}), wrap(CompleteInvite))
  56. // reset password
  57. r.Get("/user/password/send-reset-email", Index)
  58. r.Get("/user/password/reset", Index)
  59. r.Post("/api/user/password/send-reset-email", bind(dtos.SendResetPasswordEmailForm{}), wrap(SendResetPasswordEmail))
  60. r.Post("/api/user/password/reset", bind(dtos.ResetUserPasswordForm{}), wrap(ResetPassword))
  61. // dashboard snapshots
  62. r.Get("/dashboard/snapshot/*", Index)
  63. r.Get("/dashboard/snapshots/", reqSignedIn, Index)
  64. // api for dashboard snapshots
  65. r.Post("/api/snapshots/", bind(m.CreateDashboardSnapshotCommand{}), CreateDashboardSnapshot)
  66. r.Get("/api/snapshot/shared-options/", GetSharingOptions)
  67. r.Get("/api/snapshots/:key", GetDashboardSnapshot)
  68. r.Get("/api/snapshots-delete/:key", DeleteDashboardSnapshot)
  69. // api renew session based on remember cookie
  70. r.Get("/api/login/ping", quota("session"), LoginApiPing)
  71. // authed api
  72. r.Group("/api", func() {
  73. // user (signed in)
  74. r.Group("/user", func() {
  75. r.Get("/", wrap(GetSignedInUser))
  76. r.Put("/", bind(m.UpdateUserCommand{}), wrap(UpdateSignedInUser))
  77. r.Post("/using/:id", wrap(UserSetUsingOrg))
  78. r.Get("/orgs", wrap(GetSignedInUserOrgList))
  79. r.Post("/stars/dashboard/:id", wrap(StarDashboard))
  80. r.Delete("/stars/dashboard/:id", wrap(UnstarDashboard))
  81. r.Put("/password", bind(m.ChangeUserPasswordCommand{}), wrap(ChangeUserPassword))
  82. r.Get("/quotas", wrap(GetUserQuotas))
  83. r.Put("/prefs", bind(m.SavePreferencesCommand{}), wrap(SaveUserPreferences))
  84. })
  85. // users (admin permission required)
  86. r.Group("/users", func() {
  87. r.Get("/", wrap(SearchUsers))
  88. r.Get("/:id", wrap(GetUserById))
  89. r.Get("/:id/orgs", wrap(GetUserOrgList))
  90. r.Put("/:id", bind(m.UpdateUserCommand{}), wrap(UpdateUser))
  91. }, reqGrafanaAdmin)
  92. // org information available to all users.
  93. r.Group("/org", func() {
  94. r.Get("/", wrap(GetOrgCurrent))
  95. r.Get("/quotas", wrap(GetOrgQuotas))
  96. })
  97. // current org
  98. r.Group("/org", func() {
  99. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrgCurrent))
  100. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddressCurrent))
  101. r.Post("/users", quota("user"), bind(m.AddOrgUserCommand{}), wrap(AddOrgUserToCurrentOrg))
  102. r.Get("/users", wrap(GetOrgUsersForCurrentOrg))
  103. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUserForCurrentOrg))
  104. r.Delete("/users/:userId", wrap(RemoveOrgUserForCurrentOrg))
  105. // invites
  106. r.Get("/invites", wrap(GetPendingOrgInvites))
  107. r.Post("/invites", quota("user"), bind(dtos.AddInviteForm{}), wrap(AddOrgInvite))
  108. r.Patch("/invites/:code/revoke", wrap(RevokeInvite))
  109. // apps
  110. r.Get("/plugins", wrap(GetPluginList))
  111. r.Get("/plugins/:pluginId/settings", wrap(GetPluginSettingById))
  112. r.Post("/plugins/:pluginId/settings", bind(m.UpdatePluginSettingCmd{}), wrap(UpdatePluginSetting))
  113. }, reqOrgAdmin)
  114. // create new org
  115. r.Post("/orgs", quota("org"), bind(m.CreateOrgCommand{}), wrap(CreateOrg))
  116. // search all orgs
  117. r.Get("/orgs", reqGrafanaAdmin, wrap(SearchOrgs))
  118. // orgs (admin routes)
  119. r.Group("/orgs/:orgId", func() {
  120. r.Get("/", wrap(GetOrgById))
  121. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrg))
  122. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddress))
  123. r.Delete("/", wrap(DeleteOrgById))
  124. r.Get("/users", wrap(GetOrgUsers))
  125. r.Post("/users", bind(m.AddOrgUserCommand{}), wrap(AddOrgUser))
  126. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUser))
  127. r.Delete("/users/:userId", wrap(RemoveOrgUser))
  128. r.Get("/quotas", wrap(GetOrgQuotas))
  129. r.Put("/quotas/:target", bind(m.UpdateOrgQuotaCmd{}), wrap(UpdateOrgQuota))
  130. }, reqGrafanaAdmin)
  131. // orgs (admin routes)
  132. r.Group("/orgs/name/:name", func() {
  133. r.Get("/", wrap(GetOrgByName))
  134. }, reqGrafanaAdmin)
  135. // auth api keys
  136. r.Group("/auth/keys", func() {
  137. r.Get("/", wrap(GetApiKeys))
  138. r.Post("/", quota("api_key"), bind(m.AddApiKeyCommand{}), wrap(AddApiKey))
  139. r.Delete("/:id", wrap(DeleteApiKey))
  140. }, reqOrgAdmin)
  141. // Data sources
  142. r.Group("/datasources", func() {
  143. r.Get("/", GetDataSources)
  144. r.Post("/", quota("data_source"), bind(m.AddDataSourceCommand{}), AddDataSource)
  145. r.Put("/:id", bind(m.UpdateDataSourceCommand{}), UpdateDataSource)
  146. r.Delete("/:id", DeleteDataSource)
  147. r.Get("/:id", wrap(GetDataSourceById))
  148. r.Get("/plugins", GetDataSourcePlugins)
  149. }, reqOrgAdmin)
  150. r.Get("/frontend/settings/", GetFrontendSettings)
  151. r.Any("/datasources/proxy/:id/*", reqSignedIn, ProxyDataSourceRequest)
  152. r.Any("/datasources/proxy/:id", reqSignedIn, ProxyDataSourceRequest)
  153. // Dashboard
  154. r.Group("/dashboards", func() {
  155. r.Combo("/db/:slug").Get(GetDashboard).Delete(DeleteDashboard)
  156. r.Post("/db", reqEditorRole, bind(m.SaveDashboardCommand{}), PostDashboard)
  157. r.Get("/file/:file", GetDashboardFromJsonFile)
  158. r.Get("/home", GetHomeDashboard)
  159. r.Get("/tags", GetDashboardTags)
  160. })
  161. // Dashboard snapshots
  162. r.Group("/dashboard/snapshots", func() {
  163. r.Get("/", wrap(SearchDashboardSnapshots))
  164. })
  165. // Playlist
  166. r.Group("/playlists", func() {
  167. r.Get("/", wrap(SearchPlaylists))
  168. r.Get("/:id", ValidateOrgPlaylist, wrap(GetPlaylist))
  169. r.Get("/:id/items", ValidateOrgPlaylist, wrap(GetPlaylistItems))
  170. r.Get("/:id/dashboards", ValidateOrgPlaylist, wrap(GetPlaylistDashboards))
  171. r.Delete("/:id", reqEditorRole, ValidateOrgPlaylist, wrap(DeletePlaylist))
  172. r.Put("/:id", reqEditorRole, bind(m.UpdatePlaylistCommand{}), ValidateOrgPlaylist, wrap(UpdatePlaylist))
  173. r.Post("/", reqEditorRole, bind(m.CreatePlaylistCommand{}), wrap(CreatePlaylist))
  174. })
  175. // Search
  176. r.Get("/search/", Search)
  177. // metrics
  178. r.Get("/metrics/test", GetTestMetrics)
  179. }, reqSignedIn)
  180. // admin api
  181. r.Group("/api/admin", func() {
  182. r.Get("/settings", AdminGetSettings)
  183. r.Post("/users", bind(dtos.AdminCreateUserForm{}), AdminCreateUser)
  184. r.Put("/users/:id/password", bind(dtos.AdminUpdateUserPasswordForm{}), AdminUpdateUserPassword)
  185. r.Put("/users/:id/permissions", bind(dtos.AdminUpdateUserPermissionsForm{}), AdminUpdateUserPermissions)
  186. r.Delete("/users/:id", AdminDeleteUser)
  187. r.Get("/users/:id/quotas", wrap(GetUserQuotas))
  188. r.Put("/users/:id/quotas/:target", bind(m.UpdateUserQuotaCmd{}), wrap(UpdateUserQuota))
  189. r.Get("/stats", AdminGetStats)
  190. }, reqGrafanaAdmin)
  191. // rendering
  192. r.Get("/render/*", reqSignedIn, RenderToPng)
  193. // Gravatar service.
  194. avt := avatar.CacheServer()
  195. r.Get("/avatar/:hash", avt.ServeHTTP)
  196. InitAppPluginRoutes(r)
  197. r.NotFound(NotFoundHandler)
  198. }