Skip to main content

Cloud ConnectorsExabeam Cloud Connectors Configuration Guide

Citrix ShareFile Cloud Connector

Citrix ShareFile is a secure content collaboration, storage, and file sharing solution that offers managed file transfer service, cloud storage, document management, and data privacy controls. Citrix ShareFile provides cloud file sync, secure email functionality with encryption, and secure file sharing. For more information visit their website.

Prerequisites to Configure the Citrix ShareFile Connector

Before you configure the Citrix ShareFile connector you must complete the following prerequisites:

  • Ensure that the https://*.sharefile.com service is open for communication with the Exabeam Cloud Connector platform

  • Obtain an API key Exabeam for Citrix ShareFile Cloud Connector supports three authentication methods: oauth2, oauth2 password grant, and token. This topic describes how to use the oauth2 and oauth2 password grant authentication methods. For more information about the token method, contact Exabeam Support. Refer to the following table to choose the authentication method.

    Authentication Mode

    Citrix ShareFile Administrator Requirement

    Citrix ShareFile Administrator Credentials Requirement

    Exabeam Cloud Connectors Open API

    Oauth2

    Yes

    No

    No

    Oauth2-password-grant

    No

    Yes, used only once for API token creation

    Yes

    Token

    No

    No

    Yes

    Table 6. Authentication Methods


Obtain an API Key

Citrix ShareFile APIs are authenticated via application keys. You must obtain the API key that you can use as a client ID and client secret while configuring the Citrix ShareFile connector.  The procedure for obtaining the API key is the same for the oauth2 and oauth2 password grant methods.

To obtain an application key:

  1. Log in to the Citrix ShareFile developer console by accessing https://api.sharefile.com as an administrator.

  2. In the right pane, click Get an API Key.

  3. In the API Key Generator section, enter the required information.

    1. Application Name – Specify a name for your application.

    2. Description – Enter description for the API key. For example, API key for the Exabeam Cloud Connector.

    3. Redirect URI – Enter https://auth.skyformation.net/v1/oauth.

  4. Click Generate API Key.

    A table displays the values for Client ID and Client Secret. Use these values, represented by a string of letters and numbers, to configure the Citrix ShareFile cloud connector. Follow the same procedure if you want to use the oauth2 password grant method. For the oauth2 password grant method, you must enter the Citrix ShareFile administrator’s user name and password while configuring the connector. The cloud connector does not save the username and password. If two-factor authentication is enabled by Citrix, you must generate an application-specific password. For more information, see the Citrix Documentation.

Configure the Citrix ShareFile connector

Citrix ShareFile is a secure content collaboration, storage, and file sharing solution that offers managed file transfer service, cloud storage, document management, and data privacy controls. Citrix ShareFile provides cloud file sync, secure email functionality with encryption, and secure file sharing. For more information visit their website.

The following table displays audit source API and security events supported by the connector.

Audit Source: API

Service or Module Covered

Event Included

SharedSend

Any

Sharing

SharedRequest

Any

Sharing requests

Activity

Any

Administrative events

AccessChange

Any

Access events

Table 7. Audit source API and security events supported by the connector


To configure the Citrix ShareFile connector to import data into the Exabeam Cloud Connector platform:

  1. Complete the Prerequisites to Configure the Citrix ShareFile Connector.

  2. Log in to the Exabeam Cloud Connectors platform with your registered credentials.

  3. Navigate to Settings > Accounts > Add Account.

  4. Click Select Service to Add, then select Citrix ShareFile from the list.

  5. In the Accounts section, enter the required information.

    1. Tenant – Select a tenant to attach to the connector if you are using a multi-tenant edition of Exabeam. Otherwise, select default.

    2. Account Name – Specify a name for the Citrix ShareFile connector. For example, CitixShareFile_collaboration.

    3. Description – Describe the Citrix ShareFile connector (optional). For example, Citrix ShareFile cloud storage and file sharing solution for secure content collaboration.

    4. Authentication Method – Select oauth2 or oauth2-password-grant.

      1. If you select oauth2 authentication method, enter the required information for the following fields.

        1. Client-ID – Enter the client ID part of API key that you obtained while completing prerequisites.

        2. Client-Secret – Enter the client secret part of API key that you obtained while completing prerequisites.

        3. External Authentication – Click Open External Oauth Window to authorize the Exabeam Cloud Connector to communicate with Citrix account. In a window that requests for granting access to allow Exabeam Cloud Connector to interact with Citrix ShareFile account for retrieving audit events, click Login.

          Note

          For oauth2 authentication method, the Citrix administrator must be present to enter the credentials and authorize Exabeam cloud connector’s interaction with Citrix ShareFile.

      2. If you select oauth2-password-grant authentication method, enter the required information for the following fields.

        1. Sub-Domain – Enter the initial part of Citrix ShareFile account DNS name. For example, if the Citrix ShareFile account URL is https://mycompany.sharefile.com, the sub-domain is ‘mycompany’.

        2. Client-ID – Enter the client ID part of API key that you obtained while completing prerequisites.

        3. Client-Secret – Enter the client secret part of API key that you obtained while completing prerequisites.

        4. Username – Enter user name of the Citrix ShareFile administrator.

        5. Password – Enter password for the Citrix ShareFile administrator. If two-factor authentication is enabled by Citrix, enter the application specific password that you generated while completing prerequisites.

    Note

    Required fields are indicated with a red bar.

  6. To confirm that the Exabeam Cloud Connector platform communicates with the service, click Test Connection.

  7. Click Done to save your changes. The cloud connector is now set up on the Exabeam Cloud Connector platform.

  8. To ensure that the connector is ready to send and collect data, Start the connector and check that the status shows OK.