阅读683 返回首页    go 阿里云


访问控制__Android SDK_SDK使用手册_消息服务-阿里云

移动终端是一个不受信任的环境,如果把AccessKeyId和AccessKeySecret直接保存在终端本地用来加签请求,存在极高的风险。为此,SDK提供了建议只在测试时使用的 明文设置模式,和另外两种依赖于您的业务Server的鉴权模式: STS鉴权模式自签名模式

明文设置模式

  1. String endpoint = "https://mns.cn-hangzhou.aliyuncs.com";
  2. // 明文设置AccessKeyId/AccessKeySecret的方式建议只在测试时使用
  3. CredentialProvider credentialProvider = new PlainTextAKSKCredentialProvider("<accessKeyId>", "<accessKeySecret>");
  4. MNS mnss = new MNSClient(getApplicationContext(), endpoint, credentialProvider);

STS鉴权模式

介绍

MNS可以通过阿里云STS服务,临时进行授权访问。阿里云STS (Security Token Service) 是为云计算用户提供临时访问令牌的Web服务。通过STS,您可以为第三方应用或联邦用户(用户身份由您自己管理)颁发一个自定义时效和权限的访问凭证,App端称为FederationToken。第三方应用或联邦用户可以使用该访问凭证直接调用阿里云产品API,或者使用阿里云产品提供的SDK来访问云产品API。

  • 您不需要透露您的长期密钥(AccessKey)给第三方应用,只需要生成一个访问令牌并将令牌交给第三方应用即可。这个令牌的访问权限及有效期限都可以由您自定义。
  • 您不需要关心权限撤销问题,访问令牌过期后就自动失效。

以APP应用为例,交互流程如下图:

mns-sts

方案的详细描述如下:

  1. App用户登录。App用户身份是客户自己管理。客户可以自定义身份管理系统,也可以使用外部Web账号或OpenID。对于每个有效的App用户来说,AppServer可以确切地定义出每个App用户的最小访问权限。
  2. AppServer请求STS服务获取一个安全令牌(SecurityToken)。在调用STS之前,AppServer需要确定App用户的最小访问权限(用Policy语法描述)以及授权的过期时间。然后通过调用STS的AssumeRole(扮演角色)接口来获取安全令牌。角色管理与使用相关内容请参考《RAM使用指南》中的角色管理
  3. STS返回给AppServer一个有效的访问凭证,App端称为FederationToken,包括一个安全令牌(SecurityToken)、临时访问密钥(AccessKeyId, AccessKeySecret)以及过期时间。
  4. AppServer将FederationToken返回给ClientApp。ClientApp可以缓存这个凭证。当凭证失效时,ClientApp需要向AppServer申请新的有效访问凭证。比如,访问凭证有效期为1小时,那么ClientApp可以每30分钟向AppServer请求更新访问凭证。
  5. ClientApp使用本地缓存的FederationToken去请求Aliyun Service API。云服务会感知STS访问凭证,并会依赖STS服务来验证访问凭证,并正确响应用户请求。

STS安全令牌详情,请参考《RAM使用指南》中的角色管理。关键是调用STS服务接口AssumeRole来获取有效访问凭证即可。也可以直接使用STS SDK来调用该方法,点击查看

使用这种模式授权需要先开通阿里云RAM服务:RAM

STS使用手册:https://docs.aliyun.com/#/pub/ram/sts-sdk/sts_java_sdk&preface

MNS授权策略配置:点击查看

直接设置StsToken

您可以在APP中,预先通过某种方式(如通过网络请求从您的业务Server上)获取一对StsToken,然后用它来初始化SDK。采取这种使用方式,您需要格外关注StsToken的过期时间,在StsToken即将过期时,需要您主动更新新的StsToken到SDK中。

初始化代码为:

  1. String endpoint = "https://mns.cn-hangzhou.aliyuncs.com";
  2. CredentialProvider credentialProvider = new StsTokenCredentialProvider("<StsToken.AccessKeyId>", "<StsToken.SecretKeyId>", "<StsToken.SecurityToken>");
  3. MNS mns = new MNSClient(getApplicationContext(), endpoint, credentialProvider);

在您判断到Token即将过期时,您可以重新构造新的MNSClient,也可以通过如下方式更新CredentialProvider:

  1. mns.updateCredentialProvider(new StsTokenCredentialProvider("<StsToken.AccessKeyId>", "<StsToken.SecretKeyId>", "<StsToken.SecurityToken>"));

实现获取StsToken回调

如果您期望SDK能自动帮您管理Token的更新,那么,您需要告诉SDK如何获取Token。在SDK的应用中,您需要实现一个回调,这个回调通过您实现的方式去获取一个Federation Token(即StsToken),然后返回。SDK会利用这个Token来进行加签处理,并在需要更新时主动调用这个回调获取Token,如图示:

  1. String endpoint = "https://mns.cn-hangzhou.aliyuncs.com";
  2. CredentialProvider credentialProvider = new FederationCredentialProvider() {
  3. @Override
  4. public FederationToken getFederationToken() {
  5. // 您需要在这里实现获取一个FederationToken,并构造成FederationToken对象返回
  6. // 如果因为某种原因获取失败,可直接返回nil
  7. FederationToken * token;
  8. // 下面是一些获取token的代码,比如从您的server获取
  9. ...
  10. return token;
  11. }
  12. };
  13. MNS mns = new MNSClient(getApplicationContext(), endpoint, credentialProvider);

此外,如果您已经通过别的方式拿到token所需的各个字段,也可以在这个回调中直接返回。如果这么做的话,您需要自己处理token的更新,更新后重新设置该MNSClient实例的CredentialProvider。

使用示例:

假设您搭建的server地址为: https://localhost:8080/distribute-token.json ,并假设访问这个地址,返回的数据如下:

  1. {"accessKeyId":"STS.iA645eTOXEqP3cg3VeHf",
  2. "accessKeySecret":"rV3VQrpFQ4BsyHSAvi5NVLpPIVffDJv4LojUBZCf",
  3. "expiration":"2015-11-03T09:52:59Z",
  4. "federatedUser":"335450541522398178:alice-001",
  5. "requestId":"C0E01B94-332E-4582-87F9-B857C807EE52",
  6. "securityToken":"CAES7QIIARKAAZPlqaN9ILiQZPS+JDkS/GSZN45RLx4YS/p3OgaUC+oJl3XSlbJ7StKpQ...."}

那么,您可以这么实现一个FederationCredentialProvider实例:

  1. CredentialProvider credetialProvider = new FederationCredentialProvider() {
  2. @Override
  3. public FederationToken getFederationToken() {
  4. try {
  5. URL stsUrl = new URL("https://localhost:8080/distribute-token.json");
  6. HttpURLConnection conn = (HttpURLConnection) stsUrl.openConnection();
  7. InputStream input = conn.getInputStream();
  8. String jsonText = IOUtils.readStreamAsString(input, MNSConstants.DEFAULT_CHARSET_NAME);
  9. JSONObject jsonObjs = new JSONObject(jsonText);
  10. String ak = jsonObjs.getString("accessKeyId");
  11. String sk = jsonObjs.getString("accessKeySecret");
  12. String token = jsonObjs.getString("securityToken");
  13. String expiration = jsonObjs.getString("expiration");
  14. return new FederationToken(ak, sk, token, expiration);
  15. } catch (Exception e) {
  16. e.printStackTrace();
  17. }
  18. return null;
  19. }
  20. };

自签名模式

您可以把AccessKeyId/AccessKeySecret保存在您的业务server,然后在SDK实现回调,将需要加签的合并好的签名串POST到server,您在业务server对这个串按照MNS规定的签名算法签名之后,返回给该回调函数,再由回调返回。

签名算法参考:点我查看

content是已经根据请求各个参数拼接后的字符串,所以算法为:

  1. signature = "MNS " + AccessKeyId + ":" + base64(hmac-sha1(AccessKeySecret, content))

如下:

  1. String endpoint = "https://mns.cn-hangzhou.aliyuncs.com";
  2. credentialProvider = new CustomSignerCredentialProvider() {
  3. @Override
  4. public String signContent(String content) {
  5. // 您需要在这里依照MNS规定的签名算法,实现加签一串字符内容,并把得到的签名传拼接上AccessKeyId后返回
  6. // 一般实现是,将字符内容post到您的业务服务器,然后返回签名
  7. // 如果因为某种原因加签失败,描述error信息后,返回nil
  8. // 以下是用本地算法进行的演示
  9. return "MNS " + AccessKeyId + ":" + base64(hmac-sha1(AccessKeySecret, content));
  10. }
  11. };
  12. MNS mns = new MNSClient(getApplicationContext(), endpoint, credentialProvider);

特别注意: 无论是STS鉴权模式,还是自签名模式,您实现的回调函数,都需要保证调用时返回结果。所以,如果您在其中实现了向业务server获取token、signature的网络请求,建议调用网络库的同步接口。回调都是在SDK具体请求的时候,在请求的子线程中执行,所以不会阻塞主线程。

最后更新:2016-11-23 16:04:17

  上一篇:go 初始化__Android SDK_SDK使用手册_消息服务-阿里云
  下一篇:go 异常处理__Android SDK_SDK使用手册_消息服务-阿里云