E-mail et notifications
Le tiroir de notifications intégré à l'application de Kanera fonctionne sans configuration. Tout ce qui quitte le serveur (e-mail, push du navigateur et canaux de livraison personnels) nécessite une décision de votre part.
Configurer la messagerie
SMTP est facultatif, mais recommandé pour les invitations, les notifications, la vérification et l'utilisation opérationnelle.
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURITY=starttls
SMTP_PASSWORD=your-password
SMTP_FROM_NAME=Kanera
Un administrateur d'organisation peut également saisir les paramètres SMTP à partir de Paramètres -> Organisation -> Intégrations au lieu d'utiliser les valeurs d'environnement. La page des paramètres indique quelle source est utilisée.
Laissez la vérification des e-mails désactivée jusqu'à ce que le courrier sortant soit confirmé comme fonctionnant :
EMAIL_VERIFICATION_ENABLED=false
Une fois que le courrier électronique fonctionne, vous pouvez définir EMAIL_VERIFICATION_ENABLED=true pour exiger une vérification pour l'inscription, l'inscription par invitation et les modifications d'e-mail.
Notifications par courrier électronique
Une fois que SMTP fonctionne, les utilisateurs gèrent leur propre canal de messagerie et leurs préférences de messagerie par type depuis Paramètres du profil -> Notifications. Aucune autre configuration de serveur n'est nécessaire.
Poussée du navigateur
- Confirmez que Kanera est servi via HTTPS.
- Ouvert Paramètres -> Organisation -> Intégrations en tant qu'administrateur d'organisation.
- Activer Autoriser le push du navigateur pour cette organisation. Cela prépare également la configuration Web push partagée dont les navigateurs ont besoin avant que quiconque puisse s'abonner.
- Demandez aux utilisateurs qui souhaitent ouvrir des alertes push Paramètres du profil -> Notifications, activez Autoriser les notifications push, accordez l'autorisation au navigateur et choisissez leurs préférences push par type.
Push est spécifique à l’appareil et au navigateur. Un utilisateur qui souhaite des alertes sur plusieurs appareils doit activer le push depuis chaque navigateur ou PWA installé.
Le push est désactivé par défaut tant pour l'organisation que pour chaque utilisateur, mais c'est le canal qui mérite d'être encouragé : une alerte arrive pendant que le travail est en cours et ne laisse rien dans une boîte de réception par la suite. Voir Configuration.
Canaux de livraison personnels
Les utilisateurs peuvent envoyer leurs propres notifications à ntfy, Gotify ou à un webhook personnel sans aucune configuration de serveur, à condition que la destination soit accessible via HTTPS public.
Si vos utilisateurs exécutent ces services sur le réseau interne, autorisez les récepteurs privés :
KANERA_ALLOW_PRIVATE_NOTIFICATION_DESTINATIONS=true
Cela permet http:// et des adresses privées telles que le bouclage, RFC1918, CGNAT et IPv6 ULA. Les adresses de métadonnées lien-local et cloud, la multidiffusion et autres plages réservées restent bloquées. Laissez-le désactivé ou false pour exiger des destinations HTTPS publiques.
Un homelab ou un serveur interne ntfy ou Gotify est souvent la seule raison de l'auto-hébergement, c'est donc généralement le seul paramètre de notification qui mérite d'être modifié. La page des paramètres de notification indique à chaque utilisateur laquelle des deux stratégies est active. Voir Canaux de livraison personnelle.
Destinations de discussion
Les administrateurs de l'espace de travail peuvent publier l'activité des cartes dans Slack, Discord, Telegram ou Zulip depuis Paramètres de l'espace de travail -> Intégrations. Cela ne nécessite aucune configuration de serveur au-delà de l'accès HTTPS sortant.
Les destinations de discussion et les webhooks personnels stockent leurs informations d'identification cryptées avec SECRETS_ENCRYPTION_KEY. Réglez-le sur une valeur stable distincte de JWT_SECRET, et ne le modifiez pas une fois que les destinations existent. Voir Destinations de discussion.