Overview
You can use the API tokenization feature (Postman and Javascript) in the Armor Management Portal (AMP) to create an API key. This key will help you log into the Armor API system.
Step 1: Create an API key
Create an API (snippet)
| Insert excerpt |
|---|
|
Step 2: Authenticate into the Armor API system
In your Postman application, create a new GET request with the following endpoint: https://api.armor.com/roles
...
Click Headers.
...
...
Under Key,
...
select Authorization.
...
...
In Value,
...
enter {{hmacAuthHeader}}.
Under Key, select Content-Type.
...
In Value, enter application/json.
...
Click Pre-request Script.
...
Enter the script below with the following updated parameters:
...
Parameter | Description | ||
|---|---|---|---|
APP_ID | Enter the Key ID generated from AMP.
| ||
SECRET_KEY | Enter the Secret Key generated from AMP.
| ||
nonce | Enter a unique ID.
|
timestamp | Enter a Unix time stamp within 5 minutes of the current time. |
| Info |
|---|
For all v2 API's, the request body should be empty. |
| Code Block |
|---|
function getPath(url) {
var pathRegex = /.+?\:\/\/.+?(\/.+?)(?:#|\?|$)/;
var result = url.match(pathRegex);
return result && result.length > 1 ? result[1] : '';
}
function getQueryString(url) {
var arrSplit = url.split('?');
return arrSplit.length > 1 ? url.substring(url.indexOf('?')+1) : '';
}
function getAuthHeader(httpMethod, requestUrl, requestBody) {
*var APP_ID = '<use the api key id>';*
*var SECRET_KEY = '<use the secret key>';*
var AUTH_TYPE = 'ARMOR-PSK';
var requestPath = getPath(requestUrl).replace('https', 'http');
var queryString = getQueryString(requestUrl);
if (httpMethod == 'GET' || !requestBody) {
requestBody = '';
} else {
requestBody = requestBody.toString();
requestBody = CryptoJS.enc.Base64.stringify(CryptoJS.SHA512(requestBody));
}
var timestamp = Math.round(new Date().getTime() / 1000);
var nonce = timestamp;
var requestData = [APP_ID, httpMethod, requestPath, nonce, timestamp, requestBody].join("");
var mac = CryptoJS.HmacSHA512(requestData, SECRET_KEY);
var signature = CryptoJS.enc.Base64.stringify(mac);
var authHeader = AUTH_TYPE + ' ' + APP_ID + ':' + signature + ':' + nonce + ':' + timestamp;
return authHeader;
}
postman.setEnvironmentVariable('hmacAuthHeader', getAuthHeader(request['method'], request['url'], request['data'])); |
Step 3: Make an API Call
To learn about the different calls that you can make, see see Armor API Guide.
Related
...
Documentation
To learn about the different calls that you can make,
seesee Armor API Guide.
- To
To learn how to create an API key or to learn a different way to access the Armor API system, see
Log into Armor API