This guide will walk you through the process of integrating your Bitdefender EDR instance with our platform. The integration enables centralized monitoring, threat detection, and incident response capabilities.
Before beginning the onboarding process, ensure you have:
Administrative access to your Bitdefender GravityZone Portal
Permissions to generate API keys
The ability to share credentials securely with our team
To complete the onboarding, you will need to provide two items:
Base URL - Your GravityZone Portal URL
API Token - A generated API key with appropriate permissions
Your Base URL is the web address you use to access the Bitdefender GravityZone Portal.
Example formats:
https://your-company.gravityzone.bitdefender.com
https://cloud.gravityzone.bitdefender.com
To find your Base URL:
Open your browser and navigate to your GravityZone Portal
Copy the URL from your browser's address bar (everything before any additional paths)
Save this URL - you'll need to provide it during onboarding
Log in to the GravityZone Portal
Navigate to your Base URL
Enter your credentials and sign in
Access Your Account Settings
Click on your Profile icon (typically located in the top-right corner)
Select My Account from the dropdown menu
Navigate to API Section
Scroll down to the API section
Click the Add API button
Create the API Key
Enter a descriptive name for the API key
Suggested name: Hoplon-API
This helps you identify the key's purpose in the future
Configure API Scopes
Select the required scopes for the integration
Important: You must enable the following API scopes exactly as shown:
Required Enabled APIs (check these boxes):
Companies
Packages
Network
Policies
Maintenance Windows
Reports
Incidents
Event Push Service
Patch Management
Note: The specific permissions shown above are required for full platform integration. Missing any of these may result in limited functionality.
Save and Copy the API Key
Click Save or Generate
CRITICAL: Copy the API key immediately and store it securely
The key will only be displayed once for security purposes
If you lose the key, you'll need to generate a new one
Once you have both the Base URL and API Token, share it with us.
Provide the following information:
Base URL: [Your GravityZone Portal URL]
API Token: [Your generated API key]
Contact Person: [Name and email for technical questions]
After you submit your credentials:
Our team will verify the connection within 1-2 business hours
We will conduct initial tests to ensure data is flowing correctly
You'll be notified of any issues or additional requirements
When configuring your API key, ensure the following scopes are enabled:
API Scope
Required
Purpose
Companies | ✓ Yes | Access company/organization data |
Packages | ✓ Yes | Access security package information |
Network | ✓ Yes | Access network inventory and endpoints |
Policies | ✓ Yes | Read security policies and configurations |
Maintenance Windows | ✓ Yes | Access maintenance scheduling data |
Reports | ✓ Yes | Generate and access security reports |
Incidents | ✓ Yes | Access security incidents and alerts |
Event Push Service | ✓ Yes | Enable real-time event notifications |
Patch Management | ✓ Yes | Access patch status and vulnerabilities |
Accounts | ✗ No | Not required for integration |
Licensing | ✗ No | Not required for integration |
Quarantine | ✗ No | Not required for integration |
Integrations | ✗ No | Not required for integration |
PHASR | ✗ No | Not required for integration |
Questions? Don't hesitate to reach out to our onboarding team. We're here to make this process as smooth as possible.