Rocket.Chat

A partir de Workspaces 2.2 ou du plugin Rocket.Chat

Rocket.Chat permet à Ametys d'offrir un système de discussions instantanées intégré aux espaces projets.

Il n'est pas possible d'utiliser un serveur Rocket.Chat existant et déjà utilisé par ailleurs (même par une autre instance d'Ametys), pour plusieurs raisons :
* la configuration des droits va être modifiée
* Ametys va créer automatiquement les utilisateurs à partir de leur adresse mail et cela doit être unique dans Rocket.Chat

Architecture

Selon le trafic attendu, il peut être conseillé d'installer Rocket.Chat sur une machine physique du réseau différente d'Ametys.

L'application Back-office Ametys doit pouvoir communiquer avec le serveur Rocket.Chat et inversement en http/https.

Les utilisateurs finaux des espaces projets doivent aussi pouvoir communiquer directement avec le serveur Rocket.Chat en http/https.

Si au moins le CMS Ametys ou un des sites est configuré en https alors le Rocket.Chat doit aussi être configuré en https.

Installation

Effectuer une installation Rocket.Chat standard mais refuser tous les liens avec le site Rocket.Chat officiel au moment de la configuration (service cloud est devenu obligatoire mais on peut annuler en suivant, pas d'enregistrement...).

Configuration

  • 1) Créer un utilisateur administrateur tout pouvoir qui sera utilisé pour créer les utilisateurs et les salons privés.
    Cet utilisateur sera visible dans les historiques de conversation, par exemple : L'utilisateur raf_utilisateur-local a été ajouté par admin.
  • 2) Dans les préférences de ce compte (être authentifié avec ce compte, et aller dans "Mon compte", "Jeton d'accès personnel"), créer un jeton d'accès personnel pour Ametys (sans authentification à double facteur) et conserver l'identifiant utilisateur et ce jeton pour le mettre dans la configuration Ametys

Attention, la regénération du token nécessite aussi de déactiver l'authentification à double facteur. Sinon vous pouvez supprimer et recréer le token, si vous l'avez perdu.

  • 2b) Dans les préférences de ce compte (être authentifié avec ce compte, et aller dans "Mon compte", "Sécurité"), désactiver l'authentification à deux facteurs.
  • 2c) Dans Administration/Submistription, il faut annuler la Starter plan, pour utiliser la version communautaire non limitée. (c'est tout en bas de la page subscription, cancel... )
  • 3) Administration/Paramètres/Disposition/CSS personnalisée
.avatar-image {
border-radius : 100px;
}
#react-user-card + div {
display: none !important;
}
#react-user-card + div .rcx-box {
display: none !important; 
}
#react-user-card .rcx-modal__backdrop {
z-index: -1;
}
.rcx-box.rcx-box--full.rcx-message-header__username {
  display: none;
}

*[data-qa-id="reply-directly"],
*[data-qa-id="reply-in-thread"],
*[data-qa-id="Reply_in_thread"],
*[data-qa-id="Forward_message"],
*[data-qa-id="mark-message-as-unread"],
*[data-id="Link"],
*[data-id="KaTeX"],
*[data-qa-id="audio-message"],
*[data-qa-id="video-message"],
button[title="More actions"],
*[data-id="KaTeX"] + hr,
*[data-key="copy"],
*[data-key="star-message"],
*[data-key="follow-message"],
*[data-key="mark-message-as-unread"],
*[data-key="permalink"],
*[data-qa-id="menu"] hr,
*[data-qa-id="menu"] [role="presentation"]:not(:last-child){
display: none !important;
}
  • 4) Administration/Paramètres/Disposition/Scripts personnalisés/Srcipt personnalisé pour les utilisateurs connectés
document.addEventListener('click', e => {
const url = (window.location != window.parent.location)
? document.referrer
: document.location.href,
memberCard = e.target.closest('.user-card-message')
if (memberCard) {
parent.postMessage({
evtname: 'user-card-click',
username: memberCard.parentNode.getAttribute('data-username'),
id: memberCard.parentNode.getAttribute('data-id')
}, url);
}
})

window.navigation.addEventListener("navigate", (event) => { 
    if (/.*(\?|&)msg=[^&]+/.test(event.destination.url)) 
    {
        parent.postMessage({eventName: "scrolling-to-message", data: { url : window.location.href }}, "*");
    }
})

window.addEventListener("popstate",  (event) => {
    parent.postMessage({eventName: "iframe-change", data: { url : window.location.href}}, "*");
});

window.addEventListener('keydown', (event) => {
  if (event.key === "Escape") {
    parent.postMessage({eventName: "escaped", data: { url : window.location.href}}, "*");
  }
});
  • 5) Dans Administration/Paramètres/Général : "Nombre non lu" ET "Nombre de messages non lus pour les messages privés", indiquer "tous les messages"
  • 5b) Dans Administration/Paramètres/Général : dans Rest API selon la version, Activer "Activer CORS" et dans "Origine de CORS" mettre l'URL de base des espaces projets exemple : "https://projects.ametys.io" ou "*"
  • 5c) Dans Administration/Paramètres/Général : Intégration Iframe, activer l'envoie et activer la reception. + Pour les deux mettre l'URL de base des espaces projets ou "*"
  • 5d) Dans Administration/Paramètres/Général : NPS : désactiver "Activer l'enquête NPS"
  • 5e) Dans Administration/Paramètres/Disposition/Interface utilisateur : choisir Use real name
  • 6) Dans Administration/Paramètres/Chargement de fichiers et désactiver la protection des fichiers chargés
  • 7) Dans Administration/Autorisation, profil "user" (cliquer sur 100 en bas de page pour avoir moins de pages), retirer tous les droits sauf les suivants (Attention la liste des droits est paginée sur de nombreuses pages)
    1. Créer des messages directs
    2. Supprimer son propre message (Delete Own Message)
    3. Mention @all
    4. Mention ici
    5. Afficher les messages directs
    6. Voir l'historique
    7. Voir le salon privé
  • 8) Dans Administration/Paramètres/Comptes, désactiver
    • l'authentification à deux facteurs
    • Le changement de profil
    • Le changement d'avatar
    • Le changement de nom
    • Le changement de username
    • Le changement de mot de passe
    • Le changement d'email
    • Préférence utilisateur par défaut
      • Désactiver l'économie de bande passante sur mobile

Nota bene : si vous installez Rocket.chat sur des espaces projets existants, il est recommandé de synchroniser les serveurs de discussion après installation (voir ici).

Retour en haut