Як зробити · 5 хв
Видати й відкликати облікові дані
Облікові дані конектора дають вашому пристрою або шлюзу вхід на брокер Lab і власні топіки. Тут — як їх видати, безпечно зберегти, замінити і відкликати.
OBSERVE і CONTROL
| Можливість | Що дозволяє і хто видає |
|---|---|
| OBSERVE | Публікувати state, telemetry і hello. Видають власник, адміністратор або розробник. Обирається типово. |
| CONTROL | Ще й публікувати receipt і отримувати команди зі свого топіка commands. Видають лише власник або адміністратор з явним підтвердженням. |
Облікові дані CONTROL самі по собі не вмикають запис. Для команд ще потрібні локальний дозвіл на запис і окремий дозвіл власник чи адміністратор в Lab.
Видати облікові дані
Відкрийте джерело
На сторінці MQTT- або Home Assistant-джерела перейдіть до розділу «Конектор», панель «Облікові дані конектора». Для симулятора облікові дані не потрібні.
Оберіть можливість
У полі «Можливість» залиште OBSERVE, якщо потрібна лише телеметрія. Для CONTROL позначте «Надаю цьому конектору право отримувати обмежені Lab-команди».
Задайте термін дії
«Термін дії, секунд» — від 60 до 604800 (сім днів). Типово 86400, тобто доба. Коротший строк безпечніший.
Видайте дані
Натисніть «Видати дані один раз». З’явиться блок «Збережіть приватний файл зараз» із паролем і топіками.
Збережіть файл
Натисніть «Завантажити приватний файл» (lab-credential.json). На POSIX дайте йому права 0600, у Windows — приватний ACL. Потім натисніть «Закрити та очистити секрет».
Пароль показується лише один раз. Lab зберігає тільки його хеш SHA-256 і не може показати його знову. Не вставляйте пароль у профіль, тікет чи чат. Якщо файл загубився, видайте нові дані з ротацією.
Ротація
Поки є активні облікові дані, нові без ротації не видаються. Щоб замінити їх, позначте «Замінити наявні активні дані та відкликати попередні» і натисніть «Видати дані один раз».
Lab спершу закриває доступ старих даних і роз’єднує їхню сесію, а потім створює нові. Нові дані мають новий ідентифікатор, ім’я користувача, пароль і топіки. Оновіть файл у конекторі й перезапустіть його.
Відкликання
Натисніть «Відкликати»
Кнопка є біля даних у стані ACTIVE, PENDING або REVOKING. Відкликати можуть лише власник і адміністратор.
Підтвердьте
Натисніть «Підтвердити відкликання». Якщо стан лишився REVOKING, відкликання можна безпечно повторити.
Відкликання закриває доступ конектора й запитує відновлення активної команди. Воно не підтверджує виміряне відновлення: дивіться хронологію доказів.
Lab також відкликає дані сам: коли минає строк дії, коли в того, хто їх видав, забрали роль чи запрошення. Щоб прив’язати нову версію профілю до джерела, живих облікових даних бути не повинно.
Стани облікових даних
| Стан | Що означає |
|---|---|
| PENDING | Видача триває. Якщо її перервано, Lab вимикає дані, а не активує їх. |
| ACTIVE | Дані діють до вказаного строку. |
| REVOKING | Доступ у Lab уже закрито, але брокер ще не підтвердив очищення. |
| REVOKED | Відкликано й підтверджено. Знову активувати не можна. |
| EXPIRED | Строк дії минув. |
Типові проблеми
| Повідомлення | Що робити |
|---|---|
| active credential exists; explicitly rotate it | Позначте ротацію або спершу відкличте активні дані. |
| explicit bounded-control credential consent required | Для CONTROL позначте підтвердження під формою. |
| credential provisioning/revocation must reconcile first | Попередня видача чи відкликання ще не завершилися. Оновіть сторінку трохи згодом. |
| isolated Lab broker is not configured | Брокер Lab не налаштований. Зверніться до адміністратора Lab. |
| CONTROL | Немає такого варіанта — у вас роль розробника. Попросіть власника або адміністратора. |