Управление жизненным циклом подписки SaaS

Коммерческая платформа осуществляет управление всем жизненным циклом подписки SaaS после ее покупки конечным пользователем. Платформа использует целевую страницу, API выполнения, API операций и веб-перехватчик как инструмент управления активацией, использованием, обновлениями и отменой подписки SaaS. Счета выставляются конечному пользователю с учетом состояния подписки SaaS, которую обслуживает корпорация Майкрософт.

Состояния подписки SaaS

На следующей схеме приведены состояния подписки SaaS и доступные действия.

Приобретено, ожидает активации (PendingFulfillmentStart)

После того как конечный пользователь или поставщик облачных решений (CSP) приобретает предложение SaaS на коммерческой платформе, издатель уведомляется о покупке. Затем издатель может создать и настроить на своей стороне новую учетную запись SaaS для конечного пользователя.

Создание учетной записи:

1. Клиент выбирает кнопку "Настроить учетную запись", которая доступна для предложения SaaS после успешной покупки в Microsoft AppSource или портал Azure. Кроме того, клиент может использовать кнопку "Настроить сейчас " в сообщении электронной почты, которое они получат вскоре после покупки.
2. Затем корпорация Майкрософт уведомляет партнера о покупке, открыв URL-адрес целевой страницы с параметром токена (маркер идентификации покупки из коммерческой платформы) на новой вкладке браузера.

Примером такого вызова является https://contoso.com/signup?token=<blob>url-адрес целевой страницы для этого предложения SaaS в Центре https://contoso.com/signupпартнеров. Этот токен предоставляет издателю идентификатор, который однозначно идентифицирует покупку SaaS и клиента.

Совет

Не включайте символ знака фунта (#) в URL-адрес целевой страницы. В противном случае клиенты не смогут получить доступ к целевой странице.

Внимание

URL-адрес целевой страницы должен быть всегда активен и доступен, чтобы принимать вызовы от Майкрософт в любое время. Если целевая страница становится недоступной, клиенты не смогут зарегистрироваться и начать использование службы SaaS.

Затем издатель должен передать маркер обратно в Корпорацию Майкрософт, вызвав API Разрешения SaaS и введя маркер в качестве значения x-ms-marketplace-token header параметра. В результате вызова API разрешения маркер обменивается сведениями о покупке SaaS, например уникальном идентификаторе покупки, идентификаторе приобретенного предложения и идентификаторе плана.

На целевой странице клиент должен войти в новую или существующую учетную запись SaaS с помощью единого входа Microsoft Entra.

Примечание.

Издатель не получает уведомление о покупке предложения SaaS, пока клиент не запустит процедуру настройки со стороны Майкрософт.

Издателю необходимо реализовать единый вход, чтобы обеспечить взаимодействие с пользователем, которое требуется Майкрософт в рамках этого процесса. Не забудьте использовать мультитенантное приложение Microsoft Entra и разрешить рабочие и учебные учетные записи или личные учетные записи Майкрософт при настройке единого входа. Это требование относится только к целевой странице для пользователей, перенаправляемых в службу SaaS, которые уже выполнили вход с учетными данными Майкрософт. Единый вход не требуется для всех операций входа в службу SaaS.

Примечание.

Если для единого входа требуется, чтобы администратор предоставил разрешение на доступ к приложению, описание предложения в Центре партнеров должно отражать этот уровень разрешений администратора. Раскрытие такой информации требуется в соответствии с политиками сертификации коммерческих платформ.

После входа клиент должен завершить настройку SaaS на стороне издателя. Затем издатель должен вызвать API активации подписки, чтобы сообщить Azure Marketplace о том, что подготовка учетной записи SaaS завершена. Это действие запускает период выставления счетов клиента. Если вызов API активации подписки не выполнен успешно, клиент не взимается за покупку.

Покупатель и владелец учетной записи выставления счетов получают сообщение электронной почты, запрашивающее их для настройки учетной записи.

Примечание.

Издатель имеет 30 дней, чтобы разрешить ресурс, если состояние ожидаетсяFulfillmentStart, в противном случае ресурс будет пустым, так как период выставления счетов не был инициирован, и соответствующая покупка не будет выставлена счета за то, что состояние изменится на Unsubscribed. Клиент не будет выставлен счет за покупку.

Активно (Подписка оформлена)

Активно (Подписка оформлена) — это постоянное состояние должным образом подготовленной подписки SaaS. После того как вызов API активации подписки обработан на стороне Майкрософт, подписке SaaS присваивается статус Подписка оформлена. Теперь клиент может использовать службу SaaS на стороне издателя и выставляется счет.

Если подписка SaaS уже активна, клиент может выбрать управление интерфейсом SaaS в центре портал Azure или Microsoft 365 Администратор. Это действие также приводит к тому, что Майкрософт вызывает URL-адрес целевой страницы с параметром токена, как в процессе активации. Издатель должен различать новые покупки и управление существующими учетными записями SaaS, а также соответствующим образом обрабатывать вызов URL-адреса этой целевой страницы.

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

Обновляется (подписка оформлена)

Это действие означает, что обновление существующей активной подписки SaaS обрабатывается как корпорацией Майкрософт, так и издателем. Такое обновление может запускаться:

• клиентом на коммерческой платформе;
• поставщиком служб шифрования на коммерческой платформе;
• клиентом на сайте SaaS издателя (не относится к покупкам, совершенным поставщиком служб шифрования).

Для подписки SaaS доступно два типа обновлений:

• план обновления, когда клиент выбирает другой план подписки;
• Обновите количество, когда клиент изменяет количество приобретенных лицензий для подписки.

Обновление доступно только для активных подписок. Во время обновления подписки на стороне Майкрософт для нее сохраняется состояние "Активно".

Обновление запущено на коммерческой платформе

В этом потоке клиент изменяет план подписки или количество лицензий из центра портал Azure или Microsoft 365 Администратор.

1. После ввода обновления корпорация Майкрософт вызовет URL-адрес веб-перехватчика издателя, настроенный в поле веб-перехватчика Подключение ion на странице технической конфигурации в Центре партнеров с соответствующим значением для действий и других соответствующих параметров.
2. На стороне издателя необходимо внести требуемые изменения в службу SaaS и по завершении уведомить Майкрософт, вызвав действие Обновить статус API операций.
3. Если исправление отправляется с состоянием Сбой, процесс обновления не будет завершен на стороне Майкрософт. Подписка SaaS сохраняет существующий план и количество лицензий.

Примечание.

Издатель должен вызвать ИСПРАВЛЕНИЕ для обновления статуса API операций с откликом "Сбой/Успешно" в течение 10 секунд после получения уведомления от веб-перехватчика. Если состояние операции PATCH не получено в течение 10 секунд, план изменений автоматически обновляется в виде успешного выполнения.

Последовательность вызовов API в сценарии обновления, запущенного на коммерческой платформе, показана на следующей схеме.

Обновление запущено издателем

В этом потоке клиент изменяет план подписки или количество лицензий, приобретенных самой службой SaaS.

1. Перед внесением запрошенных изменений на стороне издателя код издателя должен вызвать API плана изменений или API изменения количества или оба.

2. Корпорация Майкрософт применит изменения к подписке, а затем уведомит издателя через веб-перехватчик Подключение ion, чтобы применить то же изменение.

3. Только после этого издатель должен внести необходимые изменения в подписку SaaS и уведомить Майкрософт о завершении операции изменения, вызвав действие Обновить статус API операций.

Последовательность вызовов API в сценарии обновления, запущенного на стороне издателя, показана на следующей схеме.

Уведомление, указывающее на изменение плана, будет отправлено как покупателю, так и владельцу учетной записи выставления счетов.

Уведомление, указывающее на изменение количества, будет отправлено как покупателю, так и владельцу учетной записи выставления счетов.

Приостановлено (приостановлено)

Это состояние означает, что платеж клиента за службу SaaS не был получен. Корпорация Майкрософт уведомит издателя об этом изменении в состоянии подписки SaaS. Уведомление выполняется посредством вызова веб-перехватчика с параметром действия со значением Приостановлено.

Издатель мог внести или не вносить изменения в службу SaaS на стороне издателя. Рекомендуется, чтобы издатель сделал эти сведения доступными клиенту, для которого приостановлено действие подписки, а также ограничил или заблокировал доступ клиента к службе SaaS. Существует вероятность того, что платеж никогда не будет получен.

Примечание.

Майкрософт предоставляет клиенту 30-дневный льготный период, прежде чем подписка будет автоматически отменена. После 30-дневного льготного периода через веб-перехватчик получит Unsubscribe действие.

Если подписка находится в состоянии Приостановлено:

• Партнер или независимый поставщик ПО должны обеспечить возможность восстановления учетной записи SaaS с полной функциональностью, без потери данных или параметров.
• Партнеру или независимому поставщику ПО следует ожидать запроса на возобновление подписки, если оплата получена в течение льготного периода, или запроса на отмену подготовки подписки в конце льготного периода. Оба запроса отправляются с помощью веб-перехватчика.

До выполнения каких-либо действий издателем состояние подписки изменится на "Приостановлено" на стороне Майкрософт. Приостановить можно действие только активных подписок.

Уведомление, указывающее на изменение состояния на "приостановлено", будет отправлено как покупателю, так и владельцу учетной записи выставления счетов.

После 30-дневного периода приостановки сообщение электронной почты о отмене после приостановки будет отправлено как покупателю, так и владельцу учетной записи выставления счетов.

Возобновлено (приостановлено)

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

1. Майкрософт вызывает веб-перехватчик с параметром действия, для которого задано значение Возобновить.
2. Издатель гарантирует, что на стороне издателя функциональность подписки будет полностью восстановлена.
3. Возобновление выполнено успешно, и клиенту выставляется счет за подписку SaaS.

Можно возобновить только приостановленную подписку. Приостановленная подписка SaaS сохраняет состояние Приостановлено в течение процесса возобновления. После завершения этой операции состояние подписки изменится на Активно.

Сообщение электронной почты будет отправлено как покупателю, так и владельцу выставления счетов после перехода с приостановленного состояния на восстановленное состояние.

Продлено (подписка оформлена)

Подписка SaaS автоматически продлевается корпорацией Майкрософт после окончания срока подписки (один месяц или один год). Для всех подписок SaaS для параметра автоматического продления по умолчанию устанавливается значение true. Активные подписки SaaS по-прежнему будут регулярно продлеваться. Корпорация Майкрософт предоставляет уведомления веб-перехватчика только для обновления. Клиент может отключить автоматическое продление подписки SaaS в Центре администрирования Microsoft 365. В этом случае подписка SaaS будет автоматически отменена по окончании текущего оплаченного периода. Клиенты также могут в любое время самостоятельно отменять подписку SaaS.

Автоматически продлеваются только активные подписки. Подписки остаются активными в процессе обновления, а также после успешного продления. После продления даты начала и окончания срока действия подписки будут обновлены с учетом продления.

Если продление не удается выполнить автоматически из-за проблемы с оплатой, подписка будет переведена в статус Приостановлено, и издатель получит соответствующее уведомление.

Сообщения электронной почты напоминания о продлении будут отправляться как покупателю, так и владельцу учетной записи выставления счетов, 30 дней до даты ежегодного или многолетнего продления.

Отменено (подписка отменена)

Подписки переводятся в этой состояние в результате явного действия клиента или поставщика служб шифрования — например, отмена подписки на сайте издателя, на портале Azure или в Центре администрирования Microsoft 365. Подписка также может быть отменена неявным образом в результате неуплаты, если подписка находится в статусе Приостановлено в течение 30 дней.

После того как издатель получит вызов веб-перехватчика для отмены подписки, он обязан хранить данные клиента для восстановления по запросу, как минимум, в течение семи дней. Только после этого можно удалить данные клиента.

Подписка SaaS может быть отменена на любом этапе жизненного цикла. После отмены подписку нельзя активировать повторно.

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

Следующие шаги

• API подписки SaaS версии 2
• API операций выполнения SaaS версии 2

Видеоучебники

• Создание простого портала издателя SaaS в .NET
• Использование API выполнения предложения SaaS