# Citrix DaaS connector

{% hint style="warning" %}
This documentation references external sources. Nexthink does not have control over the accuracy of third-party documentation, nor any external updates or changes that might create inconsistencies with the information presented on this page. Please report any errors or inconsistencies to [Nexthink Support](https://support.nexthink.com/).
{% endhint %}

The Connector for Citrix DaaS allows you to import device organizational information about virtual desktops, such as host pool or type of desktop virtualization.

The feature is scheduled to run automatically and communicate with the Citrix Cloud API according to the configuration of the API Client.

{% hint style="info" %}
Citrix DaaS enriches Nexthink device data to enhance device visualization.
{% endhint %}

## Prerequisites <a href="#connectorforcitrixdaas-prerequisites" id="connectorforcitrixdaas-prerequisites"></a>

1. Log in to [Citrix Cloud](https://citrix.cloud.com/) as admin.
2. Navigate to the **API Access** tab of the **Identity and Access Management** menu.
3. Create an API client; refer to the [Get started with Citrix Cloud APIs](https://developer-docs.citrix.com/en-us/citrix-cloud/citrix-cloud-api-overview/get-started-with-citrix-cloud-apis) documentation.

## Additional consideration <a href="#connectorforcitrixdaas-devicefields" id="connectorforcitrixdaas-devicefields"></a>

In the ICA policy settings, ensure the **Virtual channel allow list** is set to **Disabled**. For more information, see the [Citrix documentation](https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/policies/reference/ica-policy-settings/virtual-channel-allow-list-policy-settings).

## Device fields <a href="#connectorforcitrixdaas-devicefields" id="connectorforcitrixdaas-devicefields"></a>

The connector for Citrix DaaS imports the following device virtualization fields.

| Nexthink Field                   | Description                                                                                                                  |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Virtualization desktop pool name | Hardware characteristics of the associated VMs.                                                                              |
| Virtualization desktop pool type | <p>Type of the desktop pool. Possible values are:</p><ul><li>shared</li><li>personal</li><li>pooled</li></ul>                |
| Virtualization hostname          | The physical device hosting the virtual machine. It may be empty for those machines hosted in a cloud vendor, such as Azure. |
| Virtualization hypervisor name   | Hardware virtualization system which is being used.                                                                          |
| Environment name                 | Name of the connector instance which enriches the virtual device.                                                            |
| Desktop broker                   | Name of the desktop virtualization broker product being used. In this case, `citrix_daas`.                                   |
| Disk image                       | Name of the disk image used to deploy the VM.                                                                                |

## Configuring the Nexthink web interface <a href="#connectorforcitrixdaas-configuringthenexthinkwebinterface" id="connectorforcitrixdaas-configuringthenexthinkwebinterface"></a>

1. Go to **Administration** > **Inbound connectors**.
2. Click the **New connector** button in the top-right corner of the page.
3. Select **Citrix DaaS** from the list of connectors on the Integrations page.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-5d3169800455659792eff2de8835b64140b71cc7%2Fcitrixdaas-1697472603.png?alt=media" alt="" width="760"><figcaption></figcaption></figure>

{% hint style="info" %}
Refer to the in-product documentation for more information. You can find it in the right-side menu of the Nexthink web interface.
{% endhint %}

## Test results panel

{% hint style="info" %}
The **Test results** panel is available only for supported connectors. Connector availability also depends on your license.
{% endhint %}

Use the **Test results** panel on the right side to run the connector with real data on demand, and inspect responses and errors. The test panel helps with faster debugging and validation during setup, and also with more reliable mappings with less trial and error.

Select the **Run test** button to call the API, and validate the credentials and check connectivity to the targeted endpoint.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2F8mjoZqxE1SW0f1Jvg6rr%2Fimage.png?alt=media&#x26;token=ac09b6ce-6927-4cee-b301-2ef7c6ddf667" alt=""><figcaption></figcaption></figure>

Besides basic information, such as the response status code and time, the panel also shows a sample record of the response at the bottom.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FI4IxueEsH60Pl3NQpjF0%2FHwklwWjD3Ud5ZXPC.png?alt=media&#x26;token=85b6123d-b40e-4085-871e-bc17232c8a15" alt="" width="316"><figcaption></figcaption></figure>

In the event of an error, the system displays the API response to aid in diagnosing the issue.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FKwqz92TxPeBl3QWqbKNt%2F9kAwIQi3M5gG7Y0H.png?alt=media&#x26;token=eeb306f0-d2b8-441b-a105-1bcd708a2d7c" alt="" width="309"><figcaption></figcaption></figure>

### FAQ <a href="#connectorforcitrixdaas-f.a.q" id="connectorforcitrixdaas-f.a.q"></a>

<details>

<summary>What is the connector for Citrix DaaS used for?</summary>

Citrix DaaS enriches Nexthink device data to enhance device visualization by importing information such as host pool or the type of desktop virtualization.

</details>

<details>

<summary>How can I troubleshoot issues with the connector for Citrix DaaS?</summary>

Currently, the only way to troubleshoot issues with the connector for Citrix DaaS is to reach out to [Nexthink support](https://support.nexthink.com/).

</details>