Adding Public Cloud Data to the VSM Integration (deprecated)

Introduction

This documentation is deprecated

Please refer to the updated version of the VSM Discovery integration.

The LeanIX VSM integration offers an automatic way to integrate discovered Cloud Objects from VSM into your LeanIX Enterprise Architecture Management workspace.

This manual shows how you can extend the existing LeanIX VSM integration to also include the cloud artifacts discovered in VSM in the integration flow. This will allow you to:

  1. Use aggregated information on your discovered cloud service artifacts to drive decision making within EAM
  2. Provide an enhanced view in EAM on your IT Landscape to support your business transformation use cases

Setup

The addition of Public Cloud data to the VSM Integration is powered by the LeanIX Integration Hub to scan your company data, process it into an LDIF and automatically trigger the Inbound Integration API processor.

Prerequisites
To add Public Cloud data from VSM, two elements need to be in place:

  1. The VSM integration is set up in your EAM workspace, see this manual.
  2. The Public Cloud Discovery feature is activated in your VSM workspace, see this manual.

Installation

This integration doesn't require any installation of a plugin-in, as the Integration Hub handles the entire integration.

Configuration

📘

If you already have an existing VSM integration:

Steps 1. - 5. can be skipped should you already have the VSM integration set up as per VSM Integration. In that case, you only change the data source as per step 6)

  1. In your EAM workspace go to Administration > Integration Hub
  2. Create a new data source by clicking on New Data source
  3. Enter the following details:
    1. Connector Name: vsm-vsmsync-connector
    2. Data source name: any name to identify the data source.
  4. Enter the following details:
    1. host: your hostname e.g. demo-eu-1.leanix.net
    2. wsName: the VSM workspace name, where you have your Public Cloud Discovery actively running.
  5. Enter the following attributes under Configuration Parameters:
    1. lxToken: API token of a Technical User in the VSM workspace - the technical user needs Admin rights for this integration to work learn more
  6. Click on the "Advanced" tab and replace "bindingKey" with "executionGroup": "leanix-ws2ws-eam-import-inbound"

Your setup should look similar to:

795

Config to run the integration

📘

Troubleshooting

Details about the ongoing and previous data source runs can be found in "Sync Logging".

Imported data

The VSM integration including Public Cloud data can be visually summarized as follows:

The table below states the detailled information that is brought over from the VSM workspace, in addition to what is already brought over as part of the standard VSM Integration:

Explanation: Fact Sheet type/category of that Fact Sheet e.g. IT Component / Software Artifact

VSMEAM
Technology/Cloud Service (Level 3) Fact SheetIT Component/Cloud Service Fact Sheet
Cloud Account/Cloud Provider Fact SheetProvider Fact Sheet
Public Cloud Region and Location from the Compute Environment Fact SheetIT Component/Data Center Fact Sheet
Relation between Technology/Cloud Service (Level 3) Fact Sheet and Cloud Account/Cloud ProviderRelation between IT Component/Cloud Service and Provider Fact Sheet
Relation between Technology/Cloud Service (Level 3) Fact Sheet and the Software Artifact Fact SheetRelation between IT Component / Cloud Service and IT Component/Software Artifact
Relation between Compute Environment Fact Sheet and Software Artifact Fact SheetThe link in VSM is exploited to derive the relation between respective IT Component / Data Center Fact Sheets and the respective IT Component / Software Artifact
Relation between Public Cloud Region from the Compute Environment Fact Sheet and Cloud Account/Cloud Provider Fact SheetRelation between IT Component / Data Center and Provider
"Cloud Spend Yesterday" and "Cloud Spend Last 30 Days" on the Product Fact Sheet"Cloud Spend Yesterday" and "Cloud Spend Last 30 Days" on the Application Fact Sheet

The table below states what information is removed/ deleted from the EAM workspace when it's the counterpart in VSM Public Cloud Data is deleted

Action in VSMImpacted Fact Sheet(s)Triggered action in EAMImpacted Fact Sheet(s) in EAM
Deletion ofSoftware ArtifactSet lifecycle “end of life” ofIT Component Software Artifact
Deletion of relationSoftware Artifact ↔︎ Cloud ServiceDeletion of relationIT Component subtype Cloud Service ↔︎ IT Component subtype Software Artifact
Archive ofCloud ServiceArchive ofIT Component Cloud Service
Deletion of relation
Artifact Fact Sheet is
Compute Environment attribute Public Cloud Location to any Software ArtifactDeletion of relationIT Component subtype Software Artifact ↔︎ IT Component subtype Data Center
Deletion of attributeCompute Environment Public Cloud Location for any Software ArtifactArchive ofCorresponding IT Component subtype Data Center
Deletion of relationCompute Environment to any Cloud Account subtype Cloud ProviderDeletion ofCorresponding relation IT Component subtype Data Center ︎↔ Provider
Deletion of relationCloud Service ↔ Cloud Account subtype Cloud ProviderDeletion ofCorresponding relation IT Component subtype Cloud Service ↔ Provider

📘

Linking back to VSM

As part of the integration of Public Cloud Artifacts from VSM to EAM a backlink is created on said Fact Sheets under the resource tab for easy navigation between the two workspaces