Gérer les préréglages de fournisseurs

Un préréglage de fournisseur fournit les valeurs initiales d’un nouveau compte : régions et endpoints, région par défaut, protocole et port, domaine de copie côté serveur, capacités et politiques de compatibilité. Après création, le compte conserve sa propre configuration modifiable. S3Client utilise cette configuration, pas le nom du fournisseur, pour déterminer les fonctions disponibles.

Les deux préréglages intégrés sont Amazon S3 et S3-compatible storage. Le second est une base à adapter à votre service : l’endpoint initial est localhost, la région de signature est us-east-1 et les capacités optionnelles sont désactivées. Les préréglages personnalisés installés s’ajoutent à cette liste.

Préréglage ou export de comptes#

Un préréglage ne contient jamais de clés d’accès, de secrets, de nom de profil AWS, d’identifiant de compte de service, de liste de buckets ni de réglages locaux de buckets. Il ne reprend pas non plus le commentaire du compte, ses bénéficiaires ACL enregistrés, ses favoris de clés KMS ou l’autorisation locale de copie directe avec d’autres comptes. Son nom devient le nom initial du nouveau compte.

Un préréglage créé depuis un compte est d’abord enregistré localement dans S3Client. Export selected preset… crée ensuite, à la demande, un fichier JSON non chiffré et sans mot de passe.

Le fichier contient le domaine de copie et les groupes prédéfinis de la politique ACL. Il peut donc révéler les adresses de vos services et certains de leurs réglages. Vérifiez ces informations avant de le partager.

Pour déplacer un compte avec ses réglages personnels et éventuellement ses secrets, utilisez plutôt Importer et exporter des comptes. Les deux types de fichiers peuvent porter l’extension .s3client.json, mais leur import se fait dans des fenêtres distinctes : Manage accounts > Import accounts… dans Accounts et Import preset… dans Providers.

Installer et utiliser un préréglage#

Avant de l’utiliser, vérifiez que ses endpoints et capacités correspondent à votre service. L’installation ne teste aucune connexion et ne donne aucune permission.

Sur la page de téléchargement, Copier le lien copie l’URL complète du JSON et affiche temporairement Lien copié. Télécharger enregistre le même fichier pour l’import local.

Le choix URL accepte les liens HTTP ou HTTPS sans identifiants intégrés. Le chargement utilise le proxy configuré dans S3Client, reste en mémoire et ne crée pas de fichier local. Loading… indique que le téléchargement est en cours ; les champs de source sont alors désactivés et Cancel arrête le chargement. La limite de chargement est de 48 Mio, le délai total de 60 secondes et le nombre maximal de redirections de cinq ; une redirection de HTTPS vers HTTP est refusée. Le document chargé est ensuite soumis aux mêmes validations que le fichier local, notamment à la limite de 32 Mio du préréglage. Changer la source ou modifier le chemin ou l’URL efface le document précédemment chargé ; chargez-le de nouveau avant de l’installer.

Install provider ou Replace provider enregistre le préréglage sans modifier les comptes existants et sans confirmation supplémentaire. Pour mettre à jour certains comptes après l’import, utilisez Apply to accounts… dans Providers, comme décrit ci-dessous.

1. Dans la fenêtre principale, choisissez File > Accounts…, puis cliquez sur Manage accounts > Providers….
2. Dans Providers, cliquez sur Import preset….
3. Dans Import provider preset, File est sélectionné par défaut. Cliquez sur Browse… ou saisissez le chemin d’un fichier local ; la lecture commence lorsque vous quittez le champ. Pour importer depuis un lien direct, choisissez URL, collez-le et cliquez sur Load.
4. Vérifiez le nom affiché sous Provider preset, puis cliquez sur Install provider ou Replace provider.
5. De retour dans Accounts, cliquez sur New….
6. Dans New account, sélectionnez le préréglage sous Provider, puis cliquez sur OK.
7. Renseignez le nom et les identifiants dans Account, vérifiez les réglages, puis utilisez Test connection et enregistrez avec OK.

Les fichiers de préréglages ne demandent pas de mot de passe source. Un fichier qui n’est pas un préréglage est refusé sous Provider import error ; une erreur de téléchargement apparaît sous Import error. Un problème d’installation apparaît également sous Provider import error. Le nom ne peut pas reprendre Amazon S3 ou S3-compatible storage, sans tenir compte de la casse, ni celui d’un autre préréglage personnalisé d’identité différente. Chaque document est limité à 32 Mio ; le stockage local accepte au plus 1 000 préréglages personnalisés et 16 Mio de données.

Appliquer un préréglage aux comptes existants#

L’application remplace les capacités, les politiques de compatibilité, les limites générales des requêtes et les paramètres Object Lock des comptes cochés. Elle conserve leurs identifiants internes, noms, commentaires, états activés, identifiants de service, sources d’identifiants et secrets, buckets et réglages locaux, bénéficiaires ACL enregistrés, favoris KMS et autorisations locales de copie directe. Le coffre peut rester verrouillé. Le préréglage appliqué devient la référence affichée dans l’éditeur du compte ; les mises à jour ultérieures de ce préréglage ne sont pas appliquées automatiquement.

Replace connection settings est décochée par défaut. Les régions et tous leurs paramètres, la région par défaut, le protocole, le port et les domaines de copie côté serveur sont alors conservés. Cochez cette option pour les remplacer également par ceux du préréglage. Cela peut écraser vos endpoints personnalisés et rendre une connexion de bucket enregistrée incompatible ; vérifiez les réglages du service avant de l’appliquer. Les politiques du préréglage sont remplacées intégralement, y compris leurs affectations à des régions ou endpoints ; elles ne sont pas adaptées automatiquement aux adresses conservées. Appliquer un préréglage ne teste pas la connexion et ne donne aucune permission sur le service.

L’application est disponible pour les préréglages Custom installés et les préréglages Built-in. Pour appliquer un fichier reçu, importez-le d’abord dans Providers.

1. Ouvrez File > Accounts… > Manage accounts > Providers….
2. Sélectionnez le préréglage, puis cliquez sur Apply to accounts….
3. Dans Apply provider preset, cochez les comptes à modifier. Account, Current preset et Default endpoint permettent de les identifier. Les comptes ayant le même identifiant de préréglage apparaissent en premier, mais aucun compte n’est coché automatiquement. Les autres comptes restent sélectionnables.
4. Choisissez si vous souhaitez activer Replace connection settings. Vérifiez le compteur de comptes sélectionnés.
5. Cliquez sur Apply to accounts. Le bouton exige au moins un compte coché. L’enregistrement ne demande pas de confirmation supplémentaire. Cancel ferme cette fenêtre sans modifier les comptes.
6. Pour vérifier le résultat, ouvrez un compte modifié depuis Accounts et consultez ses capacités et sa connexion.

Les comptes cochés sont enregistrés ensemble : un échec d’application ne laisse pas seulement une partie du lot modifiée. Si Preset application error indique que les comptes ont changé, cliquez sur Reload, vérifiez la liste actualisée et les cases conservées pour les comptes encore présents, puis réessayez. Une liste vide ou indisponible empêche l’application. L’application aux comptes ne modifie pas le préréglage installé.

Choisir le préréglage Google Cloud Storage#

La page de téléchargement propose deux fichiers pour l’API XML Google. Choisissez celui correspondant au mode d’accès des buckets utilisés :

Google refuse les requêtes ACL sur un bucket à accès uniforme. Choisir un préréglage ne change pas le mode du bucket dans Google Cloud. La politique ACL s’applique à tout le compte S3Client ; utilisez des comptes distincts pour conserver les possibilités respectives des buckets Fine-grained et Uniform. S3Client ne sélectionne pas automatiquement la politique selon le bucket. Accès uniforme Google Cloud Storage.

Après l’installation et la création du compte, renseignez l’identifiant et le secret d’une clé HMAC Google dans les champs d’accès S3. Une clé API Google ou un fichier JSON de compte de service ne remplace pas ces deux valeurs. Les fichiers préconfigurent HTTPS sur storage.googleapis.com, Signature Version 4, la région de signature auto et l’accès par chemin. Les permissions de l’identité restent nécessaires. Clés HMAC Google.

Les deux fichiers supposent des buckets sans espace de noms hiérarchique, avec STANDARD comme classe par défaut et Autoclass désactivé. Si la classe par défaut diffère, adaptez Account > Capabilities > Storage classes > Default class et Assignments pour les buckets concernés. STANDARD, NEARLINE, COLDLINE et ARCHIVE sont proposées pour les envois et copies ordinaires ; elles restent lisibles directement, sans restauration S3. Classes Google Cloud Storage.

Change storage class on the same object est désactivé dans les deux fichiers : les propriétés et Rewrite storage class ne permettent pas de changer la classe par recopie sur la même clé. Cette limite ne bloque pas le placement lors d’un envoi ou d’une copie vers une autre clé. Les deux fichiers désactivent aussi les API S3 de journalisation : Access logging est masqué. Ces réglages décrivent les opérations utilisables dans S3Client, pas toutes les fonctionnalités offertes par Google.

Remplacer, exporter ou retirer un préréglage#

Chaque fichier de préréglage contient un identifiant qui permet à S3Client de le reconnaître. Si un préréglage portant cet identifiant est déjà installé, l’import propose Replace provider, même si son nom a changé. Cliquer sur ce bouton remplace le préréglage installé sans confirmation supplémentaire.

Le remplacement seul change les valeurs proposées pour les prochains comptes. Pour modifier des comptes existants, utilisez Apply to accounts… dans Providers après l’import. Dans l’éditeur d’un compte, Restore Defaults sur Regions peut aussi reprendre les régions de la nouvelle version du préréglage : vérifiez-les avant d’enregistrer.

Pour exporter un préréglage personnalisé déjà installé :

1. Ouvrez File > Accounts… > Manage accounts > Providers….
2. Dans Providers, sélectionnez une ligne de type Custom.
3. Cliquez sur Export selected preset… et choisissez le fichier .s3client.json à créer.
4. Si Replace file apparaît, vérifiez le chemin puis cliquez sur Yes pour remplacer le fichier existant, ou sur No pour le conserver.
5. Vérifiez la présence du fichier. Un échec d’écriture est signalé sous Provider export error ; le préréglage installé reste disponible.

Pour retirer un préréglage, sélectionnez sa ligne Custom dans Providers, cliquez sur Remove…, puis confirmez avec Remove dans Remove provider. Cancel le conserve. Les lignes Built-in ne peuvent être ni exportées ni retirées. Les comptes existants gardent leurs réglages et capacités après un retrait ; le fournisseur cesse seulement d’être proposé à la création. Un fichier précédemment exporté n’est pas supprimé.

Custom providers are unavailable. signifie que le stockage des préréglages personnalisés ne peut pas être lu. Les préréglages intégrés restent proposés ; consultez les détails techniques avant de réessayer.

Dans le stockage local, un préréglage invalide ou dont le schéma n’est pas pris en charge est ignoré individuellement, avec ses associations aux comptes ; les autres préréglages restent disponibles. Si plusieurs entrées valides ont le même identifiant ou le même nom, la première est conservée. La lecture ne modifie pas le fichier ; une modification normale du stockage retire les entrées ignorées. Un stockage global corrompu ou utilisant une version future est refusé en entier et n’est pas écrasé. Cette règle ne s’applique pas à l’import d’un fichier : un préréglage invalide ou dont la version n’est pas prise en charge est refusé.

Créer un préréglage depuis un compte#

Préparez et enregistrez d’abord le compte source avec les paramètres du service que vous souhaitez distribuer. Vérifiez particulièrement les régions et connexions et les capacités.

More > Save as provider preset… enregistre les réglages du compte dans un préréglage local. Aucun fichier à partager n’est créé à cette étape. Le coffre des identifiants peut rester verrouillé : l’action lit les paramètres du compte, pas ses secrets.

La fenêtre propose Create a new preset ou Update an installed preset. Si un préréglage personnalisé est déjà associé au compte, ou si le compte a été créé depuis un préréglage personnalisé encore installé, la mise à jour correspondante est présélectionnée. Sinon, la création est présélectionnée. Vous pouvez changer de mode avant d’enregistrer. La mise à jour remplace le préréglage choisi pour les prochains comptes ; elle ne modifie pas les comptes existants.

1. Dans File > Accounts…, sélectionnez le compte source.
2. Cliquez sur More > Save as provider preset….
3. Dans Save account as provider preset, choisissez Create a new preset et renseignez Preset name, ou choisissez Update an installed preset et sélectionnez Installed preset. Le nom n’est modifiable qu’en mode création.
4. Cliquez sur Create preset ou Update preset, selon le mode choisi.
5. Ouvrez Manage accounts > Providers… et vérifiez que le préréglage figure dans la liste avec le type Custom. Il est également proposé sous Provider lors de la création d’un compte.

En mode création, Preset name contient initialement le nom du compte. Le nom ne peut pas être vide ni déjà utilisé par un autre préréglage ; Preset name required ou Preset already exists vous invite à le corriger. La mise à jour conserve le nom du préréglage choisi. Les erreurs d’enregistrement apparaissent sous Provider preset error.

Le préréglage reprend les réglages effectifs du compte enregistré, y compris vos adaptations. Le nom et la configuration du compte source ne sont pas modifiés. Pour obtenir un fichier à partager, exportez ensuite ce préréglage depuis Providers avec Export selected preset….

Un fichier exporté ne contient ni les secrets du compte source ni ses réglages propres aux buckets. Vérifiez néanmoins les endpoints, le domaine de copie et les autres réglages avant de le transmettre.

Format des fichiers#

Les préréglages utilisent exclusivement le schéma 1.0. Un fichier qui déclare une autre version est refusé à l’import ; aucune conversion n’est effectuée.

La mise à jour d’un préréglage ne reconfigure pas automatiquement les comptes déjà créés. Ils conservent leurs réglages tant que vous ne leur appliquez pas explicitement le préréglage.