alks-node

#ALKS Node Client

About

Node client for interfacting with the ALKS services.

Usage

var alks = require('alks-node');

Utilities

getDurations()

Returns array of valid session durations.

alks.getDurations();

getAccountSelectorDelimiter()

Returns string dilimeter used for account/role seperation.

alks.getAccountSelectorDelimiter();

Methods

createKey(account, password, duration, callback)

Creates a new session key with the provided information. Returns a JSON document.

var data = {
    alksAccount: 'alksAccount',
    alksRole: 'alksRole',
    sessionTime: 2,
    server: 'endpoint',
    userid: 'my-network-id',
    password: 'my-network-password'
};

alks.createKey(data, 'password', 2, function(err, key){
    if(err) console.error(err);
    else console.log(JSON.stringify(key));
});

getAccounts(server, userid, password, options, callback)

Returns a collection of accounts. Options filter allows you to switch between IAM and non-IAM accounts.

alks.getAccounts('server', 'username', 'password', {filters: { iamOnly: false }}, function(err, accounts){
    if(err) console.error(err);
    else console.log(JSON.stringify(accounts));
});

generateConsoleUrl(key, callback)

Returns a AWS console URL for a given key. The URL is good for 15 minutes.

alks.generateConsoleUrl(alksKey, function(err, url){
    if(err) console.error(err);
    else console.log('The console URL is: %s', url);
});

getIamRoleTypes(server, userid, password, callback)

Returns a list of current IAM role types.

createIamKey(account, password, callback)

Generates a new session for use in creating IAM roles and console sessions.

createIamRole(account, password, roleName, roleType, includeDefaultPolicies, callback)

Creates a new IAM role, provided account must contain valid ALKS IAM session.