Postman is a great tool for crafting and managing API calls. This article will explore how to import and configure the ThreatConnect API Starter Collection.
Setting
...
up Postman
Download Postman:
Installing Postman:
...
Download the ThreatConnect API Starter Collection below:. It is a Postman collection version 2.1 json file.
| View file | ||
|---|---|---|
|
...
3. An import menu screen will pop uppopup. Click on “Upload Files” located in the center of the pagepopup.
...
4. Select the ThreatConnect API Start Collection as the desired file to import. Click the orange “Import” button.
...
6. Edit the ThreatConnect API Starter Collection by clicking on the … icon in located at the bottom right hand corner of the collection. Click on “Edit” from the menu.
...
7. Once inside the Edit Collection popup, click on the “Variables” tab.
...
8. Enter your the tc_access_id and tc_secret_key for your the API user.
If an API user has not been created for your organization, login to your the ThreatConnect Instance and navigate to the “Org Settings” page.
You should see an option to “Create API User”. If the option is not available, please check to see if an API user has already been created by looking at the users shown on the page. Otherwise, please contact ThreatConnect Technology Partners on Slack.
When creating your API user, the API user’s Access ID and Secret Key will be shown. Note that the secret key is only shown once and so it is a good idea to store it in a safe place for future use. Click the “SAVE” button to save the API user.
If an API user exists already, click on the pencil icon under the “Options” column to see the Access ID. The Secret Key will not be shown. If the Secret Key was not saved, it is recommended to delete the current API user and create another one.
Enter the Access ID as the value of the tc_access_id variable and the Secret Key as the value for the tc_secret_key variable. These values should be put under the “CURRENT VALUE” section as shown below. Click the orange “Update” button in located at the lower right hand corner of the popup.
...
If the query returns “status”: ”Failure”, there are two quick checks to do.
1. Make sure that the Access ID and Secret Key are correctly entered.
2. Make sure that the Access ID and Secret Key are entered in the Current Value section and not the Initial Value section in the variables tab in the collection settings.