Интеграция с License Manager API

Получите идентификатор шаблона подписки (license_template_id).

Идентификатор шаблона подписки можно посмотреть в кабинете партнера Cloud Marketplace. Используйте идентификатор в коде продукта, чтобы управлять подпиской.

В коде вашего продукта реализуйте следующие шаги:

1. Получение идентификатора установки приложения в кластер Kubernetes и привязка его к подписке. Пример кода.

2. Периодическая проверка того, что подписка активна.

   Получить актуальную информацию о подписке можно с помощью метода REST API list для ресурса Instance или вызова gRPC API InstanceService/List.

   Примечание

   Учитывайте, что пользователь может отвязать один ресурс от подписки и привязать к ней другой. Ваш код должен корректно обрабатывать такие случаи.

3. Организация бизнес-логики обработки подписок: учет потребления, ограничения по времени, количеству пользователей и т.п.

Получите идентификатор шаблона подписки (license_template_id).

Идентификатор шаблона подписки можно посмотреть в кабинете партнера Cloud Marketplace. Используйте идентификатор в коде продукта, чтобы управлять подпиской.

В коде вашего продукта реализуйте следующие шаги:

1. Периодическая проверка того, что подписка активна.

   Получить актуальную информацию о подписке можно с помощью метода REST API list для ресурса Instance или вызова gRPC API InstanceService/List.

   Примечание

   Учитывайте, что пользователь может отвязать один ресурс от подписки и привязать к ней другой. Ваш код должен корректно обрабатывать такие случаи.

2. Организация бизнес-логики обработки подписок: учет потребления, ограничения по времени, количеству пользователей и т.п.

Создайте сервисный аккаунт, от имени которого будете проверять активность подписок, купленных пользователями, и привязывать такие подписки к сервису:

1. Авторизуйтесь в кабинете партнера Marketplace.
2. Откройте раздел Управление доступом.
3. Нажмите Добавить федеративного пользователя.
4. В открывшемся окне укажите идентификатор сервисного аккаунта и нажмите Добавить.
5. Найдите сервисный аккаунт в списке и нажмите → Изменить.
6. В открывшемся окне нажмите + Добавить роль, выберите license-manager.saasSubscriptionSupervisor и нажмите Сохранить.

Аутентифицируйтесь в License Manager API от имени сервисного аккаунта. Для аутентификации используйте IAM-токен.

Создайте страницу, на которую нужно перенаправить пользователя во время привязки купленной им подписки к сервису.

При перенаправлении пользователя на такую страницу в строке запроса, в параметре token, передается JWT-токен (instanceToken), сгенерированный Yandex Cloud. JWT-токен действует 15 минут и содержит:

• идентификатор подписки, которую купил пользователь (license_instance_id);
• идентификатор шаблона подписки, который вы создали в кабинете партнера (license_template_id).

Пока действует JWT-токен, на созданной странице авторизуйте пользователя и присвойте ему уникальный идентификатор (resourceId). Уникальный идентификатор пользователя (resourceId) необходимо сгенерировать самостоятельно в коде продукта.

Привяжите уникальный идентификатор пользователя (resourceId) к купленной пользователем подписке (license_instance_id).

Привязать идентификатор к подписке можно с помощью метода REST API ensure для ресурса Lock или вызова gRPC API LockService/Ensure.

Передайте в запросе JWT-токен (instanceToken) и уникальный идентификатор пользователя (resourceId). В ответе вы получите идентификатор привязки (lock_id) — он находится в параметре metadata. Если в ответе ошибка, значит, подписка не привязалась к сервису и нужно попросить пользователя заново пройти все шаги.

Организуйте периодическую проверку того, что привязка подписки активна. Используйте для этого идентификатор привязки (lock_id), полученный на предыдущем шаге.

Получить актуальную информацию о привязке подписки можно с помощью метода REST API get для ресурса Lock или вызова gRPC API LockService/Get.

В ответе должен возвращаться активный ресурс Lock, для которого state = LOCKED, а время окончания действия подписки end_time находится в будущем.

Организуйте бизнес-логику обработки подписок: учет потребления, ограничения по времени, количеству пользователей и т.п.