Ga naar de hoofdinhoud

E-mail en meldingen

De in-app-meldingenlade van Kanera werkt zonder configuratie. Alles wat de server verlaat – e-mail, browserpush en kanalen voor persoonlijke bezorging – heeft een beslissing van u nodig.

E-mail configureren​

SMTP is optioneel, maar aanbevolen voor uitnodigingen, meldingen, verificatie en operationeel gebruik.

SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURITY=starttls
[email protected]
SMTP_PASSWORD=your-password
[email protected]
SMTP_FROM_NAME=Kanera

Een organisatiebeheerder kan ook SMTP-instellingen invoeren vanuit Instellingen -> Organisatie -> Integraties in plaats van omgevingswaarden te gebruiken. Op de instellingenpagina wordt aangegeven welke bron in gebruik is.

Laat e-mailverificatie uitgeschakeld totdat is bevestigd dat uitgaande e-mail werkt:

EMAIL_VERIFICATION_ENABLED=false

Nadat e-mail werkt, kunt u instellen EMAIL_VERIFICATION_ENABLED=true om verificatie te vereisen voor aanmelding, uitnodigingsaanmelding en e-mailwijzigingen.

E-mailmeldingen​

Zodra SMTP werkt, kunnen gebruikers hun eigen e-mailkanaal en e-mailvoorkeuren per type beheren Profielinstellingen -> Meldingen. Er is geen verdere serverconfiguratie nodig.

Browser-push​

  1. Bevestig dat Kanera wordt aangeboden via HTTPS.
  2. Openen Instellingen -> Organisatie -> Integraties als organisatiebeheerder.
  3. Inschakelen Sta browserpush toe voor deze organisatie. Dit bereidt ook de gedeelde web-push-configuratie voor die browsers nodig hebben voordat iemand zich kan abonneren.
  4. Vraag gebruikers die pushmeldingen willen openen Profielinstellingen -> Meldingen, inschakelen Sta pushmeldingen toe, verleen browsertoestemming en kies hun push-voorkeuren per type.

Instellingen voor persoonlijke meldingen nadat Kanera actief is.

Push is apparaat- en browserspecifiek. Een gebruiker die waarschuwingen op meerdere apparaten wil, moet push vanuit elke browser of geïnstalleerde PWA inschakelen.

Push staat standaard uit voor zowel de organisatie als iedere gebruiker, maar het is het kanaal wel aan te moedigen: er komt een alert binnen terwijl het werk actueel is en er blijft daarna niets in de inbox achter. Zie Configuratie.

Persoonlijke bezorgkanalen​

Gebruikers kunnen hun eigen meldingen naar ntfy, Gotify of een persoonlijke webhook sturen zonder enige serverconfiguratie, zolang de bestemming bereikbaar is via openbare HTTPS.

Als uw gebruikers deze services op het interne netwerk uitvoeren, staat u privéontvangers toe:

KANERA_ALLOW_PRIVATE_NOTIFICATION_DESTINATIONS=true

Dit maakt het mogelijk http:// en privéadressen zoals loopback, RFC1918, CGNAT en IPv6 ULA. Link-local en cloud metadata-adressen, multicast en andere gereserveerde bereiken blijven geblokkeerd. Laat het uitgeschakeld of false om openbare HTTPS-bestemmingen te vereisen.

Een homelab of interne ntfy- of Gotify-server is vaak de hele reden om zelf te hosten, dus dit is meestal de enige meldingsinstelling die het waard is om te veranderen. De pagina met meldingsinstellingen vertelt elke gebruiker welk van de twee beleidsregels actief is. Zie Persoonlijke bezorgkanalen.

Chatbestemmingen​

Workspace-beheerders kunnen kaartactiviteit posten in Slack, Discord, Telegram of Zulip Werkruimte-instellingen -> Integraties. Daarvoor is geen serverconfiguratie nodig behalve uitgaande HTTPS-toegang.

Chatbestemmingen en persoonlijke webhooks slaan hun inloggegevens versleuteld op SECRETS_ENCRYPTION_KEY. Stel deze in op een stabiele waarde die verschilt van JWT_SECRETen wijzig deze niet nadat bestemmingen bestaan. Zie Chatbestemmingen.