Skip to content
AgentZforiMIS®

The connection to your AI app

This article explains how the AgentZ plugin in your AI app connects to the AgentZ app, how each end proves itself, and what only a proven plugin can do.

The AgentZ plugin runs inside your AI app. It connects to the AgentZ app to receive your iMIS access token and to ask the AgentZ app to work in the iMIS browser. It never receives your iMIS password.

The connection uses your computer’s internal address (127.0.0.1), which nothing outside your computer can reach. It cannot be opened from your office network or the internet.

A web page cannot open it either: the AgentZ app refuses any connection that comes from a web page.

Each time the AgentZ app starts, it makes a new random key and saves it in a file on your computer. On a Mac, only your own user account can read that file. When the AgentZ plugin connects:

  1. The plugin proves it can read the key.
  2. The AgentZ app proves to the plugin that it can read it too.
  3. The key itself is never sent over the connection.

A program that cannot prove it holds the key is refused.

An AgentZ plugin older than version 0.7.41 cannot prove itself this way. The AgentZ app refuses it and shows that it needs updating.

Once both ends have proved themselves, every message in both directions is encrypted (AES-256-GCM, with a separate key for each direction). If a message is changed, repeated or out of order, the connection is closed.

Only an AgentZ plugin that has proved itself can:

  • receive your iMIS access token;
  • ask the AgentZ app to work in the iMIS browser: open pages, carry out steps on a page, fill in forms, take screenshots, or download and upload files;
  • start an install of a BuildHub item;
  • use your team notes.

The plugin does not run programs from your project folder

Section titled “The plugin does not run programs from your project folder”

AI apps often work in a folder of your files. The AgentZ plugin runs on Node.js, and when it starts it never uses a Node.js program found inside that folder or its project, so a file placed there cannot make AgentZ run something else.

With the AgentZ app open, list the network ports it listens on:

  • Mac – in Terminal, run lsof -nP -iTCP -sTCP:LISTEN | grep -i ifinity. Each line ends in 127.0.0.1: and a port number, which means the port is open only inside the computer.
  • Windows – in Command Prompt, run netstat -ano | findstr 127.0.0.1:9333.

Does the AgentZ app open any port to the network? No. It listens only on the computer’s internal address, 127.0.0.1.

Can a website a person visits connect to the AgentZ app? No. The AgentZ app refuses any connection that comes from a web page.

How does the AgentZ app know it is talking to the genuine plugin? Both ends prove they hold a key the AgentZ app creates afresh each time it starts, without sending the key. A program that cannot prove it is refused.

Is the traffic between the AI app and the AgentZ app encrypted? Yes, every message, in both directions, once both ends have proved themselves. An altered or repeated message closes the connection.

Does the plugin receive our iMIS password? No. It receives an access token from the AgentZ app.

Why does the AgentZ app say our plugin needs updating? An AgentZ plugin older than 0.7.41 cannot prove itself, so the AgentZ app refuses it until it is updated.

Could a file in a project folder be run by AgentZ? No. When the AgentZ plugin starts, it never uses a Node.js program from inside the folder the AI app is working in, or its project.