Requesting Ticket Generation from CodeMeter License Central

Objectives

After completing this lesson, you will be able to:
  • Configure credentials for SAP Entitlement Management and Wibu-Systems CodeMeter integration.
  • Request ticket generation from CodeMeter License Central.

Integration with Wibu-Systems CodeMeter

Note

For more information on integration with Wibu-Systems CodeMeter, see the following:

Integration between SAP Entitlement Management and Wibu-Systems CodeMeter bridges the gap between sales, provisioning, and fulfillment. This integration ensures that commercial entitlements managed in SAP Entitlement Management are seamlessly translated into technical entitlements on the end user's device using CodeMeter.

Below are the detailed steps for this integration:

Step 1: Create a Service Instance and Service Key for Inbound Authentication

  1. In the SAP Cloud Integration, create a service instance with the plan set to Integration-flow.
  2. Create a service key with the key type set to ClientId/Secret.
  3. In the Security Material section, add a new OAuth2 credential using the details from the service key.

Step 2: Add SAP Entitlement Management OAuth2 Credentials

  1. In SAP BTP, create a service instance of SAP Entitlement Management OAuth service.
  2. Generate a service key for the created service instance.
  3. In SAP Cloud Integration, in the Security Material section, add a new OAuth2 credential using the client ID, client secret, and OAuth token URL from the service key.

Step 3: Add Client Certificate of CodeMeter License Central - Web Service

  1. Navigate to the Keystore section of SAP Cloud Integration.
  2. Add a new key pair by selecting your key pair and providing an alias and password.
  3. Confirm the addition of the key pair to the Keystore.

Step 4: Add Basic Authentication Credential of CodeMeter License Central - Web Service

  1. Navigate to the Security Material section of SAP Cloud Integration.
  2. Add a new user credential.
  3. Enter the Name and Description of the user credential.
  4. Specify the Type as User Credentials.
  5. Enter the password for CodeMeter basic authentication and repeat the password for confirmation.

Step 5: Request Ticket Generation from CodeMeter License Central

  1. In SAP Cloud Integration, configure the Sender tab as follows:
    1. Specify the Address as /codemeter/ticket-generation.
    2. Set the Authorization User Role to ESBMessaging.Send.
  2. Configure the Receiver tab for CodeMeter as follows:
    1. Specify the Address of the CodeMeter web service.
    2. Set the Authentication Method to Client Certificate.
  3. Configure the Receiver tab for PostExit as follows:

    Specify the Address of your Sender Process Direct in your extension integration flow.

  4. Configure the Receiver tab for EntitlementManagement as follows:

    Specify the Address of the Inbound_Interface_Entitlement_Update_v2 API.

  5. On the More tab, set the CMLC Credential to the user credential name defined in Step 4.
  6. Specify the display names for License Quantity and Maintenance Period.
  7. Set the entitlement attribute for Ticket Code to the entitlement attribute defined in the entitlement model.
  8. Enable error handling, if required.

Step 6: Receive Activation State of License from CodeMeter License Central

  1. In SAP Cloud Integration, configure the Sender tab as follows:
    1. Specify the Address as /license/activation-state.
    2. Set the Authorization User Role to ESBMessaging.Send.
  2. Configure the Receiver tab for CodeMeter as follows:
    1. Specify the Address of the CodeMeter web service.
    2. Set the Authentication Method to Client Certificate.
  3. Configure the Receiver tab for PostExit as follows:

    Specify the Address of your Sender Process Direct in your extension integration flow.

  4. Configure the Receiver tab for EntitlementManagement as follows:

    Specify the Address of the Inbound_Interface_Entitlement_Update_v2 API.

  5. On the More tab, set the CMLC Credential to the user credential name defined in Step 4.
  6. Specify the iterating splitter settings, such as:
    • Number of Concurrent Processes
    • Timeout
  7. In SAP Entitlement Management, set the Status Code to the status configured in the integration flow.
  8. Enable error handling if required.

Step 7: Configure Wibu-Systems CodeMeter Settings

  1. Ensure you have created a service key for Wibu-Systems CodeMeter integration.
  2. If your CodeMeter License Central system is operated by WOPS, provide the clientid, clientsecret, and tokenURL to WOPS for configuration.
  3. If your CodeMeter License Central system is hosted by a software vendor, add the following settings to the deployment configuration file:
    Code Snippet
    12345678910111213141516171819
    ```​ EMS settings​ emsOAuthTokenUrl=<<tokenurl of service key>>​ emsClientId=<<clientid of service key>>​ emsClientSecret=<<clientsecret of service key>>​ emsBase=<<baseUrl of endpoint of iflow>>​ emsOrders=​ emsLicenses=​ emsActivations=<<path of endpoint of iflow>>​ ```

Step 8: Implement Extensions

  1. Identify extension points, such as:
    • Overwriting the whole process
    • Overwriting the standard process
    • Enhancing the payload of entitlement update
    • Enhancing additional actions after entitlement status update
  2. Set the appropriate parameters in the HTTP Header for each extension point.
  3. Provide a list of IDs of activation states in the HTTP Header – successIdList to confirm successful processing to CodeMeter.

Step 9: Activation Process

  1. In the Wibu-Systems WebDepot, activate the entitlements on the end user's PC or device.

    This portal allows online or offline activation of all licenses that are part of the ticket.

  2. Licenses can be stored as a software file bound to the device’s hardware digital fingerprint, in the secure crypto chip of a dongle, or in a cloud container bound to a known user.
  3. Once the activation process is completed successfully, all license checks (with the exception of a cloud license) are performed locally, with no need for a permanent server connection.

Request Ticket Generation from CodeMeter License Central

Configure SAP Cloud Integration

Create Event From SAP Entitlement Management System

Create One Entitlement To Trigger Entitlement Event

Check License From WIBU CodeMeter

Summary

By following these steps, businesses can effectively integrate SAP Entitlement Management with Wibu-Systems CodeMeter, ensuring a seamless process from sales and provisioning to the implementation and management of entitlements on end users' devices. This integration provides robust protection for intellectual property and flexible licensing options to meet diverse customer needs.

Ticket Generation from CodeMeter License Central

This integration flow allows you to trigger Wibu-Systems CodeMeter ticket generation when an entitlement is saved and write the ticket ID back to an entitlement attribute. It supports both entitlement events and entitlement group events, and provides enhancement points for adding or removing grouped entitlements.​

Step 1: Configure Sender in SAP Cloud Integration

  1. Specify the Address as /codemeter/ticket-generation.
  2. Set the Authorization User Role to ESBMessaging.Send.
  3. Set the CSRF Protected field to false.
  4. Define the Body Size (in MB) as 40.

Step 2: Configure Receiver for CodeMeter

  1. Specify the Address of the CodeMeter web service (e.g., https://lcadmin.codemeter.com/testservice).
  2. Set the Proxy Type to Internet.
  3. Set the Authentication Method to Client Certificate.
  4. Provide the Private Key Alias defined in the Key Pair section of the Keystore in SAP Cloud Integration.
  5. Set the Timeout (in ms) to 60000.
  6. Set the Compress Message field to false.
  7. Set the Allow Chunking field to true.

Step 3: Configure Receiver for PostExit

Specify the Address of your Sender Process Direct in your extension integration flow

Step 4: Configure Receiver for SAP Entitlement Management

  1. Specify the Address of the Inbound_Interface_Entitlement_Update_v2 API.
  2. Set the Authentication Method to OAuth2 Client Credentials.
  3. Provide the OAuth2 Credential Name defined in the SAP Entitlement Management OAuth2 Credentials section.
  4. Set the Timeout (in ms) to 60000.

Step 5: Configure the More Tab

  1. Set the CMLC Credential to the user credential name defined in the Basic Authentication Credential section.
  2. Specify the display names for License Quantity and Maintenance Period.
  3. Set the entitlement attribute for Ticket Code to the entitlement attribute defined in the entitlement model.
  4. Enable error handling if required.
  5. Set the Extension Implemented field to true or false, based on whether you have created your own integration flow with ProcessDirect Sender Adapter.

Step 6: Trigger Ticket Generation

  1. When an entitlement is saved in SAP Entitlement Management, this integration flow is triggered.
  2. The flow sends a request to CodeMeter License Central to generate a ticket.
  3. The generated ticket ID is written back to the specified entitlement attribute in SAP Entitlement Management.

Summary

Configures SAP Cloud Integration to request a license ticket from Code Meter License Central when an entitlement is saved and writes the ticket ID back into the entitlement.