How to Use the Xurrent App Connector
This guide explains how to use the Xurrent App Connector to automate app lifecycle events, securely manage secrets, and process webhook-based integrations within your iPaaS solution.
How to Use the Xurrent App Connector
The Xurrent App Connector allows you to retrieve app configuration details from your Xurrent environment.
For example, when you publish your app in the Xurrent App Store and a customer installs it, the connector can automatically send the customer’s details to your system.
Getting Started
- Click Select Trigger and choose Xurrent App Connector.
- The available triggers associated with the connector will be displayed.
Supported Triggers
1. Installation Changed Runbook
Use the Installation Changed trigger to implement business logic during a customer’s app lifecycle.
This trigger can respond to:
- New installations
- Updates
- App removals
Setup Steps:
- Select the Installation Changed trigger & Choose the event
- Copy the App Reference from your app offering page in Xurrent.
- Paste the App Reference into the iPaaS trigger configuration.
4. Add a Log Message action to log the customer ID (for testing/validation).
To complete the setup, go to the Connections page, finish the configuration, and promote the solution to make it operational.
2. Secrets Changed Runbook
Each iPaaS solution associated with a Xurrent App requires a Secrets Changed runbook.
When triggered, it securely configures the provider’s Xurrent account to send secrets to the iPaaS solution.
Setup Steps:
- Select the Secrets Changed trigger.
- Copy the App Reference from your Xurrent App Store configuration & paste it in trigger configuration
- Add a Log Message action to log the customer id:
Note:
Whenever a customer updates their app secrets, the updated values are stored in your iPaaS account and can be used within your runbooks.
To complete the setup, go to the Connections page, finish the configuration, and promote the solution to make it operational.
Automation Webhook Runbook
To handle integration logic, create a runbook using the Automation Webhook trigger.
This runbook is executed whenever a webhook is invoked by automation rules associated with the App offering.
Setup Steps:
- Select the Automation Webhook Runbook trigger.
- Copy the App Reference from your Xurrent App Store configuration & paste it in trigger configuration
- Define the payload schema expected from the automation rule.
- Log the webhook payload delivery to verify successful execution
To complete the setup, go to the Connections page, finish the configuration, and promote the solution to make it operational.