CIPP (CyberDrain Improved Partner Portal)

A step-by-step guide to getting started with the CIPP Integration with Gradient MSP

Overview

The CIPP integration is a custom integration that requires authentication within CIPP to establish a successful connection each time you push counts.

While we offer the option to use custom integrations, please note that our ability to troubleshoot and provide support for them is limited.

Additional Resources

How to Connect with CIPP

To configure and connect the CIPP integration, please click to navigate to the following:

  1. Generate Vendor API Keys
  2. Connect the integration 
  3. Map Accounts and Services  

Generate Vendor API Keys 

  1. Login to Reconcile and navigate to Integrations tab, and click on Custom
  2. Select the modules you want to integrate.
  3. Assign a name and description to your integration, such as “Cyberdrain” or “CIPP”.
  4. Agree to the Terms and Conditions.
  5. Generate the API Keys and store these details for use within Cyberdrain.
    1. Each integration is assigned a unique API Key.
    2. Save this key in a secure location—it will only be available once.

Connect the Integration 

  1. Log In to your CIPP account and navigate to the Extensions tab.
  2. Input the Gradient Vendor API Key and Partner API Key.
  3. Check the box for Enable Integration.
  4. Click on Test Connection to verify that the API keys are entered correctly.
  5. After entering the keys, force the first sync.
  6. Navigate back to Reconcile and click the Status Refresh button for the CIPP integration.
  7. Press Next to finalize the service and account mapping.

Troubleshooting

If the integration does not connect after following the steps above, please try the following:

  • Enter the Partner API Key first and click Set Extension Settings.
  • Refresh the page.
  • Enter the Vendor API Key and click Set Extension Settings.

Map Accounts and Services

Note: If you need further details on account and service mapping, click here.

  1. Map Accounts and Services

    • When setting up the integration for the first time, accounts are automatically matched if there's an exact match between your vendor and PSA.
    • For accounts not automatically matched:
      • Use the filter button beside the account names on the right, or
      • Use the search bar on the left to find PSA accounts.
    • Drag and drop the PSA accounts from the left to match them with vendor accounts on the right.
  2. Proceed to Service Mapping

    • Once accounts are mapped, click "Next" to access the Service Mapping step.
    • Align services or products from your PSA, displayed on the left, with the corresponding vendor services or SKUs on the right. For ConnectWise PSA users, search by Product ID.
    • Ensure at least one account and one service mapping is completed to finish the configuration.
    • After mapping the services, click "Next".
  3. Finalize Configuration

  • Review your service configurations and click "Finish" to complete the setup.
  • This will initiate a sync. The "Sync Status" indicator at the top-right will start spinning, showing that a sync is in progress.
  • Once the sync is complete, the "Refresh" button will light up pink, indicating the sync is complete. Click that button to see the vendor usage data populated.
  • Use the filter or sort options to jump to the connected services and start reviewing and approving usage!

Top