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