top
登录 | 注册

拱墅平台对接

目录

  • 1  用户对接

  • 2  资源对接

  • 3  帮助接口

  • 1. 用户对接

  • 目的:
    浙江平台对拱墅平台开放帐号登录,用户可使用其在浙江平台注册的帐号直接访问拱墅平台,或绑定其在拱墅平台的帐号后自动登录拱墅平台

  •  

  • 实现流程:

1496743052241070546.png


  • 实现步骤:
        一:加载浙江省平台logo配置访问参数
    1435646838648075313.jpg                说明:
    1.加载浙江省平台Logo;
    2.链接参数:
                    http://duijie.zjer.cn/oauthserver?client_id=xxxxxx&response_type=code
                                &state=x&redirect_uri=xxxxxx
                    client_id:拱墅平台id【省平台分配】
    state:拱墅平台标识【原样带回的参数,一般是记录应用登录用户Id】
    response_type:oauth服务响应类型,默认值code
                    redirect_uri:回调地址
    3.拱墅平台访问地址:http://study.gsjy.net/zsjypt/index.action

                     二:授权流程
     
    1435646838735067074.jpg                  说明:
    1.输入浙江省平台帐号和密码;
    2.验证用户信息和配置参数成功重定向到回调地址;
    3.回调地址格式:
       回调地址?clientid=xxxxxx&code=xxxxxx&state=x

                                      三:不存在用户绑定关系实现登录

     
    1435646838758023493.jpg                   说明:
    1.如果拱墅平台和浙江省平台授权用户没有绑定关系有此场景,有绑定关系直接进入下图场景;
    2.输入拱墅平台帐号和密码点击绑定:
    3.点击绑定后实现绑定的拱墅帐号自动登录

      四:存在用户绑定关系实现登录

                       
    1435646838783045261.png                    说明:
    1.实现与浙江省平台授权用户绑定的拱墅区域用户登录

      注:
      1.回调地址是拱墅平台一个中转地址
      2.中转地址内容要实现如下功能:
      2.1
    调用获取令牌接口【回调地址会回传一个code参数,根据code和配置参数获取】
      2.2
    调用获取用户基本信息接口【根据令牌获取】
      2.3 判断拱墅平台帐号是否存在绑定当前浙江省平台帐号和令牌
      2.3.1 不存在绑定关系跳转到绑定页面,实现拱墅帐号绑定当前浙江省平台帐号和令牌并实现登录并且保留绑定关系
      2.3.2 存在绑定关系实现拱墅绑定帐号登录并且更新绑定的令牌
      3.每次走完授权流程或拱墅平台用户获取到新令牌都要更新绑定的令牌【令牌是有有效期的】
                   

  •  

  • 2. 资源对接

  • 目的:
    拱墅平台加载浙江省平台的开放资源列表,在绑定浙江省平台开放的帐号前提下访问浙江省平台的资源,实现在浙江省平台自动登录

  •  

  • 实现流程:

1496743124834071522.png


  • 实现步骤:
                    一:加载浙江省平台资源

    1435646838832090846.png1435646838832090846.png

  •  

  • 说明:
    1.加载浙江省平台资源可以通过空间接口或资源接口获取【详细见API文档】;
    2.  访问资源URL:
    http://yun.zjer.cn/index.php?r=portal/app&access_token=xxxxxx
                   &client_id=xxxxxx&response_type=code&state=x
                   &redirect_uri=xxxxxxx&resource_url=xxxxxx
    参数:
    access_token:令牌
    client_id:拱墅平台Id
                   response_type:oauth服务响应类型,默认值code
                   state:拱墅平台用户标识【一般是userid】
    redirect_uri:回调地址【必须转码】
    resource_url:资源地址【必须转码】

                                    二:访问资源【令牌有效】

    1435646838853029459.jpg

  •  

  • 说明:
    1.在浙江省平台验证令牌有效的前提下;
    2.浙江省平台会根据令牌绑定的用户实现登录;
    3.浙江省平台会激活该令牌的有效期并访问当前资源;

                    三:访问资源【令牌失效】

1435646838735067074 (1).jpg

  •  

  • 说明:
    1.在浙江省平台验证令牌失效的前提下;
    2.令牌失效重新走授权流程;
    3.跳转到回调地址【中转地址】,更新令牌重定向资源地址
    3.1查询当前浙江省平台授权登录用户有没有和拱墅平台用户有绑定关系
    3.1.1 如果存在绑定关系,直接更新绑定令牌并重定向到资源地址
    3.1.2 如果不存在绑定关系,跳转到绑定页面输入拱墅平台帐号和密码进行绑定并重定向到资源地址
                    注:
    1.浙江省平台授权用户绑定拱墅平台用户流程:
    1.1 回调地址获取code
    调用获取令牌接口
    1.2 根据令牌参数调用获取用户基本信息接口
    2.浙江省平台令牌有效期为2周【时间是最后使用算去】
    3.令牌绑定了拱墅平台用户只能给该用户使用,不能共享给其他用户

  • 3. 帮助接口

  •                                

  • 3.1 获取令牌接口

    1435646839433099812.jpg

  • 说明:
    1.url: http://duijie.zjer.cn/oauthserver/rest/getaccesstoken
                    2.参数:
    client_id:拱墅平台id
                    code:获取令牌的参数
    grant_type:权重类型 默认值authorization_code
                    client_secret:根据Hmac算法client_id+client_key+code  加密的
    3.加密帮助文件下载:
    加密文件

  • 3.2 获取用户基本信息接口

    1435646839784074611.jpg


  •  

  • 说明:
    1.url: http://duijie.zjer.cn/oauthserver/rest/getbaseinfo
                   2.参数:
    access_token:令牌

 


My JSP 'bottom.jsp' starting page

中国教育云-浙江教育资源公共服务平台开发者后台管理 站长统计

版权所有:浙江省教育厅 指导:中央电化教育馆 主办:浙江省教育技术中心
技术支持:武汉天喻信息产业股份有限公司
©2017 yun.zjer.cn All rights reserved 浙ICP备09059518号-3