The API resolver allows you to integrate your RESTful API endpoint with Guardian Ops. When an abuse report is received, our system can call your API to resolve the responsible customer and contract (optional) using metadata like IP addresses, timestamps, ports, or domains. Your system then returns the correct identifier and additional optional metadata.

The mapping configuration allows you to integrate with every system available, such as Ubersmith, Zendesk, Radius or CRM.

Multiple API resolvers can be configured and used at any location in the Inbound Processing configuration.

​
Common Use Case

Look up the subscriber assigned to an IP address at the time of an event using:

  • IP address
  • Event timestamp

​
How to Configure an API resolver

⚠️ If your API is behind a firewall, ensure the following outgoing IPs are allowed: 18.193.183.51 52.57.46.129 18.158.191.233

To configure an API resolver in Guardian Ops:

  1. Go to app.abusix.com .
  2. Click Settings in the left menu under Guardian Ops, where the Customer API resolver tab is located.
  3. Click on New API resolver in the top right.
  4. Fill in the name and description.
  5. Provide the API endpoint, authentication credentials, and any required parameters.
  6. Hit ‘Test resolver’ to receive a response and configure the mapping. When configuring field mappings, you can either assign a field as an identifier or allocate it as supplementary metadata.
    1. Assign sets a field as primary identifier (customer ID, contract ID or tenant ID).
    2. Allocate adds metadata to the customer, contract, or tenant (e.g., service tier, location).
  7. Save. Now the created Resolver is available in the Inbound Processing configuration

​
Entity mapping

The API resolver can map IDs for customers (mandatory), contracts, and tenants and allocate metadata to each. This can be done in the configuration’s mapping step.

A contract can differentiate between different contracts, such as mobile, landline, servers, or other entities related to a specific customer.

Tenants are a hierarchical layer that differentiates parts of an organisation. For example, the tenant layer can be used if a company has two subsidiaries with non-unique customer IDs for different users or organisations.

​
Retry Threshold

The API resolver supports automated retries for up to 32 hours. Whenever Guardian Ops receives HTTP status codes other than ‘200’ it will retry until the limit is exceeded.