发布许可证激活的计算巢私有部署商品_云市场(Marketplace)-阿里云帮助中心

一、场景说明

软件在云上通常通过许可证管理系统来实现权限控制。如果厂商希望将软件上架至云市场售卖，需要完成许可证管理系统与云市场的对接。若服务商存在许可证激活需求，如需要发送许可证激活码给用户，可通过SPI（SPI，Software Provider Interface，标准协议接口）方式实现。

整体流程为：服务商预先在云市场配置好SPI，当用户在云市场完成下单和付款后，云市场会通过SPI与厂商的许可证管理系统交互，服务商通过SPI将许可证信息返回给云市场。如果是计算巢私有化部署商品，同时云市场也会将该信息传递至计算巢。此时，服务商可以在计算巢中处理返回的许可证信息，例如将其展示给用户以便手动输入激活，或直接用于脚本中的自动激活命令执行。这一流程确保用户在购买服务后能够快速激活并使用软件。

本文将介绍如何通过云市场SPI方式完成计算巢私有化部署商品的许可证激活流程。

二、前提说明

在云市场发布应用软件类商品/镜像商品，ISV首先入驻到阿里云云市场，成为云市场的ISV合作伙伴。

入驻请点击：云市场服务商使用指引

如果软件通过计算巢私有化部署进行线上一键部署，需要在计算巢控制台进行服务模板的创建。服务模板创建请点击：计算巢

三、商品发布和管理说明

第1步：伙伴的License Server和云市场的SPI进行对接

对接的流程包括新购、续费、实例释放3个环节。确保用户购买商品、退款、释放实例后伙伴侧能从云市场拿到软件实例信息、实例的有效时间，以确保许可证ID的有效期和云市场软件商品的实例的有效期保持一致。

SPI的接入说明可以参看：云市场生产SPI。填写可用的接口地址，以http(s)://开头。

新购流程

通过实例创建的SPI进行通知和回调，在许可证返回时重点关注返回参数：appInfo中的LicenseId（许可证ID）, LicenseValidPeriod（许可证有效期）,LicenseForUseGuide（使用说明地址）。以确保买家可以在云市场买家控制台的实例列表和实例详情中上得到许可证相关信息。

续费流程

对于周期类包年包月商品，当用户对包年包月商品进行续费时会调用生产地址实例续费，服务商收到续费实例调用后，根据续费时长延长许可证（License ID）的使用时间。其中应用信息中，伙伴返回对应的许可证ID的时间。

实例释放流程

当用户购买的实例到期一段时间后且一直未续费，或按量计费商品实例欠费一段时间后，会调用生产地址实例释放，服务商收到过期实例调用后，可以作废原许可证。

第2步：在计算巢服务模板中Parameters、Outputs、Metadata中新增配置

服务模板修改请点击：计算巢

Parameters:
  licenseId:
      Type: String
      Default: ''
  licenseValidPeriod:
    Type: String
    Default: ''
  licenseForUserGuide:
    Type: String
    Default: ''
  ……(其他参数)
Outputs:
  licencesId:
    Value:
      Ref: licenseId
  licenseForUserGuide:
    Value:
      Ref: licenseForUserGuide
  licenseValidPeriod:
    Value:
      Ref: licenseValidPeriod
  ……(其他参数)
Metadata:
  ALIYUN::ROS::Interface:
    Hidden:
      - licenseId
      - licenseForUserGuide
      - licenseValidPeriod
  ……(其他参数)

第3步：伙伴在关联计算巢服务模板后，填入SPI地址

路径为：商品发布 ->发布SaaS商品-> 填写接入信息-> 应用开通方式选择“计算巢部署”->配置生产通知选“是” -> 填写对应的生产地址信息

第4步：修改SPI地址

计算巢私有化部署商品发布之后需要对整体流程进行测试，商品正式发布后，不允许伙伴在服务商控制台进行商品管理。如果发布商品时SPI地址填写有误，需要修改，可以提交工单给云市场小二，由云市场小二进行确认后进行修改。