Вхід у Zammad за API-токеном

Автор: Міхал, розробник Zamio · Оновлено:

Zamio входить у Zammad за допомогою особистого API-токена, а не пароля. Ви вводите його один раз і більше не думаєте про вхід. На цій сторінці описано, що має увімкнути адміністратор і що робить кожен агент.

Чому токен, а не пароль

Я обрав токени з міркувань безпеки, а ще тому, що на телефоні це найпрактичніший варіант:

  • Ваш пароль ніколи не потрапляє в додаток. Це працює і тоді, коли ви входите в Zammad через SSO або користуєтеся двофакторною автентифікацією.
  • Обмежені дозволи. Токен отримує лише ticket.agent, і цього достатньо для всього, що робить додаток.
  • Його можна будь-коли відкликати в Zammad без зміни пароля, наприклад якщо ви загубили телефон.
  • Він залишається на пристрої. Токен зберігається в iOS Keychain або Android Keystore. Він не зберігається в жодній хмарі. Додаток підключається безпосередньо з вашого телефона до Zammad вашої компанії.

Для адміністраторів: дозвольте доступ за токеном

  1. У Zammad відкрийте налаштування адміністратора (значок шестерні) і перейдіть до Налаштування → Система → API.
  2. Увімкніть доступ за API-токеном (API Token Access).

Якщо агент і далі не бачить у профілі пункту Доступ за токеном (Token Access), перевірте, чи має його роль дозвіл user_preferences.access_token (Керування → Ролі).

Для агентів: створіть токен

  1. У Zammad у браузері натисніть свої ініціали або аватар у лівому нижньому куті й оберіть Профіль → Доступ за токеном (Profile → Token Access).
  2. Натисніть Створити (Create).
  3. Назва: щось, що підкаже, де токен використовується, наприклад Zamio – iPhone.
  4. Дозволи: позначте ticket.agent.
  5. Дата закінчення дії: необов'язково. Без неї токен працює, доки ви його не видалите.
  6. Натисніть Створити й одразу скопіюйте токен. Zammad показує його лише один раз.

Порада: відкрийте Zammad у браузері на самому телефоні й створіть токен там. Тоді ви просто вставите його в додаток, і не доведеться пересилати його собі поштою чи в месенджері.

Увійдіть у Zamio

  1. URL сервера: адреса, за якою ви відкриваєте Zammad у браузері, наприклад https://support.company.ua, без нічого після домену.
  2. API-токен: вставте токен.

Готово. Ви залишаєтеся авторизованими, доки не вийдете або доки токен не закінчиться чи не буде видалений.

Загублений телефон або звільнення працівника

Видаліть токен у Zammad у розділі Профіль → Доступ за токеном. Додаток одразу втрачає доступ до Zammad. Обліковий запис і пароль не змінюються.

Вирішення проблем

«Недійсний API-токен»
Токен скопійовано не повністю, термін його дії минув або його видалено. Наявний токен переглянути знову не можна, тому створіть новий, а старий видаліть.
Я не бачу «Доступ за токеном» у профілі
Адміністратор не увімкнув доступ за API-токеном, або ваша роль не має дозволу user_preferences.access_token. Див. розділ для адміністраторів вище.
Додаток не може підключитися до сервера
Перевірте адресу: https:// на початку, жодного шляху після домену, і та сама адреса, що й у браузері. Якщо Zammad доступний лише в мережі компанії або через VPN, телефон також має бути в цій мережі.
Бракує заявок або груп
Додаток бачить рівно те, що бачить ваш обліковий запис у Zammad. Якщо чогось бракує, перевірте свої групи та ролі в Zammad.

Після входу наступний крок — налаштування push-сповіщень.