> For the complete documentation index, see [llms.txt](https://docs.biscit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biscit.com/ekr-user-guide/getting-started/login-and-authentication.md).

# Login and Authentication

## Using Basic Kinetic Login

EKR supports basic Kinetic Authentication via a standalone login. Alternatively, if you require AD or IdP login, please refer to [Leverage All Kinetic Authentication Options Via EKR Kinetic Embed](https://app.gitbook.com/o/Ahnq5FWIxn9X9tsNkSHm/s/FuMjREj8WHcxhf8dRWZN/~/edit/~/changes/14/getting-started/leverage-all-kinetic-authentication-options-via-rms-kinetic-embed), which supports all standard Kinetic login options.

### User Access <a href="#login" id="login"></a>

For users to access the system they require access to V1 APIs. This is configured in Kinetic User Account Security Maintenance under the user's System Access, using the field `Allow API V1`.

<figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2Ful6dGRLoXvJ7PQwGILez%2Fimage.png?alt=media&amp;token=4882c27e-c2fd-485c-8034-1d0f708ed9aa" alt=""><figcaption></figcaption></figure>

### Login <a href="#login" id="login"></a>

1. Type in the EKR web address into your internet browser’s **search box** and hit **ENTER**.\ <br>

   <figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2Fcf0GdK1ySIY45hPkKONo%2Fimage.png?alt=media&amp;token=b9c9a625-33de-4294-be1d-af88648cc447" alt=""><figcaption></figcaption></figure>

   | **Header**   | **Details**    |
   | ------------ | -------------- |
   | **Username** | Input Username |
   | **Password** | Input Password |

   <br>
2. In the landing page, enter in login credentials and click on **Login**.

## Leverage All Kinetic Authentication Options Via EKR Kinetic Embed

### Integrated Auth Via Kinetic Home Page

Follow the steps below to embed the BISCIT EKR link into your Kinetic Home Page:

1. Navigate to the **Kinetic** Home Page

   1. Access your Kinetic Home Page using your standard login method.

2. Enter Edit Mode
   1. Click the **Overflow Menu** (three dots) and select **Edit**.

<figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2FZfcRYJuXdSBfPJTmn2ya%2Fimage.png?alt=media&amp;token=df94d28f-5ac9-4234-b55f-a4685c77456e" alt=""><figcaption></figcaption></figure>

3. Add a Website Widget
   1. In the **Add Widget** menu, select **Website**.

<figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2FYQudmZwIzqNrLSGhNYBY%2Fimage.png?alt=media&amp;token=4ff32806-ec8a-4f38-9130-26632777e8b6" alt=""><figcaption></figcaption></figure>

4. Configure the Embedded Website.

   1. In the **Add an Embedded Website or Link** modal, enter the following details:

   <figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2FM47DJJnL6OIlD4hcHJKA%2Fimage.png?alt=media&amp;token=f944f183-d528-461d-9f29-ba0076df02a8" alt=""><figcaption></figcaption></figure>

* **Display:** Link to Website
* **URL:** The EKR URL supplied to you from BISCIT example: `https://rms-[customer-identifier]-[environment].biscit.io/login/`\
  \
  &#x20;**NOTE:** it must end in `login/` as per the example
* **Title:** EPICOR EKR
* **Send ERP Token:** ![check mark button](https://biscit.atlassian.net/gateway/api/emoji/202b53ca-461d-4f94-b1c7-72c7a342befb/2705/path?scale=MDPI) Enabled
* **Send ERP Context:** ![check mark button](https://biscit.atlassian.net/gateway/api/emoji/202b53ca-461d-4f94-b1c7-72c7a342befb/2705/path?scale=MDPI) Enabled
* **Image:** *(Optional - upload an image if desired)*

5. Save the Widget.
6. Once all the details are entered, click **Ok**.
7. Finalise Changes.
   1. Review the widget placement on the Home Page.&#x20;
   2. Once satisfied, click **Save** to apply your changes.

<figure><img src="https://3143154457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFuMjREj8WHcxhf8dRWZN%2Fuploads%2F5jaSS2GNo2r59dgC3wPJ%2Fimage.png?alt=media&amp;token=289c898f-8512-4b9e-a97e-4e1472002e93" alt=""><figcaption></figcaption></figure>

&#x20;<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.biscit.com/ekr-user-guide/getting-started/login-and-authentication.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
