Client Admin Portal
Getting started with the Client Admin Portal
Last updated
Was this helpful?
Getting started with the Client Admin Portal
Last updated
Was this helpful?
The Client Admin Portal gives the means to create, modify, and remove Virtual Terminal users, create new API tokens, and inspect active or expiring tokens.
To get access to the portal and create new accounts, contact the Number support team.
You will be asked to provide the full name, e-mail address, and cell phone number for every individual you wish to have access to the portal. Each one of them will receive a text message containing their username and an e-mail containing their password with the URL of the portal.
Our Admin Portal utilizes two-factor authentication. Users accessing the portal will be asked to enter their username, password, and a security code that will be sent via a text message to their cell phone.
There are two methods to generate token renewals.
Once you log in, you'll see a menu on the left with a Manage Tokens heading.
The Active Tokens option allows you to view all of tokens that have been assigned to your accounts, their expiration date, and their current status. This can be useful for administrators to see what tokens are nearing their expiration. Columns can be sorted by clicking on the column header.
The Token Renewal option allows you to select the accounts to issue new tokens to. It also provides you with a summary of the total number of active tokens that are assigned to each account.
After selecting the accounts you wish to renew, you will see a summary with new token information.
Next, you will be given the option to choose how the token information should be posted. You can copy the text from the screen manually or POST the token to a URL of your choice.
When renewing multiple tokens, their info will be separated by pipe "|" characters.
You can select POST classic to post your token to your URL with the classic method or POST JSON button to make an API call that will send a JSON array of tokens to your URL.
When you select POST JSON, we will create a JSON array named TOKENS and send it directly to the URL you specify. You can obtain this data by accessing the InputStream at your server endpoint.
Once you have made your selection, click on the Post Token URL button. You will be given a window in which you can enter a URL. If you have already provided us with one, that URL will be entered into the window by default. You may still manually enter a different URL at this point.
Once you have the correct posting URL entered, click on the Post button. You'll see a parameter appended to your posting URL. This is what you will use to download your token file.
The file will contain the token information in an encrypted format consisting of an initialization vector and the data itself, separated by an equals sign "=".
When viewing the token from POST Classic, the first 12 characters are an initialization vector, including the equal sign "=" separator, the remaining are the encrypted message.
As an integrator, you will have already been provided with a unique encryption key, also referred to as an EIndex. You can use it to decrypt the token file.
Once decrypted, each token would now have the account name, account ID, token, token ID, and expiration date, with multiple tokens being separated by a pipe "|".
The token ID is a reference number by which the Number support can look up your token should you require any assistance.
