Skip to main content
Connect IT Portal so the agent uses each client’s KB articles, documents, devices, contacts and stored passwords while it works a ticket. You need an IT Portal admin who can create an organization API key under Admin → Security → API Keys.

How to connect

1

Create an API key in IT Portal

In IT Portal, open Admin → Security → API Keys and create an organization key for Rallied.Give it read access to companies, sites, devices, contacts, accounts, KB articles, documents, interactions and the type lists. Add access to credentials so the agent can reveal passwords.For the agent to write to IT Portal, also allow creating and updating devices, contacts, accounts, KB articles, documents and interactions. A missing scope doesn’t block the connection. Only the tool that needs it fails when the agent calls it.
2

Copy the key and the API endpoint

Copy the key and the API Endpoint IT Portal shows with it, such as https://yourcompany.itportal.com/p5/api/3.0/. The endpoint can differ from the address you sign in at. It must be reachable over public HTTPS.
3

Connect IT Portal

In Rallied, go to Settings → Integrations, find the IT Portal card and click Connect. Fill in the form and click Connect.Rallied checks the key against your IT Portal instance and imports your IT Portal companies as candidate client mappings.
If the connection fails, check the key and that the address is the API endpoint IT Portal showed when you created the key, not your sign-in address.

Mapping companies to clients

IT Portal stores documentation per company. Each IT Portal company maps to a Rallied client on the Companies tab of Settings → Integrations → IT Portal. Click Sync companies there to pull in new companies. Every IT Portal tool takes the client’s company and returns only that company’s records, so the agent never uses another client’s documentation. The agent can’t use IT Portal for a client until its company is mapped.

What the agent reads

Rallied indexes KB articles and documents for documentation search, so the agent can answer “how do we do X for this client” with a cited source. Rallied refreshes the index on a schedule. Deleted and archived KB articles and documents drop out of search.

Passwords and approval

Revealing, creating and updating a password also go through identity verification. The agent puts a retrieved password only in an internal note, never in a message to the end user. 2FA codes are never available through Rallied.
If your IT Portal tenant protects stored passwords with a custom encryption key, Rallied can’t read or change passwords there. A technician can still do it in IT Portal directly.

Writing to IT Portal

Read tools default to Auto so the agent can consult your documentation during diagnosis. Every write tool defaults to Approval needed: Rallied has no tool that deletes IT Portal records. To change a default, open the Policies tab on Settings → Integrations → IT Portal. See Approval settings.

See also