Veeam Service Provider Console (SPC)

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

    To get started, you need two key pieces of information to connect to the Veeam Service Provider Console (SPC):

    1. API URL
    2. 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

    1. Login to Reconcile and navigate to the Integrations tab.
    2. Select the Veeam SPC Integration card, and click Connect.
    3. Select Billing Only and click Continue.
    4. Enter the API URL and API Key generated from Veeam Service Provider Console in the previous steps.
    5. Click Authenticate.
    6. 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.
    7. Click Next.

    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!

    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.

     


    Top