Creating a service desk integration for Zendesk assets

The Oomnitza plug-in for Zendesk embeds Oomnitza-linked devices in the Zendesk ticket view and provides a link back to records in Oomnitza. 

In Oomnitza you can search for a linked device and extract a list of Zendesk tickets associated with the device.

If you edit a service desk integration for Zendesk that was previously created using basic authentication, your credentials become invalid and you must create an extended user integration that uses OAuth 2.0.  See Announcing the removal of API tokens as an authentication method for API requests.

The key features of the service desk integration are:

• Visibility of assets linked to the ticket reporter.
• Link assets effortlessly to any Zendesk ticket.
• Edit asset details right within Zendesk.
• Gain immediate visibility of Zendesk tickets connected to an asset from within your Oomnitza interface.

Setting up this integration requires an installation on the Zendesk end and an installation on the Oomnitza end to allow for the systems to communicate. 

  Contents

1. Before you start
2. Specifying trusted domains
3. Creating the Service Desk integration
4. Install the Oomnitza app in Zendesk Marketplace

Before you start

Specifying trusted domains

Use the global setting in your instance to ensure secure Cross-Origin Resource Sharing (CORS). See Enhanced CORS Policy for Service Desk integrations.

Creating OAuth 2.0 client credentials

To add your credentials to Oomnitza, you must complete the following actions in Zendesk:

• Generate a client ID and secret
• Specify scopes to control the app's access to the Zendesk resource

The Client Kind must be set to Confidential to allow Oomnitza to connect with Zendesk and the scope must be set to  read write.

Review Using OAuth authentication with your application before you add credentials to Oomnitza.

1. Log into the Admin Center.
2. Click  Apps and integrations in the sidebar, then select APIs > OAuth clients.

When you add an OAuth flow to a vendor app, you are prompted to provide the redirect URL for Oomnitza: https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url

Creating the Service Desk integration

Adding credentials to Oomnitza

Figure: Screen captures showing how to add OAuth 2.0 client credentials for Zendesk

1. Click Configuration > Security > Credentials.
2. Click Add .
3. Click Advanced mode.
4. On the INFORMATION tab:
   1. Type the name of the credentials.
   2. Select the owner of the credentials.
5. Click the AUTHORIZATION tab.
6. From the Authentication type list, select OAuth 2.0.
7. As Software SaaS, select Zendesk OAuth 2.0 Client Credentials.
8. Enter the following information:
   1. Subdomain
   2. Client ID and secret
   3. Scope
9. Click Authenticate.
10. Save your changes.

Adding the integration 

1. In Oomnitza, click Configuration > Integrations. 
2. Click Block view .
3. On the Integrations page, scroll down to the Service Desk Integrations.
4. Click the Zendesk tile.
5. Click the Connect tab.
6. Enter your Zendesk subdomain.
7. Select the OAuth 2.0 credentials that you created.
8. Click Connect.
9. Map the fields. Map the Requestor field to the Oomnitza Assigned To field.
10. Click Next.
11. Choose the fields that you want to display in the Oomnitza tab in Zendesk. Ensure that the fields you select are editable or read-only. To verify, click Configuration > Data Model > Field Configuration, and click the field.  See Creating Custom Fields in Oomnitza.
12. Click Finish. 

Install the Oomnitza app in Zendesk Marketplace

1. Log in to your Zendesk account. 
2. Go to Admin Center > Apps and integrations >Zendesk Support apps > Marketplace
3. Search for the Oomnitza Enterprise Technology Management app.
4. Click Install and select your Zendesk account. 
5. Click Install. The app is added to your Zendesk instance.
6. Enter your Oomnitza URL. The format of the URL is https://<mycompany>.oomnitza.com.  
   If you copy and paste the URL, ensure that you omit the trailing forward slash (/) at the end of the URL. If you enter, for example, https://odysseus.oomnitza.com/, the installation of the plugin will fail. You can define user access to the app in your Zendesk instance.
7. Click Install.

Result 
The plugin should now be displayed in Admin Center> Apps and integrations> Zendesk Support apps> My Apps.

Next steps

For information on adding tickets to assets in Oomnitza or adding assets to tickets in Zendesk, see:

• Adding Oomnitza assets to a Zendesk ticket
• Adding Zendesk tickets to an Oomnitza asset