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     videoChannels: {
 200       maxPerUser: CONFIG.VIDEO_CHANNELS.MAX_PER_USER
 201     },
 202     transcoding: {
 203       enabled: CONFIG.TRANSCODING.ENABLED,
 204       allowAdditionalExtensions: CONFIG.TRANSCODING.ALLOW_ADDITIONAL_EXTENSIONS,
 205       allowAudioFiles: CONFIG.TRANSCODING.ALLOW_AUDIO_FILES,
 206       threads: CONFIG.TRANSCODING.THREADS,
 207       concurrency: CONFIG.TRANSCODING.CONCURRENCY,
 208       profile: CONFIG.TRANSCODING.PROFILE,
 209       resolutions: {
 210         '0p': CONFIG.TRANSCODING.RESOLUTIONS['0p'],
 211         '144p': CONFIG.TRANSCODING.RESOLUTIONS['144p'],
 212         '240p': CONFIG.TRANSCODING.RESOLUTIONS['240p'],
 213         '360p': CONFIG.TRANSCODING.RESOLUTIONS['360p'],
 214         '480p': CONFIG.TRANSCODING.RESOLUTIONS['480p'],
 215         '720p': CONFIG.TRANSCODING.RESOLUTIONS['720p'],
 216         '1080p': CONFIG.TRANSCODING.RESOLUTIONS['1080p'],
 217         '1440p': CONFIG.TRANSCODING.RESOLUTIONS['1440p'],
 218         '2160p': CONFIG.TRANSCODING.RESOLUTIONS['2160p']
 219       },
 220       webtorrent: {
 221         enabled: CONFIG.TRANSCODING.WEBTORRENT.ENABLED
 222       },
 223       hls: {
 224         enabled: CONFIG.TRANSCODING.HLS.ENABLED
 225       }
 226     },
 227     live: {
 228       enabled: CONFIG.LIVE.ENABLED,
 229       allowReplay: CONFIG.LIVE.ALLOW_REPLAY,
 230       maxDuration: CONFIG.LIVE.MAX_DURATION,
 231       maxInstanceLives: CONFIG.LIVE.MAX_INSTANCE_LIVES,
 232       maxUserLives: CONFIG.LIVE.MAX_USER_LIVES,
 233       transcoding: {
 234         enabled: CONFIG.LIVE.TRANSCODING.ENABLED,
 235         threads: CONFIG.LIVE.TRANSCODING.THREADS,
 236         profile: CONFIG.LIVE.TRANSCODING.PROFILE,
 237         resolutions: {
 238           '144p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['144p'],
 239           '240p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['240p'],
 240           '360p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['360p'],
 241           '480p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['480p'],
 242           '720p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['720p'],
 243           '1080p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1080p'],
 244           '1440p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['1440p'],
 245           '2160p': CONFIG.LIVE.TRANSCODING.RESOLUTIONS['2160p']
 246         }
 247       }
 248     },
 249     import: {
 250       videos: {
 251         concurrency: CONFIG.IMPORT.VIDEOS.CONCURRENCY,
 252         http: {
 253           enabled: CONFIG.IMPORT.VIDEOS.HTTP.ENABLED
 254         },
 255         torrent: {
 256           enabled: CONFIG.IMPORT.VIDEOS.TORRENT.ENABLED
 257         }
 258       }
 259     },
 260     trending: {
 261       videos: {
 262         algorithms: {
 263           enabled: CONFIG.TRENDING.VIDEOS.ALGORITHMS.ENABLED,
 264           default: CONFIG.TRENDING.VIDEOS.ALGORITHMS.DEFAULT
 265         }
 266       }
 267     },
 268     autoBlacklist: {
 269       videos: {
 270         ofUsers: {
 271           enabled: CONFIG.AUTO_BLACKLIST.VIDEOS.OF_USERS.ENABLED
 272         }
 273       }
 274     },
 275     followers: {
 276       instance: {
 277         enabled: CONFIG.FOLLOWERS.INSTANCE.ENABLED,
 278         manualApproval: CONFIG.FOLLOWERS.INSTANCE.MANUAL_APPROVAL
 279       }
 280     },
 281     followings: {
 282       instance: {
 283         autoFollowBack: {
 284           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_BACK.ENABLED
 285         },
 286
 287         autoFollowIndex: {
 288           enabled: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.ENABLED,
 289           indexUrl: CONFIG.FOLLOWINGS.INSTANCE.AUTO_FOLLOW_INDEX.INDEX_URL
 290         }
 291       }
 292     },
 293     broadcastMessage: {
 294       enabled: CONFIG.BROADCAST_MESSAGE.ENABLED,
 295       message: CONFIG.BROADCAST_MESSAGE.MESSAGE,
 296       level: CONFIG.BROADCAST_MESSAGE.LEVEL,
 297       dismissable: CONFIG.BROADCAST_MESSAGE.DISMISSABLE
 298     },
 299     search: {
 300       remoteUri: {
 301         users: CONFIG.SEARCH.REMOTE_URI.USERS,
 302         anonymous: CONFIG.SEARCH.REMOTE_URI.ANONYMOUS
 303       },
 304       searchIndex: {
 305         enabled: CONFIG.SEARCH.SEARCH_INDEX.ENABLED,
 306         url: CONFIG.SEARCH.SEARCH_INDEX.URL,
 307         disableLocalSearch: CONFIG.SEARCH.SEARCH_INDEX.DISABLE_LOCAL_SEARCH,
 308         isDefaultSearch: CONFIG.SEARCH.SEARCH_INDEX.IS_DEFAULT_SEARCH
 309       }
 310     }
 311   }
 312 }
 313
 314 function convertCustomConfigBody (body: CustomConfig) {
 315   function keyConverter (k: string) {
 316     // Transcoding resolutions exception
 317     if (/^\d{3,4}p$/.exec(k)) return k
 318     if (k === '0p') return k
 319
 320     return snakeCase(k)
 321   }
 322
 323   function valueConverter (v: any) {
 324     if (validator.isNumeric(v + '')) return parseInt('' + v, 10)
 325
 326     return v
 327   }
 328
 329   return objectConverter(body, keyConverter, valueConverter)
 330 }