# Login

Licensing the device

1. In the login screen, enter the **Licence Key** to license the device and press **LICENSE DEVICE**.\ <br>

   <figure><img src="/files/gDi0gd6CZ65vevsNOff5" alt="" width="301"><figcaption></figcaption></figure>

   1. Alternatively, press **DEMO MODE** if the application is to run against **EPICOR** demo system with configured **EPIC06** or **EPIC03** company or **EpicorE6** in cloud educational environment.

2. Press **DEVICE** to see how this device will be identified by the licensing system.

## Terms

1. Toggle the **I accept** butto&#x6E;**.**<br>

   <figure><img src="/files/w4wdXA8dEkJA1p6bcnKO" alt="" width="355"><figcaption></figcaption></figure>

2. Tap on **CONTINUE**.

## Server URL

1. Enter the **Server URL** in a format *https\://\[MyAppServerHost]/\[MyAppServerInstance]* and click **CONTINUE**.\
   ("*https\://"* may be omitted when typing server URL)

<figure><img src="/files/t2MYFaCLdKtq0FfvWlrq" alt="" width="348"><figcaption></figcaption></figure>

2. An error message will indicate if the **Server URL** provided is incorrect.<br>

<figure><img src="/files/nMzewyQhepXkuB1PKPCJ" alt=""><figcaption></figcaption></figure>

## Login

1. Enter your **User Name** and **Password** and click **LOG IN**.

![](/files/iQrkFiLOnAPK2E4ff171)

## Login using QR Code

{% hint style="info" %}
️ This option is applicable to devices with an internal scanner and also devices that have no internal scanners but have cameras i.e. mobile phones
{% endhint %}

1. Tap on the “*Scan a QR Code with connection information*” icon to use camera to scan the QR Code.

![](/files/y582w3xwWsHVrx4S0Flw)

![](/files/C4k7xjJVYGcKvIX3eNc8)

2. Tap on the toggle bar to **Allow modifying system settings** on the device.
3. Repeat the step and tap on the **Scan a QR Code with connection information** icon and select **Allow**.

![](/files/GLpD8SwK4Ca1i1sbZpci)

4. Tap on the **Scan a QR Code with connection information** icon and the camera will open up and allow to scan a QR code.

{% hint style="success" %}
QR Code must contain the information of the Username and the ServerURL
{% endhint %}

![](/files/ObLYJRD5jTS4E0fVK1gS)

### a. Creating a Barcode

1. Generate a QR Code using a **QR code generator site** such as the following:

   1. [https://barcode.tec-it.com/en/QRCode?data=This is a QR Code by TEC-IT](https://barcode.tec-it.com/en/QRCode?data=This%20is%20a%20QR%20Code%20by%20TEC-IT) or <https://www.qr-code-generator.com/>

2. Enter a code following the following format:

```
{"username":"myusername","serverUrl":"myserverurl"}
```

3. Replace “*myusername*” with the user’s epicor account username: *epicor*<br>
4. Replace “*myserverurl*” with the user’s server url: *\[MyAppServerHost]/\[MyAppServerInstance]*<br>
5. The final code format should look like the following:

```
{"username":"epicor","serverUrl":"[MyAppServerHost]/[MyAppServerInstance]"}
```

6. Save and use the following generated barcode to login using **QR scanner**.

## Login to system using self-signed certificate

{% hint style="warning" %}
️ Since Chrome version [121.0.6167.101](http://121.0.6167.xxx) there are new requirements for use of private self-signed SSL certificates
{% endhint %}

{% hint style="success" %}
To be able to connect and log in to a server configured with self-signed SSL certificate, the certificate needs to include “Digital Signature” in “Key Usage” field.
{% endhint %}

<figure><img src="/files/dEbYa8bHTCD2a60FGd2d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Self-signed certificates created in Windows Server 2022 or Windows 11 include “Digital Signature” in “Key Usage” field by default.\
On older versions of Windows Server hosting the Epicor application the certificates will have to be replaced with a correct certificate.
{% endhint %}

#### How To achieve self-signed certificates&#x20;

1. Exported self-signed from Windows Server 2022 or Windows 11.
2. Copy on to the server.
3. Import and use in https bindings configuration.
   * Alternatively, a new certificate including “Digital Signature” in “Key Usage” field could be generated using tools such as PowerShell, OpenSSL or similar.

## Azure AD Authentication

{% hint style="info" %}
Before using Azure AD authentication in EMW versions 3.3.3 and higher, the following Redirect URI [https://emwkineticapp/](https://emwkinecticapp/) needs to be added to Azure AD Registered Client Application to allow EKW to be authenticated with Azure AD.
{% endhint %}

1. &#x20;Redirect the address for EKW and ensure it is entered against the AD Application (client) ID

<div align="center"><img src="/files/8svyv59jMjzAdxAYvUXa" alt=""></div>

{% hint style="info" %}
That appears in EPICOR Azure Active Directory Configuration Maintenance and was set up in Azure for Epicor client access (i.e. <http://localhost>)
{% endhint %}

![](/files/QMOG7qWlI19jbaXwWeM6)

![](/files/6B553NRA9gdDU0AZkomt)

{% hint style="info" %}
When connecting to EPICOR server configured for Azure AD Authentication Microsoft logon pages are presented instead of regular login screen shown above.

* (Additionally SaaS customers need to enter their Epicor Tenant ID. This dialog does not display for on-premise customers )
  {% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/PzFKplJEgqERmdzYr3Jz" alt="" width="319"><figcaption></figcaption></figure>

<figure><img src="/files/LQ4KX2a8mm4Owaie7D7U" alt="" width="317"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/dZdrVjfLpGLwwX6eMYL4" alt="" width="312"><figcaption></figcaption></figure>

<figure><img src="/files/IL1AWryO6QGSSfd1bpnA" alt="" width="317"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Epicor Identity Provider (IdP) Authentication

{% hint style="info" %}
Before using IdP authentication in EMWW versions 3.34.0 and higher, the following Replay URI [https://emww-biscit.com](https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Femww-biscit.com%2F\&data=04%7C01%7Chabib.waqas%40epicor.com%7C8105624e71864e6e040708d91be6617d%7C4f4f4c56a772461a967e7890c3960b3a%7C1%7C0%7C637571498578770174%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000\&sdata=E6o7l%2BdCt%2BkomRwXvDh0TusOVdX5L0bRwUdZOBy82Xw%3D\&reserved=0) needs to be added in JavascriptApp Client configuration
{% endhint %}

1. Add the specific tenant's ERP JavaScript type client (WebApp) in IdP for successful connection.

<figure><img src="/files/q93o5RL927YHudULQFlt" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/JqfauRw0VkUTjhY9eBPu" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
When connecting to EPICOR server configured for IdP Authentication EPICOR IdP logon pages are presented instead of regular login screen shown above.
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/hjRwkh7W2Nqg52qmH7qe" alt="" width="395"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/GtWwmPVDX3e6pXwKpWVi" alt="" width="395"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Select employee

1. Select the Company/Site/Employee ID.
2. Click **LOGIN**.<br>

   <figure><img src="/files/YvMNLfBDiGNFxIKD6JhQ" alt="" width="351"><figcaption></figcaption></figure>

   <br>
3. &#x20;Click the question mark for further help.

<figure><img src="/files/dU5xHqBGdBWvimFFZ3Hm" alt=""><figcaption></figcaption></figure>

{% columns %}
{% column %}

{% endcolumn %}

{% column %}

{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.biscit.com/epicor-kinetic-warehouse/epicor-kinetic-warehouse-user-guide/login.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.