ImmyBot integration

This document outlines the requirements and setup for the ImmyBot integration.

If you’re new to integrations in Rewst, read through our introductory integration documentation here.

ImmyBot does not suppot multi-instance integration. For more on this topic, see our documentation here,

What does the ImmyBot integration do?

Our ImmyBot integration enables the automation of remote machine management and monitoring. Use the ImmyBot API within Rewst workflows to gather detailed information and perform various operations on remotely managed machines, people, software, and scripts.

By default, ImmyBot's generated credentials expire two years after creation. If your integration suddenly fails and has been working for some time, try reauthorizing the integration with new credentials.

Set up the ImmyBot integration

What is automatic provisioning?

Automatic Provisioning for ImmyBot is an optional but recommended setting enabled during configuration setup. It allows for automatic authorization with your partner accounts into the Rewst platform to make integration setup easier. When enabled, Rewst will create an App Registration in your Azure tenant to utilize for authentication with your ImmyBot instance.

Set up steps in Rewst

Navigate to Marketplace > Integrations in the left side menu of your Rewst platform.
Search for ImmyBot in the integrations page.
Click on the integration tile to launch the configuration setup page.
Enter your ImmyBot Hostname: for example, rewst-qa.immy.bot.
Click Next.
Choose to toggle Automatic Provisioning on or off.
1. When enabled, Rewst will create an App Registration in your Azure tenant to utilize for authentication with your ImmyBot instance.
2. Note that if you choose to create this yourself or use the ImmyBot provisioned App Registration instead, then Rewst will not be able to provide all of the relevant values during setup steps
3. Complete the OAuth popup. The authorizing account must have sufficient Entra privileges to create app registrations and service principals in the tenant. On success, the information will automatically populate into the configuration fields in Rewst.
Enter the information copied from ImmyBot into the relevant fields if you choose not to use Automatic Provisioning:
- Microsoft Tenant ID - The ID of the Microsoft 365 Tenant associated with your ImmyBot instance
- Application ID - The Application ID of the Azure Enterprise App that Rewst will use to authenticate with ImmyBot
- Client Secret - The Client Secret of the Azure app registration Rewst will use to authenticate with ImmyBot
Click Next.
Click the link that appears on the integration configuration screen to navigate to ImmyBot's Persons Settings. Create a new Person for Rewst to use. Use your primary Tenant, and set the Azure Object ID field value. The Person's email field must not match the email address of an existing user in your Azure AD tenant, otherwise future Azure syncs from the ImmyBot side will overwrite this value and result in 403 Forbidden Errors when running ImmyBot actions.
1. You must sign in to the Microsoft dialog with an account that's allowed to create app registrations in the company's Microsoft tenant— usually an admin. If the account doesn't have that permission, Microsoft refuses access and Rewst will show error.
Click Continue to create your user and assign the admin Role.
Click Test configuration. If the integration is working properly, a green confirmation message will appear at the top of your screen.
Click Finish.

Set up steps in Microsoft

These steps are only needed if you choose not to use Automatic Provisioning. To replicate what that process creates, register an app in the Entra tenant with:

Supported account types: Accounts in any organizational directory - multitenant
API permissions: Microsoft Graph → Delegated → User.Read
Client secret: generate one under Certificates & secrets and record the value immediately
Service principal: created automatically when the app is registered in the tenant. No separate step is needed.

To complete these steps, your permissions in ImmyBot must be set to System Administrator. If your account was previously designated as Admin, ImmyBot automatically granted you the permission level of System Administrator (Legacy) in their recent permissioning change update. This is sufficient to set up the integration with Rewst.

Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our Canny feedback collector.

Triggers for ImmyBot integration

Trigger type name

Type

Description

New Computer Detected

Polling

Triggers when new computer is found that has not yet been onboarded

Actions and endpoints

For more on how actions work in Rewst, check out our introductory actions documentation here.