Adding your Citrix credentials to Oomnitza

Best practice
For the integration with Oomnitza, create a dedicated user account.

Prerequisites

Client ID, Secret and Customer ID

Citrix uses OAuth 2.0 authentication and requires your Client ID, Secret and Customer ID to be added to Oomnitza. To obtain this information, complete the following steps:

1. Log in to Citrix Cloud or create a free trial account.
2. In the Citrix Cloud console, click the menu in the upper left corner of the screen.
3. Select Identity and Access Management 
4. Select the API Access tab.
5. Name your Secure Client, and click Create Client. Download or copy the Client Id and Secret and store them securely. 
6. Take note of the customer ID in the description above the Create Client button before you leave the screen.

For further information, refer to Citrix API Documentation: Get access to Citrix Cloud.

Citrix Cloud Account URL Domain

When adding the credentials to Oomnitza you will also need to supply your URL Domain. Enter one of the URL Domains from the below table, depending on the geographical region you selected when you created your account:

URL Domain	Region
api-ap-s.cloud.com	Asia Pacific South
api-eu.cloud.com	European Union
api-us.cloud.com	United States
api.citrixcloud.jp	Japan

For further information, refer to Citrix API Documentation: Get access to Citrix Cloud.

Adding your credentials

To stream Citrix data into Oomnitza, add the credentials that you obtained to Oomnitza:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration. 
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. Add the information details.
2. Click the AUTHORIZATION tab.
3. Ensure that OAuth 2.0 is selected as the Authorization type.
4. Ensure that Citrix is selected from the SaaS list.
5. Enter the details you obtained in the previous steps.
6. Click Authenticate. 
7. Click CREATE. 

Adding your XenMobile Hostname and Port number as a global variable

To save time entering information when you create the integration and the workflow, you can add your XenMobile Server hostname and port number as a global variable as a global variable in Oomnitza.

1. From the menu,go to Configuration>General.
2. ClickGlobal Settings.
3. Click Add new variable (+). 
4. Enter Citrix.Hostname as the variable key.
5. Enter your Hostname as the value.
6. Save your changes.
7. Repeat the steps above to add Citrix.Port variable key and enter your Port number as the value.

You use the credentials that you added to create and customize your integrations with Oomnitza.