It’s quite clear what the API key is for. The S3 Credentials are for the S3 gateway - that also makes sense. But I am failing to understand the connection between the S3 Credentials and the Access Grant.
I’ve seen an introduction where STORJ is being used via the S3 Gateway. That’s why the S3 Credentials were used. But in that video (and also in some documentation) it says to also create an Access Grant.
So - creating the S3 credentials implicitly also creates the access grant and it is not (despite what is described in the linked docs) necessary to create an access grant manually.
If I understood that correctly - it suddenly makes much more sense.
Yes, you understand it correctly, the S3 credentials based on Access Grant, just now this creation is happening under the hood.
You may create an access grant and register it from the uplink CLI, the result will be the same. But if you prefer UI, then yes, you should use the Create S3 Credentials wizard.
Just this flow has changed recently and we implemented a Create S3 Credentials wizard, but you may also choose the S3 Credentials option when you create an Access Grant
our product is changing faster than our documentation
You may see a Billing on the left side in the screenshot from documentation, but it is recently moved to My Account.
As a side note - if I maybe add some UX/UI observations:
Using the same wizard from all 3 buttons is a bit confusing.
I know the access type gets pre-selected, but yet I can click on “API Access” and switch it to create “S3 Credentials”. I suggest to either have one button to open the dialog or remove/disable the type selection in the box.
Also the “Name” placeholder is confusing. The title says “Name”, the placeholder is “Input Access Name”. While in hindsight it’s clear, better stay consistent between the title and the placeholder. It should be either “Name” and “(Input) Name” or “Access Name” and “(Input) Access Name”. Everything else is confusing - at least during onboarding of new users.
The placeholders are helpers, where we can give users examples, instructions, and guidance. It’s good practice to provide more information about the input field in the placeholders, because good labels are usually short and most users can benefit from this “extra” help.
I hear the confusion you reported. I’ll test your suggestions and see what users in general think. We’re testing our assumptions in all these iterations, so we’ll certainly be able to change them.
An option could be to make the placeholder maybe a bit more clear.
Instead of “Input Access Name” try “Enter (a) Name for (the) Access/Grant/Credentials/Key”.
The naming here becomes a bit of a problem as you have the same dialog but a different naming. One time it’s “credentials” the other one is a “grant” or “key”.
Anyway - enough from me. Thanks for listening.
Happy user testing
Would you like to be part of our selected group of testers? I’m frequently testing our design iterations before they go live through unmoderated tests on the Usertesting platform. It would be great to have your input before implementing our ideas! If yes, shoot me an email at livia@storj.io, and we’ll set up your participation.