1. Home
  2. Docs
  3. Kiwire ( v3 ) – Administrator
  4. Integration
  5. Active Directory

Active Directory

Active Directory module lets you to authenticate user authentication via their credential with your existing Microsoft Windows server active directory. In this module, objects are organised in a number of levels such as domains, trees and forests. At the top of the structure is the forest. A forest is a collection of multiple trees that share a common global catalog, directory schema, logical structure, and directory configuration. In a multi-domain forest, each domain contains only those items that belong in that domain. Global Catalog servers provide a global list of all objects in a forest. Kiwire allow you to map active directory user associated groups with a local Kiwire profiles.




How it Works?

  1. Send credential to Kiwire, which itself will connect to Microsoft Active Directory services and perform authentication on behalf.
  2. If request is to primary forest tree domain, active directory will check with its domain for correct node to perform authentication.
  3. Active directory will revert the authentication status.
  4. A locally assigned profile will attached to the user’s authentication. Kiwire will send the local assign profiles to NAS and let user connect to network.
  5. The profile and authorization will be send to the NAS and user will be able to connect.


For Kiwire to authenticate with your Microsoft Active Directory, you are required to provide a read only domain administrator privileges account in order to authenticate user active directory credential.

Manage Active Directory Connection
To access the active directory module, click on Integration > Active Directory from the navigation. This includes main and mapping for Kiwire platform.


Note: Please save the setting before click on test button.

The field and its function description is listed below.

Field Function
Enable Enable or disable this function.
Domain Controller Hostname or IP Address of active directory server.
* NOTE : Please ensure Kiwire is using the active directory DNS setting to ensure compatibility.
Account Suffix Account suffix for your domain.
* e.g : @mydomain.local
Domain Admin Username The account that have administrator access level to the active directory.
Domain Admin Password The password of the administrator access account.
Base DN The user and group base DN.*Optional* Your base dn can be located in the extended attributes in Active Directory Users and Computers MMC.
* e.g : DC=mydomain, DC=local
Link with Profile Default profile assign to active directory users login. However you can map active directory users groups with local profile using the group mapping function, user group that are not mapped will be default to the default profile.
Zone Restriction Default zone restriction assign to user that login thru active directory when they login. Leave it to “None” if you do not wish to assign restriction to users.

NOTE: You can use diagnostic active directory to verify if your configuration are successful. If there is connection or credential issue the error will be displayed. To determine your Base DN, please refer to your active directory setup.

Active Directory Mapping

One of Kiwire new feature is capability to map active directory users groups with a local profile. This allow you assign relative local profile such as different groups with different profiles. The mapping screen will list all associated active directory groups [Group name] with the local profile [Link to profile]. If a user is a member of multiple groups, the priority will determine which profile the user will be assigned to. Please save the active directory configuration prior using the Mapping function.



The field and its function description is listed below.

Field Function
Group Name The name of the group mapping.
Link to Profile The local profile assign to the selected group.
Zone Restriction Default zone restriction assign to user that login.
Priority The priority of the group mapping order, used when users is member of multiple groups.
Status Status of the group mapping whether enable or disable.
Action

The access granted to the super user

  • To edit the setting of the group mapping.
  • To delete the group mapping.



Add New Active Directory

Click on “Add Active Directory” button and populate the required fields. Fill in the field with relevant information to complete the process.



The field and its function description is listed below.

Field Function
Enable Enable or disable the mapping.
Group Name Click on the select box, Kiwire will connect to the active directory server and load the available group from active directory services.
Link With Profile The local profile assign to the selected group.
Zone Restriction Default zone restriction assign to user that login. Leave it to “None” if you do not wish to assign restriction to users.
Priority The priority of the group mapping order , used when users is member of multiple groups.



EDIT OR DELETE ACTIVE DIRECTORY

Click the edit icon on the listing screen to edit the setting of the active directory. The edit screen be display which you can edit the setting of the active directory. Click on the delete icon to delete the active directory. A prompt will be display to ask for your confirmation to proceed to delete the active directory. Please exercise with cautions as this not a reversible action.