# Logging On

{% embed url="<https://www.youtube.com/watch?v=j2Qpjiy3snU>" %}

After launching Keyfax Administrator Tools, you will be presented with a brief splash screen which will display the Keyfax Administrator Tools version number. For example...

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FMB24yZhdevsviqBiVPsE%2FLogin%20splash%20screen.png?alt=media&#x26;token=dfeebede-ec3b-474a-b3ee-98fc3d1dd07f" alt=""><figcaption><p>Keyfax Administrator Tools Splash Screen</p></figcaption></figure>

You will then be presented with the login dialog.

### Login Form

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2Fxyu1l3xwArmRU1lNW5QK%2FLogin%20screen%204.4.7.png?alt=media&#x26;token=2169a781-0205-4897-9145-e1617ced34af" alt=""><figcaption><p>Keyfax Administration Tools login screen</p></figcaption></figure>

The login form contains the following fields...

* **Username / Password**\
  As initially supplied or subsequently configured by your Administrator.
* **Server**\
  This is preset at installation. You may find you have access to single or multiple servers, e.g. Live, Test, Training & Dev or other variations.
* **System**\
  This is preset at installation time. You may have one of more configured 'systems' on the same server, e.g. Live & Test.
* **Script Type**\
  These are the supported Script Type(s) available for the chosen System (above).&#x20;
* **Master Web Service (MWS)**\
  The Master Web Service is a URL that enables Administrator Tools to communicate with the Keyfax Web Server. This will also appear if you hover over the logo area at the top of dialogue. This URL will be a preset value but it is possible to change this to point at an alternative server, so long as that server is running a version of Keyfax that is compatible with the version of Administrator Tools you are running.&#x20;

Clicking the Master Web Service text itself will display this dialogue (if any error had occurred when connecting to the server, this too would be displayed):

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FJS2zwNTvnSd5AFczu5Sa%2FMaster%20Web%20Service%20URL%204.4.7.png?alt=media&#x26;token=4100d23d-c9e5-4b50-9882-679616b91293" alt=""><figcaption><p>Viewing or editing the Master Web Service URL</p></figcaption></figure>

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2F6XziWitpeyrSzzJ5rN7w%2FMaster%20Web%20Service%20URL%20error%204.4.7.png?alt=media&#x26;token=bf39c18f-7c79-4358-8a24-fd823a19fc4b" alt=""><figcaption><p>Master Web Service URL Error - no endpoint listening</p></figcaption></figure>

### **Forgot password**

Assuming your user details are set up with a valid email address, and you have entered your username (above), you will be sent a new temporary password. You will be prompted to change this when you first login.

### **Password Requirements**

In the [User Maintenance](https://docs.keyfax.biz/product-suite/admin/user_maintenance) tab a Login Mode (‘Windows’ or ‘Keyfax’) is defined for each user. As in earlier releases, ‘Keyfax’ administrator logins require a valid password. Windows Login requires **all** administrators to be using Active Directory (AD).&#x20;

{% hint style="info" %}
**NOTE** It is not possible for some administrators to use Windows login if any other administrator needs to login with a non Active Directory account.
{% endhint %}

The login screen will pre-populate the most recent User (defaulting to any previous User). No password is required for a valid Keyfax ‘Windows’ login matching the current Windows User. Windows login is only available if configured on request or by your implementor.&#x20;

### Change Password

Login has a **Change Password** option which is forced in these situations:

* When a password is reset either from Login ‘Forgot Password’ or in Admin Tools
* If the password is not changed within the configured period
* For any Admins with passwords that don’t meet the minimum requirements for password strength on the first login after the upgrade.


---

# 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.keyfax.biz/product-suite/admin/logging-on.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.
