764      阿里云

使用入门__Java SDK_STS SDK使用手册_访问控制-阿里云

创建和管理角色

STS的AssumeRole接口的使用，需要在RAM中创建和管理角色，请参考RAM角色管理

使用maven创建项目

mvn archetype:generate -DgroupId=com.aliyun.sts.sample 
-DartifactId=sts-sdk-sample 
-Dpackage=com.aliyun.sts.sample 
-Dversion=1.0-SNAPSHOT

修改生成的pom.xml， 添加aliyun-java-sdk的相关依赖。以2.1.6版本为例，在 标签内加入如下内容：

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-sts</artifactId>
  <version>2.1.6</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>2.1.7</version>
</dependency>

aliyun-java-sdk已经加入到 https://maven-repository.com/artifact/com.aliyun

无需设置maven的settings.xml。

aliyun-java-sdk-sts使用的示例代码

• 注意： 请修改accessKeyId和accessKeySecret为有效值。
• 在com/aliyun/sts/sample/目录下创建Java源代码StsServiceSample.java，内容如下：

package com.aliyun.sts.sample;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import com.aliyuncs.sts.model.v20150401.AssumeRoleRequest;
import com.aliyuncs.sts.model.v20150401.AssumeRoleResponse;
public class StsServiceSample {
  // 目前只有"cn-hangzhou"这个region可用, 不要使用填写其他region的值
  public static final String REGION_CN_HANGZHOU = "cn-hangzhou";
  // 当前 STS API 版本
  public static final String STS_API_VERSION = "2015-04-01";
  static AssumeRoleResponse assumeRole(String accessKeyId, String accessKeySecret,
                                       String roleArn, String roleSessionName, String policy,
                                       ProtocolType protocolType) throws ClientException {
    try {
      // 创建一个 Aliyun Acs Client, 用于发起 OpenAPI 请求
      IClientProfile profile = DefaultProfile.getProfile(REGION_CN_HANGZHOU, accessKeyId, accessKeySecret);
      DefaultAcsClient client = new DefaultAcsClient(profile);
      // 创建一个 AssumeRoleRequest 并设置请求参数
      final AssumeRoleRequest request = new AssumeRoleRequest();
      request.setVersion(STS_API_VERSION);
      request.setMethod(MethodType.POST);
      request.setProtocol(protocolType);
      request.setRoleArn(roleArn);
      request.setRoleSessionName(roleSessionName);
      request.setPolicy(policy);
      // 发起请求，并得到response
      final AssumeRoleResponse response = client.getAcsResponse(request);
      return response;
    } catch (ClientException e) {
      throw e;
    }
  }
  public static void main(String[] args) {
    // 只有 RAM用户（子账号）才能调用 AssumeRole 接口
    // 阿里云主账号的AccessKeys不能用于发起AssumeRole请求
    // 请首先在RAM控制台创建一个RAM用户，并为这个用户创建AccessKeys
    String accessKeyId = "o************F";
    String accessKeySecret = "y*******************U";
    // AssumeRole API 请求参数: RoleArn, RoleSessionName, Policy, and DurationSeconds
    // RoleArn 需要在 RAM 控制台上获取
    String roleArn = "acs:ram::145883****900618:role/ossadminrole";
    // RoleSessionName 是临时Token的会话名称，自己指定用于标识你的用户，主要用于审计，或者用于区分Token颁发给谁
    // 但是注意RoleSessionName的长度和规则，不要有空格，只能有'-' '_' 字母和数字等字符
    // 具体规则请参考API文档中的格式要求
    String roleSessionName = "alice-001";
    // 如何定制你的policy?
    String policy = "{n" +
            "    "Version": "1", n" +
            "    "Statement": [n" +
            "        {n" +
            "            "Action": [n" +
            "                "oss:GetBucket", n" +
            "                "oss:GetObject" n" +
            "            ], n" +
            "            "Resource": [n" +
            "                "acs:oss:*:*:*"n" +
            "            ], n" +
            "            "Effect": "Allow"n" +
            "        }n" +
            "    ]n" +
            "}";
    // 此处必须为 HTTPS
    ProtocolType protocolType = ProtocolType.HTTPS;
    try {
      final AssumeRoleResponse response = assumeRole(accessKeyId, accessKeySecret,
              roleArn, roleSessionName, policy, protocolType);
      System.out.println("Expiration: " + response.getCredentials().getExpiration());
      System.out.println("Access Key Id: " + response.getCredentials().getAccessKeyId());
      System.out.println("Access Key Secret: " + response.getCredentials().getAccessKeySecret());
      System.out.println("Security Token: " + response.getCredentials().getSecurityToken());
    } catch (ClientException e) {
      System.out.println("Failed to get a token.");
      System.out.println("Error code: " + e.getErrCode());
      System.out.println("Error message: " + e.getErrMsg());
    }
  }
}

mvn install

mvn -q exec:java -Dexec.mainClass=com.aliyun.sts.sample.StsServiceSample