server/controllers/api/config.ts

   1 import express from 'express'
   2 import { remove, writeJSON } from 'fs-extra'
   3 import { snakeCase } from 'lodash'
   4 import validator from 'validator'
   5 import { ServerConfigManager } from '@server/lib/server-config-manager'
   6 import { UserRight } from '../../../shared'
   7 import { About } from '../../../shared/models/server/about.model'
   8 import { CustomConfig } from '../../../shared/models/server/custom-config.model'
   9 import { auditLoggerFactory, CustomConfigAuditView, getAuditIdFromRes } from '../../helpers/audit-logger'
  10 import { objectConverter } from '../../helpers/core-utils'
  11 import { CONFIG, reloadConfig } from '../../initializers/config'
  12 import { ClientHtml } from '../../lib/client-html'
  13 import { asyncMiddleware, authenticate, ensureUserHasRight, openapiOperationDoc } from '../../middlewares'
  14 import { customConfigUpdateValidator, ensureConfigIsEditable } from '../../middlewares/validators/config'
  15
  16 const configRouter = express.Router()
  17
  18 const auditLogger = auditLoggerFactory('config')
  19
  20 configRouter.get('/',
  21   openapiOperationDoc({ operationId: 'getConfig' }),
  22   asyncMiddleware(getConfig)
  23 )
  24
  25 configRouter.get('/about',
  26   openapiOperationDoc({ operationId: 'getAbout' }),
  27   getAbout
  28 )
  29
  30 configRouter.get('/custom',
  31   openapiOperationDoc({ operationId: 'getCustomConfig' }),
  32   authenticate,
  33   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  34   getCustomConfig
  35 )
  36
  37 configRouter.put('/custom',
  38   openapiOperationDoc({ operationId: 'putCustomConfig' }),
  39   authenticate,
  40   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  41   ensureConfigIsEditable,
  42   customConfigUpdateValidator,
  43   asyncMiddleware(updateCustomConfig)
  44 )
  45
  46 configRouter.delete('/custom',
  47   openapiOperationDoc({ operationId: 'delCustomConfig' }),
  48   authenticate,
  49   ensureUserHasRight(UserRight.MANAGE_CONFIGURATION),
  50   ensureConfigIsEditable,
  51   asyncMiddleware(deleteCustomConfig)
  52 )
  53
  54 async function getConfig (req: express.Request, res: express.Response) {
  55   const json = await ServerConfigManager.Instance.getServerConfig(req.ip)
  56
  57   return res.json(json)
  58 }
  59
  60 function getAbout (req: express.Request, res: express.Response) {
  61   const about: About = {
  62     instance: {
  63       name: CONFIG.INSTANCE.NAME,
  64       shortDescription: CONFIG.INSTANCE.SHORT_DESCRIPTION,
  65       description: CONFIG.INSTANCE.DESCRIPTION,
  66       terms: CONFIG.INSTANCE.TERMS,
  67       codeOfConduct: CONFIG.INSTANCE.CODE_OF_CONDUCT,
  68
  69       hardwareInformation: CONFIG.INSTANCE.HARDWARE_INFORMATION,
  70
  71       creationReason: CONFIG.INSTANCE.CREATION_REASON,
  72       moderationInformation: CONFIG.INSTANCE.MODERATION_INFORMATION,
  73       administrator: CONFIG.INSTANCE.ADMINISTRATOR,
  74       maintenanceLifetime: CONFIG.INSTANCE.MAINTENANCE_LIFETIME,
  75       businessModel: CONFIG.INSTANCE.BUSINESS_MODEL,
  76
  77       languages: CONFIG.INSTANCE.LANGUAGES,
  78       categories: CONFIG.INSTANCE.CATEGORIES
  79     }
  80   }
  81
  82   return res.json(about)
  83 }
  84
  85 function getCustomConfig (req: express.Request, res: express.Response) {
  86   const data = customConfig()
  87
  88   return res.json(data)
  89 }
  90
  91 async function deleteCustomConfig (req: express.Request, res: express.Response) {
  92   await remove(CONFIG.CUSTOM_FILE)
  93
  94   auditLogger.delete(getAuditIdFromRes(res), new CustomConfigAuditView(customConfig()))
  95
  96   reloadConfig()
  97   ClientHtml.invalidCache()
  98
  99   const data = customConfig()
 100
 101   return res.json(data)
 102 }
 103
 104 async function updateCustomConfig (req: express.Request, res: express.Response) {
 105   const oldCustomConfigAuditKeys = new CustomConfigAuditView(customConfig())
 106
 107   // camelCase to snake_case key + Force number conversion
 108   const toUpdateJSON = convertCustomConfigBody(req.body)
 109
 110   await writeJSON(CONFIG.CUSTOM_FILE, toUpdateJSON, { spaces: 2 })
 111
 112   reloadConfig()
 113   ClientHtml.invalidCache()
 114
 115   const data = customConfig()
 116
 117   auditLogger.update(
 118     getAuditIdFromRes(res),
 119     new CustomConfigAuditView(data),
 120     oldCustomConfigAuditKeys
 121   )
 122
 123   return res.json(data)
 124 }
 125
 126 // ---------------------------------------------------------------------------
 127
 128 export {
 129   configRouter
 130 }
 131
 132 // ---------------------------------------------------------------------------
 133
 134 function customConfig (): CustomConfig {
 135   return {
 136     instance: {
 137       name: CONFIG.INSTANCE.NAME,
 138       shortDescription: CONFIG.INSTANCE.SHORT_DESCRIPTION,
 139       description: CONFIG.INSTANCE.DESCRIPTION,
 140       terms: CONFIG.INSTANCE.TERMS,
 141       codeOfConduct: CONFIG.INSTANCE.CODE_OF_CONDUCT,
 142
 143       creationReason: CONFIG.INSTANCE.CREATION_REASON,
 144       moderationInformation: CONFIG.INSTANCE.MODERATION_INFORMATION,
 145       administrator: CONFIG.INSTANCE.ADMINISTRATOR,
 146       maintenanceLifetime: CONFIG.INSTANCE.MAINTENANCE_LIFETIME,
 147       businessModel: CONFIG.INSTANCE.BUSINESS_MODEL,
 148       hardwareInformation: CONFIG.INSTANCE.HARDWARE_INFORMATION,
 149
 150       languages: CONFIG.INSTANCE.LANGUAGES,
 151       categories: CONFIG.INSTANCE.CATEGORIES,
 152
 153       isNSFW: CONFIG.INSTANCE.IS_NSFW,
 154       defaultNSFWPolicy: CONFIG.INSTANCE.DEFAULT_NSFW_POLICY,
 155
 156       defaultClientRoute: CONFIG.INSTANCE.DEFAULT_CLIENT_ROUTE,
 157
 158       customizations: {
 159         css: CONFIG.INSTANCE.CUSTOMIZATIONS.CSS,
 160         javascript: CONFIG.INSTANCE.CUSTOMIZATIONS.JAVASCRIPT
 161       }
 162     },
 163     theme: {
 164       default: CONFIG.THEME.DEFAULT
 165     },
 166     services: {
 167       twitter: {
 168         username: CONFIG.SERVICES.TWITTER.USERNAME,
 169         whitelisted: CONFIG.SERVICES.TWITTER.WHITELISTED
 170       }
 171     },
 172     cache: {
 173       previews: {
 174         size: CONFIG.CACHE.PREVIEWS.SIZE
 175       },
 176       captions: {
 177         size: CONFIG.CACHE.VIDEO_CAPTIONS.SIZE
 178       },
 179       torrents: {
 180         size: CONFIG.CACHE.TORRENTS.SIZE
 181       }
 182     },
 183     signup: {
 184       enabled: CONFIG.SIGNUP.ENABLED,
 185       limit: CONFIG.SIGNUP.LIMIT,
 186       requiresEmailVerification: CONFIG.SIGNUP.REQUIRES_EMAIL_VERIFICATION,
 187       minimumAge: CONFIG.SIGNUP.MINIMUM_AGE
 188     },
 189     admin: {
 190       email: CONFIG.ADMIN.EMAIL
 191     },
 192     contactForm: {
 193       enabled: CONFIG.CONTACT_FORM.ENABLED
 194     },
 195     user: {
 196       videoQuota: CONFIG.USER.VIDEO_QUOTA,
 197       videoQuotaDaily: CONFIG.USER.VIDEO_QUOTA_DAILY
 198     },
 199     transcoding: {
 200       enabled: CONFIG.TRANSCODING.ENABLED,
 201       allowAdditionalExtensions: CONFIG.TRANSCODING.ALLOW_ADDITIONAL_EXTENSIONS,
 202       allowAudioFiles: CONFIG.TRANSCODING.ALLOW_AUDIO_FILES,
 203       threads: CONFIG.TRANSCODING.THREADS,
 204       concurrency: CONFIG.TRANSCODING.CONCURRENCY,
 205       profile: CONFIG.TRANSCODING.PROFILE,
 206       resolutions: {
 207         '0p': CONFIG.TRANSCODING.RESOLUTIONS['0p'],
 208         '240p': CONFIG.TRANSCODING.RESOLUTIONS['240p'],
 209         '360p': CONFIG.TRANSCODING.RESOLUTIONS['360p'],
 210         '480p': CONFIG.TRANSCODING.RESOLUTIONS['480p'],
 211         '720p': CONFIG.TRANSCODING.RESOLUTIONS['720p'],
 212         '1080p': CONFIG.TRANSCODING.RESOLUTIONS['1080p'],
 213         '1440p': CONFIG.TRANSCODING.RESOLUTIONS['1440p'],
 214         '2160p': CONFIG.TRANSCODING.RESOLUTIONS['2160p']
 215       },
 216       webtorrent: {
 217         enabled: CONFIG.TRANSCODING.WEBTORRENT.ENABLED
 218       },
 219       hls: {
 220         enabled: CONFIG.TRANSCODING.HLS.ENABLED
 221       }
 222     },
 223     live: {
 224       enabled: CONFIG.LIVE.ENABLED,
 225       allowReplay: CONFIG.LIVE.ALLOW_REPLAY,
 226       maxDuration: CONFIG.LIVE.MAX_DURATION,
 227       maxInstanceLives: CONFIG.LIVE.MAX_INSTANCE_LIVES,
 228       maxUserLives: CONFIG.LIVE.MAX_USER_LIVES,
 229       transcoding: {
 230         enabled: CONFIG.LIVE.TRANSCODING.ENABLED,
 231         threads: CONFIG.LIVE.TRANSCODING.THREADS,
 232         profile: CONFIG.LIVE.TRANSCODING.PROFILE,
 233         resolutions: {
 234           '240p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['240p'],
 235           '360p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['360p'],
 236           '480p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['480p'],
 237           '720p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['720p'],
 238           '1080p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1080p'],
 239           '1440p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1440p'],
 240           '2160p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['2160p']
 241         }
 242       }
 243     },
 244     import: {
 245       videos: {
 246         concurrency: CONFIG.IMPORT.VIDEOS.CONCURRENCY,
 247         http: {
 248           enabled: CONFIG.IMPORT.VIDEOS.HTTP.ENABLED
 249         },
 250         torrent: {
 251           enabled: CONFIG.IMPORT.VIDEOS.TORRENT.ENABLED
 252         }
 253       }
 254     },
 255     trending: {
 256       videos: {
 257         algorithms: {
 258           enabled: CONFIG.TRENDING.VIDEOS.ALGORITHMS.ENABLED,
 259           default: CONFIG.TRENDING.VIDEOS.ALGORITHMS.DEFAULT
 260         }
 261       }
 262     },
 263     autoBlacklist: {
 264       videos: {
 265         ofUsers: {
 266           enabled: CONFIG.AUTO_BLACKLIST.VIDEOS.OF_USERS.ENABLED
 267         }
 268       }
 269     },
 270     followers: {
 271       instance: {
 272         enabled: CONFIG.FOLLOWERS.INSTANCE.ENABLED,
 273         manualApproval: CONFIG.FOLLOWERS.INSTANCE.MANUAL_APPROVAL
 274       }
 275     },
 276     followings: {
 277       instance: {
 278         autoFollowBack: {
 279           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_BACK.ENABLED
 280         },
 281
 282         autoFollowIndex: {
 283           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.ENABLED,
 284           indexUrl: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.INDEX_URL
 285         }
 286       }
 287     },
 288     broadcastMessage: {
 289       enabled: CONFIG.BROADCAST_MESSAGE.ENABLED,
 290       message: CONFIG.BROADCAST_MESSAGE.MESSAGE,
 291       level: CONFIG.BROADCAST_MESSAGE.LEVEL,
 292       dismissable: CONFIG.BROADCAST_MESSAGE.DISMISSABLE
 293     },
 294     search: {
 295       remoteUri: {
 296         users: CONFIG.SEARCH.REMOTE_URI.USERS,
 297         anonymous: CONFIG.SEARCH.REMOTE_URI.ANONYMOUS
 298       },
 299       searchIndex: {
 300         enabled: CONFIG.SEARCH.SEARCH_INDEX.ENABLED,
 301         url: CONFIG.SEARCH.SEARCH_INDEX.URL,
 302         disableLocalSearch: CONFIG.SEARCH.SEARCH_INDEX.DISABLE_LOCAL_SEARCH,
 303         isDefaultSearch: CONFIG.SEARCH.SEARCH_INDEX.IS_DEFAULT_SEARCH
 304       }
 305     }
 306   }
 307 }
 308
 309 function convertCustomConfigBody (body: CustomConfig) {
 310   function keyConverter (k: string) {
 311     // Transcoding resolutions exception
 312     if (/^\d{3,4}p$/.exec(k)) return k
 313     if (k === '0p') return k
 314
 315     return snakeCase(k)
 316   }
 317
 318   function valueConverter (v: any) {
 319     if (validator.isNumeric(v + '')) return parseInt('' + v, 10)
 320
 321     return v
 322   }
 323
 324   return objectConverter(body, keyConverter, valueConverter)
 325 }