STS临时Token

技术原理

通过STS为第三方访问颁发一个自定义时效和访问权限的访问凭证（STS临时Token）。第三方用户可以使用STS临时Token直接调用点播服务端API。

使用说明

获取STS临时Token

为免去自行签名等麻烦，建议集成STS SDK并通过SDK调用AssumeRole来获取STS临时Token。集成STS SDK前必须创建RAM用户，RAM用户角色并为角色授权访问点播服务。

1. 创建RAM用户。操作指引请参见创建RAM角色并进行STS临时授权。
2. （可选）如需自定义授权，请参见基于RAM Policy实现自定义授权。
3. 集成STS SDK并通过SDK调用AssumeRole来获取STS临时Token。操作步骤根据使用的语言不同而不同。

   服务端语言	操作指引
   Java	Java示例 说明 下文提供了Java语言的示例代码详解。
   Python	Python示例
   PHP	PHP示例
   .NET	.NET示例
   Node.js	Node.js示例
   Go	Go示例

Java示例

Java获取STS临时Token示例代码

1. 集成STS SDK。
   添加STS SDK依赖。

   <dependencies>
     <!--  原版 SDK  -->
     <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>aliyun-java-sdk-sts</artifactId>
       <version>3.1.1</version>
     </dependency>
   </dependencies>

   添加核心库SDK Core依赖。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>aliyun-java-sdk-core</artifactId>
     <version>4.6.1</version>
   </dependency>

2. 调用AssumeRole获取STS临时Token。

   
   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.http.MethodType;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.profile.IClientProfile;
   import com.aliyuncs.sts.model.v20150401.AssumeRoleRequest;
   import com.aliyuncs.sts.model.v20150401.AssumeRoleResponse;
   
   
   /**
    * @author jack
    * @date 2020/5/25
    */
   public class TestStsService {
   
       public static void main(String[] args) {
           // 只有RAM用户（子账号）才能调用 AssumeRole 接口
           // 阿里云主账号的AccessKeys不能用于发起AssumeRole请求
           // 请首先在RAM控制台创建一个RAM用户，并为这个用户创建AccessKeys
           String accessKeyId = "LTAI5tKtf6vKccbinQu****";
           String accessKeySecret = "D47l1yBPgjdqe3JzVASSF9yrje****";
           // AssumeRole API 请求参数： RoleArn, RoleSessionName, Policy, and DurationSeconds
           // RoleArn 需要在 RAM 控制台上获取
           String roleArn = "acs:ram::174809843091****:role/vodrole";
           // RoleSessionName 角色会话名称，自定义参数
           String roleSessionName = "session-name";// 自定义即可
           // 定制你的policy
           String policy = "{\n" +
                   "  \"Version\": \"1\",\n" +
                   "  \"Statement\": [\n" +
                   "    {\n" +
                   "      \"Action\": \"vod:*\",\n" +
                   "      \"Resource\": \"*\",\n" +
                   "      \"Effect\": \"Allow\"\n" +
                   "    }\n" +
                   "  ]\n" +
                   "}";
           try {
               AssumeRoleResponse response = assumeRole(accessKeyId, accessKeySecret, roleArn, roleSessionName, policy);
               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());
               System.out.println("RequestId: " + response.getRequestId());
   
               createUploadVideo(response.getCredentials().getAccessKeyId(), response.getCredentials().getAccessKeySecret(), 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());
           }
       }
   
       static AssumeRoleResponse assumeRole(String accessKeyId, String accessKeySecret, String roleArn, String roleSessionName, String policy) throws ClientException {
           try {
               //构造default profile（参数留空，无需添加Region ID）
               /*
               说明：当设置SysEndpoint为sts.aliyuncs.com时，regionId可填可不填；反之，regionId必填，根据使用的服务区域填写，例如：cn-shanghai
               详情参考STS各地域的Endpoint，请参见接入地址。
                */
               IClientProfile profile = DefaultProfile.getProfile("", accessKeyId, accessKeySecret);
               //用profile构造client
               DefaultAcsClient client = new DefaultAcsClient(profile);
               // 创建一个 AssumeRoleRequest 并设置请求参数
               final AssumeRoleRequest request = new AssumeRoleRequest();
               request.setSysEndpoint("sts.aliyuncs.com");
               request.setSysMethod(MethodType.POST);
               request.setRoleArn(roleArn);
               request.setRoleSessionName(roleSessionName);
               request.setPolicy(policy);
               // 发起请求，并得到response
               final AssumeRoleResponse response = client.getAcsResponse(request);
               return response;
           } catch (ClientException e) {
               throw e;
           }
       }
                   

参数说明