# Active Directory Settings

The Active Directory settings allows you to setup an Active Directory server that will be used globally by ngSurvey to let Active Directory users log into ngSurvey using their Active Directory credentials.

## 🔅 Active Directory properties

* **`Directory path`** that will be used to send out email messages. Active Directory LDAP path that will be used to connect to the Active Directory server. eg: `LDAP://ADServer`
* **`Domain`** Domain of your Active Directory users.
* **`Search filter`** Search filter that is used to search filter when adding new [Active Directory users](/installation-setup/installation/active-directory/active-directory-users.md) manually from the [users management](/multi-user-management/users.md) interface.
* **`Username`** Username that can access the Active Directory server with enough rights to query any user.
* **`Password`** Password of the user who has access to the Active Directory server.
* **`Single signon`** Tries to use existing credentials entered by the user in the browser. If no credentials can be found or can be used user can still enter the administration section by entering manually his credentials in a web based form. &#x20;
* **`Automatic access to new users`** If you are dealing with a lot of users you may want to avoid having to add manually each [Active Directory user](/installation-setup/installation/active-directory/active-directory-users.md) from the [user management](/multi-user-management/users.md) interface. If automatic access is enabled ngSurvey will automatically let any successfully authorized Active Directory users access the administration section. Note that you may use the auto link option of the [Roles](/multi-user-management/roles.md) to automatically add a role to each new Active Directory user.

{% hint style="danger" %}
Active Directory works only when ngSurvey is setup under a Windows Server based configuration&#x20;
{% endhint %}


---

# 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.ngsurvey.com/installation-setup/system-settings/active-directory-settings.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.
