config-loader.js 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549
  1. const debug = require('debug')('growi:service:ConfigLoader');
  2. const { envUtils } = require('growi-commons');
  3. const isSecurityEnv = require('../../lib/util/isSecurityEnv');
  4. const TYPES = {
  5. NUMBER: { parse: (v) => { return parseInt(v, 10) } },
  6. STRING: { parse: (v) => { return v } },
  7. BOOLEAN: { parse: (v) => { return envUtils.toBoolean(v) } },
  8. };
  9. /**
  10. * The following env vars are excluded because these are currently used before the configuration setup.
  11. * - MONGO_URI
  12. * - NODE_ENV
  13. * - PORT
  14. * - REDIS_URI
  15. * - SESSION_NAME
  16. * - PASSWORD_SEED
  17. * - SECRET_TOKEN
  18. *
  19. * The commented out item has not yet entered the migration work.
  20. * So, parameters of these are under consideration.
  21. */
  22. const ENV_VAR_NAME_TO_CONFIG_INFO = {
  23. FILE_UPLOAD: {
  24. ns: 'crowi',
  25. key: 'app:fileUploadType',
  26. type: TYPES.STRING,
  27. default: 'aws',
  28. },
  29. FILE_UPLOAD_USES_ONLY_ENV_VAR_FOR_FILE_UPLOAD_TYPE: {
  30. ns: 'crowi',
  31. key: 'app:useOnlyEnvVarForFileUploadType',
  32. type: TYPES.BOOLEAN,
  33. default: false,
  34. },
  35. // HACKMD_URI: {
  36. // ns: ,
  37. // key: ,
  38. // type: ,
  39. // default:
  40. // },
  41. // HACKMD_URI_FOR_SERVER: {
  42. // ns: ,
  43. // key: ,
  44. // type: ,
  45. // default:
  46. // },
  47. // PLANTUML_URI: {
  48. // ns: ,
  49. // key: ,
  50. // type: ,
  51. // default:
  52. // },
  53. // BLOCKDIAG_URI: {
  54. // ns: ,
  55. // key: ,
  56. // type: ,
  57. // default:
  58. // },
  59. // OAUTH_GOOGLE_CLIENT_ID: {
  60. // ns: 'crowi',
  61. // key: 'security:passport-google:clientId',
  62. // type: ,
  63. // default:
  64. // },
  65. // OAUTH_GOOGLE_CLIENT_SECRET: {
  66. // ns: 'crowi',
  67. // key: 'security:passport-google:clientSecret',
  68. // type: ,
  69. // default:
  70. // },
  71. // OAUTH_GOOGLE_CALLBACK_URI: {
  72. // ns: 'crowi',
  73. // key: 'security:passport-google:callbackUrl',
  74. // type: ,
  75. // default:
  76. // },
  77. // OAUTH_GITHUB_CLIENT_ID: {
  78. // ns: 'crowi',
  79. // key: 'security:passport-github:clientId',
  80. // type: ,
  81. // default:
  82. // },
  83. // OAUTH_GITHUB_CLIENT_SECRET: {
  84. // ns: 'crowi',
  85. // key: 'security:passport-github:clientSecret',
  86. // type: ,
  87. // default:
  88. // },
  89. // OAUTH_GITHUB_CALLBACK_URI: {
  90. // ns: 'crowi',
  91. // key: 'security:passport-github:callbackUrl',
  92. // type: ,
  93. // default:
  94. // },
  95. // OAUTH_TWITTER_CONSUMER_KEY: {
  96. // ns: 'crowi',
  97. // key: 'security:passport-twitter:consumerKey',
  98. // type: ,
  99. // default:
  100. // },
  101. // OAUTH_TWITTER_CONSUMER_SECRET: {
  102. // ns: 'crowi',
  103. // key: 'security:passport-twitter:consumerSecret',
  104. // type: ,
  105. // default:
  106. // },
  107. // OAUTH_TWITTER_CALLBACK_URI: {
  108. // ns: 'crowi',
  109. // key: 'security:passport-twitter:callbackUrl',
  110. // type: ,
  111. // default:
  112. // },
  113. DRAWIO_URI: {
  114. ns: 'crowi',
  115. key: 'app:drawioUri',
  116. type: TYPES.STRING,
  117. default: null,
  118. },
  119. NCHAN_URI: {
  120. ns: 'crowi',
  121. key: 'app:nchanUri',
  122. type: TYPES.STRING,
  123. default: null,
  124. },
  125. APP_SITE_URL: {
  126. ns: 'crowi',
  127. key: 'app:siteUrl',
  128. type: TYPES.STRING,
  129. default: null,
  130. },
  131. PUBLISH_OPEN_API: {
  132. ns: 'crowi',
  133. key: 'app:publishOpenAPI',
  134. type: TYPES.BOOLEAN,
  135. default: false,
  136. },
  137. S2SMSG_PUBSUB_SERVER_TYPE: {
  138. ns: 'crowi',
  139. key: 's2sMessagingPubsub:serverType',
  140. type: TYPES.STRING,
  141. default: null,
  142. },
  143. S2SMSG_PUBSUB_NCHAN_PUBLISH_PATH: {
  144. ns: 'crowi',
  145. key: 's2sMessagingPubsub:nchan:publishPath',
  146. type: TYPES.STRING,
  147. default: '/pubsub',
  148. },
  149. S2SMSG_PUBSUB_NCHAN_SUBSCRIBE_PATH: {
  150. ns: 'crowi',
  151. key: 's2sMessagingPubsub:nchan:subscribePath',
  152. type: TYPES.STRING,
  153. default: '/pubsub',
  154. },
  155. S2SMSG_PUBSUB_NCHAN_CHANNEL_ID: {
  156. ns: 'crowi',
  157. key: 's2sMessagingPubsub:nchan:channelId',
  158. type: TYPES.STRING,
  159. default: null,
  160. },
  161. S2CMSG_PUBSUB_CONNECTIONS_LIMIT: {
  162. ns: 'crowi',
  163. key: 's2cMessagingPubsub:connectionsLimit',
  164. type: TYPES.NUMBER,
  165. default: 5000,
  166. },
  167. S2CMSG_PUBSUB_CONNECTIONS_LIMIT_FOR_ADMIN: {
  168. ns: 'crowi',
  169. key: 's2cMessagingPubsub:connectionsLimitForAdmin',
  170. type: TYPES.NUMBER,
  171. default: 100,
  172. },
  173. S2CMSG_PUBSUB_CONNECTIONS_LIMIT_FOR_GUEST: {
  174. ns: 'crowi',
  175. key: 's2cMessagingPubsub:connectionsLimitForGuest',
  176. type: TYPES.NUMBER,
  177. default: 2000,
  178. },
  179. MAX_FILE_SIZE: {
  180. ns: 'crowi',
  181. key: 'app:maxFileSize',
  182. type: TYPES.NUMBER,
  183. default: Infinity,
  184. },
  185. FILE_UPLOAD_TOTAL_LIMIT: {
  186. ns: 'crowi',
  187. key: 'app:fileUploadTotalLimit',
  188. type: TYPES.NUMBER,
  189. default: Infinity,
  190. },
  191. FILE_UPLOAD_DISABLED: {
  192. ns: 'crowi',
  193. key: 'app:fileUploadDisabled',
  194. type: TYPES.BOOLEAN,
  195. default: false,
  196. },
  197. FILE_UPLOAD_LOCAL_USE_INTERNAL_REDIRECT: {
  198. ns: 'crowi',
  199. key: 'fileUpload:local:useInternalRedirect',
  200. type: TYPES.BOOLEAN,
  201. default: false,
  202. },
  203. FILE_UPLOAD_LOCAL_INTERNAL_REDIRECT_PATH: {
  204. ns: 'crowi',
  205. key: 'fileUpload:local:internalRedirectPath',
  206. type: TYPES.STRING,
  207. default: '/growi-internal/',
  208. },
  209. ELASTICSEARCH_URI: {
  210. ns: 'crowi',
  211. key: 'app:elasticsearchUri',
  212. type: TYPES.STRING,
  213. default: null,
  214. },
  215. ELASTICSEARCH_REQUEST_TIMEOUT: {
  216. ns: 'crowi',
  217. key: 'app:elasticsearchRequestTimeout',
  218. type: TYPES.NUMBER,
  219. default: 8000, // msec
  220. },
  221. SEARCHBOX_SSL_URL: {
  222. ns: 'crowi',
  223. key: 'app:searchboxSslUrl',
  224. type: TYPES.STRING,
  225. default: null,
  226. },
  227. MONGO_GRIDFS_TOTAL_LIMIT: {
  228. ns: 'crowi',
  229. key: 'gridfs:totalLimit',
  230. type: TYPES.NUMBER,
  231. default: null, // set null in default for backward compatibility
  232. // cz: Newer system respects FILE_UPLOAD_TOTAL_LIMIT.
  233. // If the default value of MONGO_GRIDFS_TOTAL_LIMIT is Infinity,
  234. // the system can't distinguish between "not specified" and "Infinity is specified".
  235. },
  236. FORCE_WIKI_MODE: {
  237. ns: 'crowi',
  238. key: 'security:wikiMode',
  239. type: TYPES.STRING,
  240. default: undefined,
  241. },
  242. SESSION_MAX_AGE: {
  243. ns: 'crowi',
  244. key: 'security:sessionMaxAge',
  245. type: TYPES.NUMBER,
  246. default: undefined,
  247. },
  248. USER_UPPER_LIMIT: {
  249. ns: 'crowi',
  250. key: 'security:userUpperLimit',
  251. type: TYPES.NUMBER,
  252. default: Infinity,
  253. },
  254. DISABLE_LINK_SHARING: {
  255. ns: 'crowi',
  256. key: 'security:disableSharing',
  257. type: TYPES.BOOLEAN,
  258. default: false,
  259. },
  260. LOCAL_STRATEGY_ENABLED: {
  261. ns: 'crowi',
  262. key: 'security:passport-local:isEnabled',
  263. type: TYPES.BOOLEAN,
  264. default: true,
  265. },
  266. LOCAL_STRATEGY_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS: {
  267. ns: 'crowi',
  268. key: 'security:passport-local:useOnlyEnvVarsForSomeOptions',
  269. type: TYPES.BOOLEAN,
  270. default: false,
  271. },
  272. SAML_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS: {
  273. ns: 'crowi',
  274. key: 'security:passport-saml:useOnlyEnvVarsForSomeOptions',
  275. type: TYPES.BOOLEAN,
  276. default: false,
  277. },
  278. SAML_ENABLED: {
  279. ns: 'crowi',
  280. key: 'security:passport-saml:isEnabled',
  281. type: TYPES.BOOLEAN,
  282. default: null,
  283. },
  284. SAML_ENTRY_POINT: {
  285. ns: 'crowi',
  286. key: 'security:passport-saml:entryPoint',
  287. type: TYPES.STRING,
  288. default: null,
  289. },
  290. SAML_CALLBACK_URI: {
  291. ns: 'crowi',
  292. key: 'security:passport-saml:callbackUrl',
  293. type: TYPES.STRING,
  294. default: null,
  295. },
  296. SAML_ISSUER: {
  297. ns: 'crowi',
  298. key: 'security:passport-saml:issuer',
  299. type: TYPES.STRING,
  300. default: null,
  301. },
  302. SAML_ATTR_MAPPING_ID: {
  303. ns: 'crowi',
  304. key: 'security:passport-saml:attrMapId',
  305. type: TYPES.STRING,
  306. default: null,
  307. },
  308. SAML_ATTR_MAPPING_USERNAME: {
  309. ns: 'crowi',
  310. key: 'security:passport-saml:attrMapUsername',
  311. type: TYPES.STRING,
  312. default: null,
  313. },
  314. SAML_ATTR_MAPPING_MAIL: {
  315. ns: 'crowi',
  316. key: 'security:passport-saml:attrMapMail',
  317. type: TYPES.STRING,
  318. default: null,
  319. },
  320. SAML_ATTR_MAPPING_FIRST_NAME: {
  321. ns: 'crowi',
  322. key: 'security:passport-saml:attrMapFirstName',
  323. type: TYPES.STRING,
  324. default: null,
  325. },
  326. SAML_ATTR_MAPPING_LAST_NAME: {
  327. ns: 'crowi',
  328. key: 'security:passport-saml:attrMapLastName',
  329. type: TYPES.STRING,
  330. default: null,
  331. },
  332. SAML_CERT: {
  333. ns: 'crowi',
  334. key: 'security:passport-saml:cert',
  335. type: TYPES.STRING,
  336. default: null,
  337. },
  338. SAML_ABLC_RULE: {
  339. ns: 'crowi',
  340. key: 'security:passport-saml:ABLCRule',
  341. type: TYPES.STRING,
  342. default: null,
  343. },
  344. S3_REFERENCE_FILE_WITH_RELAY_MODE: {
  345. ns: 'crowi',
  346. key: 'aws:referenceFileWithRelayMode',
  347. type: TYPES.BOOLEAN,
  348. default: false,
  349. },
  350. S3_LIFETIME_SEC_FOR_TEMPORARY_URL: {
  351. ns: 'crowi',
  352. key: 'aws:lifetimeSecForTemporaryUrl',
  353. type: TYPES.NUMBER,
  354. default: 120,
  355. },
  356. GCS_API_KEY_JSON_PATH: {
  357. ns: 'crowi',
  358. key: 'gcs:apiKeyJsonPath',
  359. type: TYPES.STRING,
  360. default: null,
  361. },
  362. GCS_BUCKET: {
  363. ns: 'crowi',
  364. key: 'gcs:bucket',
  365. type: TYPES.STRING,
  366. default: null,
  367. },
  368. GCS_UPLOAD_NAMESPACE: {
  369. ns: 'crowi',
  370. key: 'gcs:uploadNamespace',
  371. type: TYPES.STRING,
  372. default: null,
  373. },
  374. GCS_REFERENCE_FILE_WITH_RELAY_MODE: {
  375. ns: 'crowi',
  376. key: 'gcs:referenceFileWithRelayMode',
  377. type: TYPES.BOOLEAN,
  378. default: false,
  379. },
  380. GCS_USES_ONLY_ENV_VARS_FOR_SOME_OPTIONS: {
  381. ns: 'crowi',
  382. key: 'gcs:useOnlyEnvVarsForSomeOptions',
  383. type: TYPES.BOOLEAN,
  384. default: false,
  385. },
  386. GCS_LIFETIME_SEC_FOR_TEMPORARY_URL: {
  387. ns: 'crowi',
  388. key: 'gcs:lifetimeSecForTemporaryUrl',
  389. type: TYPES.NUMBER,
  390. default: 120,
  391. },
  392. PROMSTER_ENABLED: {
  393. ns: 'crowi',
  394. key: 'promster:isEnabled',
  395. type: TYPES.BOOLEAN,
  396. default: false,
  397. },
  398. PROMSTER_PORT: {
  399. ns: 'crowi',
  400. key: 'promster:port',
  401. type: TYPES.NUMBER,
  402. default: 7788,
  403. },
  404. GROWI_CLOUD_URI: {
  405. ns: 'crowi',
  406. key: 'app:growiCloudUri',
  407. type: TYPES.STRING,
  408. default: null,
  409. },
  410. SLACK_SIGNING_SECRET: {
  411. ns: 'crowi',
  412. key: 'slackbot:signingSecret',
  413. type: TYPES.STRING,
  414. default: null,
  415. },
  416. SLACK_BOT_TOKEN: {
  417. ns: 'crowi',
  418. key: 'slackbot:token',
  419. type: TYPES.STRING,
  420. default: null,
  421. },
  422. SLACK_INTEGRATION_PROXY_URI: {
  423. ns: 'crowi',
  424. key: 'slackbot:proxyServerUri',
  425. type: TYPES.STRING,
  426. default: null,
  427. },
  428. SLACK_BOT_TYPE: {
  429. ns: 'crowi',
  430. key: 'slackbot:currentBotType', // 'officialBot' || 'customBotWithoutProxy' || 'customBotWithProxy'
  431. },
  432. GROWI_APP_ID_FOR_GROWI_CLOUD: {
  433. ns: 'crowi',
  434. key: 'app:growiAppIdForCloud',
  435. type: TYPES.STRING,
  436. default: null,
  437. },
  438. DEFAULT_EMAIL_PUBLISHED: {
  439. ns: 'crowi',
  440. key: 'customize:isEmailPublishedForNewUser',
  441. type: TYPES.BOOLEAN,
  442. default: true,
  443. },
  444. };
  445. class ConfigLoader {
  446. constructor(configModel) {
  447. this.configModel = configModel;
  448. }
  449. /**
  450. * return a config object
  451. */
  452. async load() {
  453. const configFromDB = await this.loadFromDB();
  454. const configFromEnvVars = this.loadFromEnvVars();
  455. // merge defaults per ns
  456. const mergedConfigFromDB = {
  457. crowi: Object.assign(this.configModel.getDefaultCrowiConfigsObject(), configFromDB.crowi),
  458. markdown: Object.assign(this.configModel.getDefaultMarkdownConfigsObject(), configFromDB.markdown),
  459. notification: Object.assign(this.configModel.getDefaultNotificationConfigsObject(), configFromDB.notification),
  460. };
  461. // In getConfig API, only null is used as a value to indicate that a config is not set.
  462. // So, if a value loaded from the database is empty,
  463. // it is converted to null because an empty string is used as the same meaning in the config model.
  464. // By this processing, whether a value is loaded from the database or from the environment variable,
  465. // only null indicates a config is not set.
  466. for (const namespace of Object.keys(mergedConfigFromDB)) {
  467. for (const key of Object.keys(mergedConfigFromDB[namespace])) {
  468. if (mergedConfigFromDB[namespace][key] === '') {
  469. mergedConfigFromDB[namespace][key] = null;
  470. }
  471. }
  472. }
  473. return {
  474. fromDB: mergedConfigFromDB,
  475. fromEnvVars: configFromEnvVars,
  476. };
  477. }
  478. async loadFromDB() {
  479. const config = {};
  480. const docs = await this.configModel.find().exec();
  481. for (const doc of docs) {
  482. if (!config[doc.ns]) {
  483. config[doc.ns] = {};
  484. }
  485. config[doc.ns][doc.key] = JSON.parse(doc.value);
  486. }
  487. debug('ConfigLoader#loadFromDB', config);
  488. return config;
  489. }
  490. loadFromEnvVars() {
  491. const config = {};
  492. for (const ENV_VAR_NAME of Object.keys(ENV_VAR_NAME_TO_CONFIG_INFO)) {
  493. const configInfo = ENV_VAR_NAME_TO_CONFIG_INFO[ENV_VAR_NAME];
  494. if (config[configInfo.ns] === undefined) {
  495. config[configInfo.ns] = {};
  496. }
  497. if (process.env[ENV_VAR_NAME] === undefined) {
  498. config[configInfo.ns][configInfo.key] = configInfo.default;
  499. }
  500. else {
  501. config[configInfo.ns][configInfo.key] = configInfo.type.parse(process.env[ENV_VAR_NAME]);
  502. }
  503. }
  504. debug('ConfigLoader#loadFromEnvVars', config);
  505. return config;
  506. }
  507. /**
  508. * get config from the environment variables for display admin page
  509. *
  510. * **use this only admin home page.**
  511. */
  512. static getEnvVarsForDisplay(avoidSecurity = false) {
  513. const config = {};
  514. for (const ENV_VAR_NAME of Object.keys(ENV_VAR_NAME_TO_CONFIG_INFO)) {
  515. const configInfo = ENV_VAR_NAME_TO_CONFIG_INFO[ENV_VAR_NAME];
  516. if (process.env[ENV_VAR_NAME] === undefined) {
  517. continue;
  518. }
  519. if (isSecurityEnv(configInfo.key) && avoidSecurity) {
  520. continue;
  521. }
  522. config[ENV_VAR_NAME] = configInfo.type.parse(process.env[ENV_VAR_NAME]);
  523. }
  524. debug('ConfigLoader#getEnvVarsForDisplay', config);
  525. return config;
  526. }
  527. }
  528. module.exports = ConfigLoader;