AADFS installation

Learn how to install AADFS (AskCody Active Directory Forwarding Service) to manage user and hosts synchronization via Active Directory

AskCody Active Directory Forwarding Service (AADFS) is a small Windows service that forwards object data from Active Directory to AskCody, enabling an automatic user synchronization between users in your organization's Active Directory and AskCody.

The service must run on a Windows server on your network, but not on the Active Directory server itself.

Minimum Requirements

The service depends on the following:

  • Windows Server 2008 R2 SP1 or later
  • .NET Framework 4.6.2 

Minimum Server Requirements

  • Processor: Minimum 2GHz dual-core
  • RAM: 2GB
  • Memory: 1.75GB


Since the AADFS service will forward data to an AskCody endpoint, outbound communication on port 443 (HTTPS) and internet connection is required.

Depending on the region where the AskCody customer is signed-up the following endpoints are used:

US region: https://sync.goaskcody.com/active_directory/ 

EU region: https://sync.onaskcody.com/active_directory/ 

Installing the service

  • Download the installer here
  • Run the .exe installer to install the service's program files 
  • Go to the following route in the server where you installed the service: C:\Users\USERNAME\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\AskCody ApS\AskCody Active Directory Forwarding Service
  • Press install and when the service prompts for a username and password, please insert the credentials of the user logged in the server and running the service.


The service stores configuration file, logs, and runtime data in %USERPROFILE%\AppData\Roaming\AskCody\ActiveDirectory\ForwardingService.

Please note that %USERPROFILE% is a placeholder that is replaced with the user that the service will run as, which is not necessarily the user that installed the service. In that case, the AADFS shortcut folder on the Desktop might point to the wrong folder.

Now the service is installed it needs to be configured. Please click here to learn how to do it.

Version 2.4 (current version)

  • Added the AADFS Diagnostics Tool, aadfs-diag.exe, which can be used to troubleshoot common problems. The tool is currently in PREVIEW, although it is included in the release. 
  • Added domain whitelist to sync configuration so synchronized users can be limited to those with email domains in the whitelist.
  • AADFS now does a fallback search for groups created with objectClass=group if a group with objectCategory=group cannot be found, a warning will be logged to the service log file when this happens.
  • The AADFS icon has been updated.