S3Client
Documentation

Obtenir une adresse ou un lien d’accès

Dans Addresses, vous pouvez copier l’identifiant S3 de l’objet, son URL web ou créer un lien présigné qui autorise temporairement sa lecture. Copier une adresse ne rend pas l’objet public.

Choisir la cible

  1. Pour une version précise, activez Show versions dans le panneau S3.
  2. Sélectionnez l’objet courant ou la version voulue, puis ouvrez Properties.
  3. Ouvrez Addresses après chargement.

S3 URI: affiche s3://bucket/key. Son bouton de copie conserve la clé, mais pas la version. Web URL: tient compte de l’endpoint et du paramètre versionId pour une version précise. Les marqueurs de suppression n’ont pas de lien de téléchargement utilisable.

Avec Options décoché, l’URL est ordinaire, sans authentification ajoutée. Son accès dépend des droits publics ou de l’authentification du client utilisé. Copy URL to Clipboard et Copy URLs to Clipboard dans le menu contextuel copient aussi des URL ordinaires, pas des liens présignés.

Préparer un lien présigné

Le compte doit avoir des identifiants utilisables et la permission de lire la cible, normalement s3:GetObject ou s3:GetObjectVersion. Ouvrez File > Accounts…, sélectionnez le compte, cliquez sur Edit…, puis ouvrez Capabilities > General. Presigned URLs doit correspondre au service. La capacité n’accorde pas la lecture.

Les autorisations liées au chiffrement restent nécessaires, notamment celles de la clé KMS. Un lien présigné ne restaure pas une archive : le contenu doit être lisible au moment de son utilisation. Voir le chiffrement et les archives.

Quiconque possède le lien peut utiliser l’autorisation du signataire pendant sa validité. Les politiques du service, l’expiration ou la révocation des identifiants peuvent le rendre inutilisable plus tôt.

  1. Dans Properties > Addresses, cochez Options.
  2. Choisissez Signed.
  3. Renseignez l’expiration dans le fuseau affiché, (UTC) ou (local time). L’expiration proposée au départ est dans une heure.
  4. Attendez les identifiants et l’affichage de Web URL:.
  5. Cliquez sur Copy web URL pour copier le lien encodé, ou Open pour l’ouvrir dans le navigateur par défaut.

L’expiration doit être future. Signature Version 4 limite la durée à sept jours. Si l’expiration des identifiants temporaires est connue, le lien ne peut pas la dépasser. Signature Version 2 ne permet pas de générer un lien avec des identifiants temporaires dans S3Client.

En vue versions, le lien conserve la version ciblée. Le lien de l’objet courant suit la clé ; un remplacement peut changer le contenu retourné. S3Client crée le lien sans demander au service de lire l’objet. Pour vérifier l’accès, essayez le lien avec le navigateur ou le logiciel qui doit l’utiliser.

Lien SSE-C

SSE-C exige HTTPS, Signature Version 4, la lecture autorisée par la politique de chiffrement et la clé exacte de l’objet. Fournissez-la dans Encryption > Read key…, puis Reload properties, avant de revenir dans Addresses.

Le lien doit être Signed et accompagné des en-têtes SSE-C. Open est désactivé car le navigateur ne les envoie pas à partir du lien seul.

  • Copy required SSE-C headers (includes key) copie l’algorithme, la clé encodée et son MD5.
  • Copy command including SSE-C key copie une commande curl.exe sous Windows, ou curl ailleurs, contenant le lien et les en-têtes.

Sous Windows, exécutez la commande copiée dans PowerShell.

Ces boutons copient la clé secrète dans le presse-papiers ; la commande peut rester dans l’historique du terminal. Transmettez ces valeurs seulement aux destinataires autorisés à posséder la clé. La clé temporaire n’est pas enregistrée dans le compte.

Torrent

Torrent apparaît si BitTorrent download metadata est activé, sans version précise, pour un objet de taille connue inférieure à la limite de copie simple de 5 Gio. Cochez Options, puis Torrent, pour obtenir l’adresse de métadonnées BitTorrent. Le choix ne signe pas la requête et n’accorde aucun accès. Il dépend de la prise en charge effective de cette ancienne API.

Lien indisponible ou refusé

Symptôme ou messageCause et action
Loading credentials…Résolution des identifiants en cours ; attendez ou corrigez leur source si elle échoue.
The signed URL expiration must be in the futureDate passée ; choisissez une date future.
Signature Version 4 signed URLs cannot exceed seven daysRéduisez la durée.
The signed URL cannot expire after the credentialsChoisissez une expiration plus proche ou obtenez de nouveaux identifiants.
This URL may stop working early because the credential expiration is unknown.La fin de validité des identifiants temporaires n’est pas connue.
Provide the SSE-C key for this object before creating its signed URL.Fournissez la clé de lecture puis rechargez.
AccessDenied, ExpiredToken ou erreur de signature à l’ouvertureVérifiez les droits, la validité des identifiants, l’horloge et l’utilisation intacte du lien et des en-têtes.

Un lien expiré ne se prolonge pas ; générez-en un nouveau. Voir les identifiants et le dépannage.

Préc
Configurer les journaux d’accès du bucket
Suiv
Suivre et interrompre les opérations