免费注册
帮助文档(华北一、二)

  • 1   简介

    本文档是云市场“SaaS商品接口开发的描述,服务商将商品接入到云市场平台售卖,需要服务商对接实现生产接口开发。

    SaaS商品上架后,浪潮云市场用户下单购买、退订等,云市场将购买的用户信息、商品信息等调用服务商的生产接口同步到服务商侧,服务商将生产结果返回给云市场。用户在云市场已购买的服务中,可以免登录直接跳转到服务商SaaS产品的使用页面。

    2   适用对象

    云市场“SaaS接入类商品,适合哪些商品接入?

    服务商的商品符合以下全部特点,即适合接入:

    Ø  用户可以通过服务商的网站,直接进行注册、登录即可管理使用的软件;

    Ø  属于在线应用类的软件,业内一般称为“SaaS”软件;

    Ø  用户无需将软件部署到独立的云资源上即可使用的软件。

    3   接入前期准备

    3.1   完成注册

    服务商请联系浪潮云市场对接人完成SaaS系统在云市场的注册。请先实现并提供‘新购商品’接口。

    3.2   完成程序的改造

    为了实现“用户在云市场已购买的服务中,可以免登录直接跳转到服务商SaaS产品的使用页面”,请对SaaS系统做以下改造:

    3.2.1    引入jar

    siam-am-agent-simple-2.1.RELEASE.jar

            siam-am-agent-simple-2.1.RELEASE.rar

    3.2.2    引入私钥和证书

    resources目录下添加文件夹cert,并在该文件夹下引入私钥&证书文件spdev.tiam.sinopec.com.jkskeystore

            spdev.tiam.sinopec.com.rar

     

    resources目录下添加文件夹conf,并在文件夹下引入sp-simple-config.properties文件

    sp-simple-config.rar

     

    3.2.3    web.xml的改造

    请将以下内容加入到现有的web.xml中:

           <context-param>

            <param-name>spSimpleConfigFile</param-name>

            <param-value>classpath:/conf/sp-simple-config.properties</param-value>

             </context-param>

     

        <!-- Filter for SAML handler -->

        <filter>

            <filter-name>com.sinopec.siam.agent.web.SAMLProfileFilter</filter-name>

            <display-name>com.sinopec.siam.agent.web.SAMLProfileFilter</display-name>

            <filter-class>com.sinopec.siam.agent.web.SAMLProfileFilter</filter-class>

        </filter>

        <filter-mapping>

            <filter-name>com.sinopec.siam.agent.web.SAMLProfileFilter</filter-name>

            <url-pattern>/SSO/*</url-pattern>

        </filter-mapping>

        <filter>

            <filter-name>AccessEnforcer4TamLdap</filter-name>

            <display-name>AccessEnforcer4TamLdap</display-name>

            <filter-class>com.sinopec.siam.agent.web.AccessEnforcer</filter-class>

            <init-param>

                <param-name>AuthenticationMethod</param-name>

                <param-value>urn:oasis:names:tc:SAML:2.0:ac:classes:TAMUsernamePassword</param-value>

            </init-param>

            <init-param>

                <param-name>noFilterURLs</param-name>

                <param-value>/cloudmap/getUserInfoBamboo</param-value>

            </init-param>

        </filter>

        <filter-mapping>

            <filter-name>AccessEnforcer4TamLdap</filter-name>

            <url-pattern>/*</url-pattern>

        </filter-mapping>

     

    4   接口描述

    4.1  新购商品

    4.1.1    描述

    客户购买商品并付款成功,云市场将调用本接口通知SaaS服务商购买商品的客户信息。

    4.1.2    请求方式

    该接口以HTTP POST方式调用,消息传输以JSON格式。

    4.1.3    请求参数

    参数描述

    参数ID

    类型及范围

    是否必填

    邮箱

    email

    String

    必填

    手机号码

    mobile

    String

    必填

    4.1.4    返回参数

    参数描述

    参数ID

    类型及范围

    是否必填

    接口调用是否成功

    status

    String

    必填

    success表示成功;fail表示失败。

    4.1.5    报文样例

    请求报文

    {

    "email":zhangsan@qq.com,

        "mobile":"张三的11位手机号码"

    }

    响应报文

    {

    "status": "success"

    }

     

    4.2   获取登录用户信息

    4.2.1    描述

    用户在云市场已购买的服务中,免登录直接跳转到服务商SaaS系统时,服务商通过该接口获取到用户信息。

    4.2.2    请求方式

    调用siam-am-agent-simple-2.1.RELEASE.jarSSOPrincipal类的getSingleValue方法。

    4.2.3    样例

    SSOPrincipal ssoPrincipal = ((SSOPrincipal) -session.getAttribute(SSOPrincipal.NAME_OF_SESSION_ATTR));

         String phone = ssoPrincipal.getSingleValue("mobile"); // 获取登录用户的手机号

    String email= ssoPrincipal.getSingleValue("email");  // 获取登录用户的email

     

    4.3   退订商品(201802月提供)

    4.3.1    描述

    云市场将在客户购买的商品过期时调用该接口,服务商接到该通知以后应该将指定的实例冻结。

文档是否已解决您的问题?

  已解决   未解决

如您有其它疑问,您也可以与我们技术专家联系探讨。

联系技术专家