Moteur de stockage : S3 (Pro)

File storage: S3(Pro)Professional Edition+

Introduction

S'appuyant sur le plugin de gestion de fichiers, ce plugin ajoute la prise en charge de types de stockage de fichiers compatibles avec le protocole S3. Tout service de stockage d'objets compatible avec le protocole S3 peut être facilement intégré, comme Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2, etc., ce qui améliore encore la compatibilité et la flexibilité des services de stockage.

Fonctionnalités

Téléchargement côté client : Le processus de téléchargement des fichiers ne passe pas par le serveur NocoBase, mais se connecte directement au service de stockage de fichiers, offrant ainsi une expérience de téléchargement plus efficace et plus rapide.
Accès privé : Des URL signées avec expiration sont utilisées par défaut. Des URL non signées peuvent aussi être générées pour les buckets publics.

Cas d'utilisation

Gestion des collections de fichiers : Gérez et stockez de manière centralisée tous les fichiers téléchargés, en prenant en charge divers types de fichiers et méthodes de stockage pour faciliter leur classification et leur récupération.
Stockage des champs de pièces jointes : Utilisé pour le stockage des données de pièces jointes téléchargées dans des formulaires ou des enregistrements, prenant en charge l'association avec des enregistrements de données spécifiques.

Configuration du plugin

Activez le plugin plugin-file-storage-s3-pro.
Cliquez sur "Paramètres -> Gestionnaire de fichiers" pour accéder aux réglages du gestionnaire de fichiers.
Cliquez sur le bouton "Ajouter un nouveau" et sélectionnez "S3 Pro".

Une fois la fenêtre contextuelle affichée, vous verrez un formulaire avec de nombreux champs à remplir. Vous pouvez vous référer à la documentation suivante pour obtenir les informations sur les paramètres pertinents pour le service de fichiers correspondant et les renseigner correctement dans le formulaire.

Configuration des URL

En plus des options communes « URL NocoBase », « URL d’origine » et « Autoriser l’accès public » du gestionnaire de fichiers, S3 Pro permet de configurer séparément les formats des URL de téléversement et d’accès, ainsi que l’utilisation des URL signées. Consultez la présentation des moteurs de stockage pour les options communes.

Ces options contrôlent différentes étapes :

« URL NocoBase / URL d’origine » détermine l’adresse renvoyée par l’enregistrement du fichier
« Autoriser l’accès public » détermine si les autorisations de consultation sont vérifiées lors de l’accès à une URL NocoBase
« Ne pas utiliser d’URL signée » détermine si le stockage objet vérifie la signature de l’URL

Ces réglages peuvent être combinés indépendamment. Par défaut, il est recommandé d’utiliser l’URL NocoBase, de ne pas cocher « Autoriser l’accès public » et de conserver les URL signées.

Configuration des URL de S3 Pro

Comment choisir

Cas d’utilisation	URL du fichier	Autoriser l’accès public	Ne pas utiliser d’URL signée
Les fichiers doivent respecter les autorisations de rôle et de données tandis que le bucket reste privé	URL NocoBase	Non coché	Non coché
Une adresse NocoBase publique est nécessaire tandis que le bucket reste privé	URL NocoBase	Coché	Non coché
Un service externe a besoin d’un accès temporaire à l’adresse de stockage	URL d’origine	Non applicable	Non coché ; configurez Access URL expiration
Un bucket public ou un CDN nécessite une adresse d’origine non signée	URL d’origine	Non applicable	Coché

Format de l’URL de téléversement

« Format de l’URL de téléversement » contrôle l’URL S3 utilisée par le client pour téléverser les fichiers. Sélectionnez le format pris en charge par votre service de stockage. Le formulaire affiche un exemple basé sur l’Endpoint, le Bucket et le chemin actuels :

« Bucket as subdomain » : https://bucket-name.s3.example.com/path/to/object
« Bucket as subpath » : https://s3.example.com/bucket-name/path/to/object
« Ignore bucket » : https://upload.example.com/path/to/object

Format de l’URL d’accès

« Format de l’URL d’accès » détermine si le Bucket apparaît dans le domaine, dans le chemin ou pas du tout lorsque S3 Pro génère une adresse d’accès. Les trois formats sont identiques à ceux de l’URL de téléversement, mais peuvent être configurés séparément—par exemple, le téléversement peut utiliser un Endpoint S3 tandis que l’accès utilise un domaine CDN sans Bucket.

Cette option affecte les URL d’origine et l’adresse de stockage vers laquelle une URL NocoBase redirige finalement, mais ne change pas le format de l’URL NocoBase elle-même.

Ne pas utiliser d’URL signée

S3 Pro utilise des URL signées par défaut. Une URL d’origine générée contient des paramètres de signature, par exemple :

https://bucket-name.s3.example.com/path/to/object?X-Amz-Signature=xxxx

L’URL signée reste valide pendant la durée configurée dans « Access URL expiration », et le bucket peut rester privé. Avec une URL NocoBase, NocoBase génère une adresse signée ou redirige vers celle-ci après validation des autorisations.

Lorsque « Ne pas utiliser d’URL signée » est coché, S3 Pro génère une adresse sans paramètres de signature. Le bucket et les objets téléversés doivent alors autoriser la lecture publique, et « Access URL expiration » ne s’applique plus.

« Ne pas utiliser d’URL signée » contrôle uniquement la vérification de la signature par le service de stockage et ne modifie pas les autorisations NocoBase. Si l’URL NocoBase est sélectionnée et « Autoriser l’accès public » n’est pas coché, la requête doit toujours passer d’abord le contrôle d’autorisation NocoBase.

Configuration du fournisseur de services

Amazon S3

Création du bucket

Ouvrez https://ap-southeast-1.console.aws.amazon.com/s3/home pour accéder à la console S3.
Cliquez sur le bouton "Create bucket" (Créer un bucket) à droite.

Renseignez le nom du bucket (Bucket Name). Les autres champs peuvent être laissés avec leurs paramètres par défaut. Faites défiler la page jusqu'en bas et cliquez sur le bouton "Create" (Créer) pour finaliser la création.

Configuration CORS

Accédez à la liste des buckets, trouvez et cliquez sur le bucket que vous venez de créer pour accéder à sa page de détails.

Cliquez sur l'onglet "Permissions", puis faites défiler vers le bas pour trouver la section de configuration CORS.

Saisissez la configuration suivante (vous pouvez la personnaliser davantage) et enregistrez.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

Obtention de l'AccessKey et du SecretAccessKey

Cliquez sur le bouton "Security credentials" (Identifiants de sécurité) dans le coin supérieur droit de la page.

Faites défiler vers le bas jusqu'à la section "Access Keys" (Clés d'accès) et cliquez sur le bouton "Create Access Key" (Créer une clé d'accès).

Cliquez pour accepter (ceci est une démonstration avec le compte root ; il est recommandé d'utiliser IAM dans un environnement de production).

Enregistrez l'Access key et le Secret access key affichés sur la page.

Obtention et configuration des paramètres

L'AccessKey ID et le SecretAccessKey sont les valeurs que vous avez obtenues à l'étape précédente. Veuillez les renseigner avec précision.
Accédez au panneau des propriétés de la page de détails du bucket, où vous pourrez obtenir le nom du bucket et les informations sur la région (Region).

Accès public non signé (facultatif)

Configurez cette option uniquement si vous avez besoin d’URL non signées, car le bucket et les objets téléversés doivent autoriser la lecture publique. Si vous souhaitez seulement partager une URL NocoBase publique, cochez « Autoriser l’accès public » et conservez les URL signées ; le bucket n’a pas besoin d’être public.

Accédez au panneau Permissions, faites défiler jusqu'à Object Ownership, cliquez sur modifier, et activez les ACLs.

Faites défiler jusqu'à Block public access, cliquez sur modifier, et configurez-le pour autoriser le contrôle des ACLs.

Cochez « Ne pas utiliser d’URL signée » dans NocoBase.

Configuration des miniatures (facultatif)

Cette configuration est facultative et est utilisée pour optimiser la taille ou les effets de prévisualisation des images. Veuillez noter que cette solution de déploiement peut entraîner des coûts supplémentaires. Pour connaître les frais spécifiques, veuillez vous référer aux conditions générales d'AWS.

Visitez Dynamic Image Transformation for Amazon CloudFront.
Cliquez sur le bouton Launch in the AWS Console (Lancer dans la console AWS) en bas de la page pour commencer le déploiement de la solution.
Suivez les invites pour compléter la configuration. Portez une attention particulière aux options suivantes :
1. Lors de la création de la pile, vous devez spécifier le nom d'un bucket Amazon S3 contenant les images sources. Veuillez saisir le nom du bucket que vous avez créé précédemment.
2. Si vous choisissez de déployer l'interface utilisateur de démonstration, vous pourrez tester les fonctionnalités de traitement d'image via cette interface après le déploiement. Dans la console AWS CloudFormation, sélectionnez votre pile, accédez à l'onglet "Outputs" (Sorties), trouvez la valeur correspondant à la clé DemoUrl, et cliquez sur le lien pour ouvrir l'interface de démonstration.
3. Cette solution utilise la bibliothèque Node.js sharp pour un traitement efficace des images. Vous pouvez télécharger le code source depuis le dépôt GitHub et le personnaliser selon vos besoins.
Une fois la configuration terminée, attendez que le statut de déploiement passe à CREATE_COMPLETE.
Dans la configuration NocoBase, voici quelques points à noter :
1. Thumbnail rule (Règle des miniatures) : Renseignez les paramètres liés au traitement d'image, par exemple ?width=100. Pour plus de détails, consultez la documentation AWS.
2. Access endpoint (Point d'accès) : Renseignez la valeur de Outputs -> ApiEndpoint après le déploiement.
3. « Format de l’URL d’accès » : sélectionnez « Ignore bucket », car le nom du bucket est déjà inclus dans la configuration et n’est pas nécessaire dans l’URL d’accès.

Exemple de configuration