Skip to content

Подключение CCBoot к IZI

Опубликовано: · Обновлено: (5 дней назад)· IZI Team

CCBoot Cloud хранит общий образ Windows на сервере клуба и загружает игровые ПК по сети. IZI подключается к нему через API iCafeCloud: включает ПК и обновляет клиент IZI в общем образе из Центра управления. Эта инструкция проводит от выдачи доступа в iCafeCloud до готового подключения в CRM.


Что понадобитсяГде взять
Работающий CCBoot CloudПанель iCafeCloud клуба: раздел Boot, список ПК и назначенный им образ Windows.
Учётная запись Admin в iCafeCloudУ владельца лицензии CCBoot. Она даёт доступ к созданию API-токена.
Исходящий IP интеграции IZI81.26.188.3 — фиксированный адрес для поля API Access IP в iCafeCloud.
Доступ к настройке Boot в IZIУ сотрудника с разрешением BOOT_CONFIG_MANAGE.
Клиент IZI в общем образеДля первичной подготовки образа с клиентом IZI в режиме бездисковых ПК обратитесь в поддержку IZI. После загрузки ПК появляется в CRM со своим именем Windows.

  1. Войдите в облачную панель iCafeCloud под учётной записью Admin.
  2. Откройте Settings → API settings.
  3. В поле API Access IP укажите 81.26.188.3 — фиксированный исходящий IP интеграции IZI. Если поле уже содержит адреса других сервисов, добавьте 81.26.188.3 к списку через запятую, сохранив остальные адреса.
  4. Скопируйте License ID — в CRM он используется как Cafe ID.

Настройки API в iCafeCloud: License ID, поле API access IP и кнопка Create

Скриншот из инструкции iCafeCloud по API. Значения на иллюстрации относятся к примеру; для своего клуба используйте собственный License ID и IP интеграции IZI 81.26.188.3.

IZI отправляет запросы к iCafeCloud через выделенный прокси с зарезервированным статическим адресом 81.26.188.3. Этот адрес сохраняется при замене сервера прокси.


  1. На этой же странице нажмите Create.
  2. Подтвердите выпуск ключа кнопкой Yes.
  3. Нажмите Copy и сохраните выданный токен в менеджере паролей: окно выдачи показывает его один раз.

Подтверждение выпуска API-ключа в iCafeCloud, кнопка Yes

Источник: iCafeCloud — API settings.

У iCafeCloud действует один API-ключ на лицензию. Выпуск нового ключа заменяет прежний: запланируйте обновление ключа во всех сервисах, которые используют API этой лицензии. Срок действия — один год. При переносе лицензии в другую серверную группу iCafeCloud выпустите ключ заново и обновите подключение в IZI.


В IZI CRM откройте Настройки → Оборудование → Зоны. Для зон с ПК CCBoot включите Бездисковая зона. Режим редактируется, пока зона пустая; после добавления устройств он закрепляется за зоной. Подробнее о настройке зон.

Распределите ПК CCBoot по этим зонам. В разделе «Сетевая загрузка» система загрузки выбирается отдельно для зон с локальным диском и для бездисковых зон. Подключение CCBoot относится к бездисковым зонам клуба.


Откройте Настройки → Оборудование → Хранилище игр, в блоке Бездисковые зоны на карточке CCBoot нажмите «Настроить →».

Поле в CRMЧто ввести
Cafe IDЧисловой License ID из iCafeCloud.
API URLhttps://api.icafecloud.com — адрес уже заполнен в форме.
API tokenКлюч, скопированный после нажатия Create. Вставьте само значение токена. Заголовок авторизации IZI сформирует при отправке запроса.

Нажмите «Сохранить», затем «Проверить подключение». При проверке IZI запрашивает список загрузочных ПК клуба в iCafeCloud. Сообщение об успешной проверке подтверждает доступ с сохранёнными параметрами.

Пометка «Подключено» на карточке показывает наличие сохранённой настройки. Результат обращения к iCafeCloud показывает действие «Проверить подключение».

После сохранения токен скрыт. Для его замены нажмите «Изменить» у поля токена, вставьте актуальный ключ и сохраните форму. При редактировании Cafe ID или API URL сохранённый ключ продолжает использоваться.


Откройте список ПК в Boot → Computers панели iCafeCloud и сведения о том же устройстве в IZI. Сверьте полное имя компьютера Windows: оно должно точно совпадать с именем ПК в CCBoot, включая регистр и ведущие нули.

ЗначениеПример
Имя ПК в CCBootPC01
Имя компьютера Windows, переданное клиентом IZIPC01
Номер места в CRM01

IZI использует полное имя компьютера для поиска ПК в CCBoot. Номер места служит для отображения в зале. Сверьте также назначенный ПК загрузочный образ: обновление клиента сохраняется в образ выбранной машины.

Подключение готово: параметры сохранены, проверка подключения завершилась успешно, ПК находятся в бездисковых зонах, имена компьютеров совпадают с CCBoot.


Для обновления выделите свободный ПК с работающим клиентом IZI. На время операции он становится редактором общего образа и проходит две перезагрузки. Для каждого образа обновление выполняется на одном ПК за раз.

  1. В Центре управления откройте меню команд выбранного ПК → «Обновление образа».
  2. Нажмите «Начать».
  3. Следите за этапами в окне операции: включение Super Client → обновление клиента в образе → сохранение в образ → возврат в обычный режим.
  4. Дождитесь завершения операции. Затем перезагрузите остальные свободные ПК, использующие этот образ, чтобы они загрузили сохранённую версию клиента.

Окно операции можно закрыть: состояние остаётся на плитке ПК, а обновление продолжается на сервере.

Если CRM показывает инструкцию включить Super Client вручную, откройте панель iCafeCloud → Boot → Computers, нажмите правой кнопкой по тому же ПК → Enable super client, выберите диск образа и подтвердите OK. IZI продолжит обновление после включения режима.

Меню компьютера в панели CCBoot Cloud, команда Enable super client

Источник: CCBoot Cloud — Super client.

Если CRM просит сохранить образ вручную, выключите ПК-редактор. После появления статуса Offline выберите Disable super client, включите Update the Image, добавьте описание обновления и нажмите OK. Дождитесь окончания сохранения.

Сохранение изменений: Update the Image и описание обновления в окне Disable super client

Источник: CCBoot Cloud — Super client.


СитуацияДействие
Ошибка авторизации APIУбедитесь, что API Access IP содержит 81.26.188.3, проверьте срок ключа и актуальность токена в CRM. После перевыпуска ключа сохраните его в IZI.
Ответ Url not matchСверьте Cafe ID с License ID нужного клуба и API URL с https://api.icafecloud.com.
Ограничение частоты запросовДождитесь снятия ограничения iCafeCloud и повторите проверку подключения.
Тайм-аут или ошибка связи с APIПередайте поддержке IZI название клуба, время обращения и сообщение CRM для проверки канала связи с iCafeCloud.
Соединение успешно, команда к конкретному ПК завершается ошибкойСверьте его зону, полное имя Windows, имя в списке CCBoot и назначенный образ.
Образ уже занят обновлениемДождитесь завершения текущего обновления этого образа.
ПК-редактор требует восстановления связиПерезагрузите его и дождитесь появления онлайн в IZI; операция продолжится после восстановления связи.

Частые вопросы

Какой IP указать в API Access IP?

Укажите 81.26.188.3 — фиксированный исходящий IP интеграции IZI. Запросы к iCafeCloud отправляет сервер IZI через выделенный прокси с этим адресом.

Где взять Cafe ID?

В панели iCafeCloud откройте Settings → API settings и скопируйте License ID. Идентификатор также указан в лицензии iCafeCloud.

Как связать ПК с CCBoot?

Привяжите ПК к бездисковой зоне IZI и сверьте полное имя Windows с именем ПК в CCBoot, например PC01. IZI сопоставляет устройства по этому имени.

Что делает команда «Обновление образа»?

Обновляет клиент IZI в общем образе через Super Client: включает редактирование, устанавливает клиент, сохраняет образ и возвращает ПК в обычный режим.

О продукте IZI