Alibaba Cloud STS client for Node.js


Installation

``bash
npm install @alicloud/sts-sdk
`

Node.js >= 8.5.0 required.

Usage

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

const sts = new StsClient({
endpoint: 'sts.aliyuncs.com', // check this from sts console
accessKeyId: '*', // check this from aliyun console
accessKeySecret: '*', // 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

$3

#### 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

$3

#### Returns

* userInfo Object - the identity of the current caller

$3

#### Returns

* akInfo Object - session key & secret

Test & Coverage

You should set environment variables before running the test or coverage. For example:

* run test

`
ACCESS_KEY= SECRET_KEY= ENDPOINT=sts.aliyuncs.com npm run test
`

* run code coverage

`
ACCESS_KEY= SECRET_KEY= ENDPOINT=sts.aliyuncs.com npm run cov
``

License

MIT