Nextcloud on slash-root.fr

Nextcloud : Add-in Outlook pour l’envoi de gros fichiers par mail sans effort

Thu, 29 Sep 2022 08:00:31 +0200

Presentation

Il est possible d'installer un add-in au client lourd Microsoft Office 2019 pour y intégrer de nouvelles fonctionnalités avec Nextcloud.

Cet add-in permet :

D'upload automatiquement les fichiers vers Nextcloud et de générer un lien pour les destinataires dans le mail. Cela permet de pouvoir envoyer de très gros fichiers par mail sans les placer en pièce jointe.
De créer et partager un espace publique avec les destinataires pour qu'ils puissent y uploader des fichiers au lieu de les envoyer par pièce jointe.

Sur ces 2 fonctionnalités, il est possible de :

Définir une date d'expiration du lien.
Protéger les liens publiques par mot de passe.
Regrouper un ensemble de fichiers pour un même lien.
Personnaliser les messages qui seront inclus automatiquement dans le mail.

Pre-requis

Un compte sur un serveur Nextcloud (Testé avec un Nextcloud 24.0.5).
Un client lourd Outlook 2019 sous Windows.

Add-in

Information

Il existe plusieurs versions de cet add-in :

Free
Basic
Professional
Premium

Détails des différentes versions : https://nextcloud.com/outlook/

Ici, je vais utiliser la version Free. Cette version est limité à 50 utilisateurs.

Installation

Côté Nextcloud, il n'y a rien à faire 🙂

Sur le poste Windows, avec le client lourd Outlook 2019, télécharger l'add-in puis lancer son installation. Celle-ci est vraiment très brève.

Lien vers les add-ins : https://download.nextcloud.com/outlook/

Sur un Windows 10 64 bits, j'ai pris celui-ci : https://download.nextcloud.com/outlook/20190410/Setup_23117_x64_free.msi

Configuration

Au 1er lancement d'Outlook, il est demandé de renseigner les paramètres du compte Nextcloud à lié au client de messagerie.

Renseigner l'URL du serveur Nextcloud.

Ne surtout pas cliquer sur Connect.

Cliquer sur Manual login.

Renseigner les credentials du compte Nextcloud de l'utilisateur et Connect.

Maintenant, lors de la création d'un nouveau mail, un onglet Nextcloud est disponible. Celui-ci permet d'accéder aux fonctionnalités de l'add-in.

Ici dans la version Free :

L'envoi de fichier volumineux par mail avec génération d'un lien publique.
La création d'un espace partagé avec génération d'un lien publique.

Dans le menu Settings, il est possible de paramétrer l'add-in.

Par exemple :

L'activation ou non de la génération d'un mot de passe pour protéger l'URL.
La personnalisation du message généré dans le corps du mail qui sera ajouté automatiquement.

Appliquer pour valider les modifications.

Utilisation

Fichiers volumineux

Pour la 1ère fonctionnalité qui permet de partager un ou des fichiers volumineux sans les mettre en pièces jointes (en générant automatiquement un lien publique par le biais de Nextcloud) :

Lors de la rédaction d'un nouveau mail, sélectionner Upload files.

Sélectionner le ou les fichiers à partager.
(Recommandé) : Définir une date d'expiration du lien.
Valider avec le bouton Upload files.

Un message, dans le corps du mail, s'ajoute automatiquement pour indiquer :

Le lien publique pour accéder aux données.
Le mot de passe (si activé) pour accéder à la ressource.
La date d'expiration du lien.

Espace partagé

Pour la 2nde fonctionnalité qui permet la création d'un espace partagé avec les destinataires et en leurs donnant la possibilité d'upload leurs fichiers sans les joindre en retour par mail (en générant automatiquement un lien publique par le biais de Nextcloud) :

Lors de la rédaction d'un nouveau mail, sélectionner Share public folder.

(Recommandé) : Définir une date d'expiration du lien.
Valider avec le bouton Public share.

Tout comme pour l'envoi de fichiers volumineux, un message s'insère dans le corps du mail en indiquant les informations nécessaires pour les destinataires.

Recommandation

Une utilisation abusive, avec de très gros fichiers, peut provoquer une surcharge au point de vue stockage sur le serveur Nextcloud.

De ce fait, il est important de définir une purge régulière des fichiers envoyés.

Du point de vue serveur, les données sont organisées ce cette façon :

www-data@9938e68f8acd:/var/www/html/data/julien/files# tree -d -L 3
.
|-- Documents
|-- Outlook
| |-- Public-Share
| | `-- 20220928
| `-- Upload-Files
| `-- 20220928
|-- Photos
`-- Templates

8 directories

Attention à préserver les répertoires suivant :

Outlook
Public-Share
Upload-Files

On peut constater qu'un sous-répertoire est créé automatiquement avec la date du jour suivant la fonctionnalité employée. Ces dossiers datés peuvent être supprimés directement sur le serveur par le biais de script, crontab, etc...

Si cette méthode est employé :

Réindexer les fichiers dans la BDD de Nextcloud :

www-data@9938e68f8acd:/var/www/html# php occ files:scan --all
Starting scan for user 1 out of 2 (admin)
Starting scan for user 2 out of 2 (julien)
+---------+-------+--------------+
| Folders | Files | Elapsed time |
+---------+-------+--------------+
| 25 | 67 | 00:00:00 |
+---------+-------+--------------+

Docker Swarm : Stack Nextcloud

Thu, 18 Aug 2022 13:00:13 +0200

Changelog

22/08/2022 : Fix traefik headers as same origin, trusted proxy, redirectregex

Informations importantes

Nécéssite le stack pour traefik voir ici : /docker-swarm-stack-traefik/
Bien modifier ce qu'il faut dans le stack (voir commentaires)

Fichier stack.yml

version: '3.3'

services:

 mariadb:
 image: mariadb
 command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW --skip-innodb-read-only-compressed
 environment:
 # Indiquer les mots de passe souhaités
 MYSQL_ROOT_PASSWORD: MotDePasseTresSecure
 MYSQL_PASSWORD: MotDePasseTresSecure
 MYSQL_DATABASE: nextcloud
 MYSQL_USER: nextcloud
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock:ro
 - /etc/localtime:/etc/localtime:ro
 # Indiquer les volumes à monter. Si le volume est inexistant, il sera créé automatiquement. Attention si contexte de cluster (swarm), penser à placer une contrainte de label.
 - mariadb:/var/lib/mysql
 networks:
 - net
 deploy:
 #resources:
 #limits:
 #cpus: '0.50'
 #memory: 1024M
 #reservations:
 #cpus: '0.25'
 #memory: 512M
 placement:
 constraints:
 #- node.role == worker
 - node.labels.nextcloud_mariadb == true

 app:
 image: nextcloud
 environment:
 # Indiquer le mot de passe inscrit précédement
 MYSQL_PASSWORD: MotDePasseTresSecure
 MYSQL_DATABASE: nextcloud
 MYSQL_USER: nextcloud
 MYSQL_HOST: mariadb
 TRUSTED_PROXIES: traefik
 # Indiquer le domaine souhaité de l'application
 OVERWRITEHOST: nextcloud.example.com
 OVERWRITEPROTOCOL: https
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock:ro
 - /etc/localtime:/etc/localtime:ro
 # Indiquer les volumes à monter. Si le volume est inexistant, il sera créé automatiquement. Attention si contexte de cluster (swarm), penser à placer une contrainte de label.
 - nextcloud:/var/www/html
 networks:
 - net
 # Indispensable pour communiquer avec traefik
 - traefik-public
 deploy:
 #resources:
 #limits:
 #cpus: '0.50'
 #memory: 1024M
 #reservations:
 #cpus: '0.25'
 #memory: 512M
 placement:
 constraints:
 #- node.role == worker
 - node.labels.nextcloud_nextcloud == true
 labels:
 # Activation de traefik
 - traefik.enable=true
 - traefik.docker.network=traefik-public
 - traefik.constraint-label=traefik-public
 # Indiquer le domaine souhaité pour l'application
 - traefik.http.routers.nextcloud-http.rule=Host(`nextcloud.example.com`)
 - traefik.http.routers.nextcloud-http.entrypoints=http
 - traefik.http.routers.nextcloud-http.middlewares=https-redirect
 # Indiquer le domaine souhaité pour l'application
 - traefik.http.routers.nextcloud-https.rule=Host(`nextcloud.example.com`)
 - traefik.http.routers.nextcloud-https.entrypoints=https
 - traefik.http.routers.nextcloud-https.tls=true
 - traefik.http.routers.nextcloud-https.tls.certresolver=le
 # Middleware pour nextcloud
 - traefik.http.middlewares.nextcloud-redirectregex.redirectRegex.permanent=true
 - traefik.http.middlewares.nextcloud-redirectregex.redirectRegex.regex=https://(.*)/.well-known/(card|cal)dav
 - traefik.http.middlewares.nextcloud-redirectregex.redirectRegex.replacement=https://$${1}/remote.php/dav/
 - traefik.http.middlewares.hsts-headers.headers.stsSeconds=315360000
 - traefik.http.middlewares.hsts-headers.headers.stsPreload=true
 - traefik.http.middlewares.hsts-headers.headers.stsIncludeSubdomains=true
 - traefik.http.middlewares.hsts-headers.headers.customFrameOptionsValue=SAMEORIGIN
 - traefik.http.middlewares.hsts-headers.headers.sslRedirect=true
 - traefik.http.middlewares.hsts-headers.headers.forceSTSHeader=true
 - traefik.http.middlewares.hsts-headers.headers.referrerPolicy=same-origin
 - traefik.http.routers.nextcloud-https.middlewares=hsts-headers,nextcloud-redirectregex
 # Indiquer le port utiliser de l'application
 - traefik.http.services.nextcloud.loadbalancer.server.port=80

networks:
 net:
 driver: overlay
 attachable: true
 traefik-public:
 external: true

volumes:
 mariadb:
 driver: local
 nextcloud:
 driver: local

Déploiement

docker stack deploy -c stack.yml nextcloud

Nextcloud : Intégration d’une authentification SSO avec AD FS

Fri, 08 Jul 2022 12:00:33 +0200

Cet article fait office de PoC (Proof of Concept) sur la mise en place d'une authentification SSO (Single-Sign-On) à travers le service ADFS (Active Directory Federation Services) de Microsoft et l'application Open Source Nextcloud.

Cela va permettre aux utilisateurs de la plateforme Nextcloud de s'authentifier avec leur compte Active Directory en utilisant le protocole SAML dans des contextes réseaux totalement différents.

Environnement

Environnements déjà déployés :
- Nextcloud v24.0.2
- Contrôleur de domaine Windows Serveur 2019
Informations :
- Domaine AD : aukfood.lan
- Nom serveur AD : adfs-dev
- Domaine publique utilisé : example.com (remplace les parties floutées dans les captures d'écrans)
- URL Nextcloud : https://nc-dev.example.com
- Enregistrement DNS pour l'ADFS : adfs2-dev.example.com

Génération du certificat Let’s Encrypt

A effectuer sur le serveur Windows (Tous les services seront déployés sur le contrôleur de domaine) :

Installation de IIS en Powershell :

Install-WindowsFeature -name Web-Server -IncludeManagementTools

Faire un enregistrement de type A dans une zone DNS publique pour le serveur IIS :
```
adfs2-dev IN A xxx.xxx.xxx.xxx
```
Dans ce PoC, le domaine publique utilisé sera example.com.
Créer la racine du site web pour résoudre le challenge :
```
mkdir c:\inetpub\adfs2-dev.example.com
```
Créer un fichier index.html dans la racine du site web :
```
notepad c:\inetpub\adfs2-dev.example.com\index.html
```
Insérer le contenu suivant puis enregistrer :
```
Hello world
```
Ouvrir la console de Gestionnaire des services Internet (IIS).
Supprimer le site web par défaut.
Ajouter un nouveau site web :
Télécharger le client ACME pour Let's Encrypt ici : https://www.win-acme.com/

A l'heure actuelle, la dernière version : https://github.com/win-acme/win-acme/releases/download/v2.1.22.1267/win-acme.v2.1.22.1267.x64.pluggable.zip
Décompresser l'archive et déplacer le fichier Web_Config.xml à la racine du site web.
Redémarrer le site web.
Lancer une ligne de commandes et se positionner dans le répertoire préalablement extrait.
Exécuter wacs.exe :
Créer un nouveau certificat (Choix N).
Sélectionner le site ajouté au préalable dans IIS :
Peu importe si le certificat est de type wildcard ou non.
Le certificat est généré avec une tâche planifiée qui va renouveller le certificat automatiquement :
Une liaison https (vhost) a été automatiquement générée pour le site web :
Ce certificat est celui qui sera exploité par le service AD FS.

Exportation du certificat au format pfx

Re-lancer l'outil wacs.exe.
Faire le choix A (Manage renewals) :
Afficher les détails avec D, puis noter le .pfx password :

Ouvrir le dossier des certificats Let's Encrypt :

explorer C:\ProgramData\win-acme\acme-v02.api.letsencrypt.org\Certificates\

Sélectionner le certificat .pfx correspondant puis démarrer l'assistant d'importation du certificat au niveau de l'ordinateur local (Pour rappel : c'est le DC) :
Saisir le mot de passe de la clé privée (.pfx password noté au préalable) et cocher Marquer cette clé comme exportable :
Sélectionner automatiquement le magasin de certificats.
Terminer l'assistant d'importation du certificat.
Ouvrir la gestion des certificats de l'ordinateur local :
```
certlm.msc
```
Dans "Personnel\Certificats" (1), sélectionner le certificat préalablement importé (2). Dans "Toutes les tâches" (3), sélectionner "Exporter" (4) :
Il est maintenant possible d'exporter la clé privée du certificat :
Exporter toutes les propriétés étendues :
Saisir un mot de passe pour protéger la clé privée :
Spécifier le nom du fichier à exporter au format pfx.
Terminer l'assistant d'exportation du certificat.

Installation AD FS

Installer le service ADFS-Federation en Powershell :

Install-WindowsFeature -name ADFS-Federation -IncludeManagementTools

Créer la clé racine du service de distribution de clés en Powershell :
```
Add-KdsRootKey -EffectiveTime (Get-Date).AddHours(-10)
```
La configuration du service se fera en mode graphique à travers le gestionnaire de serveur servermanager.exe :
Créer le premier serveur de fédération dans une batterie de serveurs de fédération.
Importer le certificat préalablement exporté au format .pfx (1). Puis, entrer un nom pour le service FS (2) :
Spécifier un compte de service :
Une base de données SQL Server peut être exploitée. Dans ce PoC, une base de données interne Windows est utilisée.
Après examen des options, la configuration peut être lancée :
Redémarrer le serveur Windows.

Activer la page de login de l'ADFS en Powershell :

Set-AdfsProperties -EnableIdpInitiatedSignonPage $true

Tester la connexion : https://adfs2-dev.example.com/adfs/ls/IdpInitiatedSignon.aspx

Paramétrage Nextcloud

Se connecter en SSH sur le serveur Nextcloud et se positionner à la racine du projet web :
```
cd /var/www/nc-dev.example.com/www/
```

Installer l'application user_saml avec occ (A adapter selon le propriétaire du projet web) :

sudo -u nextcloud php8.0 occ app:install user_saml
# user_saml 5.0.2 installed
# user_saml enabled

Se connecter à l'interface web du Nextcloud en admin.
Se rendre dans "Paramètres" (1) / "Authentification SSO & SAML" (2). Puis "Utiliser l'authentification SAML intégrée" (3) :
Dans la partie "Général", entrer l'Attribut pour relier l'UID :
```
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn
```
C'est l'UPN du compte de l'utilisateur dans l'AD qui fera office de nom d'utilisateur au sein de l'instance Nextcloud.
Configurer les options IdP :
- Identifiant de l'entité IdP : http://adfs2-dev.example.com/adfs/services/trust
- URL cible du fournisseur d'identités à qui le fournisseur de service enverra la requête d'authentification : https://adfs2-dev.example.com/adfs/ls
Cliquer sur "Hide optional Identity Provider settings" pour accéder au champ Certificat public X.509 de l'IdP.
Sur le serveur Windows, ouvrir la console de gestion de l'ADFS :
```
%windir%\ADFS\Microsoft.IdentityServer.msc
```
Dans "Service" / "Certificats" (1), Afficher le certificat (2) utilisé pour la signature de jetons :
Dans l'onglet "Détails", copier dans un fichier :
Exporter au format : *X.509 encodé en base 64 (.cer)**
Spécifier un nom de fichier pour l'export.
Copier le contenu de ce fichier exporté au format .cer et le coller dans le champ Certificat public X.509 de l'IdP dans Nextcloud :
Mapper les attributs suivants au minimum :
- Attribut pour relier le nom d'utilisateur : http://schemas.microsoft.com/identity/claims/displayname
- Attribut pour relier l'adresse mail : http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
Télécharger le fichier metadata.xml :
Pour avoir la possibilité de garder l'authentification avec la base utilisateur interne de Nextcloud, cocher Autoriser l'utilisation de plusieurs systèmes d'authentification :

Bien vérifier l'enregistrement du paramétrage en quittant le menu "Authentification SSO & SAML" et en y revenant (Surtout sur le paramétrage du point précédent).

Paramétrage AD FS

Sur le serveur Windows, ouvrir la console de gestion de l'AD FS :
```
%windir%\ADFS\Microsoft.IdentityServer.msc
```
Ajouter une approbation de partie de confiance :
Prendre en charge les revendications.
Importer les données concernant la partie de confiance à partir du fichier metadata.xml téléchargé préalablement :
Saisir un nom pour cette approbation et éventuellement des notes.
Sélectionner une stratégie de contrôle d'accès. Dans ce PoC, tout le monde sera autorisé :
La partie de confiance a été configurée à l'aide du fichier metadata.xml fourni.
Editer la stratégie d'émission de revendication :
2 règles de revendication de transformations sont à ajouter au minimum :
- userPrincipalName
- Email
Le modèle de régle de revendication à suivre est : Envoyer les attributs LDAP en tant que revendications.
Règle userPrincipalName :
Règle Email :
Appliquer les 2 règles ajoutées.

Vérification de l’authentification

Se connecter à Nextcloud, et choisir de s'authentifier au travers une Connection SSO & SAML :
Utiliser un compte de l'Active Directory autoriser à se connecter à travers l'AD FS :
Congratulations !

Ressources en vrac

Nextcloud : Importer ses données de Google

Thu, 16 Jun 2022 08:00:16 +0200

Contexte

Il est possible de donner aux utilisateurs, un moyen de pouvoir importer plusieurs données de leur compte Google au sein de leur compte Nextcloud comme :

Les agendas
Les contacts
Les photos
Les fichiers

Pour se faire, plusieurs APIs Google vont être exploitées.

Google integration

Se connecter en admin sur l'interface web du Nextcloud.
Rechercher, télécharger, installer l'application Google integration.
Dans les Paramètres d'Administration, se rendre dans Comptes connectés (1). C'est à cet endroit qu'il va falloir renseigner l'ID Client et le Secret client (2) afin de pouvoir autoriser les utilisateurs à s'authentifier plus tard sur leur compte Google afin de procéder à l'importation de leur données dans leur espace Nextcloud.
Cliquer sur Paramètres de l'API Google (3) afin de créer une application OAuth Google et de récupérer les informations à renseigner (2) pour finaliser l'intégration de Google.
S'identifier avec un compte Google sur la Google Cloud Platform.

Ce compte Google sera exploité uniquement pour l'API Google.

Google Cloud Platform

Projet

Créer un nouveau Projet.
Nommer le projet (1). Puis, valider (2).

Consentement

Dans Ecran de consentement OAuth (1), définir le type d'utilisateur (2). Puis, valider (3).
Entrer le nom de l'application demandant l'autorisation (1) ainsi que l'adresse mail d'assistance (2).

Il est possible de spécifier un logo qui apparaitra sur la page de consentement lorsque l'utilisateur saisira ces informations de compte Google.
Tout en bas de la page, indiquer vos coordonnées de développeur. Puis Enregistrer et continuer.
Sur l'écran suivant, Enregistrer et continuer tout en bas de la page.
A ce stade le projet a un status de publication à l'état de Test. Il est nécessaire d'ajouter (1) les comptes Google (2) que les utilisateurs utiliseront pour les autoriser à utiliser ce projet. Puis, Enregistrer et continuer.
Un résumé de l'écran de consentement paramétré est afficher.

Identifiants

Maintenant, il faut générer des identifiants de type OAuth dans le projet Google Cloud Platform créé. Ceux-ci seront à renseigner par la suite dans le paramétrage de Nextcloud.

Dans le menu API et services à gauche, se rendre dans Identifiants (1). Créer des identifiants (2) de type ID client OAuth (3).
Renseigner le Type d'application (1). Indiquer un Nom (2) pour identifier le client dans la console Google Cloup Platform. Indiquer l'URI de redirection (3) autorisés. Cette URI est disponible dans l'interface Nextcloud vu précédemment, dans la parti Intégration de Google. Puis, Créer (4).
l'ID client et le code secret du client sont disponible.
Retourner sur l'interface web de Nextcloud dans la partie Intégration de Google. Puis, indiquer l'ID client (1) et le Secret client (2).

API

Toujours sur Google Cloud Platform, dans API et services, se rendre dans Bibliothèque.
Rechercher et activer les API suivantes :
- Google Drive API
- Google Calendar API
- Google People API
- Photos Library API

Nextcloud

Dorénavant, lorsqu'un utilisateur se connectera sur l'interface web de son Nextcloud, une section Migration de données (1) est disponible dans ses paramètres. Cela va permettre à l'utilisateur de connecter son compte Google (2) afin de migrer les données voulues vers son compte Nextcloud.

Une fois que l'utilisateur a connecté son compte Google et autorisé l'accès aux données à migrer, il suffit de sélectionner les éléments à importer.

Si aucune données n'est présente dans une des fonctionnalités Google, celle-ci ne sera pas proposée à l'import.

Nextcloud : Ajouter un calendrier Google privé (Sans credentials)

Thu, 09 Jun 2022 08:00:00 +0200

Contexte

Le but est d'ajouter un calendrier Google (Google Agenda) dans les calendriers d'un utilisateur Nextcloud.

Le calendrier Google restera privé et ne passera donc pas en publique.

De plus, il ne sera accessible qu'en lecture. C'est comme ça...

Attention : L'accès au calendrier ne se fera pas avec les credentials du compte mais à l'aide d'une URL secrète (A ne surtout pas diffuser).

Côté Google

Se connecter au compte Google à ajouter dans Nextcloud.
Dans la partie gauche de l'interface web, cliquer sur les 3 petits points à droite du calendrier à intégrer dans Nextcloud (1). Puis sélectionner Paramètres et partage (2).

Faire défiler jusqu'à la partie Intégrer l'agenda.
L'adresse secrète au format iCal est disponible (1). Afin de mettre cette adresse dans le presse-papier, cliquer sur l'icône "Copier" en bout de ligne (2).

En utilisant cette adresse secrète, il n'est pas obligatoire de rendre l'agenda publique. De ce fait, le calendrier Google restera privé. Attention toutefois, son accès se fait sans credentials mais uniquement en lecture seule.

Côté Nextcloud

Se connecter sur le compte Nextcloud qui doit bénificer de l'agenda Google et se rendre dans la section Agenda.
Ajouter un nouvel agenda (1). Puis, créer un nouvel abonnement par lien (2).

Coller l'adresse secrète récupérée précédemment. Puis, valider.

Un nouveau calendrier calendar.google.com a été ajouté en lecture seule. Il est possible de la renommer pour lui donner un nom plus explicite.

Taux de rafraîchissement

Le taux de rafraîchissement (refresh rate), d'une souscription à un calendrier dans Nextcloud, est d'une fois toutes les semaines par défaut.

https://docs.nextcloud.com/server/19/user_manual/pim/calendar.html

Subscriptions are refreshed every week by default. Your admin may have changed this setting.

Modifier le taux de rafraîchissement :

Se connecter avec un terminal en root à l'instance Nextcloud.

Se positionner à la racine du site Nextcloud.

cd /var/www/nextcloud.example.com/www/ # Par exemple

Obtenir le propriétaire du fichier config.php.

ls -l config/config.php
.rw-r----- nextcloud nextcloud 1.5 KB Wed May 25 10:17:35 2022 config/config.php

Modifier la valeur de l'option calendarSubscriptionRefreshRate de l'application calendrier de Nextcloud à 5 minutes.
```
sudo -u nextcloud php8.0 occ config:app:set dav calendarSubscriptionRefreshRate --value "PT5M"
# Résultat :
# Config value calendarSubscriptionRefreshRate for app dav set to PT5M
```
- Utiliser l'utilisateur étant propriétaire du fichier config .php avec la commande sudo.
- Utiliser le binaire php correspondant à la version du Nextcloud.

Vérifier la prise en compte.

sudo -u nextcloud php8.0 occ config:list | grep -i calendar
# Résultat :
# "calendar": {
# "calendarSubscriptionRefreshRate": "PT5M",

Crontab

Editer la crontab de l'utilisateur étant propriétaire du fichier config.php vu précédemment.
```
sudo -u nextcloud crontab -e
```
Ajouter une tâche toutes les 5 minutes exécutant le script php situé à la racine du site Nextcloud.
```
*/5 * * * * php8.0 -f /var/www/nextcloud.example.com/www/cron.php
```
Utiliser le binaire php correspondant à la version du Nextcloud.
Se connecter en admin sur l'interface web de Nextcloud. Puis se rendre dans Paramètres.
Dans la section Administration en bas à gauche, se rendre dans Paramètres de base.
S'assurer que les Tâches de fond soient configurées avec Cron.

Sources

Nextcloud : Group Folders

Thu, 05 May 2022 08:00:20 +0200

Contexte

Nextcloud est orienté utilisateurs.

C'est à dire que si l'on souhaite partager des données à d'autres utilisateurs et/ou groupes d'utilisateurs, ces partages se retrouveront à la racine (par défaut) de chaque espace de travail des utilisateurs sans conserver toute l'arborescence.

Un exemple concret :

Un utilisateur nommé "Jean-Jacques" possède une arborescence comme suit :

Ce dossier partagé se retrouvera à la racine (par défaut) du Nextcloud des destinataires concernés.

L'arborescence complète ne sera pas visible.

Cela n'est pas adapté si l'on souhaite partager toute une arborescence avec des droits spécifiques et diverses en son sein.

C'est la que l'application Group Folders intervient.

Group Folders

Présentation

Group Folders est une application que l'on va pouvoir greffer à Nextcloud.

Cette application va permettre de configurer des dossiers partagés à un / des groupe(s) d'utilisateurs.

Ensuite, l'administrateur va pouvoir configurer finement des droits spécifiques (lecture / écriture / partage / quota) sur ces dossiers partagés.

De plus l'intérêt est qu'avec cette application, les données ne seront plus dépendantes d'un utilisateur. Par exemple si Jean-Jacques est supprimé, toutes ces données seront supprimmées ainsi que les partages qu'il a pu faire.

Lien vers le projet : https://github.com/nextcloud/groupfolders

Exemple

Dans mon Nextcloud, je possède plusieurs utilisateurs repartis dans les groupes suivant :

Comptabilité
Direction
Technique
Invité

Je souhaite déployer une arborescence de ce type au sein de mon Nextcloud :

.
├── compta # Accessible en écriture au groupe comptabilité et en lecture au groupe direction
│ ├── note_de_frais
│ └── salaires
├── direction # Accessible en écriture au groupe direction
│ ├── courriers
│ └── projets
├── public # Accessible en écriture à tous les groupes sauf au groupe invité qui sera en lecture seule
│ ├── documents
│ └── entreprise
└── technique # Accessible en écriture au groupe technique et en lecture au groupe direction
 ├── manuels
 └── procedures

Installation

Pour installer Group Folders, il faut se connecter en tant qu'admin sur la plateforme Nextcloud puis se rendre dans les Applications.

Ensuite, rechercher Group Folders puis Télécharger et activer :

Configuration

Toujours en tant qu'admin, se rendre dans les Paramètres d'Administration puis Dossiers du groupe :

Créer dans un 1er temps les dossiers qui figureront à la racine des utilisateurs :

Ensuite, y associer les groupes d'utilisateurs désirés avec les permissions adéquates :

Ici pour le dossier compta, le groupe Comptabilité pourra lire et écrire et le groupe Direction aura simplement un droit de lecture. Naturellement, je refuse que ces données soient partageables par les utilisateurs qui y auront accès.

Il est possible d'y définir un quota maximal :

Puis, définir qui pourra gérer les droits de ce dossier :

Il faut que ce soit un utlisateur / groupe qui ait accès au dossier.

Configurer l'intégralité des autorisations souhaitées comme suit :

Bien entendu, il faut ensuite créer les sous-dossiers dans chaque Group Folders dans l'espace Fichiers de Nextcloud.

Maintenant, les utilisateurs verront uniquement ce à quoi ils doivent avoir accès à la racine de leur Nextcloud.

Par exemple, pour mon utilisateur Pierre qui fait partie du groupe Comptabilité :

Autorisation avancée

Il est possible d'aller encore plus loin dans les autorisations.

Je pourrais souhaiter qu'un utilisateur qui fait partie d'un groupe (ayant des autorisations d'écriture) ait finalement q'un droit de lecture (un stagiaire par exemple). Pour cela dans les détails d'un dossier, des règles d'autorisations avancées peuvent être appliquées :

Ici, je dis que Pierre du groupe Comptabilité peut finalement que lire et non modifier ce qui se trouve dans ce dossier :

Ligne de commande

L'intégralité de la configuration peut être réalisé en ligne de commande via occ :

occ groupfolders:create <name> → create a group folder
occ groupfolders:delete <folder_id> [-f|--force] → delete a group folder and all its contents
occ groupfolders:expire → trigger file version and trashbin expiration (see Nextcloud docs for versionning and Nextcloud docs for the trash bin for details)
occ groupfolders:group <folder_id> <group_id> [-d|--delete] [write|share|delete] → assign groups and their rights to a group folder
occ groupfolders:list → list configured group folders
occ groupfolders:permissions → configure advanced permissions (see below for details)
occ groupfolders:quota <folder_id> [<quota>|unlimited] → set a quota for a group folder
occ groupfolders:rename <folder_id> <name> → rename a group folder
occ groupfolders:scan <folder_id> → trigger a filescan for a group folder
occ groupfolders:trashbin:cleanup → empty the trashbin of all group folders

Conclusion

Group Folders permet d'aller beaucoup plus loin dans la gestion des droits que peut le faire naturellement Nextcloud.

Et surtout, ces données ne sont pas dépendante d'un utilisateur.

Bien entendu, cela est synchronisable avec les clients desktop Nextcloud Windows, Mac, Linux.

Docker-Compose : Nextcloud

Mon, 13 Dec 2021 11:37:28 +0100

docker-compose.yml

version: '2'

services:
 db:
 image: mariadb
 container_name: nextcloud_mariadb
 restart: unless-stopped
 command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW --skip-innodb-read-only-compressed
 volumes:
 - ./db:/var/lib/mysql
 environment:
 - MYSQL_ROOT_PASSWORD=password
 - MYSQL_PASSWORD=password
 - MYSQL_DATABASE=nextcloud
 - MYSQL_USER=nextcloud
 - APACHE_DISABLE_REWRITE_IP=1
 - TRUSTED_PROXIES=172.16.0.10 # Si reverse proxy, mettre son IP sinon commenter la ligne

 app:
 image: nextcloud
 container_name: nextcloud
 restart: unless-stopped
 ports:
 - 8084:80
 links:
 - db
 volumes:
 - ./nextcloud:/var/www/html
 environment:
 - MYSQL_PASSWORD=password
 - MYSQL_DATABASE=nextcloud
 - MYSQL_USER=nextcloud
 - MYSQL_HOST=db
 - APACHE_DISABLE_REWRITE_IP=1
 - TRUSTED_PROXIES=172.16.0.10 # Si reverse proxy, mettre son IP sinon commenter la ligne