Services
Path: apps/api/src/config/services.ts
Single Sign-On
System supports Single Sign-On (SSO) using OpenID Connect. It is possible to configure multiple providers.
Refer to your OpenID Connect provider documentation for the required configuration values. Usually, you will need to register your application with the provider and obtain a client ID and client secret.
Issuer
Issuer URL of the OpenID Connect provider to be used for the discovery document / specification.
- object-path:
oidc[provider].issuer - dotenv var:
OIDC_{PROVIDER}_ISSUER - type:
string
Client ID
Client ID of the OpenID Connect provider.
- object-path:
oidc[provider].clientId - dotenv var:
OIDC_{PROVIDER}_CLIENT_ID - type:
string
Client Secret
Client secret of the OpenID Connect provider.
- object-path:
oidc[provider].clientSecret - dotenv var:
OIDC_{PROVIDER}_CLIENT_SECRET - type:
string
CAPTCHA
Password recovery and user generation can be protected by captcha services.
Implemented providers:
V2 (invisible) version is currently implemented.
Provider
Captcha provider to use. Captcha will be disabled if left empty.
- object-path:
captcha.provider - dotenv var:
CAPTCHA_PROVIDER - type:
h-captcha | re-captcha - default:
''
Secret key
- object-path:
captcha.secret - dotenv var:
CAPTCHA_SECRET - type:
string - default:
''
Communications
Provides email communications functionality via third-party providers.
Provider
Communications provider to use. Communications will be disabled if left empty.
- object-path:
comms.provider - dotenv var:
COMMS_PROVIDER - type:
string - default:
null
Email Blaster
Provides email communications via Email Blaster.
URL
Base URL for Email Blaster API.
- object-path:
comms.emailBlaster.url - dotenv var:
COMMS_EMAIL_BLASTER_URL - type:
string - default:
'https://api.emailblaster.cloud/2.0'
API key
API key for Email Blaster.
- object-path:
comms.emailBlaster.apiKey - dotenv var:
COMMS_EMAIL_BLASTER_API_KEY - type:
string - default:
''
Newsletter ID
Newsletter list ID for general communications.
- object-path:
comms.emailBlaster.lists.newsletter - dotenv var:
COMMS_EMAIL_BLASTER_NEWSLETTER - type:
string - default:
''
Support ID
Support list ID for support-related communications.
- object-path:
comms.emailBlaster.lists.support - dotenv var:
COMMS_EMAIL_BLASTER_SUPPORT - type:
string - default:
''
Web-push
Provides web-push functionality for supported browsers.
To enable the functionality, VAPID keys has to be generated.
pnpx web-push generate-vapid-keysSubject
- object-path:
webPush.subject - dotenv var:
WEBPUSH_SUBJECT - type:
string - default:
''
VAPID public key
- object-path:
webPush.publicKey - dotenv var:
WEBPUSH_PUBLIC_KEY - type:
string - default:
''
VAPID private key
- object-path:
webPush.privateKey - dotenv var:
WEBPUSH_PRIVATE_KEY - type:
string - default:
''