Object Listings
Storj comes with highly-secure default settings for uploading data to the network. By default, not only is the object content encrypted, but the object metadata and the object key are as well. See How Encryption is Implemented for details on how object keys (also know as paths) are encrypted.
Encrypting the object keys comes with a shortcoming. When listing the objects of a bucket, the result does not come in lexicographically sorted order. The list order is still deterministic - based on the sort order of the cipher text of the encrypted object keys.
If your S3-compatible app requires object listings to be lexicographically sorted, you can disable the encryption for object keys.
Access Grants determine the access to objects and how they are encrypted, including their object key. Follow these steps to create an access grant with disabled encryption for object keys and register it as S3 credentials.
The following instructions cannot be executed entirely in the Satellite Console and require the final steps to be completed with the Uplink CLI (v1.76 or later).
Log in to the Satellite Console and follow the steps to Create Access Grant in CLI.
Once you switch to your command terminal and execute the setup command, you will be prompted for the API Key and the Satellite Address.
After entering them, answer with
y
to the question:Would you like to disable encryption for object keys (allows lexicographical sorting of objects in listings)? (y/N)
Answer with
y
the next question too:Would you like S3 backward-compatible Gateway credentials (y/N)
The command will generate the S3 credentials with disabled encryption for object keys. Configure them in your S3-compatible app.
Avoid using access grants or S3 credentials with different path encryption settings in the same bucket. Otherwise, you may get unexpected results in the object listings. The best practice is to start with an empty bucket.
The Object Browser in the Satellite Console cannot list objects with unencrypted object keys yet. If you try to open a bucket with such objects, you'll see it empty with a message "You have objects locked with a different passphrase". Support for unencrypted object keys in the Object Browser will be added in a future release. Until then, you can use the Uplink CLI API or a S3-compatible app to list such objects.