api.go 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. package api
  2. import (
  3. "github.com/Unknwon/macaron"
  4. "github.com/grafana/grafana/pkg/api/dtos"
  5. "github.com/grafana/grafana/pkg/middleware"
  6. m "github.com/grafana/grafana/pkg/models"
  7. "github.com/macaron-contrib/binding"
  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.Post("/api/snapshots/", bind(m.CreateDashboardSnapshotCommand{}), CreateDashboardSnapshot)
  60. r.Get("/dashboard/snapshot/*", Index)
  61. r.Get("/api/snapshot/shared-options/", GetSharingOptions)
  62. r.Get("/api/snapshots/:key", GetDashboardSnapshot)
  63. r.Get("/api/snapshots-delete/:key", DeleteDashboardSnapshot)
  64. // api renew session based on remember cookie
  65. r.Get("/api/login/ping", quota("session"), LoginApiPing)
  66. // authed api
  67. r.Group("/api", func() {
  68. // user (signed in)
  69. r.Group("/user", func() {
  70. r.Get("/", wrap(GetSignedInUser))
  71. r.Put("/", bind(m.UpdateUserCommand{}), wrap(UpdateSignedInUser))
  72. r.Post("/using/:id", wrap(UserSetUsingOrg))
  73. r.Get("/orgs", wrap(GetSignedInUserOrgList))
  74. r.Post("/stars/dashboard/:id", wrap(StarDashboard))
  75. r.Delete("/stars/dashboard/:id", wrap(UnstarDashboard))
  76. r.Put("/password", bind(m.ChangeUserPasswordCommand{}), wrap(ChangeUserPassword))
  77. r.Get("/quotas", wrap(GetUserQuotas))
  78. })
  79. // users (admin permission required)
  80. r.Group("/users", func() {
  81. r.Get("/", wrap(SearchUsers))
  82. r.Get("/:id", wrap(GetUserById))
  83. r.Get("/:id/orgs", wrap(GetUserOrgList))
  84. r.Put("/:id", bind(m.UpdateUserCommand{}), wrap(UpdateUser))
  85. }, reqGrafanaAdmin)
  86. // org information available to all users.
  87. r.Group("/org", func() {
  88. r.Get("/", wrap(GetOrgCurrent))
  89. r.Get("/quotas", wrap(GetOrgQuotas))
  90. })
  91. // current org
  92. r.Group("/org", func() {
  93. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrgCurrent))
  94. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddressCurrent))
  95. r.Post("/users", quota("user"), bind(m.AddOrgUserCommand{}), wrap(AddOrgUserToCurrentOrg))
  96. r.Get("/users", wrap(GetOrgUsersForCurrentOrg))
  97. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUserForCurrentOrg))
  98. r.Delete("/users/:userId", wrap(RemoveOrgUserForCurrentOrg))
  99. // invites
  100. r.Get("/invites", wrap(GetPendingOrgInvites))
  101. r.Post("/invites", quota("user"), bind(dtos.AddInviteForm{}), wrap(AddOrgInvite))
  102. r.Patch("/invites/:code/revoke", wrap(RevokeInvite))
  103. // apps
  104. r.Get("/apps", wrap(GetOrgAppsList))
  105. r.Get("/apps/:appId/settings", wrap(GetAppSettingsById))
  106. r.Post("/apps/:appId/settings", bind(m.UpdateAppSettingsCmd{}), wrap(UpdateAppSettings))
  107. }, reqOrgAdmin)
  108. // create new org
  109. r.Post("/orgs", quota("org"), bind(m.CreateOrgCommand{}), wrap(CreateOrg))
  110. // search all orgs
  111. r.Get("/orgs", reqGrafanaAdmin, wrap(SearchOrgs))
  112. // orgs (admin routes)
  113. r.Group("/orgs/:orgId", func() {
  114. r.Get("/", wrap(GetOrgById))
  115. r.Put("/", bind(dtos.UpdateOrgForm{}), wrap(UpdateOrg))
  116. r.Put("/address", bind(dtos.UpdateOrgAddressForm{}), wrap(UpdateOrgAddress))
  117. r.Delete("/", wrap(DeleteOrgById))
  118. r.Get("/users", wrap(GetOrgUsers))
  119. r.Post("/users", bind(m.AddOrgUserCommand{}), wrap(AddOrgUser))
  120. r.Patch("/users/:userId", bind(m.UpdateOrgUserCommand{}), wrap(UpdateOrgUser))
  121. r.Delete("/users/:userId", wrap(RemoveOrgUser))
  122. r.Get("/quotas", wrap(GetOrgQuotas))
  123. r.Put("/quotas/:target", bind(m.UpdateOrgQuotaCmd{}), wrap(UpdateOrgQuota))
  124. }, reqGrafanaAdmin)
  125. // orgs (admin routes)
  126. r.Group("/orgs/name/:name", func() {
  127. r.Get("/", wrap(GetOrgByName))
  128. }, reqGrafanaAdmin)
  129. // auth api keys
  130. r.Group("/auth/keys", func() {
  131. r.Get("/", wrap(GetApiKeys))
  132. r.Post("/", quota("api_key"), bind(m.AddApiKeyCommand{}), wrap(AddApiKey))
  133. r.Delete("/:id", wrap(DeleteApiKey))
  134. }, reqOrgAdmin)
  135. // Data sources
  136. r.Group("/datasources", func() {
  137. r.Get("/", GetDataSources)
  138. r.Post("/", quota("data_source"), bind(m.AddDataSourceCommand{}), AddDataSource)
  139. r.Put("/:id", bind(m.UpdateDataSourceCommand{}), UpdateDataSource)
  140. r.Delete("/:id", DeleteDataSource)
  141. r.Get("/:id", wrap(GetDataSourceById))
  142. r.Get("/plugins", GetDataSourcePlugins)
  143. }, reqOrgAdmin)
  144. r.Get("/frontend/settings/", GetFrontendSettings)
  145. r.Any("/datasources/proxy/:id/*", reqSignedIn, ProxyDataSourceRequest)
  146. r.Any("/datasources/proxy/:id", reqSignedIn, ProxyDataSourceRequest)
  147. // Dashboard
  148. r.Group("/dashboards", func() {
  149. r.Combo("/db/:slug").Get(GetDashboard).Delete(DeleteDashboard)
  150. r.Post("/db", reqEditorRole, bind(m.SaveDashboardCommand{}), PostDashboard)
  151. r.Get("/file/:file", GetDashboardFromJsonFile)
  152. r.Get("/home", GetHomeDashboard)
  153. r.Get("/tags", GetDashboardTags)
  154. })
  155. // Playlist
  156. r.Group("/playlists", func() {
  157. r.Get("/", wrap(SearchPlaylists))
  158. r.Get("/:id", ValidateOrgPlaylist, wrap(GetPlaylist))
  159. r.Get("/:id/items", ValidateOrgPlaylist, wrap(GetPlaylistItems))
  160. r.Get("/:id/dashboards", ValidateOrgPlaylist, wrap(GetPlaylistDashboards))
  161. r.Delete("/:id", reqEditorRole, ValidateOrgPlaylist, wrap(DeletePlaylist))
  162. r.Put("/:id", reqEditorRole, bind(m.UpdatePlaylistQuery{}), ValidateOrgPlaylist, wrap(UpdatePlaylist))
  163. r.Post("/", reqEditorRole, bind(m.CreatePlaylistQuery{}), wrap(CreatePlaylist))
  164. })
  165. // Search
  166. r.Get("/search/", Search)
  167. // metrics
  168. r.Get("/metrics/test", GetTestMetrics)
  169. }, reqSignedIn)
  170. // admin api
  171. r.Group("/api/admin", func() {
  172. r.Get("/settings", AdminGetSettings)
  173. r.Post("/users", bind(dtos.AdminCreateUserForm{}), AdminCreateUser)
  174. r.Put("/users/:id/password", bind(dtos.AdminUpdateUserPasswordForm{}), AdminUpdateUserPassword)
  175. r.Put("/users/:id/permissions", bind(dtos.AdminUpdateUserPermissionsForm{}), AdminUpdateUserPermissions)
  176. r.Delete("/users/:id", AdminDeleteUser)
  177. r.Get("/users/:id/quotas", wrap(GetUserQuotas))
  178. r.Put("/users/:id/quotas/:target", bind(m.UpdateUserQuotaCmd{}), wrap(UpdateUserQuota))
  179. }, reqGrafanaAdmin)
  180. // rendering
  181. r.Get("/render/*", reqSignedIn, RenderToPng)
  182. InitApiPluginRoutes(r)
  183. r.NotFound(NotFoundHandler)
  184. }