]> git.immae.eu Git - github/Chocobozzz/PeerTube.git/blame_incremental - server/controllers/api/users/index.ts
Merge branch 'release/v1.2.0'
[github/Chocobozzz/PeerTube.git] / server / controllers / api / users / index.ts
... / ...
CommitLineData
1import * as express from 'express'
2import * as RateLimit from 'express-rate-limit'
3import { UserCreate, UserRight, UserRole, UserUpdate } from '../../../../shared'
4import { logger } from '../../../helpers/logger'
5import { getFormattedObjects } from '../../../helpers/utils'
6import { CONFIG, RATES_LIMIT, sequelizeTypescript } from '../../../initializers'
7import { Emailer } from '../../../lib/emailer'
8import { Redis } from '../../../lib/redis'
9import { createUserAccountAndChannel } from '../../../lib/user'
10import {
11 asyncMiddleware,
12 asyncRetryTransactionMiddleware,
13 authenticate,
14 ensureUserHasRight,
15 ensureUserRegistrationAllowed,
16 ensureUserRegistrationAllowedForIP,
17 paginationValidator,
18 setDefaultPagination,
19 setDefaultSort,
20 token,
21 userAutocompleteValidator,
22 usersAddValidator,
23 usersGetValidator,
24 usersRegisterValidator,
25 usersRemoveValidator,
26 usersSortValidator,
27 usersUpdateValidator
28} from '../../../middlewares'
29import {
30 usersAskResetPasswordValidator,
31 usersAskSendVerifyEmailValidator,
32 usersBlockingValidator,
33 usersResetPasswordValidator,
34 usersVerifyEmailValidator
35} from '../../../middlewares/validators'
36import { UserModel } from '../../../models/account/user'
37import { auditLoggerFactory, getAuditIdFromRes, UserAuditView } from '../../../helpers/audit-logger'
38import { meRouter } from './me'
39import { deleteUserToken } from '../../../lib/oauth-model'
40import { myBlocklistRouter } from './my-blocklist'
41import { myVideosHistoryRouter } from './my-history'
42import { myNotificationsRouter } from './my-notifications'
43import { Notifier } from '../../../lib/notifier'
44import { mySubscriptionsRouter } from './my-subscriptions'
45
46const auditLogger = auditLoggerFactory('users')
47
48const loginRateLimiter = new RateLimit({
49 windowMs: RATES_LIMIT.LOGIN.WINDOW_MS,
50 max: RATES_LIMIT.LOGIN.MAX,
51 delayMs: 0
52})
53
54const askSendEmailLimiter = new RateLimit({
55 windowMs: RATES_LIMIT.ASK_SEND_EMAIL.WINDOW_MS,
56 max: RATES_LIMIT.ASK_SEND_EMAIL.MAX,
57 delayMs: 0
58})
59
60const usersRouter = express.Router()
61usersRouter.use('/', myNotificationsRouter)
62usersRouter.use('/', mySubscriptionsRouter)
63usersRouter.use('/', myBlocklistRouter)
64usersRouter.use('/', myVideosHistoryRouter)
65usersRouter.use('/', meRouter)
66
67usersRouter.get('/autocomplete',
68 userAutocompleteValidator,
69 asyncMiddleware(autocompleteUsers)
70)
71
72usersRouter.get('/',
73 authenticate,
74 ensureUserHasRight(UserRight.MANAGE_USERS),
75 paginationValidator,
76 usersSortValidator,
77 setDefaultSort,
78 setDefaultPagination,
79 asyncMiddleware(listUsers)
80)
81
82usersRouter.post('/:id/block',
83 authenticate,
84 ensureUserHasRight(UserRight.MANAGE_USERS),
85 asyncMiddleware(usersBlockingValidator),
86 asyncMiddleware(blockUser)
87)
88usersRouter.post('/:id/unblock',
89 authenticate,
90 ensureUserHasRight(UserRight.MANAGE_USERS),
91 asyncMiddleware(usersBlockingValidator),
92 asyncMiddleware(unblockUser)
93)
94
95usersRouter.get('/:id',
96 authenticate,
97 ensureUserHasRight(UserRight.MANAGE_USERS),
98 asyncMiddleware(usersGetValidator),
99 getUser
100)
101
102usersRouter.post('/',
103 authenticate,
104 ensureUserHasRight(UserRight.MANAGE_USERS),
105 asyncMiddleware(usersAddValidator),
106 asyncRetryTransactionMiddleware(createUser)
107)
108
109usersRouter.post('/register',
110 asyncMiddleware(ensureUserRegistrationAllowed),
111 ensureUserRegistrationAllowedForIP,
112 asyncMiddleware(usersRegisterValidator),
113 asyncRetryTransactionMiddleware(registerUser)
114)
115
116usersRouter.put('/:id',
117 authenticate,
118 ensureUserHasRight(UserRight.MANAGE_USERS),
119 asyncMiddleware(usersUpdateValidator),
120 asyncMiddleware(updateUser)
121)
122
123usersRouter.delete('/:id',
124 authenticate,
125 ensureUserHasRight(UserRight.MANAGE_USERS),
126 asyncMiddleware(usersRemoveValidator),
127 asyncMiddleware(removeUser)
128)
129
130usersRouter.post('/ask-reset-password',
131 asyncMiddleware(usersAskResetPasswordValidator),
132 asyncMiddleware(askResetUserPassword)
133)
134
135usersRouter.post('/:id/reset-password',
136 asyncMiddleware(usersResetPasswordValidator),
137 asyncMiddleware(resetUserPassword)
138)
139
140usersRouter.post('/ask-send-verify-email',
141 askSendEmailLimiter,
142 asyncMiddleware(usersAskSendVerifyEmailValidator),
143 asyncMiddleware(askSendVerifyUserEmail)
144)
145
146usersRouter.post('/:id/verify-email',
147 asyncMiddleware(usersVerifyEmailValidator),
148 asyncMiddleware(verifyUserEmail)
149)
150
151usersRouter.post('/token',
152 loginRateLimiter,
153 token,
154 success
155)
156// TODO: Once https://github.com/oauthjs/node-oauth2-server/pull/289 is merged, implement revoke token route
157
158// ---------------------------------------------------------------------------
159
160export {
161 usersRouter
162}
163
164// ---------------------------------------------------------------------------
165
166async function createUser (req: express.Request, res: express.Response) {
167 const body: UserCreate = req.body
168 const userToCreate = new UserModel({
169 username: body.username,
170 password: body.password,
171 email: body.email,
172 nsfwPolicy: CONFIG.INSTANCE.DEFAULT_NSFW_POLICY,
173 autoPlayVideo: true,
174 role: body.role,
175 videoQuota: body.videoQuota,
176 videoQuotaDaily: body.videoQuotaDaily
177 })
178
179 const { user, account } = await createUserAccountAndChannel(userToCreate)
180
181 auditLogger.create(getAuditIdFromRes(res), new UserAuditView(user.toFormattedJSON()))
182 logger.info('User %s with its channel and account created.', body.username)
183
184 return res.json({
185 user: {
186 id: user.id,
187 account: {
188 id: account.id,
189 uuid: account.Actor.uuid
190 }
191 }
192 }).end()
193}
194
195async function registerUser (req: express.Request, res: express.Response) {
196 const body: UserCreate = req.body
197
198 const userToCreate = new UserModel({
199 username: body.username,
200 password: body.password,
201 email: body.email,
202 nsfwPolicy: CONFIG.INSTANCE.DEFAULT_NSFW_POLICY,
203 autoPlayVideo: true,
204 role: UserRole.USER,
205 videoQuota: CONFIG.USER.VIDEO_QUOTA,
206 videoQuotaDaily: CONFIG.USER.VIDEO_QUOTA_DAILY,
207 emailVerified: CONFIG.SIGNUP.REQUIRES_EMAIL_VERIFICATION ? false : null
208 })
209
210 const { user } = await createUserAccountAndChannel(userToCreate)
211
212 auditLogger.create(body.username, new UserAuditView(user.toFormattedJSON()))
213 logger.info('User %s with its channel and account registered.', body.username)
214
215 if (CONFIG.SIGNUP.REQUIRES_EMAIL_VERIFICATION) {
216 await sendVerifyUserEmail(user)
217 }
218
219 Notifier.Instance.notifyOnNewUserRegistration(user)
220
221 return res.type('json').status(204).end()
222}
223
224async function unblockUser (req: express.Request, res: express.Response, next: express.NextFunction) {
225 const user: UserModel = res.locals.user
226
227 await changeUserBlock(res, user, false)
228
229 return res.status(204).end()
230}
231
232async function blockUser (req: express.Request, res: express.Response, next: express.NextFunction) {
233 const user: UserModel = res.locals.user
234 const reason = req.body.reason
235
236 await changeUserBlock(res, user, true, reason)
237
238 return res.status(204).end()
239}
240
241function getUser (req: express.Request, res: express.Response, next: express.NextFunction) {
242 return res.json((res.locals.user as UserModel).toFormattedJSON())
243}
244
245async function autocompleteUsers (req: express.Request, res: express.Response, next: express.NextFunction) {
246 const resultList = await UserModel.autoComplete(req.query.search as string)
247
248 return res.json(resultList)
249}
250
251async function listUsers (req: express.Request, res: express.Response, next: express.NextFunction) {
252 const resultList = await UserModel.listForApi(req.query.start, req.query.count, req.query.sort, req.query.search)
253
254 return res.json(getFormattedObjects(resultList.data, resultList.total))
255}
256
257async function removeUser (req: express.Request, res: express.Response, next: express.NextFunction) {
258 const user: UserModel = res.locals.user
259
260 await user.destroy()
261
262 auditLogger.delete(getAuditIdFromRes(res), new UserAuditView(user.toFormattedJSON()))
263
264 return res.sendStatus(204)
265}
266
267async function updateUser (req: express.Request, res: express.Response, next: express.NextFunction) {
268 const body: UserUpdate = req.body
269 const userToUpdate = res.locals.user as UserModel
270 const oldUserAuditView = new UserAuditView(userToUpdate.toFormattedJSON())
271 const roleChanged = body.role !== undefined && body.role !== userToUpdate.role
272
273 if (body.email !== undefined) userToUpdate.email = body.email
274 if (body.emailVerified !== undefined) userToUpdate.emailVerified = body.emailVerified
275 if (body.videoQuota !== undefined) userToUpdate.videoQuota = body.videoQuota
276 if (body.videoQuotaDaily !== undefined) userToUpdate.videoQuotaDaily = body.videoQuotaDaily
277 if (body.role !== undefined) userToUpdate.role = body.role
278
279 const user = await userToUpdate.save()
280
281 // Destroy user token to refresh rights
282 if (roleChanged) await deleteUserToken(userToUpdate.id)
283
284 auditLogger.update(getAuditIdFromRes(res), new UserAuditView(user.toFormattedJSON()), oldUserAuditView)
285
286 // Don't need to send this update to followers, these attributes are not propagated
287
288 return res.sendStatus(204)
289}
290
291async function askResetUserPassword (req: express.Request, res: express.Response, next: express.NextFunction) {
292 const user = res.locals.user as UserModel
293
294 const verificationString = await Redis.Instance.setResetPasswordVerificationString(user.id)
295 const url = CONFIG.WEBSERVER.URL + '/reset-password?userId=' + user.id + '&verificationString=' + verificationString
296 await Emailer.Instance.addForgetPasswordEmailJob(user.email, url)
297
298 return res.status(204).end()
299}
300
301async function resetUserPassword (req: express.Request, res: express.Response, next: express.NextFunction) {
302 const user = res.locals.user as UserModel
303 user.password = req.body.password
304
305 await user.save()
306
307 return res.status(204).end()
308}
309
310async function sendVerifyUserEmail (user: UserModel) {
311 const verificationString = await Redis.Instance.setVerifyEmailVerificationString(user.id)
312 const url = CONFIG.WEBSERVER.URL + '/verify-account/email?userId=' + user.id + '&verificationString=' + verificationString
313 await Emailer.Instance.addVerifyEmailJob(user.email, url)
314 return
315}
316
317async function askSendVerifyUserEmail (req: express.Request, res: express.Response, next: express.NextFunction) {
318 const user = res.locals.user as UserModel
319
320 await sendVerifyUserEmail(user)
321
322 return res.status(204).end()
323}
324
325async function verifyUserEmail (req: express.Request, res: express.Response, next: express.NextFunction) {
326 const user = res.locals.user as UserModel
327 user.emailVerified = true
328
329 await user.save()
330
331 return res.status(204).end()
332}
333
334function success (req: express.Request, res: express.Response, next: express.NextFunction) {
335 res.end()
336}
337
338async function changeUserBlock (res: express.Response, user: UserModel, block: boolean, reason?: string) {
339 const oldUserAuditView = new UserAuditView(user.toFormattedJSON())
340
341 user.blocked = block
342 user.blockedReason = reason || null
343
344 await sequelizeTypescript.transaction(async t => {
345 await deleteUserToken(user.id, t)
346
347 await user.save({ transaction: t })
348 })
349
350 await Emailer.Instance.addUserBlockJob(user, block, reason)
351
352 auditLogger.update(getAuditIdFromRes(res), new UserAuditView(user.toFormattedJSON()), oldUserAuditView)
353}