API Keys
Click 'Admin Panel' > 'Manage' > 'API Keys'
-
ITarian contains several modules that help IT managers to keep their organization's computers running smoothly. Some of the modules like Endpoint Manager (EM) are capable of automatically sending tickets to Service Desk via API.
- You can integrate Service Desk to your own applications through API. Once integrated, you can submit and manage tickets using your own interfaces.
- Service Desk requires API keys to authenticate ITarian modules and custom applications that submit tickets.
- Administrators need to specify the IP addresses from which these applications can access Service Desk.
- Service Desk auto-generates API keys for these IP addresses to authenticate access requests.
The 'API
Keys' interface lets administrators create and manage keys used to
communicate with external devices that access Service Desk.
Open the 'API Keys' interface
- Open the 'Admin Panel' (see the last link on the left)
- Click 'Manage' > 'API Keys'
- API Key: The key generated for the IP address shown in the 2ndcolumn
- IP Addr: IP address of the endpoint or network for which the key was generated
- Status: Indicates whether the key is enabled or disabled
- Date Added: The date on which the key was generated
- Last
Updated: Time and date that the key was
most recently edited.
Select an API key click the 'Enable' or 'Disable' link at the top, to make it active or inactive.
- Click a column header to sort items in ascending/descending order
- The 'Show records' drop-down on the right allows you to select the number of entries to be displayed per page.
- Open the 'Admin Panel' (see the last link on the left)
- Click 'Manage' > 'API Keys'
- Click 'Add New API Key' at the top
- Status: Activate or disable the key. Service desk will not accept connections from disabled keys.
- IP Address: Enter the IP address of the connecting client. A single API key can be shared by a group of clients by entering the '%' symbol at the end. For example, 10.10.0.% will cover all clients in the subnet 10.10.0.0/24.
- Can Create Tickets (XML/JSONE/EMAIL): If enabled, clients can create and submit tickets using XML/JSONE scripts.
- Can Execute Cron: If enabled, Service Desk allows external schedulers to run (Linux crontab) for various tasks. The external scheduler can only be set by system administrators at the time of Service Desk installation.
- Admin Notes: Add any additional informational about the key. For example, you could use this space to leave configuration notes
- Click 'Add Key' to save the key and make it available for selection
Edit an API Key
- Open the 'Admin Panel' (see the last link on the left)
- Click 'Manage' > 'API Keys'
- Click a key in the list
- This will open the update key screen. The configuration is the same as that for adding a new API Key.
Delete a API Key
- Select the key(s) that you want to delete then click the trash can icon above the table.