Skip to main content
Matrix42 Self-Service Help Center

Matrix42 MyWorkspace

Overview

The configured Matrix42 MyWorkspace Data Provider imports all accounts of your users from the Matrix42 Accounts server.

If additional settings are configured in the Single Sign-On section under Administration > Settings > Matrix42 MyWorkspace, a user will be able to log in to Matrix42 Software Service and Asset Management with their Matrix42 Account.

Prerequisites for Importing Accounts and Logging in with your Matrix42 Account

Prior to configuring the Matrix42 Accounts Data Provider, make sure that certain prerequisites are fulfilled.

  1. Settings for importing Matrix42 Accounts are configured.
    • An access token has been generated manually on your company's user profile page at https://accounts.matrix42.com/.
    • The Enterprise Name, Server, and Access Token fields are filled in the Administration application under Settings > Matrix42 MyWorkspace
  2. Settings for logging in with a Matrix42 Account are configured.
    • Matrix42 Access Control System (ACS) service administrator has registered the OAuth2 client and relying party (scope) in ACS and provided scope, client ID, and client secret values to your company. This data is necessary to allow your application access to https://accounts.matrix42.com/.
    • You have enabled the single sign-on and filled in the scope, client ID, and client secret values in the Administration application under Settings > Matrix42 MyWorkspace.
      The Scope, Client ID, and Client Secret are used by the application each time when a user selects to be logged in by using their Matrix42 Account. The user is redirected to https://accounts.matrix42.com/ with this data in URL. Based on this data, ACS authenticates the user. If the authentication is successful and the corresponding account has been previously imported by the Matrix42 Accounts Data Provider, the user is redirected back to Matrix42 Software Asset and Service Management and logged in with their Matrix42 Account.

SettingsIntegration.jpg

Import of Matrix42 Accounts

ADM_M42Accounts_Cycle.png

If the Matrix42 Software Asset and Service Management cannot access the Matrix42 Accounts server directly, you can install the Data Gateway on a proxy server that has access both to the Matrix42 Software Asset and Asset Management server and to the Matrix42 Accounts server.

  1. Activating the Matrix42 Accounts Data Provider
    Import of accounts can be triggered either manually by running the Activate action or automatically by the Data Provider Activation engine activation. The activation is set to run daily according to a specific schedule.
     
  2. Launching the Matrix42 Accounts Server Workflow
    The Matrix42 Accounts Data Provider launches the Matrix42 Accounts workflow. It is a server workflow that is run in Matrix42 Software Asset and Service Management.
     
  3. Launching the Matrix42 Accounts - Client Workflow
    The Matrix42 Accounts workflow creates jobs according to the specified configurations of the Data Provider. When the Data Gateway finds the jobs, it starts the Matrix42 Accounts - Client workflow.
     
  4. Retrieving Matrix42 Accounts
    The Matrix42 Accounts - Client workflow creates an HTTP request to the Matrix42 Accounts server and saves the retrieved accounts in an Account.xml file.
  5. Passing Matrix42 Accounts to Matrix42 Software and Asset Management
    The Data Gateway passes the Account.xml file to the Matrix42 Accounts workflow.

  6. Creating and Updating Objects Based on Imported Data
    The Matrix42 Accounts workflow executes two import definitions to create and/or update accounts and persons in Matrix42 Software Asset and Service Management. It uses the XML file as a data source.

    The following import definitions are executed:
    • Matrix42 Accounts: Import Accounts

      The import definition updates the existing accounts and creates new ones based on data received from the Matrix42 Accounts server. If an account has been deactivated on the Matrix42 Accounts server, the account status in Matrix42 Software Asset and Service Management is changed to Inactive.

    • Matrix42 Accounts: Import Persons

      The import definition updates the existing persons and creates new ones based on data received from the Matrix42 Accounts server. If an account has been deactivated on the Matrix42 Accounts server, the status of the corresponding person in Matrix42 Software Asset and Service Management is changed to Inactive.

Configuring the Matrix42 MyWorkspace Data Provider

For information on required ports, see Ports Used by Connectors and Data Providers.

The Matrix42 MyWorkspace Data Provider is designed for establishing the integration between Matrix42 Software Asset and Service Management and the Matrix42 Accounts server.

To configure the Matrix42 MyWorkspace Data Provider:

  1. In Matrix42 Software Asset and Service Management switch to the Administration application, open the Integration > Data Providers search page.
  2. Double-click the Matrix42 MyWorkspace Data Provider to open it. The properties dialog contains the Configurations list where configurations for this provider can be managed.
    MyWorkspaceDP.jpg
  3. To add a new configuration for the Data Provider, click + above the Configuration grid. The new properties dialog will open.

General

  • Data Gateway: Select the Data Gateway instance that will execute the configuration.
  • Description: Provide additional details about this configuration.
  • Enable Import: Select the checkbox to activate this configuration for import.

GeneralMyWOrkspace.jpg

 

  • Was this article helpful?