集成第三方原生应用

1. 在AWS平台为第三方应用注册SSO服务
2. 第三方原生应用进行SSO集成开发
3. 将第三方原生应用添加到AWS平台

1. 在AWS平台为第三方应用注册SSO服务

进行此步骤前需先安装AWS应用SSO单点登录管理， 如不需要与第三方应用进行SSO集成， 可跳过此步骤

1.登录AWS控制台， 找到并打开「工具附加>SSO单点登录管理」。

2.点击「新建」按钮进行SSO服务注册。

3.点击「保存」按钮后，可获得调用该SSO验证的access_key。

Android集成开发

第三方应用在manifest.xml中注册隐式Intent，该Intent的action name需要与第三方应用的package name保持一致。 假设package name是com.actionsoft.entaddress, 则Intent应为：

    <activity
        android:name="com.actionsoft.entaddress.MainActivity"
        android:configChanges="orientation|keyboard|keyboardHidden|screenSize">
        <intent-filter>
            <action android:name="com.actionsoft.entaddress" />
            <category android:name="android.intent.category.DEFAULT" />
        </intent-filter>
    </activity>

AWS移动门户调用该Intent打开三方应用， 并传递tokenId参数。

    Intent intent = new Intent("[三方应用 package name]");
    intent.putExtra("tokenId", "xxxxx");
    startActivity(intent);

第三方应用需要在Activity中获取tokenId， 并上传到服务器做验证。

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        String tokenId = getIntent().getStringExtra("tokenId");
        //TODO 将tokenId传递给第三方服务器进行验证
    }

iOS集成开发

在App中注册URL Schemes， 值与Bundle ID保持一致，假设Bundle ID是com.actionsoft.entaddress

AWS移动门户通过以下代码打开第三方应用， 并传递tokenId参数。

    NSString *url=[NSString stringWithFormat:@"[三方App Bundle ID]://sso?tokenId=%@", xxxx];
  [[UIApplication sharedApplication] openURL:[NSURL URLWithString:url]]

第三方应用可通过下面的代理方法获取tokenId， 并上传到服务器做验证。

- (BOOL)application:(UIApplication *)application
        openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation
{
    NSLog(@"URL scheme:%@", [url scheme]);
    NSLog(@"URL query: %@", [url query]);
    //TODO  获取tokenId并上传到三方服务器做验证

}

2. 第三方原生应用进行SSO集成开发

第三方服务器获取到第三方应用传递来的tokenId后，需向AWS服务器发送请求进行验证。

服务请求地址

向AWS发送请求的URL地址，该服务在安装本应用后自动提供。

假设AWS服务的访问地址是：https://abc.awspaas.com ，地址示例如下

https://abc.awspaas.com/r/jd?cmd=com.actionsoft.apps.addons.sso_validate&tokenId=xxxx&access_key=xxxx

如果是开发者自己的本地开发环境，地址可能如下

http://localhost:8088/portal/r/jd?cmd=com.actionsoft.apps.addons.sso_validate&tokenId=xxxx&access_key=xxxx

服务请求参数

请求处理结果

结果以json数据结构返回。假设要验证的tokenId为AAA，access_key为xxx-xxx，返回的数据结构如下

{
"data":{
"uid":"对应的AWS登录账户名",
"tokenId":"AAA",
"access_key":"xxx-xxx",
"validate":true
},
"msg":"",
"result":"ok"
}

• 当data/validate值为true时，表示该令牌有效
• 当result不为ok时，说明发生系统级错误，相关错误码请参考这里

• 当令牌验证通过后，会在json结果中提供uid，即该令牌对应的AWS登录账户，开发者可根据该账户在该系统的权限，返回对应在该系统的业务数据
• 如果Token提供的账户与第三方系统账户不一致，需要额外的实施和维护账户匹配规则（不在本应用标准功能之内）

更多SSO API规范请参考这里

3. 将第三方原生应用添加到AWS平台

1.登录AWS实例控制台， 在「移动应用管理>移动应用列表」 页面中，点击左上角 「添加」 按钮， 选择 iOS应用程序文件或者Android应用程序文件。

2.上传apk或者ipa文件

3.填写应用基本信息

4.填写应用扩展信息

5.对应用进行授权

至此，在移动应用列表中会出现该应用，被授权用户从移动门户中也可查看到该应用。