IT Glue Setup Guide

Purpose

This document outlines the standardized procedure for integrating ITGlue with the Mizo platform. It covers both user creation for document access and API key setup to ensure secure and scoped access.

Section 1 – Setting up the base configurations in Mizo

Step 1: Configure Integration in Mizo

1. Log into the Mizo console.
2. In the left-hand menu, go to Integrations.
3. Select ITGlue from the list.

Step 2: Enter ITGlue URL

1. Instance URL:
   • Enter your ITGlue instance URL (e.g., https://{{your-company-name}}.itglue.com)
2. API Key:
   • Will be covered in section 2.
3. Webapp Username / Password:
   • Will be covered in section 3.

Section 2 – Creating an ITGlue API Client for Mizo Integration

Step 1: Log in to ITGlue

• Use an Administrator account to sign in.

Step 2: Navigate to Admin Settings

• In the top navigation bar, click Admin.

Step 3: Generate an API Key

1. Scroll to the API Keys section.
2. Click + New API Key.
3. Uncheck the option for Password access.

1. Once the key is generated:
   • Copy the API key immediately (it will only be shown once).
   • Add the API Key to the Mizo console.

Step 4: Save configuration in Mizo

1. Save the configuration in the Mizo console by leaving the Webapp Username / Password fields blank. These steps will be completed after section 3 by a Mizo admin.

Section 3 – Creating a Mizo User in ITGlue

Step 1: Log in to ITGlue

• Use an Administrator account to sign in to the ITGlue web platform.

Step 2: Add a new Group (Restrict Password Access)

1. Go to the Groups tab and click + New (top-right corner).
2. Configure the group as follows:
   • Group Name: Mizo Agent Passwords Deny
   • Deny Asset Type Access: Passwords

Step 3: Add a New User

1. In the left-hand sidebar, navigate to Users.
2. Click + New (top-right corner).
3. Fill in the following user details:
   • Name: Mizo Agent
   • Email Address: itglue.account+{CompanyName}@mizo.tech(e.g. [email protected])
   • Role: Editor
4. Assign the Mizo Agent user to the created group to restrict visibility of sensitive credentials.
5. Configure Access to Organizations
   • Scroll to the Organizations section (bottom-right).
   • Specify which organizations the user should have access to:
     • Select relevant organizations individually
       or
     • Select All Organizations if company-wide access is appropriate.

Step 4: Ensure Password Auth is Enabled

1. In the left-hand sidebar, navigate to Settings.
2. Click Authentication (Top bar).
3. If any of the Single Sign-On options are activated, scroll down to the section
   Require Log In with {SSO Option}

   1. If it is enabled, make sure the Mizo Agent is in the User Exceptions list

      

   2. If it is disabled, no action is required

Step 5: Send the Invitation

1. Click Save or Send Invite to finalize the user creation.
2. A Mizo admin will receive the invitation and complete the account setup.