Iris AUM JS SDK

Introduction

This section describes JavaScript SDK for Iris Auth Manager. Package can be installed with

``
npm i @iris-platform/iris-aum-js-sdk
`

Registration – Social Media, Cima, SSO, or PingID

This API requires valid Facebook, Google, Cima, PingID access token. The API will exchange the given access token for Iris JWT token. The registration API validates provided token and uses the user information to create Iris user and returns JWT token that then can be used to access all other Iris platform APIs.

`
mediaRegister(type, mediaToken, successCallback, errorCallback)


type – LOGIN_TYPE_FACEBOOK, LOGIN_TYPE_GOOGLEPLUS, LOGIN_TYPE_PINGID, LOGIN_TYPE_SSO, LOGIN_TYPE_CIMA
mediaToken – token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
mediaRegisterAsync(type, mediaToken)


type – LOGIN_TYPE_FACEBOOK, LOGIN_TYPE_GOOGLEPLUS, LOGIN_TYPE_PINGID, LOGIN_TYPE_SSO, LOGIN_TYPE_CIMA
mediaToken – token

Returns promise that returns JSON payload on success and error on failure.
`

To get constants import them like this:
`
import {
LOGIN_TYPE_FACEBOOK,
LOGIN_TYPE_GOOGLEPLUS,
LOGIN_TYPE_PINGID,
LOGIN_TYPE_SSO,
LOGIN_TYPE_CIMA
} from 'iris-aum-js-sdk';
`

Registration – Email

Register using email.

`
emailRegister(username, email, password, successCallback, errorCallback)

username – user name like first name and last name with optional middle name
email – user’s email
password – user’s password
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
emailRegisterAsync(username, email, password)

username – user name like first name and last name with optional middle name
email – user’s email
password – user’s password

Returns promise that returns JSON payload on success and error on failure.
`

Registration – Device

Register using device unique id.

`
emailRegister(typeId, successCallback, errorCallback)

typeId - device uunique id
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
emailRegisterAsync(typeId)

typeId - device uunique id

Returns promise that returns JSON payload on success and error on failure.
`

Get User Information

This API allows to get user information associated with JWT token. This API
can be used with any Iris token accept the ones obtained with anonymous login.

`
userInformation(token, successCallback, errorCallback)

token – Iris JWT access token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
userInformationAsync(token)

token – Iris JWT access token

Returns promise that returns JSON payload on success and error on failure.
`

Validate Access Token

This API will validate if the token is valid. This API
can be used with any Iris token accept the ones obtained with anonymous login.

`
validateUserAccessToken(token, successCallback, errorCallback)

token – Iris JWT access token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
validateUserAccessTokenAsync(token)

token – Iris JWT access token

Returns promise that returns JSON payload on success and error on failure.
`

Returns if the token is valid or not.

Login - Social Media, SSO, Cima or PingID

Login using social media, SSO, Cima or PingID.

`
mediaLogin(type, mediaToken, successToken, errorCallback)

type – LOGIN_TYPE_FACEBOOK, LOGIN_TYPE_GOOGLEPLUS, LOGIN_TYPE_PINGID, LOGIN_TYPE_SSO, LOGIN_TYPE_CIMA
mediaToken – token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
mediaLoginAsync(type, mediaToken)

type – LOGIN_TYPE_FACEBOOK, LOGIN_TYPE_GOOGLEPLUS, LOGIN_TYPE_PINGID, LOGIN_TYPE_SSO, LOGIN_TYPE_CIMA
mediaToken – token

Returns promise that returns JSON payload on success and error on failure.
`

Returns Iris JWT access token.

Email Login

Login using email.

`
emailLogin(email, password, successCallback, errorCallback)

email – user’s email
password – user’s password
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
emailLoginAsync(email, password)

email – user’s email
password – user’s password

Returns promise that returns JSON payload on success and error on failure.
`

Returns Iris JWT access token.

Email Account Password Change

Change password for email based user account.

`
emailAccountPasswordChange(token, email, currentPassword, newPassword, successCallback, errorCallback)

token – bearer token, it can be client or server
email – user’s email
currentPassword – user’s current password
newPassword – user’s new password
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
emailAccountPasswordChangeAsync(token, email, currentPassword, newPassword)

token – bearer token, it can be client or server
email – user’s email
currentPassword – user’s current password
newPassword – user’s new password

Returns promise that returns JSON payload on success and error on failure.
`

Device Login

Login using device unique id.

`
deviceLogin(typeId, successCallback, errorCallback)

typeId - device uunique id
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
deviceLoginAsync(typeId, successCallback, errorCallback)

typeId - device uunique id

Returns promise that returns JSON payload on success and error on failure.
`

Returns Iris JWT access token.

Server Login

Get server to server JWT

`
serverLogin(successCallback, errorCallback)

successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
deviceLoginAsync(successCallback, errorCallback)

Returns promise that returns JSON payload on success and error on failure.
`

Returns Iris server to server JWT access token.

Anonymous Login

This API allows anonymous login. This is useful if applications that do not require concept of user.

`
anonymousLogin(userID, successCallback, errorCallback)

userID – optional string with user name or id. It can be empty.
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
anonymousLoginAsync(userID)

userID – optional string with user name or id. It can be empty.

Returns promise that returns JSON payload on success and error on failure.
`


Returns Iris JWT access token.

Logout

Logout API takes valid Iris JWT and adds it to blacklist so it cannot be used further to access Iris platform.

`
logout(token, successCallback, errorCallback)

token – Iris JWT token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

`
logoutAsync(token)

token – Iris JWT token

Returns promise that returns JSON payload on success and error on failure.
`

Decode Iris JWT

This API will return object with decoded JWT’s header, claims and signature.

`
decodeToken(token)

token – valid Iris JWT token
`

Following APIs are only available in v1.1

$3

APIs to retrieve new token with refresh token.

`
refreshTokenAsync(refreshToken)

refreshToken - refresh token
`

`
refreshToken(refreshToken, successCallback, errorCallback)

refreshToken - refresh token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

$3

Revoke specified refresh token

`
revokeRefreshTokenAsync(refreshToken)

refreshToken - refresh token
`

`
revokeRefreshToken(refreshToken, successCallback, errorCallback)

refreshToken - refresh token
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

$3

This API allows for attaching profile to specified user. Profile can be arbitrary
JSON object.

`
updateUserProfileAsync(token, userID, profileObject)

token - server to server token
userID - user id
profileObject - JSON object with profile data
`

`
updateUserProfile(token, userID, profileObject, successCallback, errorCallback)

token - server to server token
userID - user id
profileObject - JSON object with profile data
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

$3

Find users based on query of profile data. For example,

`
const queryObject = {
'user_name': newUserName,
}
`
will search for user whose profile contains user_name equal to newUserName

`
queryUserProfileAsync(token, queryObject, isMatch, start, limit)

token - server to server token
queryObject - JSON object with query
isMatch - true to match field with value exactly, false will search for value contained in the field
start - pagination start index
limit - pagination count of entries returned
`

`
queryUserProfile(token, queryObject, isMatch, start, limit, successCallback, errorCallback)

token - server to server token
queryObject - JSON object with query
isMatch - true to match field with value exactly, false will search for value contained in the field
start - pagination start index
limit - pagination count of entries returned
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

$3

Delete user with given user_id

`
deleteUserAsync(token, userID)

token - server to server token
userID - user id
`

`
deleteUser(token, userID, successCallback, errorCallback)

token - server to server token
userID - user id
successCallback – when API succeeds this callback will receive JSON response.
failureCallback – in case of failure error information will be passed into this callback.
`

Example

After you npm i @iris-platform/iris-aum-js-sdk you can test it out with the following code:

`
let irisAuth = require("@iris-platform/iris-aum-js-sdk")
let authMgr = irisAuth.AuthManagerFactory({"authMgrApiUrl": "", "apiVersion": "v1.1", "appkey": "", "appsecret": "authMgr.anonymousLogin("Some Name")
.then(data => console.log(data))
.catch(error => console.log(error))
``