docs: explain token and credentials flow

README.md

@@ -39,13 +39,13 @@ shared-SQS покрывает 17 SQS-операций:
 - ChangeMessageVisibility
 - ChangeMessageVisibilityBatch
 
-## Где взять ключи
+## Где взять токен и ключи
 
-Есть два варианта:
+Есть два сценария.
 
-### 1. Ознакомительный доступ
+### 1. Просто посмотреть сервис
 
-Для простого знакомства можно использовать demo credentials из блока выше:
+Для ознакомительного доступа можно использовать demo credentials:
 
 ```bash
 export AWS_ACCESS_KEY_ID="SSAK-demo-shared-sqs"
@@ -54,13 +54,21 @@ export AWS_DEFAULT_REGION="us-east-1"
 ENDPOINT="--endpoint-url https://qu.kube5s.ru"
 ```
 
-### 2. Собственные tenant credentials
+### 2. Получить свои credentials через Web UI
 
-Если нужен полноценный доступ для своих очередей и сообщений, используйте credentials своего тенанта.
+Если нужен полноценный доступ к своим очередям и сообщениям, используйте Web UI:
-Это обычная пара Access Key / Secret Key, выданная для вашего tenant.
 
-Примеры ниже работают в обоих режимах: с demo credentials и с собственными tenant credentials.
+1. Откройте `https://qu.kube5s.ru/ui/`
+2. В поле входа вставьте `API Token (nubes JWT)`
+3. Этот токен пользователь получает в панели управления облаком Nubes
+4. После успешного входа shared-SQS автоматически создаёт tenant и показывает `Access Key` и `Secret Key`
+5. Эти `Access Key / Secret Key` дальше используются в AWS CLI, boto3, AWS SDK for JavaScript и других клиентах
 
+Важно:
+- `Secret Key` показывается только один раз, его нужно сохранить
+- для AWS CLI и SDK нужен не UI token, а именно выданные сервисом `Access Key / Secret Key`
+
+Примеры ниже можно запускать либо с demo credentials, либо со своими tenant credentials.
 
 ## Быстрый старт через AWS CLI