S3 Object Storage HOSTKEY¶

Dans cet article

• Description du service
• Fonctionnalités clés
• Paramètres techniques
• Accès via navigateur et CORS
• Prise en charge des URL présignées
• Tarification
• Création de stockage S3
• Panneau de contrôle du stockage S3 dans Invapi
• Récupération des identifiants de stockage S3 dans Invapi
• Gestion des buckets de stockage S3 dans Invapi
• Utilisation via S3 Browser
• Opérations de fichiers de base
• Utilisation de HOSTKEY S3 via AWS CLI

Description du service¶

Fonctionnalités clés¶

• Création de stockages indépendants - pendant la période bêta gratuite sur le plan Free Beta 1, les utilisateurs peuvent créer jusqu'à 3 buckets de stockage S3 indépendants ;
• Indépendance vis-à-vis du VPS/VDS - les stockages S3 fonctionnent de manière autonome et ne nécessitent pas de location de serveur HOSTKEY ;
• Création de Buckets - lors de la création d'un stockage, le premier bucket avec un nom unique est automatiquement créé. Création de Buckets : Pendant la période bêta, les utilisateurs peuvent créer jusqu'à 10 buckets dans chaque stockage S3 ;
• Accès compatible S3 - prise en charge complète du protocole standard Amazon S3 pour toutes les opérations de données ;
• Utilisation avec n'importe quel client S3 - utilisez S3 Browser, Cyberduck, boto3 et d'autres outils compatibles S3 ;
• Accès sécurisé - autorisation via Access Key et Secret Key via le protocole HTTPS ;
• Gestion simple des identifiants - génération et consultation des clés d'accès via l'interface web de votre compte ;
• Plans prêts à l'emploi - choix de plans avec volume de stockage et bande passante fixes.

Paramètres techniques¶

• Endpoint URL : https://s3-nl.hostkey.com;
• Protocole : HTTPS (SSL/TLS);
• Autorisation : AWS Signature Version 4.

Accès via navigateur et CORS¶

Lors de l'utilisation du S3 Object Storage dans des applications web (accès direct depuis un navigateur via fetch/XHR), vous devez configurer les règles CORS côté bucket. Vous pouvez configurer vous-même les politiques CORS en utilisant l'API/CLI (méthode PutBucketCors).

Paramètres recommandés pour les applications web :

• Allowed Origins : L'URL de votre domaine (ex: https://your-app.com).
• Allowed Methods : GET, PUT, POST, HEAD.
• Allowed Headers : Authorization, Content-Type, Content-MD5, x-amz-*.
• Expose Headers : ETag (requis pour le fonctionnement correct du Multipart Upload).

Prise en charge des URL présignées¶

Le S3 Object Storage prend entièrement en charge les mécanismes d'accès temporaires :

• URL GET/PUT présignée : création de liens signés pour l'upload et le téléchargement.
• Multipart Upload : prise en charge du téléchargement de fichiers volumineux via part-URL et finalisation de l'opération via CompleteMultipartUpload.

Tarification¶

Le stockage S3 est fourni sur une base payante. Vous pouvez consulter les plans tarifaires actuels ici. Vous pouvez également augmenter votre volume de stockage et de trafic avec un paiement à l'usage ("pay-as-you-go"). Le coût de l'utilisation supplémentaire est calculé quotidiennement.

Au moment de la commande du service, les fonds correspondant à un mois d'utilisation réelle seront déduits du solde de votre compte conformément aux conditions du plan tarifaire sélectionné. Par la suite, les paiements pour les mois d'utilisation suivants, ainsi que les frais pour dépassement des limites de ressources, seront également déduits de votre solde.

Pour consulter l'historique de votre facturation, allez dans le menu Balance & Payments du profil utilisateur dans Invapi et naviguez vers la section Billing Details.

Dans la section Billing Details, vous pouvez consulter l'historique des transactions pour tous les services additionnels associés à ce compte (Managed Apps, S3), ainsi que le montant total facturé à ce compte. Chaque frais de service est listé séparément au sein du cycle de facturation mensuel.

Les relevés de facturation sont générés le 2ème jour du mois suivant le mois de référence à 05:00 UTC. Vous pouvez consulter les relevés de facturation dans la section Balance & Payments de Invapi sous l'onglet Billing Details. Le montant indiqué sur les relevés est calculé pour un mois civil et inclut le coût d'utilisation du service. Une facture consolidée unique comprenant le montant total pour tous les services additionnels peut être générée.

Création de stockage S3¶

1. Connectez-vous à votre compte sur Invapi

2. Allez dans la section S3 Storage ;

3. Créez un nouveau stockage :

   

   • Region : sélectionnez la région (par défaut NL - Pays-Bas);
   • Bucket name : saisissez le nom du bucket (par exemple, bde347688-testbucket) :
     • le nom doit être unique ;
     • maximum 63 caractères ;
     • uniquement des lettres minuscules, des chiffres et des traits d'union ;
     • doit commencer et se terminer par une lettre ou un chiffre.
   • Plan : sélectionnez un plan tarifaire (par exemple, Standart). Pour sélectionner, cliquez sur le nom du plan ;
   • Cliquez sur Create S3 Storage.

Après la création du stockage, vous serez invité à payer votre commande.

Panneau de contrôle du stockage S3 dans Invapi¶

Après un paiement réussi, vous serez redirigé vers le panneau Your Independent Storages (ou en sélectionnant S3 Storage dans le menu de gauche), où vous pourrez :

1. Voir vos stockages payants et leurs tarifs
2. Créer un nouveau stockage S3 indépendant
3. Sélectionner un stockage spécifique dans la liste pour voir ses détails
4. Voir les statistiques sur le volume de stockage et l'utilisation du trafic
5. Voir les identifiants pour se connecter au stockage
6. Ajouter de nouveaux buckets au stockage actuel
7. Voir la liste des buckets ajoutés et leurs statistiques
8. Effectuer des opérations sur les buckets

Récupération des identifiants de stockage S3 dans Invapi¶

1. Dans la liste de vos stockages, trouvez le stockage créé et allez sur l'onglet Credentials :

   

2. Copiez les identifiants :

   Vous aurez besoin de :

   • Host Name (Endpoint URL) : https://s3-nl.hostkey.com;
   • S3 User ID : (ex: oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key : cliquez sur pour révéler la clé ;
   • Secret Key : cliquez sur pour révéler la clé.

   Enregistrez ces données - elles seront nécessaires pour la connexion.

Gestion des buckets de stockage S3 dans Invapi¶

Directement depuis l'interface du stockage S3 dans Invapi, les opérations suivantes sur les buckets sont disponibles :

1. Voir l'espace occupé par le bucket dans le stockage et le nombre d'objets qu'il contient ;
2. Supprimer le bucket ;
3. Voir le contenu du bucket en cliquant sur la ligne correspondant à son nom ;
4. Voir la taille des fichiers et les informations de date de création pour les fichiers dans le bucket ;
5. Rechercher des fichiers dans le bucket ;
6. Supprimer des fichiers individuels du bucket.

Utilisation via S3 Browser¶

1. Téléchargez la version gratuite de S3 Browser : https://s3browser.com;

2. Ajoutez un nouveau compte :

   

   • Ouvrez S3 Browser ;
   • Cliquez sur Accounts >> Add New Account.

3. Remplissez le formulaire :

   • Display name : HOSTKEY S3 (n'importe quel nom pratique) ;
   • Account type : S3 Compatible Storage (pas Amazon S3 Storage !) ;
   • API endpoint : s3-nl.hostkey.com (sans le https://) ;
   • Access Key ID : collez votre Access Key depuis le panneau HOSTKEY ;
   • Secret Access Key : collez votre Secret Key depuis le panneau HOSTKEY ;
   • Use secure transfer (SSL/TLS) : laissez la case cochée.

4. Cliquez sur Add new account ;

5. Travaillez avec les fichiers :

   

   Après une connexion réussie, vous verrez :

   • La Bucket list à gauche ;
   • Les Files in bucket à droite ;
   • Les boutons de gestion : Upload, Download, Delete, New Folder, Refresh.

   Opérations disponibles :

   • Upload - télécharger (uploader) des fichiers ;
   • Download - télécharger (downloader) des fichiers ;
   • Delete - supprimer des fichiers ;
   • New Folder - créer des dossiers ;
   • Refresh - actualiser la liste.

Opérations de fichiers de base¶

Après s'être connecté à un stockage S3 via un client compatible S3, les opérations suivantes sont disponibles :

Téléchargement (Upload) de fichiers¶

1. Via S3 Browser :

   • Sélectionnez un bucket dans le panneau de gauche ;
   • Cliquez sur le bouton Upload ou Upload folder(s) ;
   • Sélectionnez des fichiers sur votre ordinateur ;
   • Confirmez l'upload :

   

2. Via le glisser-déposer :

   • Faites simplement glisser les fichiers de l'explorateur vers la fenêtre de S3 Browser.

Téléchargement (Download) de fichiers¶

1. Sélectionnez un fichier dans le bucket ;

2. Cliquez sur le bouton Download ou faites un clic droit et sélectionnez Download :

   

3. Spécifiez le dossier où enregistrer le fichier sur votre ordinateur.

Suppression de fichiers et dossiers¶

1. Sélectionnez un fichier ou un dossier ;

2. Cliquez sur le bouton Delete ou appuyez sur la touche Delete du clavier :

   

3. Confirmez la suppression.

Création de structure de dossiers¶

1. Sélectionnez un bucket ou un dossier ;

2. Cliquez sur New Folder :

   

3. Saisissez le nom du dossier :

   

4. Cliquez sur Create new folder.

Copier et déplacer des fichiers¶

• Copier : sélectionnez un fichier > clic droit > Copy > allez dans le dossier cible > clic droit > Paste ;
• Déplacer : faites glisser le fichier vers le dossier souhaité tout en maintenant le bouton de la souris enfoncé.

Renommer des fichiers¶

1. Faites un clic droit sur le fichier ;

2. Sélectionnez Rename :

   

3. Saisissez un nouveau nom ;

4. Appuyez sur Enter sur le clavier.

Gestion des permissions d'accès (ACL)¶

1. Faites un clic droit sur le fichier ou le bucket ;

2. Dans le menu contextuel, sélectionnez Edit Permissions (ACL) :

   

3. Dans la fenêtre qui s'ouvre, configurez les permissions d'accès pour les utilisateurs :

   • Owner - contrôle total sur l'objet ;
   • Any AWS Users - accès pour tous les utilisateurs AWS ;
   • All Users - accès public pour tout le monde.

4. Pour chaque catégorie d'utilisateur, vous pouvez définir :

   • Full Control - contrôle total ;
   • Read - lire l'objet ;
   • Write - écrire/modifier l'objet ;
   • Read Permissions - permissions de lecture ;
   • Write Permissions - permissions d'écriture (modification des accès) :

   

5. Pour une configuration rapide, utilisez les boutons :

   • Make public - rendre le fichier public ;
   • Make private - rendre le fichier privé.

6. Après la configuration, cliquez sur Apply changes pour enregistrer.

Génération de liens web¶

Pour créer un lien public vers un fichier ou un dossier dans le S3 Object Storage :

1. Faites un clic droit sur le fichier ;

2. Dans le menu contextuel, sélectionnez Generate Web URL :

   

3. Dans la fenêtre Web URL Generator, configurez les paramètres de génération du lien :

4. Use secure transfer (HTTPS) - utiliser une connexion sécurisée (recommandé pour les données confidentielles) ;

5. Expiration - choisissez la période d'expiration du lien ;

6. Hostname - sélection de l'hôte :

   • Use default host name - utiliser l'adresse par défaut (ex: https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • Ou spécifiez votre propre domaine ;

7. Après avoir configuré les paramètres, le système générera un lien complet vers le fichier, ex :

   https://s3-nl.hostkey.com/bfcc62b88-testbucket/dedicated-server-architecture.drawio

Raccourcissement du lien :¶

1. Pour créer un lien court, cliquez sur le bouton Shorten et choisissez un service :

   • Shorten with Bitly - raccourcir avec Bitly ;
   • Shorten with TinyURL - raccourcir avec TinyURL ;
   • Configure... - configurer les services de raccourcissement ;

   

   

2. Après un raccourcissement réussi, vous recevrez un lien court (ex: https://tinyurl.com/2dhcsk8y) ;

3. Utilisez les boutons :

   • Copy - copier le lien dans le presse-papiers ;
   • Close - fermer la fenêtre du générateur.

   

Utilisation de HOSTKEY S3 via AWS CLI¶

Installation de l'AWS CLI¶

L'AWS CLI peut être installée de deux manières. Choisissez l'une d'entre elles :

Méthode 1 : Installation via pip (universelle)¶

Avantages :

• Installation simple avec une seule commande ;
• Mise à jour facile ;
• Fonctionne sur toutes les plateformes (Windows, Linux, macOS).

Inconvénients :

• Nécessite l'installation de Python ;
• Peut afficher des avertissements dans certains terminaux.

Installation :

pip install awscli boto3

Vérifier l'installation :

aws --version

pip show awscli boto3

Mise à jour :

pip install --upgrade awscli boto3

Méthode 2 : Installateur MSI pour Windows (recommandé)¶

Avantages :

• Ne nécessite pas Python ;
• Pas d'avertissements dans le terminal ;
• Installation propre sur le système.

Inconvénients :

• Uniquement pour Windows ;
• Les mises à jour doivent être téléchargées manuellement.

Installation via le terminal :

curl -o AWSCLIV2.msi https://awscli.amazonaws.com/AWSCLIV2.msi

msiexec /i AWSCLIV2.msi /quiet /norestart

Après l'installation :

1. Redémarrez le terminal ;
2. Vérifiez l'installation.

   aws --version
   

   where aws
   

Résultat attendu :

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64
C:\Program Files\Amazon\AWSCLIV2\aws.exe

Méthode d'installation alternative :

• Téléchargement manuel : https://awscli.amazonaws.com/AWSCLIV2.msi ;
• Lancez l'installateur par un double-clic ;
• Redémarrez le terminal.

Vérifier les conflits :

where aws

Si plusieurs chemins s'affichent, supprimez l'une des versions :

pip uninstall awscli -y

wmic product where "name like 'AWS Command Line Interface%'" call uninstall

Configuration de la connexion à HOSTKEY S3¶

1. Obtention des identifiants depuis le panneau HOSTKEY

1. Connectez-vous à votre compte sur Invapi ;
2. Allez dans la section S3 Storage ;
3. Ouvrez l'onglet "Credentials" ;

4. Copiez les données suivantes :

   Pour l'identifiant utilisateur S3 (Access Key ID) :

   • Cliquez sur l'icône de l'œil pour révéler la clé ;
   • Copiez la valeur affichée manuellement ou via le bouton Copy.

   Pour la clé secrète (Secret Access Key) :

   • Cliquez sur l'icône de l'œil pour révéler la clé ;
   • Copiez la valeur affichée manuellement ou via le bouton Copy.

   Attention

   Vous devez d'abord cliquer sur l'icône pour afficher les vraies valeurs des clés ; ce n'est qu'après cela qu'elles pourront être correctement copiées.

5. Vous aurez également besoin de :

6. Host name : https://s3-nl.hostkey.com;
7. Region : affichée dans le panneau (ex: nl pour les Pays-Bas).

2. Configuration du profil

aws configure --profile hostkey

Lorsqu'on vous le demande, entrez :

AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: nl
Default output format [None]: json

Exemple :

AWS Access Key ID [None]: s3uid_XXXXXXXXXXXXXXXXX
AWS Secret Access Key [None]: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Default region name [None]: nl
Default output format [None]: json

3. Vérifier la configuration

aws configure list --profile hostkey

Résultat attendu :

NAME       : VALUE                    : TYPE             : LOCATION
profile    : hostkey                  : manual           : --profile
access_key : ****************xxxx     : shared-credentials-file :
secret_key : ****************xxxx     : shared-credentials-file :
region     : nl                       : config-file      : ~/.aws/config

4. Vérifier la connexion

aws s3 ls --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat attendu (liste de vos buckets) :

2025-11-26 13:54:16 your-bucket-name

Opérations de fichiers de base¶

Visualisation du contenu d'un bucket¶

aws s3 ls s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 ls s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

2025-11-28 12:14:28         21 test.txt
2025-11-28 14:52:11         19 test_new.txt

Téléchargement (Upload) d'un fichier¶

Créer un fichier de test :

echo Hello HOSTKEY S3 > test.txt

Télécharger le fichier vers le bucket :

aws s3 cp test.txt s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 cp test_new.txt s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

upload: .\test_new.txt to s3://your-bucket-name/test_new.txt

Téléchargement (Download) d'un fichier¶

aws s3 cp s3://bucket-name/file.txt ./local-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 cp s3://your-bucket-name/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

download: s3://your-bucket-name/test.txt to .\downloaded.txt

Vérification du fichier téléchargé (Windows) :¶

type downloaded.txt

Vérification du fichier téléchargé (Linux/macOS) :¶

cat downloaded.txt

Suppression d'un fichier¶

aws s3 rm s3://bucket-name/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 rm s3://your-bucket-name/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

delete: s3://your-bucket-name/test.txt

Synchronisation de dossiers¶

Téléchargement d'un dossier vers le bucket :

aws s3 sync path/to/local/folder s3://bucket-name/path-in-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/remote-folder/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

upload: Documents\Test\file1.txt to s3://your-bucket-name/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://your-bucket-name/remote-folder/file2.docx

Téléchargement d'un dossier depuis le bucket :

aws s3 sync s3://bucket-name/path-in-bucket/ path/to/local/folder --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Avec affichage de la progression :

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/backup/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com --progress

Correct :

aws s3 sync "C:\Users\Name\My Documents" s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Incorrect (provoquera une erreur) :

aws s3 sync C:\Users\Name\My Documents s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Commandes additionnelles¶

Création d'un bucket¶

aws s3 mb s3://new-bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Suppression d'un bucket vide¶

aws s3 rb s3://bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Suppression d'un bucket avec tout son contenu¶

aws s3 rb s3://bucket-name --force --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Copie entre buckets¶

aws s3 cp s3://source-bucket/file.txt s3://dest-bucket/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Déplacement d'un fichier¶

aws s3 mv s3://bucket-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Dépannage¶

Erreur : "aws" n'est pas une commande reconnue¶

Cause : L'AWS CLI n'est pas installé ou n'a pas été ajouté au PATH.

Solution :

1. Redémarrez le terminal après l'installation ;
2. Vérifiez l'installation avec la commande where aws (doit afficher un chemin) ;
3. Si cela ne résout pas le problème, réinstallez l'AWS CLI.

Erreur : Nom de bucket invalide¶

Cause : Nom de bucket incorrect.

Solution : Utilisez le nom exact du bucket depuis le panneau HOSTKEY (ex: prefix-testbucket).

Erreur : AccessDenied¶

Cause : Identifiants incorrects ou permissions insuffisantes.

Solution :

1. Vérifiez l'Access Key et la Secret Key dans le panneau HOSTKEY ;
2. Recréez le profil.

   aws configure --profile hostkey
   

Conflit entre les versions pip et MSI¶

Symptômes : La commande where aws affiche deux chemins.

Solution : Supprimez l'une des versions (voir la section "Ne mélangez pas les méthodes d'installation").

Réinitialisation de la configuration¶

Windows :

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS :

rm -rf ~/.aws

Configuration à nouveau :

aws configure --profile hostkey

Emplacement des fichiers de configuration¶

Windows :

C:\Users\NOM_UTILISATEUR\.aws\credentials
C:\Users\NOM_UTILISATEUR\.aws\config

Linux/macOS :

~/.aws/credentials
~/.aws/config

Contenu des fichiers :

• credentials - Access Key et Secret Key ;
• config - paramètres de région et de format de sortie.

Commandes utiles pour la vérification¶

Version AWS CLI :

aws --version

Emplacement de l'exécutable :

where aws

Informations sur le profil :

aws configure list --profile hostkey

Informations sur le package (pour la version pip) :

pip show awscli boto3

Mise à jour (pour la version pip) :

pip install --upgrade awscli boto3