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.
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.