Connecting

The Match API is available via

https://yourserver/match/api/matchgrid_id/v1/

where matchgrid_id indicates the Matchgrid to access. Authentication and authorization for Match API access is controlled by API Users. The matchgrid_id is available on the page for configuring Matchgrid API Users, or by inspecting the URL of most Matchgrid-specific pages.

Protocol

COmanage Match implements the TAP Identity Match Protocol. Please note the following:

  • Search Only requests via GET are not supported, and will return a 405 error. Search via POST instead.
  • Responses do not include Additional Identifiers or Golden Attributes.
  • Attributes sent in a request that are not configured in any Rules will be silently ignored.

Request Headers

Client headers are not specified in the TAP Identity Match Protocol. For access to the COmanage Match implementation of this API:

  • Content-Type should be set to text/json, especially for requests that include a body.
  • Accept should not be sent (CO-1774).