Skip to main content

Getting started - Login

This section describes how to get started with the Enterprise Manager .NET SDK. To help you better understand how to implement the available methods, a code sample and a readme file that describes the code are located in the <Enterprise Manager_Installation_Folder>/clients/dotnet folder.

  1. Create a project that references the AemRestClient.dll and Newtonsoft.Json.dll files
  2. Create the AemRestClient object using one of the following constructors:

    1. public AemRestClient(ICredentials credentials, string url = "https://localhost/attunityenterprisemanager", bool verifyCertificate = true);
      • credentials – See below.
      • url – The URL to the Qlik Enterprise Manager server. The URL must begin with "https".
      • verifyCertificate – See below.
    2. public AemRestClient(ICredentials credentials, string host, int port, string urlSuffix = "attunityenterprisemanager", bool verifyCertificate = true);
      • credentials – See below.
      • host – The machine on which Enterprise Manager is installed.
      • port – The Enterprise Manager server port (usually 443).
      • urlSuffix – The part of the Enterprise Manager URL that follows the host and port (usually attunityenterprisemanager).
      • verifyCertificate – See below.
Information note

When verifyCertificate is set to true there must be a valid certificate on the Enterprise Manager machine. When set to false, the Enterprise Manager client will not validate the server certificate.

Example 1: Connecting to Enterprise Manager using Active Directory

Information noteThis login method requires you to be in possession of a Personal Access Token generated in Enterprise Manager. You need to log in to Enterprise Manager using SAML and then generate a token as described in Setting up API authentication.

var credentials = new NetworkCredential

{

UserName = "USERNAME",

Password = "PASSWORD",

Domain = "DOMAIN"

};

_client = new AemRestClient(credentials, "localhost", 443, false);

Example 2: Connecting to Enterprise Manager using OpenID Connect

Information noteThis login method requires you to be in possession of a Personal Access Token generated in Enterprise Manager. For details, see Setting up OpenID Connect authentication

var credentials = new NetworkCredential

{

UserName = "api-token",

Password = "EUni+sUn3dNxnDysRNYJctyhWxu8uzbYMXVqJLxqwtxnTsWu4D..."

};

_client = new AemRestClient(credentials, "localhost", 443, false);

Example 3: Connecting to Enterprise Manager using a JWT

Information noteThis login method requires you to be in possession of a JWT. For details, see Logging in to Enterprise Manager with a JWT token via the API.

var credentials = new NetworkCredential

{

UserName = "jwt",

Password = "your-jwt-token"

};

_client = new AemRestClient(credentials, "localhost", 443, false);

Example 4: Using client methods to Get/Set data on Qlik Enterprise Manager

After creating credentials and a client object, you can call the client methods to get/set data from Enterprise Manager using the public APIs.

Syntax:

_client.GetServerList()

_client.GetServerDetails(serverName)

_client.ExportTask(serverName, taskName);

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!