Versions Compared

Old Version 12

changes.mady.by.user James Zeng

Saved on

compared with

New Version Current

changes.mady.by.user James Zeng

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Anchor
_Toc341972345
_Toc341972345
/auth/listApplications

Parameters:

Code Block
languagejs
{
	"return":["id","name"]
}

Response:resetLogon

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"total":2,
		"rows":
		[
			{
				"id":"aid1",
				"name":"application 1"
			},
			{
				"id":"aid2",
				"name":"application 2"
			}
		]
	}
}

Anchor
_Toc341972346
_Toc341972346
/auth/listDomains

Parameters:

Code Block
languagejs
{
	"application":
	{
		"id":"appid"
	},
	"return":["id","name"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"total":2,
		"rows":
		[
			{
				"id":"domain id 1",
				"name":"domain 1"
			},
			{
				"id":"domain id 2",
				"name":"domain 2"
			}
		]
	}
}

Anchor
_Toc341972347
_Toc341972347
/auth/listAuthenticators

List authenticators in the specified logon step.

Parameters:

Code Block
languagejs
{
	"step": 1// step is 1-based
	"application":
	{
		"id":"appid"
	},
	"user":
	{
		"domain.id":"domainid",
		"loginName":"login name"
	}
}

...

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"total":2,
		"rows":
		[
			{"code":"OTP", "name":"One-Time Password"},
			{"code":"OTPoD", "name":"On-Demand Password"}
		]
	}
}

Anchor
_Toc341972348
_Toc341972348
/auth/getLogonSteps

Parameters:

Code Block
languagejs
{
	"application":
	{
		"id": "appid"
	},
	"user":
	{
		"loginName": "user login name"
	},
	"return":["name","challengResponse","authenticators"]
}

Response:

Code Block
languagejs
{
Wiki Markup
+Examples:+
Method:/auth/getLogonSteps
Parameters: 
\{
 "application":
\{
"id":appid
\},
"return":\["challengResponse", "checkStaticPass","name"\]
\}
Response: 
\{
 "error":0,
 	"result":\[total:3, rows:\[...\]\]
\}
\\
\\
\\

...


	{
		"total":2,
		"rows":
		[
			{
				"name": "step 1",
				"challengResponse": false,
				"authenticators":
				[
					{"code":"OTP", "name":"One-Time Password"}
				]
			},
			{
				"name": "step 2",
				"challengResponse": false,
				"authenticators":
				[
					{"code":"SPASS", "name":"Static Password"}
				]
			}
		]
	}
}

Anchor
auth_listTokenAssignments
auth_listTokenAssignments
/auth/listTokenAssignments

Examples:

The following example will list all OOBA tokens:


Method: /auth/listTokenAssignments

Examples:
Method:/auth/logon
Parameters:

Code Block
languagejs
{
	"application":
	{
		"id":appid
	},
	"user":
	{
		"id":userid
	},
	"token":
	{
		"serial":"10000000"
	},
	"credential":
	{
		"otp":"123456",
		//"cc":"121212" // if verifyResponse is required
	}
}

...

Code Block
languagejs
{
	"error":0
}

...

Examples:
Method:/auth/logout
Parameters:

Code Block
languagejs
{
}

...

Code Block
languagejs
{
	"error":0
}

...

Examples:
Method:/auth/verify
Parameters:

Code Block
languagejs
{	"application":
	{
		"id":"appid"
	},
	"user":
	{
		"id":"userid"
	},
	"token":
	{
		"serialproduct.functions":"10000000OOBA"
	},
	"credentialreturn":
	{[
		"otpid":, "123456status",
		//{"cctoken":"121212" // if verifyResponse is required
	}["id","serial","oobDeviceModel","oobDeviceType"]}
	]
}


Response:

Code Block
languagejs
{
	"error":0
}

...

Examples:
Method:/auth/verifyResponse
Parameters:

Code Block
languagejs
{
	"user":,
	"result":
	{
		"idtotal":userid1,
	},
	"tokenrows":
		{[
			"serialid":"10000000dda5f3744f7d7750676acc24f31fe1287085872ff856224655bf55ec501fa2ba"
	},
	"credentialstatus":"ACTIVE",
	{
		"otptoken":"123456",
		"cc	{
				"id":"13113131bc650db324ef8e2873444e9e1001ac07",
	}
}

...

Code Block
languagejs
{
	"error":0
}

...

				"serial":"110000035",
				"oobDeviceModel":"Xiaomi M2007J20CG",
				"oobDeviceType":"Android"
			}
		]
	}
}

Anchor
_Toc341972349
_Toc341972349
/auth/logon

Examples 1: OTP loginExamples:
Method:/auth/sendOTPlogon
Parameters:

Code Block
languagejstitleExample 1
{
	"userapplication":
	{
		"loginNameid": "user login nameappid"
	},
	"token    "remoteIp": "xxx.xxx.xxx.xxx", // client optional
	IP Address
    "user":
	{
		"serialid":"10000000userid"
	},
	"optionstoken": // optional
	{
		"formatserial":"TEXT|HTML",10000000"
	},
	"credential":
	{
		"channelotp":"SMS123456",
		//"expirecc":"2021-01-01T00:00:00"
	}
}121212" // if verifyResponse is required
	}
}

Examples 2: OOBA login
Method: /auth/logon
Parameters:Send OTP to user "acme\john.smith" via "SMS"

Code Block
languagejstitleExample 2
{
	"userapplication":
	{
		"loginNameid": "acme\\john.smith"appid"
	},
	"optionsuser":
	{
		"channelid":"SMS"userid"
	},
	"token":
	{
		"serial":"110000035"
	},
	"credential":
	{
		"method":"OOBA",
		"tokenId":"bc650db324ef8e2873444e9e1001ac07",
	}
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_

...

Toc341972350
_

...

Toc341972350
/auth/

...

logout

Examples:
Method:/auth/sendActivationCodelogout
Parameters:

Code Block
languagejstitleExample 1
{
	"user":
	}


Response:

Code Block
languagejs
{
		"iderror":"userid"0
}



Anchor
_Toc341972351
_Toc341972351
/auth/verify

Examples:
Method:/auth/verify
Parameters:

Code Block
languagejs
{
    "remoteIp": "xxx.xxx.xxx.xxx", // client IP Address
	"user	},
	"token":
	{
		"serial":"10000000"
	},
	"options":
	{
		"formatid":"TEXT|HTML"userid"
	},
		"channeltoken":"SMS", // optional
	{
		"expireserial":"2021-01-01T00:00:0010000000"
	}
}
Code Block
languagejs
titleExample 2
{,
	"tokenAssignmentcredential":
	{
		"idotp":"token assignment id123456",
	},
	//"options":
	{
		"format":"TEXT|HTML",
		"channel":"SMS",
		"expire":"2021-01-01T00:00:00"
	cc":"121212" // if verifyResponse is required
	}
}

...


Code Block
languagejs
{
	"error    "user":0
}

...


    {
        "loginName":"loginName"
    },
    "credential":
    {
        "method":"SPASS",
        "password":"pass"
    }
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972353
_Toc341972353
/auth/sendOTP

Examples:
Method:/auth/syncToken
Parameters:
{
"user":
{
"id":userid
},
"token":
{
"serial":"10000000"
},
"credential":"otp1,otp2"
}
Response:
{
"error":0
}

...

Examples:
Method:/auth/downloadTokensendOTP
Parameters:

Code Block
languagejs

...

titleExample 1
{
	"user":

...


	{
		"loginName": "user login name"
	},
	"token":

...

 // optional
	{
		"serial":"10000000"

...


	},

...


	"

...

Examples:
Method:/auth/activateTokenAssignment
Parameters:
{
// "tokenAssignment":{"id":assid}
"user":
{
"id":userid
},
"token":
{
"serial":"10000000"
},
"acHash":SHA1 hash of activation code in base64 encoded
}
Response:
{
"error":0
}

...

Wiki Markup
+Examples:+
Method:/auth/getPolicy
Parameters: 
\{
"application":
\{
 "name":"appname"
\},
"user":
\{
"loginName":"login name",
"domain.id":domainid
\},
"category":
\{
 "name":"logon"
\},
 "return":\["name", "id","options"\]
\}
Response: 
\{
 "error":0,
"result":
\{
  "id":"1",
  "name":"System logon policy",
"options":
\{
 "key":"value",
...
\}
\}
\}

...

Wiki Markup
+Examples:+
Method:/auth/listUsers
Parameters: 
\{
"user":
\{
"loginName":"login name",
"domain.id":domainid
\}
 return:\["*"\]
\}
Response:
\{
 "error":0,
"result":\{"id":1,…\}
\}

...

Wiki Markup
+Examples:+
Method:/auth/listSiteStamps
Parameters: 
\{
"user":
\{
"id":userid
\}
 return:\["*"\]
\}
Response:
\{
 "error":0,
"result":\{"id":1, …\}
\}
\\
\\

...

Wiki Markup
+Examples:+
Method:/auth/getChallengeCode
Parameters: 
\{
"user":
\{
"loginName":"login name",
"domain.id":domainid
\},
"token":
\{
id:tid1
\},
 return:\["id", "code", "starts", "expires"\]
\}
Response:
\{
 "error":0,
"result":\{"id":1, "code":"xxx", starts:"xxx", expires:"xxx"\}
\}
\\
+Examples:+
The GridGo challenge code is the matrix in JSON string
\\
Parameters: 
\{
 "user":
\{
"loginName":"login name",
"domain.id":domainid
\},
"token":
\{
"product.method":"GridGo"
\},
\\
"return":\["id", "code", "reference"\]
\}
Response: 
\{
 "error":0,
 "result":
\{
 "id":"#i#_ChallengeCode_22",
"code":
'\{"grid":\["53c1s3npxgws4pw6jp5kx3",
"scmmu698wp9t1sag5spxzz",
"gmmzdj97x3jn4bpe9cvu1r",
"ps0hs5g2nh5xer6r93fj7x",
"mn8zbs5nnnm8rxt2r5ekd0",
"0jr935hx618a3vcvzdehn0",
"9xtr71jff7jaz255n5rtc4",
"dr96rxn7pgs3anmfzpeu7y",
"uf06ttmc3kfvhrun2remk9",
"z7c3ytf9u2xtfmc60p06ax"\],
"rows":10,
"cols":22,
"indiecs":"ABCDEFGHJKMNPRSTUVWXY"
\}',
"reference":"10948e64-b829-47be-be2a-414217bee16f"
\}
\}

...

Wiki Markup
+Examples:+
Method:/auth/listTokens
Parameters: 
\{
 "user":
\{
"loginName":"login name",
"domain.id":domainid
\},
"token":
\{
"product.method":"GridCard"
\},
\\
"return":\["id", "serial"\]
\}
Response: 
\{
 "error":0,
 "result":
\{
 "total":2,
 "rows":
\[
 \{"id":1, "serial":"77003456"\},
\{"id":2, "serial":"77003457"\}
\]
\}
\}
\\

...

Examples:
Method:/auth/changePassword
Parameters:
{
"user":
{
"loginName":"login name",
"domain.id":domainid
},
"oldPassword":"old",
"newPassword":"new"
}
Response:
{
"error":0
}

...

Examples:
Method:/auth/verifyPin

  1. verify password

Parameters:
{
"user":
{
"loginName":"login name",
"domain.id":domainid
},
"pin":"password"
}
Response:
{
"error":0
}

  1. verify pin

Parameters:
{
"user":
{
"loginName":"login name",
"domain.id":domainid
},
"token":
{
"serial":"1213131"
}
"pin":"pin"
}
Response:
{
"error":0
}

  1. verify pin

...

options": // optional
	{
		"format":"TEXT|HTML",
		"channel":"SMS",
		"expire":"2021-01-01T00:00:00"
	}
}

Send OTP to user "acme\john.smith" via "SMS"

Code Block
languagejs
titleExample 2
{
	"user":
	{
		"loginName": "acme\\john.smith"
	},
	"options":
	{
		"channel":"SMS"
	}
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972354
_Toc341972354
/auth/sendActivationCode

Examples:
Method:/auth/sendActivationCode
Parameters:

Code Block
languagejs
titleExample 1
{
	"user":
	{
		"id":"userid"
	},
	"token":
	{
		"serial":"10000000"
	},
	"options":
	{
		"format":"TEXT|HTML",
		"channel":"SMS",
		"expire":"2021-01-01T00:00:00"
	}
}


Code Block
languagejs
titleExample 2
{
	"tokenAssignment":
	{
		"id":"token assignment id"
	},
	"options":
	{
		"format":"TEXT|HTML",
		"channel":"SMS",
		"expire":"2021-01-01T00:00:00"
	}
}



Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972355
_Toc341972355
/auth/syncToken

Examples:
Method:/auth/syncToken
Parameters:

Code Block
languagejs
{
	"user":
	{
		"id":"userid"
	},
	"token":
	{
		"serial":"10000000"
	},
	"credential":"otp1,otp2"
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972356
_Toc341972356
/auth/downloadToken

Examples:
Method:/auth/downloadToken
Parameters:

Code Block
languagejs
{
	"user":
	{
		"id":"userid"
	},
	"token":
	{
		"serial":"10000000"
	},
	"acHash": "SHA1 hash of activation code in base64 encoded"
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972357
_Toc341972357
/auth/activateTokenAssignment

Examples:
Method:/auth/activateTokenAssignment
Parameters:

Code Block
languagejs
{
	// "tokenAssignment":{"id":assid}
	"user":
	{
		"id":"userid"
	},
	"token":
	{
		"serial":"10000000"
	},
	"acHash":"SHA1 hash of activation code in base64 encoded"
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972358
_Toc341972358
/auth/getPolicy

Parameters:

Code Block
languagejs
{
	"application":
	{
		"name":"appname"
	},
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"category":
	{
		"name":"logon"
	},
	"return":["name", "id","options"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"id":"policy id 1",
		"name":"System logon policy",
		"options":
		{
			"key1":"value1",
			"key2":"value2",
			...
		}
	}
}


Anchor
_Toc341972360
_Toc341972360
/auth/listSiteStamps

Parameters:

Code Block
languagejs
{
	"user":
	{
		"id":"userid"
	}
	return:["*"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"total":2,
		"rows":
		[
			{"id":"id1", …},
			{"id":"id2", …}
		]
	}
}



Anchor
_Toc341972361
_Toc341972361
/auth/getChallengeCode

Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"token":
	{
		"id":"tid1"
	},
	return:["id", "code", "starts", "expires"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":{"id":1, "code":"xxx", "starts":"xxx", "expires":"xxx"}
}

Examples:
The GridGo challenge code is the matrix in JSON string

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"token":
	{
		"product.method":"GridGo"
	},
	"return":["id", "code", "reference"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"id":"#i#_ChallengeCode_22",
		"code":
			"{\"grid\":[\"53c1s3npxgws4pw6jp5kx3\",
			\"scmmu698wp9t1sag5spxzz\",
			\"gmmzdj97x3jn4bpe9cvu1r\",
			\"ps0hs5g2nh5xer6r93fj7x\",
			\"mn8zbs5nnnm8rxt2r5ekd0\",
			\"0jr935hx618a3vcvzdehn0\",
			\"9xtr71jff7jaz255n5rtc4\",
			\"dr96rxn7pgs3anmfzpeu7y\",
			\"uf06ttmc3kfvhrun2remk9\",
			\"z7c3ytf9u2xtfmc60p06ax\"],
			\"rows\":10,
			\"cols\":22,
			\"indiecs\":\"ABCDEFGHJKMNPRSTUVWXY\"
			}",
		"reference":"10948e64-b829-47be-be2a-414217bee16f"
	}
}

Anchor
_Toc341972362
_Toc341972362
/auth/listTokens

Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"token":
	{
		"product.method":"GridCard"
	},
	"return":["id", "serial"]
}

Response:

Code Block
languagejs
{
	"error":0,
	"result":
	{
		"total":2,
		"rows":
		[
			{"id":"tid1", "serial":"77003456"},
			{"id":"tid2", "serial":"77003457"}
		]
	}
}

Anchor
_Toc341972363
_Toc341972363
/auth/changePassword

Examples:
Method:/auth/changePassword
Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"oldPassword":"old",
	"newPassword":"new"
}


Response:

Code Block
languagejs
{
	"error":0
}

Anchor
_Toc341972364
_Toc341972364
/auth/verifyPin

Examples:
Method:/auth/verifyPin

1. verify password

Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"pin":"password"
}

2. verify pin

Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"token":
	{
		"serial":"1213131"
	}
	"pin":"pin"
}

Response:

Code Block
languagejs
{
	"error":0
}

3. verify pin by assignment

Parameters:

Code Block
languagejs
{
	"user":
	{
		"loginName":"login name",
		"domain.id":"domainid"
	},
	"tokenAssignment":
	{
		"id":"assignment id"
	}
	"pin":"pin"
}


Response:

Code Block
languagejs
{
	"error":0
}


/auth/resetLogon

Reset the logon session, this API will reset everything in the logon session: user, logon step, access control etc.

Request:

Code Block
languagejs
{
}

Response:

Code Block
languagejs
{
	"error":0
}