Nextcloud

Nextcloud est une plateforme de partage de fichiers et de collaboration auto-hébergée (ou hébergée). Ordalie se connecte à votre instance Nextcloud via le protocole WebDAV, vous donnant accès à vos fichiers, à la recherche et aux fonctionnalités d'écriture.

Qui peut configurer

Tout utilisateur PRO, depuis Paramètres > Intégrations. C'est une intégration personnelle utilisant vos identifiants Nextcloud.

Guide de configuration

Étape 1 : Connecter votre instance Nextcloud

1. Allez dans Paramètres > Intégrations.
2. Trouvez Nextcloud et cliquez sur Connecter.
3. Entrez l'URL de votre serveur Nextcloud (ex : https://cloud.example.com).
   • L'URL est automatiquement nettoyée : les chemins comme /apps/... ou /index.php sont supprimés.
   • https:// et https:// sont acceptés, mais HTTPS est fortement recommandé.
4. Choisissez le niveau d'accès (Lecture seule ou Lecture & Écriture).
5. Cliquez sur Connecter. Une fenêtre de connexion Nextcloud s'ouvrira.
6. Connectez-vous à votre instance Nextcloud et autorisez l'accès à l'application.
7. Nextcloud va générer un token d'application spécifiquement pour Ordalie. Ce token est stocké de manière sécurisée.

Étape 2 : Commencer à utiliser vos fichiers

Une fois connecté :

• Parcourez vos fichiers Nextcloud via le panneau workspace.
• Utilisez les mentions @ pour référencer des fichiers Nextcloud dans les conversations.
• Recherchez dans vos fichiers.
• Envoyez des fichiers et créez des dossiers (si l'accès en écriture est activé).

Fonctionnement

Ordalie utilise le protocole WebDAV pour communiquer avec votre instance Nextcloud :

• Listing : Requêtes PROPFIND pour parcourir les répertoires.
• Recherche : Méthode WebDAV SEARCH avec filtrage par nom de fichier. Repli sur listing + filtrage si le serveur ne supporte pas la méthode SEARCH.
• Lecture : Requêtes GET standard pour télécharger le contenu des fichiers.
• Écriture : Requêtes PUT pour envoyer des fichiers.
• Création de dossiers : Requêtes MKCOL pour créer des répertoires.

L'authentification utilise Basic Auth avec le token d'application généré lors du flux de connexion. Aucun mot de passe n'est stocké — uniquement le token spécifique à l'application.

Sécurité

• Protection SSRF : Ordalie valide l'URL du serveur pour empêcher les connexions vers des adresses réseau internes (localhost, plages IP privées).
• Tokens d'application : Le token est limité à Ordalie et peut être révoqué indépendamment de votre compte Nextcloud.
• HTTPS : Bien que HTTP soit techniquement supporté, utilisez toujours HTTPS pour les instances en production.

Référence de configuration

Le nom d'utilisateur et le token d'application sont obtenus automatiquement lors du flux de connexion et stockés de manière sécurisée.

Opérations supportées

Questions fréquentes

Q : Quelles versions de Nextcloud sont supportées ? R : Toute version de Nextcloud supportant le protocole WebDAV et le Login Flow v2 (utilisé pour la génération du token d'application). Cela inclut Nextcloud 16 et versions ultérieures.

Q : Puis-je me connecter à un Nextcloud derrière un VPN ? R : Ordalie se connecte depuis ses serveurs, donc l'instance Nextcloud doit être accessible depuis Internet. Si votre instance est derrière un VPN, vous devrez l'exposer ou utiliser un reverse proxy.

Q : Que se passe-t-il si je change mon mot de passe Nextcloud ? R : Les tokens d'application sont indépendants de votre mot de passe principal. Changer votre mot de passe n'invalide pas le token utilisé par Ordalie.

Q : Comment révoquer l'accès ? R : Allez dans Paramètres > Intégrations dans Ordalie et déconnectez. Vous pouvez aussi révoquer le token d'application depuis votre instance Nextcloud : Paramètres > Sécurité > Appareils et sessions.