Connexions S3
Déclarer, tester et restreindre les accès aux buckets S3 de l'organisation (administrateurs du module GED)
À quoi ça sert
Les connexions S3 disent à la GED quels comptes de stockage votre organisation possède et qui peut s'en servir. Seuls les administrateurs du module « GED » accèdent à la page « Administration ». Les identifiants d'une connexion ne sont jamais réaffichés après l'enregistrement.
Concepts clés
- Type de stockage — « S3 ou compatible » ou « Cellar (Clever Cloud) ».
- Bucket facultatif — renseigné, la connexion est liée à ce bucket ; laissé vide, elle donne accès à tous les buckets du compte.
- Dossier racine — limite la connexion à un sous-dossier du bucket.
- Rôles autorisés — les rôles qui peuvent utiliser la connexion. Vide : tous les utilisateurs du module. Les administrateurs du module accèdent toujours à toutes les connexions.
- CORS — la règle qui autorise le navigateur à envoyer les fichiers directement au bucket. Deltia la configure lui-même quand les identifiants le permettent.
Comment faire
Ajouter une connexion
- Ouvrez la page « Administration » de la GED, bloc « Connexions S3 ».
- Cliquez sur « Ajouter une connexion ».
- Choisissez le « Type de stockage ».
- Renseignez le « Nom », l'« Adresse du service S3 » (ou l'« Hôte du Cellar ») et la « Région ».
- Renseignez le « Bucket (facultatif) » et le « Dossier racine » si besoin.
- Saisissez l'« Identifiant de clé d’accès » et la « Clé secrète ».
- Cochez « Adressage par chemin » pour MinIO, Ceph et la plupart des services auto-hébergés.
- Choisissez les « Rôles autorisés » si la connexion doit être restreinte.
- Cliquez sur « Tester la connexion », puis sur « Ajouter ».
Résultat : « Connexion ajoutée ». Le tableau affiche « Nom », « Bucket » et « Accès » (« Tous les utilisateurs du module » ou le nombre de rôles).
Tester une connexion
Cliquez sur « Tester la connexion » dans le formulaire. Les résultats possibles :
| Résultat | Signification |
|---|---|
| Connexion réussie. Le bucket accepte déjà les dépôts depuis Deltia. | Tout est en place |
| Connexion réussie. Deltia a autorisé ses adresses dans les règles CORS du bucket. | Deltia a ajouté la règle CORS |
| Connexion réussie, mais Deltia n’a pas pu configurer le CORS du bucket… | Ajoutez la « Règle CORS à coller » chez votre hébergeur, sinon les dépôts échouent |
| Identifiant ou clé secrète refusés par le service S3. | Identifiants incorrects |
| Ces identifiants n’ont pas le droit de lister ce bucket (ou ce dossier racine). | Droits insuffisants |
| Ce bucket est introuvable : vérifiez son nom, la région et l’adresse du service. | Bucket, région ou adresse erronés |
| Le service S3 est injoignable : vérifiez l’adresse et réessayez. | Adresse inaccessible |
Les tests sont limités en nombre : « Trop de tests de connexion : réessayez dans … secondes. »
Modifier une connexion
- Cliquez sur « Modifier » sur la ligne de la connexion.
- Changez les champs, puis cliquez sur « Enregistrer ».
Résultat : « Connexion mise à jour ». Pour changer l'adresse, la région, le bucket ou l'identifiant de clé, saisissez à nouveau la clé secrète : « Saisissez à nouveau la clé secrète : elle ne peut pas être réutilisée vers une autre cible. »
Restreindre une connexion à des rôles
- Ouvrez la connexion avec « Modifier ».
- Renseignez « Rôles autorisés », puis enregistrez.
Le droit « Utiliser la connexion » (objet « Connexions S3 de la GED ») couvre parcourir le bucket, télécharger et créer des liens de dépôt.
Supprimer une connexion
- Cliquez sur « Supprimer », puis confirmez « Supprimer cette connexion ? ».
Résultat : « Connexion supprimée ». La connexion n'est plus proposée ; le bucket et ses fichiers ne sont pas touchés. Les liens de dépôt créés sur elle affichent « Connexion supprimée » dans la colonne « Connexion ».
Référence
| Champ | Obligatoire | Règle |
|---|---|---|
| Nom | oui | « Le nom est requis » |
| Adresse du service S3 / Hôte du Cellar | oui | URL https:// sans chemin, sans identifiants, sans paramètres ; adresse publique |
| Région | oui | « La région est requise » |
| Bucket | non | 3 à 63 caractères : minuscules, chiffres, points, tirets |
| Dossier racine | non | pas de « . » ni « .. » ni caractères spéciaux, court |
| Identifiant de clé d’accès | oui | « L’identifiant de clé d’accès est requis » |
| Clé secrète | à la création | chiffrée, jamais réaffichée |
Questions fréquentes
Pourquoi mon adresse est-elle refusée ? Elle doit désigner un service public joignable depuis Internet : « Cette adresse n'est pas autorisée ».
Supprimer une connexion supprime-t-il mes fichiers ? Non.