How to enable the Gizmo API


Follow the steps in this procedure to enable the Gizmo API. You need to complete this procedure before you can integrate Martello Gizmo with Martello iQ 

This procedure uses a PowerShell script, which performs the following tasks: 

  • Creates a local User, based on information in the script.  
  • Creates a new IIS website to be used for the API. The Website is setup using HTTP on the port specified in the script.  

Perform this procedure on the Gizmo Server. 

Before you Begin 

Procedure 

  1. Extract the zip file.  
  2. Edit the EnableAPIs.ps1 file with either a text editor or PowerShell ISE. Use the first 3 lines of the script to edit the username, password and port number:
    $Username="GizmoAPI" 
    $Password='G1zm0AP1' 
    $port = 8080 

    NOTE: The username and password in the script are placeholders. Please use complex password rules.  

  3. After you have made the edits, run the script using an administrator account. Your screen should look like the one shown in the image below when the script is complete:


  4. In IIS Manager, verify that you can see a newly created website called “gsxapi,” as shown in the image below: 


  5. To verify that the API is working, navigating to http://<servername>:8080/api/v1/robotmanager. 
  6. The browser asks you to authenticate. Enter the Username and Password from the script.

The interface should display json data, like the output shown in the image below:

Additional information 

The default installation is http on port 8080. We recommend that you add a CERT to the website. It may be necessary to change the port number for any firewall requirements. You can make these changes in the bindings of the website.  

If you see the following Warning, it indicates that you did not add Windows Authentication via the roles and features prior to running the script: