api.go 8.3 KB

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