Exploratum^0.2Projet

Qu'est-ce que c'est ?

Exploratum est un script php permettant de mettre en place rapidement un partage de fichiers avec accès protégé.

Il liste les fichiers d'un dossier et permet de les télécharger. Un contrôle des droits d'accès peut être réalisé par noms d'utilisateurs et par groupes. Les fichiers non accessibles sont masqués sur la liste des fichiers disponibles et ne peuvent pas être téléchargés par accès direct à la page de téléchargement.

Changement de direction

Cette application n'est plus développée.
Elle sera intégrée dans un projet plus gros nommé Partage.

Fonctionnalités

Depuis v0.2 : [± en développement]

• Droits d'accès sur fichiers
• Droits d'accès sur dossiers par héritage
• Gestion des utilisateurs
• Gestion des groupes d'utilisateurs
• Gestion intelligente des URL

Depuis v0.1 :

• Listing automatique des répertoires avec leur architecture
• Liste d'accès par expression régulière
• Masquage des fichiers non accessibles
• Téléchargement des fichiers

Installation

• Récupérez le projet et copiez ses fichiers sur un espace exécutant php,
• Déposez vos fichiers dans le dossier docs/,
• Assurez-vous que ces fichiers ne sont pas accessibles directement, ⁽¹⁾
• Utilisez exploratum.

⁽¹⁾ Voir la note sur l'accès aux fichiers.

Note sur l'accès aux fichiers

Exploratum effectue un contrôle des droits d'accès pardes mécanismes internes. Pour que celui-ci ait un sens, il est nécessaire que le serveur ne distribue pas lui-même ces fichiers à une autre adresse. En effet, le serveur n'a pas connaissance de vos règles d'accès dans ce cas et ne les applique donc pas.

Il convient donc d'empêcher l'accès du répertoire docs/. Sur les serveurs interprétant les fichiers .htaccess, une règle est déjà définie et vous n'aurez certainement rien à faire. Sur les autres serveurs, assurez vous de refuser l'accès au téléchargement direct sans interdire la lecture des fichiers par php.

Note sur les URL^{[En développement]}

Exploratum propose une gestion intelligente des URL, c'est à dire qu'il propose des liens en relation sa propre adresse.

Les url correctement interprétées sont du type :

• QUERY. Adresse du dossier dans la chaîne de query. ⁽¹⁾
  Exemple : http://exploratum.desbwa.org/index.php?/dossier/fichier.txt
• PATH_INFO. Utilisation du script comme dossier virtuel.
  Exemple : http://exploratum.desbwa.org/index.php/dossier/fichier.txt
• URL_REWRITE. Utilisation par réécriture d'url. ⁽²⁾
  Exemple : http://exploratum.desbwa.org/dossier/fichier.txt
• NOT_FOUND. Le script est appelé lorsque l'url n'aboutit pas. ⁽²⁾⁽³⁾
  Exemple : http://exploratum.desbwa.org/dossier/fichier.txt

⁽¹⁾ Option par défaut si aucune autre méthode n'a pu être déterminée.
⁽²⁾ Il est possible de modifier la base de recherche si besoin.
⁽³⁾ Exploratum retourne un statut http 200 ou 404, selon que la page demandée est accessible ou non.

À propos d'exploratum

Exploratum est développé et maintenu par Florent TOUCHARD (JackDesBwa) et est disponible sur les dépôts GIT du serveur DesBwa.