Integration¶

Connecter Nextcloud et Mattermost avec l'ecosysteme interne — SSO, observabilité, forge logicielle et clients.

SSO via Keycloak (OIDC)¶

L'authentification centralisee evite aux utilisateurs de gérer des mots de passe distincts pour chaque service. Keycloak fournit le protocole OpenID Connect (OIDC) utilise par Nextcloud et Mattermost.

Créer les clients OIDC dans Keycloak¶

Dans le realm de votre organisation, creez deux clients :

Notez le Client Secret génère pour chaque client.

Configurer Nextcloud OIDC¶

Installez l'application user_oidc :

podman exec -u www-data nextcloud php occ app:install user_oidc

Configurez le provider :

podman exec -u www-data nextcloud php occ user_oidc:provider:create \
    --identifier="keycloak" \
    --clientid="nextcloud" \
    --clientsecret="VOTRE_SECRET_NC" \
    --discoveryuri="https://auth.example.com/realms/org/.well-known/openid-configuration" \
    --mapping-uid="preferred_username" \
    --mapping-displayname="name" \
    --mapping-email="email" \
    --unique-uid=1

podman exec -u www-data nextcloud php occ config:app:set user_oidc \
    allow_multiple_user_backends --value="0"

Configurer Mattermost OIDC¶

Ajoutez la configuration OpenID Connect dans le config.json de Mattermost ou via les variables d'environnement :

# Variables d'environnement supplementaires pour le docker-compose.yml
MM_OPENIDSETTINGS_ENABLE=true
MM_OPENIDSETTINGS_SECRET=VOTRE_SECRET_MM
MM_OPENIDSETTINGS_ID=mattermost
MM_OPENIDSETTINGS_DISCOVERYENDPOINT=https://auth.example.com/realms/org/.well-known/openid-configuration
MM_OPENIDSETTINGS_BUTTONTEXT=Se connecter avec Keycloak
MM_OPENIDSETTINGS_BUTTONCOLOR=#0067a5

Apres le redemarrage, un bouton "Se connecter avec Keycloak" apparait sur la page de login.

Integration Mattermost-Nextcloud¶

Partage de fichiers dans le chat¶

Le plugin Nextcloud for Mattermost permet de :

• Rechercher et partager des fichiers Nextcloud directement depuis un canal Mattermost
• Recevoir des notifications Mattermost quand un fichier Nextcloud est partage avec vous
• Previsualiser les liens Nextcloud dans les messages

Installation :

# Telecharger le plugin
curl -L -o nextcloud-plugin.tar.gz \
    "https://github.com/mattermost/mattermost-plugin-nextcloud/releases/latest/download/nextcloud-plugin.tar.gz"

# Installer via mmctl
podman exec mattermost mmctl plugin add /path/to/nextcloud-plugin.tar.gz
podman exec mattermost mmctl plugin enable com.mattermost.nextcloud

Configurez le plugin dans System Console > Plugins > Nextcloud :

Observabilité — Grafana¶

Metriques Nextcloud¶

Nextcloud expose des metriques via l'application serverinfo :

podman exec -u www-data nextcloud php occ app:install serverinfo

Endpoint de metriques :

GET https://cloud.example.com/ocs/v2.php/apps/serverinfo/api/v1/info?format=json
Authorization: Basic <admin_credentials>

Metriques disponibles :

Metriques Mattermost¶

Mattermost expose des metriques Prometheus nativement sur le port 8067 :

# Activer les metriques (variables d'environnement)
MM_METRICSSETTINGS_ENABLE=true
MM_METRICSSETTINGS_LISTENADDRESS=:8067

Configurez un scrape Prometheus :

# prometheus.yml (extrait)
scrape_configs:
  - job_name: mattermost
    static_configs:
      - targets: ["mattermost:8067"]

  - job_name: nextcloud
    static_configs:
      - targets: ["nextcloud-exporter:9205"]

Dashboard Grafana¶

Importez les dashboards depuis le catalogue Grafana :

DNS¶

Configurez les enregistrements DNS pour les trois sous-domaines :

cloud.example.com.   IN A     <IP_SERVEUR>
chat.example.com.    IN A     <IP_SERVEUR>
office.example.com.  IN A     <IP_SERVEUR>

Si vous utilisez un load balancer ou un CDN, utilisez des enregistrements CNAME vers le point d'entree.

Gitea — Webhooks vers Mattermost¶

Connectez votre forge logicielle a Mattermost pour recevoir les notifications de commits, pull requests et issues.

Webhook entrant dans Mattermost¶

1. Dans Mattermost, allez dans Integrations > Incoming Webhooks
2. Creez un webhook pour le canal #dev :
   • Display Name : Gitea
   • Description : Notifications Gitea
   • Channel : dev
3. Copiez l'URL du webhook

Webhook sortant dans Gitea¶

Dans chaque dépôt Gitea, configurez un webhook :

CalDAV — Synchronisation calendrier¶

Les calendriers Nextcloud sont accessibles via CalDAV par tout client compatible.

Thunderbird¶

iOS / macOS¶

DAVx5 (Android)¶

Installez DAVx5 depuis F-Droid, ajoutez un compte avec l'URL de base https://cloud.example.com et DAVx5 decouvre automatiquement les calendriers et contacts via le service discovery.

Applications mobiles¶

Nextcloud¶

Configuration :

1. Ouvrir l'app et entrer https://cloud.example.com
2. L'app redirige vers Keycloak pour le SSO
3. Autoriser l'accès et l'app se connecte automatiquement

Mattermost¶

Configuration :

1. Ouvrir l'app et entrer https://chat.example.com
2. Choisir "Se connecter avec Keycloak"
3. Les notifications push fonctionnent via le Push Proxy configure

Politiques de partage externe¶

Par defaut, les partages sont internes a l'organisation. Pour les cas necessitant un partage avec des externes :

Configurez ces politiques dans Nextcloud :

# Interdire les liens publics sans mot de passe
podman exec -u www-data nextcloud php occ config:app:set core \
    shareapi_enforce_links_password --value="yes"

# Expiration par defaut des partages par lien
podman exec -u www-data nextcloud php occ config:app:set core \
    shareapi_default_expire_date --value="yes"
podman exec -u www-data nextcloud php occ config:app:set core \
    shareapi_expire_after_n_days --value="7"

# Desactiver le partage avec des groupes non autorises
podman exec -u www-data nextcloud php occ config:app:set core \
    shareapi_only_share_with_group_members --value="yes"