Freshservice
  • 06 Nov 2024
  • 5 Minutes to read
  • Dark
    Light
  • PDF

Freshservice

  • Dark
    Light
  • PDF

Article summary

Freshservice is a cloud-based IT help desk and service management solution that enables organizations to simplify their IT operations.

Related Enforcement Actions

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices
  • Users
  • Software
  • SaaS Applications
  • Tickets

Parameters

  1. Freshservice Domain (required) - The hostname of the Freshservice server. The hostname field format is '[instance].freshservice.com'.

  2. API Key (required) - Specify the API Key provided by Freshservice.
    To locate your API Key, see Locate API Key.

  3. Throttle API Requests - Select this option to only use 90% of the API total rate limit bandwidth. For example: If a customer has 3000 total API calls allowed per hour, Axonius will only produce 2700 calls and leave the remaining 10% available.

  4. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  5. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Freshservcenew

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings with different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters.

  1. Freshservice asset type Include list (optional) - Specify a comma-separated list of Freshservice asset types.
    • If supplied, all connections for this adapter will only fetch devices whose asset type is any of the comma-separated list of Freshservice CI types that have been defined in this field.
    • If not supplied, all connections for this adapter will fetch devices with any Freshservice asset type.
  2. Fetch installed software - Select to fetch installed software.
  3. Fetch disabled users - Select to fetch disabled users. This setting is relevant only if one of the Fetch ___ as Users settings is selected.
  4. Fetch devices (optional, default: true) - Select to fetch devices.
  5. Fetch device relationships - Select this option to fetch device relationships from Freshservice (when cleared this data is not fetched).
  6. Fetch Agent as Users - Select to fetch agents as users.
  7. Fetch Requesters as Users - Select to fetch requestors as users.
  8. Fetch Assets as Users - Select to fetch assets as users.
  9. Use short format to describe OS Builds - Select this option to use short format to describe OS Builds.
  10. Fetch and resolve Product Fields - Select this option to fetch Freshservice product fields.
  11. Devices Schema and Users Schema (Custom schema entry (JSON) - Use these settings to add a JSON file to fetch information from one object to another. Refer to Using Custom Schema Entries to add a JSON file to Fetch Information from One Object to Another for details of how to configure these fields.
  12. Advanced to Basic Devices Schema and Advanced to Basic Users Schema (Custom schema entry (JSON) - You can configure fields that generally appear in 'Advanced' to appear in 'Basic' view. Refer to Showing Advanced Fields in Basic View.
  13. Fetch EC Action ticket updates (optional, default: true) - Select whether to fetch EC action ticket updates.
Note:

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.


Using Custom Schema Entries to Add a JSON File to Fetch Information from One Object to Another

You can use Custom devices schema, Custom users schema to add a JSON file to fetch information from one object to another. For instance from a source. For instance to enrich a laptop with information from another object. You can add more than one JSON file.

The schema below fetches extra information for the entity in the “Assets” table from the “Users” table and it looks up using the value in the “UserID” field. It then inserts the information in the “Advanced View” (JSON view in the Asset Profile page for the specific adapter connection) under the “ax_user” field. The JSON file must be of the format:

{
        "type": "link",
        "link_type": "reference",
        "source_table": "Assets",
        "source_field": "UserID",
        "destination_table": "Users",
        "link_to_field": "ax_user"
}

link_type - The only supported type is reference.
source_table - The type of the source object type in Freshservice. This is the table that will be enriched from the data in the destination_table.
source_field - The attribute of the object type from which the values should be brought. Enrich the contents of the source_table which has the same name as the value of the source_field in the destination_table, with the contents of the destination_table field.
destination_table - The destination object type in Freshservice from which the data will be imported.
linked_record_identifier - the name of the attribute that identifies the object.
All of the above are mandatory.
It is not necessary to list all of the source tables, instead of listing all source_tables, it is possible to write “$ROOT” in the “source_table” field.

[
  {
    "id": "35452789AI",
    "type": "link",
    "link_type": "reference",
    "source_table": "$ROOT",
    "destination_table": "sys_user",
    "source_field": "u_user"
  }
]

For instance if the source table contains the field "owner" then the system fetches the object of the sort "user" for all of the tables. This will populate associated users for all source objects that have the field "owner".

Showing Advanced Fields in Basic View

You can configure fields that generally appear in 'Advanced' to appear in 'Basic' view. Configure for devices and users separately as required. Use the plus sign to add an entry to each field.

Freshservice Advanced to Basic

Enter fields in the following JSON format:

[
{
    "label":"My First Field", 
    "raw_field": "field_a",
    "field_type": "str"
},
{
    "label":"My Second Field",
    "raw_field": "field_b",
    "field_type": "int"
}
]
  • label - the name for the field you want to appear in the basic view

  • raw_field - the path of the field as it appears in JSON format on the Adapter Connections page of the Asset Profile (or Advanced view table). For the inner path use the slash sign (/).

  • field_type -the field type as it appears in JSON format. The following field types are supported. int, string, datetime, float, bool. You can write them in the following ways:

    'int', 'string', 'str', 'date', 'datetime', 'float', 'bool', 'boolean'.


Locate API Key

To locate your API Key

  1. Log in to your Support Portal.
  2. Click on your profile picture on the top right corner of your portal.
  3. Go to the Profile Settings page. Your API Key is displayed below the Change Password section on the right side.



Was this article helpful?

What's Next