@alicloud/sts-sdk

Alibaba Cloud STS client for Node.js

Installation

npm install @alicloud/sts-sdk

Node.js >= 8.5.0 required.

Usage

const StsClient = require('@alicloud/sts-sdk');

const sts = new StsClient({
  endpoint: 'sts.aliyuncs.com', // check this from sts console
  accessKey: '***************', // check this from aliyun console
  secretKey: '***************', // check this from aliyun console
});

async function demo() {
  const res1 = await sts.assumeRole(`acs:ram::${accountID}:role/${roleName}`, 'xxx');
  console.log(res1);
  const res2 = await sts.getCallerIdentity();
  console.log(res2);
}

demo();

API Doc

Method: assumeRole()

Arguments

• roleArn String required - aliyun resource name, acs:ram::${accountID}:role/${roleName}
• roleSessionName String required - differentiate tokens, /^[a-zA-Z0-9.@-_]+$/
• policy String optional - @see https://help.aliyun.com/document_detail/28664.html
• durationSeconds Number optional - the specified expiration time (seconds), range: 900~3600, default value is 3600

Returns

• credentials Object - sts credentials

Method: getCallerIdentity()

Returns

• userInfo Object - the identity of the current caller

Method (Japan only): generateSessionAccessKey()

Returns

• akInfo Object - session key & secret