api.go 8.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240
  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. })
  84. // users (admin permission required)
  85. r.Group("/users", func() {
  86. r.Get("/", wrap(SearchUsers))
  87. r.Get("/:id", wrap(GetUserById))
  88. r.Get("/:id/orgs", wrap(GetUserOrgList))
  89. r.Put("/:id", bind(m.UpdateUserCommand{}), wrap(UpdateUser))
  90. }, reqGrafanaAdmin)
  91. // org information available to all users.
  92. r.Group("/org", func() {
  93. r.Get("/", wrap(GetOrgCurrent))
  94. r.Get("/quotas", wrap(GetOrgQuotas))
  95. })
  96. // current org
  97. r.Group("/org", func() {
  98. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrgCurrent))
  99. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddressCurrent))
  100. r.Post("/users", quota("user"), bind(m.AddOrgUserCommand{}), wrap(AddOrgUserToCurrentOrg))
  101. r.Get("/users", wrap(GetOrgUsersForCurrentOrg))
  102. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUserForCurrentOrg))
  103. r.Delete("/users/:userId", wrap(RemoveOrgUserForCurrentOrg))
  104. // invites
  105. r.Get("/invites", wrap(GetPendingOrgInvites))
  106. r.Post("/invites", quota("user"), bind(dtos.AddInviteForm{}), wrap(AddOrgInvite))
  107. r.Patch("/invites/:code/revoke", wrap(RevokeInvite))
  108. // apps
  109. r.Get("/plugins", wrap(GetPluginList))
  110. r.Get("/plugins/:pluginId/settings", wrap(GetPluginSettingById))
  111. r.Post("/plugins/:pluginId/settings", bind(m.UpdatePluginSettingCmd{}), wrap(UpdatePluginSetting))
  112. }, reqOrgAdmin)
  113. // create new org
  114. r.Post("/orgs", quota("org"), bind(m.CreateOrgCommand{}), wrap(CreateOrg))
  115. // search all orgs
  116. r.Get("/orgs", reqGrafanaAdmin, wrap(SearchOrgs))
  117. // orgs (admin routes)
  118. r.Group("/orgs/:orgId", func() {
  119. r.Get("/", wrap(GetOrgById))
  120. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrg))
  121. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddress))
  122. r.Delete("/", wrap(DeleteOrgById))
  123. r.Get("/users", wrap(GetOrgUsers))
  124. r.Post("/users", bind(m.AddOrgUserCommand{}), wrap(AddOrgUser))
  125. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUser))
  126. r.Delete("/users/:userId", wrap(RemoveOrgUser))
  127. r.Get("/quotas", wrap(GetOrgQuotas))
  128. r.Put("/quotas/:target", bind(m.UpdateOrgQuotaCmd{}), wrap(UpdateOrgQuota))
  129. }, reqGrafanaAdmin)
  130. // orgs (admin routes)
  131. r.Group("/orgs/name/:name", func() {
  132. r.Get("/", wrap(GetOrgByName))
  133. }, reqGrafanaAdmin)
  134. // auth api keys
  135. r.Group("/auth/keys", func() {
  136. r.Get("/", wrap(GetApiKeys))
  137. r.Post("/", quota("api_key"), bind(m.AddApiKeyCommand{}), wrap(AddApiKey))
  138. r.Delete("/:id", wrap(DeleteApiKey))
  139. }, reqOrgAdmin)
  140. // Data sources
  141. r.Group("/datasources", func() {
  142. r.Get("/", GetDataSources)
  143. r.Post("/", quota("data_source"), bind(m.AddDataSourceCommand{}), AddDataSource)
  144. r.Put("/:id", bind(m.UpdateDataSourceCommand{}), UpdateDataSource)
  145. r.Delete("/:id", DeleteDataSource)
  146. r.Get("/:id", wrap(GetDataSourceById))
  147. r.Get("/plugins", GetDataSourcePlugins)
  148. }, reqOrgAdmin)
  149. r.Group("/datasources/name/:name", func() {
  150. r.Get("/", wrap(GetDataSourceByName))
  151. }, reqOrgAdmin)
  152. r.Get("/frontend/settings/", GetFrontendSettings)
  153. r.Any("/datasources/proxy/:id/*", reqSignedIn, ProxyDataSourceRequest)
  154. r.Any("/datasources/proxy/:id", reqSignedIn, ProxyDataSourceRequest)
  155. // Dashboard
  156. r.Group("/dashboards", func() {
  157. r.Combo("/db/:slug").Get(GetDashboard).Delete(DeleteDashboard)
  158. r.Post("/db", reqEditorRole, bind(m.SaveDashboardCommand{}), PostDashboard)
  159. r.Get("/file/:file", GetDashboardFromJsonFile)
  160. r.Get("/home", GetHomeDashboard)
  161. r.Get("/tags", GetDashboardTags)
  162. })
  163. // Dashboard snapshots
  164. r.Group("/dashboard/snapshots", func() {
  165. r.Get("/", wrap(SearchDashboardSnapshots))
  166. })
  167. // Playlist
  168. r.Group("/playlists", func() {
  169. r.Get("/", wrap(SearchPlaylists))
  170. r.Get("/:id", ValidateOrgPlaylist, wrap(GetPlaylist))
  171. r.Get("/:id/items", ValidateOrgPlaylist, wrap(GetPlaylistItems))
  172. r.Get("/:id/dashboards", ValidateOrgPlaylist, wrap(GetPlaylistDashboards))
  173. r.Delete("/:id", reqEditorRole, ValidateOrgPlaylist, wrap(DeletePlaylist))
  174. r.Put("/:id", reqEditorRole, bind(m.UpdatePlaylistCommand{}), ValidateOrgPlaylist, wrap(UpdatePlaylist))
  175. r.Post("/", reqEditorRole, bind(m.CreatePlaylistCommand{}), wrap(CreatePlaylist))
  176. })
  177. // Search
  178. r.Get("/search/", Search)
  179. // metrics
  180. r.Get("/metrics/test", GetTestMetrics)
  181. }, reqSignedIn)
  182. // admin api
  183. r.Group("/api/admin", func() {
  184. r.Get("/settings", AdminGetSettings)
  185. r.Post("/users", bind(dtos.AdminCreateUserForm{}), AdminCreateUser)
  186. r.Put("/users/:id/password", bind(dtos.AdminUpdateUserPasswordForm{}), AdminUpdateUserPassword)
  187. r.Put("/users/:id/permissions", bind(dtos.AdminUpdateUserPermissionsForm{}), AdminUpdateUserPermissions)
  188. r.Delete("/users/:id", AdminDeleteUser)
  189. r.Get("/users/:id/quotas", wrap(GetUserQuotas))
  190. r.Put("/users/:id/quotas/:target", bind(m.UpdateUserQuotaCmd{}), wrap(UpdateUserQuota))
  191. r.Get("/stats", AdminGetStats)
  192. }, reqGrafanaAdmin)
  193. // rendering
  194. r.Get("/render/*", reqSignedIn, RenderToPng)
  195. // Gravatar service.
  196. avt := avatar.CacheServer()
  197. r.Get("/avatar/:hash", avt.ServeHTTP)
  198. InitAppPluginRoutes(r)
  199. r.NotFound(NotFoundHandler)
  200. }