Authenticate a user for the SoftLayer customer portal
Description
Attempt to authenticate a username and password to the SoftLayer customer portal. Many portal user accounts are configured to require answering a security question on login. In this case getPortalLoginToken() also verifies the given security question ID and answer. If authentication is successful then the API returns a token containing the ID of the authenticated user and a hash key used by the SoftLayer customer portal to maintain authentication.
Parameters
| Name |
Type |
Description |
| username |
string |
The username you wish to authenticate to the SoftLayer customer portal with. |
| password |
string |
Your SoftLayer customer portal user’s portal password. |
| securityQuestionId |
int |
A security question you wish to answer when authenticating to the SoftLayer customer portal. This parameter isn’t required if no security questions are set on your portal account or if your account is configured to not require answering a security account upon login. |
| securityQuestionAnswer |
string |
The answer to your security question. |
Required Headers
Optional Headers
Return Values
Error Handling
- Throws the exception “Invalid login credentials provided.” if the given username and password combination is incorrect.
- Throws the exception “Account has been locked for 30 minutes.” if there have been at least ten unsuccessful login attempts for the given username in the past 30 minutes.
- Throws the exception “Account has been locked for 30 minutes.” if there have been at least ten unsuccessful login attempts from the IP address making the API call in the past 30 minutes.
- Throws the exception “Invalid answer provided for security question.” if the given security question and answer are invalid and the user is required to answer security questions on portal login.
- Throws the exception “Unauthorized IP Address!” if the given user has an IP whitelist defined and the IP address of the user making the api call is not within this user’s IP address whitelist.
- Throws the exception “Unauthorized IP Address!” if the given user has an IP blacklist defined and the IP address of the user making the api call is within this user’s IP address blacklist.
- Throws the exception “User account is currently {state}” if the given user is not an active portal user account. In this case {state} contains the current state of the given user account.
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [string, string, int, string]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_User_Customer_OpenIdConnect/getPortalLoginToken'