AuthorizationManager.js 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244
  1. const { callbackify } = require('util')
  2. const { ObjectId } = require('mongodb')
  3. const CollaboratorsGetter = require('../Collaborators/CollaboratorsGetter')
  4. const CollaboratorsHandler = require('../Collaborators/CollaboratorsHandler')
  5. const ProjectGetter = require('../Project/ProjectGetter')
  6. const { User } = require('../../models/User')
  7. const PrivilegeLevels = require('./PrivilegeLevels')
  8. const TokenAccessHandler = require('../TokenAccess/TokenAccessHandler')
  9. const PublicAccessLevels = require('./PublicAccessLevels')
  10. const Errors = require('../Errors/Errors')
  11. function isRestrictedUser(userId, privilegeLevel, isTokenMember) {
  12. if (privilegeLevel === PrivilegeLevels.NONE) {
  13. return true
  14. }
  15. return (
  16. privilegeLevel === PrivilegeLevels.READ_ONLY && (isTokenMember || !userId)
  17. )
  18. }
  19. async function isRestrictedUserForProject(userId, projectId, token) {
  20. const privilegeLevel = await getPrivilegeLevelForProject(
  21. userId,
  22. projectId,
  23. token
  24. )
  25. const isTokenMember = await CollaboratorsHandler.promises.userIsTokenMember(
  26. userId,
  27. projectId
  28. )
  29. return isRestrictedUser(userId, privilegeLevel, isTokenMember)
  30. }
  31. async function getPublicAccessLevel(projectId) {
  32. if (!ObjectId.isValid(projectId)) {
  33. throw new Error('invalid project id')
  34. }
  35. // Note, the Project property in the DB is `publicAccesLevel`, without the second `s`
  36. const project = await ProjectGetter.promises.getProject(projectId, {
  37. publicAccesLevel: 1,
  38. })
  39. if (!project) {
  40. throw new Errors.NotFoundError(`no project found with id ${projectId}`)
  41. }
  42. return project.publicAccesLevel
  43. }
  44. /**
  45. * Get the privilege level that the user has for the project.
  46. *
  47. * @param userId - The id of the user that wants to access the project.
  48. * @param projectId - The id of the project to be accessed.
  49. * @param {Object} opts
  50. * @param {boolean} opts.ignoreSiteAdmin - Do not consider whether the user is
  51. * a site admin.
  52. * @param {boolean} opts.ignorePublicAccess - Do not consider the project is
  53. * publicly accessible.
  54. *
  55. * @returns {string|boolean} The privilege level. One of "owner",
  56. * "readAndWrite", "readOnly" or false.
  57. */
  58. async function getPrivilegeLevelForProject(
  59. userId,
  60. projectId,
  61. token,
  62. opts = {}
  63. ) {
  64. if (userId) {
  65. return getPrivilegeLevelForProjectWithUser(userId, projectId, token, opts)
  66. } else {
  67. return getPrivilegeLevelForProjectWithoutUser(projectId, token, opts)
  68. }
  69. }
  70. // User is present, get their privilege level from database
  71. async function getPrivilegeLevelForProjectWithUser(
  72. userId,
  73. projectId,
  74. token,
  75. opts = {}
  76. ) {
  77. const privilegeLevel = await CollaboratorsGetter.promises.getMemberIdPrivilegeLevel(
  78. userId,
  79. projectId
  80. )
  81. if (privilegeLevel && privilegeLevel !== PrivilegeLevels.NONE) {
  82. // The user has direct access
  83. return privilegeLevel
  84. }
  85. if (!opts.ignoreSiteAdmin) {
  86. const isAdmin = await isUserSiteAdmin(userId)
  87. if (isAdmin) {
  88. return PrivilegeLevels.OWNER
  89. }
  90. }
  91. if (!opts.ignorePublicAccess) {
  92. // Legacy public-access system
  93. // User is present (not anonymous), but does not have direct access
  94. const publicAccessLevel = await getPublicAccessLevel(projectId)
  95. if (publicAccessLevel === PublicAccessLevels.READ_ONLY) {
  96. return PrivilegeLevels.READ_ONLY
  97. }
  98. if (publicAccessLevel === PublicAccessLevels.READ_AND_WRITE) {
  99. return PrivilegeLevels.READ_AND_WRITE
  100. }
  101. }
  102. return PrivilegeLevels.NONE
  103. }
  104. // User is Anonymous, Try Token-based access
  105. async function getPrivilegeLevelForProjectWithoutUser(
  106. projectId,
  107. token,
  108. opts = {}
  109. ) {
  110. const publicAccessLevel = await getPublicAccessLevel(projectId)
  111. if (!opts.ignorePublicAccess) {
  112. if (publicAccessLevel === PublicAccessLevels.READ_ONLY) {
  113. // Legacy public read-only access for anonymous user
  114. return PrivilegeLevels.READ_ONLY
  115. }
  116. if (publicAccessLevel === PublicAccessLevels.READ_AND_WRITE) {
  117. // Legacy public read-write access for anonymous user
  118. return PrivilegeLevels.READ_AND_WRITE
  119. }
  120. }
  121. if (publicAccessLevel === PublicAccessLevels.TOKEN_BASED) {
  122. return getPrivilegeLevelForProjectWithToken(projectId, token)
  123. }
  124. // Deny anonymous user access
  125. return PrivilegeLevels.NONE
  126. }
  127. async function getPrivilegeLevelForProjectWithToken(projectId, token) {
  128. // Anonymous users can have read-only access to token-based projects,
  129. // while read-write access must be logged in,
  130. // unless the `enableAnonymousReadAndWriteSharing` setting is enabled
  131. const {
  132. isValidReadAndWrite,
  133. isValidReadOnly,
  134. } = await TokenAccessHandler.promises.validateTokenForAnonymousAccess(
  135. projectId,
  136. token
  137. )
  138. if (isValidReadOnly) {
  139. // Grant anonymous user read-only access
  140. return PrivilegeLevels.READ_ONLY
  141. }
  142. if (isValidReadAndWrite) {
  143. // Grant anonymous user read-and-write access
  144. return PrivilegeLevels.READ_AND_WRITE
  145. }
  146. // Deny anonymous access
  147. return PrivilegeLevels.NONE
  148. }
  149. async function canUserReadProject(userId, projectId, token) {
  150. const privilegeLevel = await getPrivilegeLevelForProject(
  151. userId,
  152. projectId,
  153. token
  154. )
  155. return [
  156. PrivilegeLevels.OWNER,
  157. PrivilegeLevels.READ_AND_WRITE,
  158. PrivilegeLevels.READ_ONLY,
  159. ].includes(privilegeLevel)
  160. }
  161. async function canUserWriteProjectContent(userId, projectId, token) {
  162. const privilegeLevel = await getPrivilegeLevelForProject(
  163. userId,
  164. projectId,
  165. token
  166. )
  167. return [PrivilegeLevels.OWNER, PrivilegeLevels.READ_AND_WRITE].includes(
  168. privilegeLevel
  169. )
  170. }
  171. async function canUserWriteProjectSettings(userId, projectId, token) {
  172. const privilegeLevel = await getPrivilegeLevelForProject(
  173. userId,
  174. projectId,
  175. token,
  176. { ignorePublicAccess: true }
  177. )
  178. return [PrivilegeLevels.OWNER, PrivilegeLevels.READ_AND_WRITE].includes(
  179. privilegeLevel
  180. )
  181. }
  182. async function canUserRenameProject(userId, projectId, token) {
  183. const privilegeLevel = await getPrivilegeLevelForProject(
  184. userId,
  185. projectId,
  186. token
  187. )
  188. return privilegeLevel === PrivilegeLevels.OWNER
  189. }
  190. async function canUserAdminProject(userId, projectId, token) {
  191. const privilegeLevel = await getPrivilegeLevelForProject(
  192. userId,
  193. projectId,
  194. token
  195. )
  196. return privilegeLevel === PrivilegeLevels.OWNER
  197. }
  198. async function isUserSiteAdmin(userId) {
  199. if (!userId) {
  200. return false
  201. }
  202. const user = await User.findOne({ _id: userId }, { isAdmin: 1 }).exec()
  203. return user != null && user.isAdmin === true
  204. }
  205. module.exports = {
  206. canUserReadProject: callbackify(canUserReadProject),
  207. canUserWriteProjectContent: callbackify(canUserWriteProjectContent),
  208. canUserWriteProjectSettings: callbackify(canUserWriteProjectSettings),
  209. canUserRenameProject: callbackify(canUserRenameProject),
  210. canUserAdminProject: callbackify(canUserAdminProject),
  211. getPrivilegeLevelForProject: callbackify(getPrivilegeLevelForProject),
  212. isRestrictedUser,
  213. isRestrictedUserForProject: callbackify(isRestrictedUserForProject),
  214. isUserSiteAdmin: callbackify(isUserSiteAdmin),
  215. promises: {
  216. canUserReadProject,
  217. canUserWriteProjectContent,
  218. canUserWriteProjectSettings,
  219. canUserRenameProject,
  220. canUserAdminProject,
  221. getPrivilegeLevelForProject,
  222. isRestrictedUserForProject,
  223. isUserSiteAdmin,
  224. },
  225. }