CIPP
Overview
The CIPP (CyberDrain Improved Partner Portal) integration allows Bumblebee to manage Microsoft 365 tenants across your MSP portfolio. Currently, it supports listing users and their assigned licenses for specific tenants.
Prerequisites & Setup
Before setting up the CIPP integration, you need:
- An active CIPP instance (hosted or self-hosted).
- Administrator access to CIPP.
1. Create an API Client in CIPP
- In your CIPP dashboard, navigate to Integrations > CIPP-API.
- Click Actions > Create New Client.
- Fill in an App Name (e.g., "Bumblebee") and submit.
- Important: Copy the Application Secret immediately and store it securely.
- Find your new client in the table, ensure it is Enabled, and click Actions > Save Azure Configuration to apply the changes.
2. Required Connection Details
You will need the following four values to configure the integration:
- Token URL: Usually
https://login.microsoftonline.com/<your-mgmt-tenant-id>/oauth2/v2.0/token - CIPP Client ID: The Client ID of the API client you just created.
- CIPP Client Secret: The Application Secret you saved in step 4.
- API Base URL: The URL of your CIPP API (e.g.,
https://api.yourinstance.com/api).
Configure in Bumblebee
- Go to the Integrations page in Bumblebee.
- Click on CIPP.
- Enter the Token URL, Client ID, Client Secret, and API Base URL.
- Save the configuration.
Available Tools
User Management
- list_users - List Microsoft 365 users for a tenant via CIPP and return license names. Required: tenant_filter (string)
Mailbox Management
- convert_mailbox - Convert a mailbox to a different type via CIPP. Required: tenant_filter (string), user_id (string), mailbox_type (string)
- set_out_of_office - Configure Out of Office / automatic replies for a user's mailbox via CIPP. Required: tenant_filter (string), user (string), auto_reply_state (string). Optional: internal_message, external_message, start_time, end_time
- set_mailbox_forwarding - Set or disable email forwarding for a user's mailbox via CIPP. Required: tenant_filter (string), user_id (string). Optional: forward_external_email_address, forward_internal_email_address, keep_copy, disable_forwarding
- edit_mailbox_permissions - Add or remove mailbox permissions (Full Access, Send As, Send on Behalf) via CIPP. Required: tenant_filter (string), user_id (string). Optional: add_full_access_auto_map, add_full_access_no_auto_map, remove_full_access, add_send_as, remove_send_as, add_send_on_behalf, remove_send_on_behalf
- get_mailbox_permissions - Get mailbox permissions (Full Access, Send As, Send on Behalf) for a user via CIPP. Required: tenant_filter (string), user_id (string)
- get_mailbox - Get mailbox details for a user via CIPP, including archive status. Required: tenant_filter (string), user_id (string)
Reference: CIPP API Documentation