Account API

Authentication

Authenticate a standard account

POST /account/authenticate

Note

Use /authenticate for authenticating as a regular user (in which case you must specify a tenantName or hostName), or for an administration account for deploying configurations (in which case you should not specify a tenantName or hostName.)

Authenticate an admin account

POST /account/authenticateAdmin

Note

Use /authenticateAdmin for authenticating as a “tenant administrator.” It’s the equivalent of logging in as an administrator in the Socotra Administration UI to modify users, maintain external integrations, and query plugin logs. You must specify one of the tenantLocator, hostName, or tenantName. This type of account token cannot be used to deploy configurations.

Note

Values for hostName and tenantName can be included in either the query string or the AuthenticateRequest3

Renew an authentication token

POST /account/renewAuthentication

AuthenticateRequest3

{
  // Required
  password : string
  username : string

  // Optional
  hostName : string
  tenantName : string
}

AuthenticateResponse3

{
  // Required
  authorizationToken : string
  expiresTimestamp : timestamp
}

Account Lockout Reset

Unlock an account that has been locked out due to failed login attempts

POST /account/unlock

AccountUnlockRequest

{
  // Required
  username : string

  // Optional
  hostName : string
  tenantName : string
}