This document provides the steps required to configure the Veeam Service Provider Console (SPC) Integration with Reconcile.
Overview
Our Veeam Service Provider Console (SPC) integration automatically synchronizes company-level service usage data from Veeam SPC to streamline billing and account management. For details on deploying and configuring Veeam SPC, refer to the Veeam Service Provider Console Deployment Guide.
How to Connect Veeam SPC
To configure and connect the Veeam SPC integration, please click to navigate to the following:
- Authentication Details
- Connect Veeam SPC
- Map Accounts and Services
- Usage Breakdown for Managed Services
Authentication Details
To get started, you need two key pieces of information to connect to the Veeam Service Provider Console (SPC):
- API URL
- API Key
API URL
To establish a connection with our integration, you'll require the API URL tailored to your specific setup. The API URL adheres to the following format:
-
If you're accessing the Veeam Service Provider Console Web UI via HTTPS without a designated port number:
API URL:
https://<hostname>
-
In case you're connecting to the Veeam Service Provider Console Web UI using HTTPS with a customized port number:
API URL (with port):
https://<hostname>:<port>
- Please note that the default port number is 1280.
For more details, see the Veeam Service Provider Console REST API Resource URLs.
API Key
When configuring our Veeam integration, we use the Simple API Key authentication method. This generates a single Private Key that serves as your integration’s authentication token.
For instructions on creating a Simple API Key, refer to the Configuring a Simple API Key guide.
Whitelisting IPs on Host Server
Due to the random IPs utilized by our Veeam SPC integration, whitelisting IPs on your Veeam SPC host server is currently not feasible. We're devising a plan to enable whitelisting for static IPs on your host server. However, if you prefer not to expose your host server to the internet at the moment, you can implement a custom "self-hosted" integration with Veeam SPC. For more details, reach out to support@meetgradient.com.
Certificate Requirement on Host Server
Note that a SSL certificate is mandatory for the server hosting the console. This certificate is crucial for authentication and establishing connections with the host server. Failure to have a valid SSL certificate in place can result in Synthesize being unable to authenticate or establish a connection with the host server.
Certificate Verification
Utilizing a reliable third-party certificate check tool like www.sslshopper.com/ssl-check.html can help identify any missing certificates. In instances where a certificate is not recognized as trusted, it may be necessary to install an intermediate/chain certificate or associate the URL with a trusted root certificate.
Connect Veeam SPC
- Login to Reconcile and navigate to the Integrations tab.
- Select the Veeam SPC Integration card, and click Connect.
- Select Billing Only and click Continue.
- Enter the API URL and API Key generated from Veeam Service Provider Console in the previous steps.
- Click Authenticate.
- Once successfully authenticated, accounts and services will be generated, and the integration will be updated to a pending status. You can click the status refresh button or simply refresh your browser if you are unable to proceed to the next step.
- Click Next.
Map Accounts and Services
Note: If you need further details on account and service mapping, click here.
-
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.
-
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".
-
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!
Usage Breakdown for Managed Services
This comprehensive breakdown outlines the various services integrated into Reconci. We aggregate usage data from these services based on Managed services counters from the Veeam Service Provider Console REST API. This breakdown serves as a reference for mapping services when configuring the integration in Synthesize.
To access a more extensive catalog of billable services within the Veeam Service Provider Console, please consult the following documentation: Veeam Service Provider Console - Services.
Service | Description |
---|---|
AgentCloudBackupDataTransferIn | Agent cloud backup data transfer (incoming). |
AgentCloudBackupDataTransferOut | Agent cloud backup data transfer (outgoing). |
BackedupVms | Backed up virtual machines. |
CloudArchiveTierBackupSize | Cloud archive tier backup size. |
CloudCapacityTierBackupSize | Cloud capacity tier backup size. |
CloudInsiderProtectionBackupSize | Cloud insider protection backup size. |
CloudObjectStorageUsage | Object cloud storage usage. |
CloudPerfomanceTierBackupSize | Cloud performance tier backup size. |
CloudRegularStorageUsage | Regular cloud storage usage. |
CloudRepositoryUsageByServerAgent | Cloud repository usage by server agents. |
CloudRepositoryUsageByVm | Cloud repository usage by virtual machines. |
CloudRepositoryUsageByWorkstationAgent | Cloud repository usage by workstation agents. |
CloudTotalUsage | Total cloud storage usage. |
FileShareArchiveSize | File share archive size. |
FileShareBackupSize | File share backup size. |
FileShareSourceSize | File share source size. |
ManagedAgentsLinuxOS | Managed agents for Linux OS. |
ManagedAgentsMacOS | Managed agents for macOS. |
ManagedAgentsWindowsDesktopOS | Managed agents for Windows desktop OS. |
ManagedAgentsWindowsServerOS | Managed agents for Windows server OS. |
ManagedCloudVms | Managed cloud virtual machines. |
ManagedServerAgents | Managed server agents. |
ManagedUsers | Managed users. |
ManagedVms | Charged by the number of managed VMs. A managed VM is a VM that has a backup or replica restore point. |
ManagedWorkstationAgents | Managed workstation agents. |
ReplicatedVms | Replicated virtual machines. |
Vb365ArchiveSize | Veeam 365 archive size. |
Vb365BackupSize | Veeam 365 backup size. |
Vb365ProtectedGroups | Veeam 365 protected groups. |
Vb365ProtectedSites | Veeam 365 protected sites. |
Vb365ProtectedTeams | Veeam 365 protected teams. |
Vb365ProtectedUsers | Veeam 365 protected users. |
VbrCloudBackupDataTransferIn | Veeam Backup & Replication cloud backup data transfer (incoming). |
VbrCloudBackupDataTransferOut | Veeam Backup & Replication cloud backup data transfer (outgoing). |
VbrCloudReplicaDataTransferIn | Veeam Backup & Replication cloud replica data transfer (incoming). |
VbrCloudReplicaDataTransferOut | Veeam Backup & Replication cloud replica data transfer (outgoing). |
VmCloudBackups | Virtual machine cloud backups. |
VmCloudReplicaComputeTime | Compute time for virtual machine cloud replicas. |
VmCloudReplicaStorageUsage | Storage usage for virtual machine cloud replicas. |
VmCloudReplicas | Virtual machine cloud replicas. |
WorkstationCloudBackups | Workstation cloud backups. |