[{"data":1,"prerenderedAt":454},["ShallowReactive",2],{"connector-en-matrix42":3},{"id":4,"title":5,"body":6,"category":444,"description":445,"extension":446,"meta":447,"navigation":448,"path":449,"seo":450,"sidebar":451,"stem":452,"updatedAt":444,"__hash__":453},"connectorsEn\u002Fen\u002Fconnectors\u002Fmatrix42.md","Matrix42",{"type":7,"value":8,"toc":427},"minimark",[9,13,18,21,40,44,65,69,115,119,122,151,155,160,163,187,191,252,258,262,323,327,363,367,376,382,398,402],[10,11,12],"p",{},"The Matrix42 connector retrieves into OverView the computers registered in Matrix42 Enterprise Service Management, through the Matrix42 API.",[14,15,17],"h2",{"id":16},"objective","Objective",[10,19,20],{},"The Matrix42 connector retrieves the following information:",[22,23,24,28,31,34,37],"ul",{},[25,26,27],"li",{},"Computers of the asset inventory (name, DNS name, IP address, MAC address, serial number, manufacturer and model, memory and processor)",[25,29,30],{},"Operating system of each computer",[25,32,33],{},"Assigned user and location of each computer",[25,35,36],{},"Lifecycle state of each computer (for example Active or Disposed)",[25,38,39],{},"Dates of the first and last inventory scan",[14,41,43],{"id":42},"prerequisites","Prerequisites",[22,45,46,58],{},[25,47,48,49,53,54,57],{},"An account with access to the ",[50,51,52],"strong",{},"Administration"," and ",[50,55,56],{},"Master Data"," applications of Matrix42, to create the Person, the user role and the API token used by OverView",[25,59,60,61,64],{},"For a Matrix42 server installed on premises: an ",[50,62,63],{},"OverView OutPost"," deployed in your network and an HTTPS flow allowed from the OutPost VM to the Matrix42 server",[14,66,68],{"id":67},"information-to-provide-in-overview","Information to provide in OverView",[70,71,72,85],"table",{},[73,74,75],"thead",{},[76,77,78,82],"tr",{},[79,80,81],"th",{},"Field",[79,83,84],{},"Description",[86,87,88,105],"tbody",{},[76,89,90,97],{},[91,92,93,96],"td",{},[50,94,95],{},"Server URL","*",[91,98,99,100,104],{},"Base URL of the Matrix42 web services, as the OutPost VM reaches it, without a trailing slash (e.g., ",[101,102,103],"code",{},"https:\u002F\u002Fmatrix42.example.com\u002FM42Services",")",[76,106,107,112],{},[91,108,109,96],{},[50,110,111],{},"API Token",[91,113,114],{},"API token generated below",[14,116,118],{"id":117},"parameters","Parameters",[10,120,121],{},"These parameters are optional. Leave them at their default value unless you have a specific reason to change them.",[70,123,124,136],{},[73,125,126],{},[76,127,128,131,133],{},[79,129,130],{},"Parameter",[79,132,84],{},[79,134,135],{},"Default",[86,137,138],{},[76,139,140,145,148],{},[91,141,142],{},[50,143,144],{},"Verify SSL",[91,146,147],{},"Verify the TLS certificate of the Matrix42 server. Disable it for a server using a self-signed or internal certificate",[91,149,150],{},"Enabled",[14,152,154],{"id":153},"procedure","Procedure",[156,157,159],"h3",{"id":158},"create-a-person-for-overview","Create a Person for OverView",[10,161,162],{},"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.",[164,165,166,180],"ol",{},[25,167,168,169,171,172,175,176,179],{},"Open the ",[50,170,56],{}," application and go to ",[50,173,174],{},"Users"," > ",[50,177,178],{},"Persons",".",[25,181,182,183,186],{},"Create a Person named for its use (e.g., ",[101,184,185],{},"OverView Connector",").",[156,188,190],{"id":189},"create-a-read-only-user-role","Create a read-only user role",[164,192,193,203,217,224,231,249],{},[25,194,168,195,171,197,175,200,179],{},[50,196,52],{},[50,198,199],{},"Security",[50,201,202],{},"User Roles",[25,204,205,206,209,210,213,214,186],{},"Click ",[50,207,208],{},"Add User Role"," and enter a ",[50,211,212],{},"Name"," (e.g., ",[101,215,216],{},"OverView Read Only",[25,218,219,220,223],{},"On the ",[50,221,222],{},"Members"," tab, add the Person created above.",[25,225,226,227,230],{},"Save the role, then run the ",[50,228,229],{},"Set Permissions"," action on it.",[25,232,233,234,237,238,241,242,245,246,179],{},"Select the ",[50,235,236],{},"Computer"," configuration item, set the ",[50,239,240],{},"read"," permission to ",[50,243,244],{},"allowed"," and leave every other permission at ",[50,247,248],{},"not set",[25,250,251],{},"Save the permissions.",[10,253,254,255,257],{},"A permission left at ",[50,256,248],{}," is denied, so the role grants nothing beyond reading computers.",[156,259,261],{"id":260},"generate-the-api-token","Generate the API token",[164,263,264,276,283,320],{},[25,265,266,267,269,270,175,273,179],{},"In the ",[50,268,52],{}," application, go to ",[50,271,272],{},"Integration",[50,274,275],{},"Web Service Tokens",[25,277,278,279,282],{},"Run the ",[50,280,281],{},"Generate New Token"," action.",[25,284,285,286],{},"Fill in the fields:\n",[22,287,288,296,314],{},[25,289,290,292,293,104],{},[50,291,212],{},": a unique name (e.g., ",[101,294,295],{},"OverView",[25,297,298,301,302,305,306,309,310,313],{},[50,299,300],{},"Expires at",": the token lifetime. The default is ",[50,303,304],{},"30 days","; the connector stops working when the token expires, so choose a longer lifetime (",[50,307,308],{},"1 year"," or ",[50,311,312],{},"Never Expires",", depending on your security policy) or renew the token before that date.",[25,315,316,319],{},[50,317,318],{},"User",": the Person created above",[25,321,322],{},"Copy the token displayed on the action result page immediately: Matrix42 does not store it and does not display it again.",[156,324,326],{"id":325},"configure-the-connector-in-overview","Configure the connector in OverView",[164,328,329,338,347,350,358],{},[25,330,331,332,175,335,179],{},"In OverView, go to ",[50,333,334],{},"Data Sources Settings",[50,336,337],{},"Sources",[25,339,340,341,343,344,179],{},"Select ",[50,342,5],{}," and click ",[50,345,346],{},"Configure",[25,348,349],{},"For a Matrix42 server installed on premises, choose your OutPost as the collection point.",[25,351,352,353,355,356,179],{},"Enter the ",[50,354,95],{}," and the ",[50,357,111],{},[25,359,205,360,179],{},[50,361,362],{},"Save Configuration",[14,364,366],{"id":365},"required-permissions","Required Permissions",[10,368,369,370,372,373,375],{},"The Person linked to the API token needs ",[50,371,240],{}," access to the ",[50,374,236],{}," configuration item. The connector only reads data: it never creates, modifies or deletes anything in Matrix42.",[10,377,378,379,381],{},"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 ",[50,380,240],{}," permission on the configuration items holding persons and locations.",[10,383,384,385,388,389,391,392,175,395,186],{},"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 ",[50,386,387],{},"Audience"," (",[50,390,52],{}," application, ",[50,393,394],{},"Web Services",[50,396,397],{},"Public API",[14,399,401],{"id":400},"official-documentation","Official Documentation",[22,403,404,413,420],{},[25,405,406],{},[407,408,412],"a",{"href":409,"rel":410},"https:\u002F\u002Fdocs.matrix42.com\u002Fen_US\u002F1074558_web-services\u002F3463381_web-services-tokens-generate-api-token",[411],"nofollow","Web Services tokens: Generate API Token",[25,414,415],{},[407,416,419],{"href":417,"rel":418},"https:\u002F\u002Fdocs.matrix42.com\u002Fen_US\u002F1074558_web-services\u002F3463238_web-services-rest-api-integration",[411],"Web Services: REST API integration",[25,421,422],{},[407,423,426],{"href":424,"rel":425},"https:\u002F\u002Fdocs.matrix42.com\u002Fen_US\u002F1065183_security\u002F3460358_security-management-user-roles-and-permissions",[411],"Security Management: User Roles and Permissions",{"title":428,"searchDepth":429,"depth":429,"links":430},"",2,[431,432,433,434,435,442,443],{"id":16,"depth":429,"text":17},{"id":42,"depth":429,"text":43},{"id":67,"depth":429,"text":68},{"id":117,"depth":429,"text":118},{"id":153,"depth":429,"text":154,"children":436},[437,439,440,441],{"id":158,"depth":438,"text":159},3,{"id":189,"depth":438,"text":190},{"id":260,"depth":438,"text":261},{"id":325,"depth":438,"text":326},{"id":365,"depth":429,"text":366},{"id":400,"depth":429,"text":401},null,"Integrate Matrix42 Enterprise Service Management to retrieve the computers of your asset inventory","md",{},true,"\u002Fen\u002Fconnectors\u002Fmatrix42",{"title":5,"description":445},{"label":5},"en\u002Fconnectors\u002Fmatrix42","jn9TMMXRXPROZVIhm2mb3Z7OEhBRQRXaJhb0JZ_4sWg",1795084500226]