Matrix42 Matrix42

Integrate Matrix42 Enterprise Service Management to retrieve the computers of your asset inventory

The Matrix42 connector retrieves into OverView the computers registered in Matrix42 Enterprise Service Management, through the Matrix42 API.

Objective

The Matrix42 connector retrieves the following information:

  • Computers of the asset inventory (name, DNS name, IP address, MAC address, serial number, manufacturer and model, memory and processor)
  • Operating system of each computer
  • Assigned user and location of each computer
  • Lifecycle state of each computer (for example Active or Disposed)
  • Dates of the first and last inventory scan

Prerequisites

  • An account with access to the Administration and Master Data applications of Matrix42, to create the Person, the user role and the API token used by OverView
  • For a Matrix42 server installed on premises: an OverView OutPost deployed in your network and an HTTPS flow allowed from the OutPost VM to the Matrix42 server

Information to provide in OverView

FieldDescription
Server URL*Base URL of the Matrix42 web services, as the OutPost VM reaches it, without a trailing slash (e.g., https://matrix42.example.com/M42Services)
API Token*API token generated below

Parameters

These parameters are optional. Leave them at their default value unless you have a specific reason to change them.

ParameterDescriptionDefault
Verify SSLVerify the TLS certificate of the Matrix42 server. Disable it for a server using a self-signed or internal certificateEnabled

Procedure

Create a Person for OverView

The API token runs with the permissions of the Person it is linked to. A Person dedicated to OverView keeps those permissions limited to what the connector reads.

  1. Open the Master Data application and go to Users > Persons.
  2. Create a Person named for its use (e.g., OverView Connector).

Create a read-only user role

  1. Open the Administration application and go to Security > User Roles.
  2. Click Add User Role and enter a Name (e.g., OverView Read Only).
  3. On the Members tab, add the Person created above.
  4. Save the role, then run the Set Permissions action on it.
  5. Select the Computer configuration item, set the read permission to allowed and leave every other permission at not set.
  6. Save the permissions.

A permission left at not set is denied, so the role grants nothing beyond reading computers.

Generate the API token

  1. In the Administration application, go to Integration > Web Service Tokens.
  2. Run the Generate New Token action.
  3. Fill in the fields:
    • Name: a unique name (e.g., OverView)
    • Expires at: the token lifetime. The default is 30 days; the connector stops working when the token expires, so choose a longer lifetime (1 year or Never Expires, depending on your security policy) or renew the token before that date.
    • User: the Person created above
  4. Copy the token displayed on the action result page immediately: Matrix42 does not store it and does not display it again.

Configure the connector in OverView

  1. In OverView, go to Data Sources Settings > Sources.
  2. Select Matrix42 and click Configure.
  3. For a Matrix42 server installed on premises, choose your OutPost as the collection point.
  4. Enter the Server URL and the API Token.
  5. Click Save Configuration.

Required Permissions

The Person linked to the API token needs read access to the Computer configuration item. The connector only reads data: it never creates, modifies or deletes anything in Matrix42.

The assigned user and the location of each computer are read from the person and location records. To retrieve them, the same role also needs the read permission on the configuration items holding persons and locations.

If the connection returns an access error although the role is in place, check that the Matrix42 web services are not restricted to other users by their Audience (Administration application, Web Services > Public API).

Official Documentation