Installing Adapters

Installing Adapters in IAP (Optional)

IAP uses network and OSS adapters to facilitate the integration of IAP with various systems and applications. To add a new adapter to IAP, the adapter must be installed under node_modules within the IAP installation directory.

From the npm registry

The following steps demonstrate installing the adapter, from the npm registry and in its package form.

cd /opt/pronghorn/current

# Install "latest".
npm install @itentialopensource/adapter-db_mongo

# Install, or upgrade, a specific version.
npm install @itentialopensource/[email protected]

From source

Alternatively, an adapter may be installed "from source" without using a package manager. In the example shown below, the adapter is installed from Itential opensource. For custom adapters, use the appropriate scope (e.g., “@customername” or “@customercreatedvalue”) to which the adapter source applies.

Example

cd /opt/pronghorn/current/node_modules/@itentialopensource
git clone [email protected]:itentialopensource/adapters/persistence/adapter-db_mongo
cd adapter-db_mongo
npm ci

When you must upgrade, or change versions of an adapter, run the following.

Note: Be sure to checkout the branch you want to use.

cd /opt/pronghorn/current/node_modules/@itentialopensource/adapter-db_mongo
git checkout <branchname>
git pull

# If you need to see a list of all the tags/version numbers: `git tag`.

git checkout <your desired version number>
git pull
rm -rf node_modules
npm ci

Instantiate the adapter

Once the adapter is installed, restart IAP and the adapter will be auto-discovered during IAP startup and become available when adding an adapter via the IAP UI.

To add an available adapter to IAP:

1. Login to IAP and select Admin Essentials in the left navbar.

Figure 1: Admin Essentials

2. Click the plus (+) sign in the top toolbar of the Admin Essentials application to open the Create dialog.
3. Select Adapter from the dropdown menu, enter the desired name of the adapter and select the type, and then click Save.

Figure 2: Create Adapter

4. A skeleton JSON object of the Service Configuration for the adapter will be created and can be edited to match your environment by enabling the Service Config editor using the toggle switch (top-right).

Figure 3: Adapter Configuration

5. Click the Save button to retain your config changes for the adapter.

Figure 4: Save Config

6. The adapter will display under the Adapters menu in the left navbar, and from the Adapters collection view when you click the search icon (magnifying glass) in the top toolbar and select the Adapters tab.

Figure 5: Adapters Collection

7. Adapter connectivity can be confirmed from the Admin Essentials home page in the Alerts dashboard.

Figure 6: Alerts

Import the service config for an adapter

Itential enables you to build your own custom adapters to integrate specific network applications with IAP. Use the following steps to import the service config for your custom adapter.

From the Admin Essentials home page:

1. Click the Import icon in the top toolbar to display the Import dialog.
2. Select Adapter from the dropdown.
3. You can import (upload) your Adapter file by drag-and-drop, or click Browse Files to find and select the Adapter you want to import.

Figure 7: Adapter Import

4. Once the Adapter is imported, the name of the Adapter will pre-populate from the file, along with a description, in the Import modal. You can change the description, as needed, to provide specific information for your import and to better communicate what the adapter is used for within your platform.
5. Once you click the Import button, and upon successful import, the Adapter will be added to the collection list in the left sidebar.

Figure 8: Adapters Collection

Additional information on adapters

• For more information on adapter integration, see the IAP Integrations guide.
• See the Itential Open Source repository for available adapters.
• See the Adapters Technical Resources site for a library of information related to adapters, including Itential's Adapter Builder.