When logging into the Web Portal you will not use your email address, you will use your Active Directory credentials

We cannot reset your password, so that link on this login page will not work with this type of login

There are two places Active Directory integration is configured, one to add/update users to the web portal and one to log them in.

Active Directory Synch - Syncs Users Between AD & Clarity

One is in the Active Directory Synch tool located on the desktop of the Clarity host server.

There are several tabs that you need to configure, please refer to the help link below.  The AD server should match what you configure in the Clarity Web Portal.

https://s3.amazonaws.com/IMAGINiTSoftware/Documentation/Clarity/2026/System_Setup/Active_Directory_Integration.htm?rhsearch=Active%20Directory&rhhlterm=active%20directory

This tool is used to add/update and depending on setting, potentially remove users from Clarity when it synchronizes.

This runs in Services and only Synchronizes users between Active Directory and Clarity

This service has nothing to do with logging users into the Web Portal.

LOGIN ISSUE NOTE:

If a user is having issues logging in and was previously able to log in, the quick solution is to remove the user from the Clarity Users tab and run the Sync to add them again.   

If the issue is more global, it is likely a different issue and we will need the Clarity Host logs from the Server tab, Logs page to figure out the cause.

To force an Active Directory sync

Browse to the C:\Program Files\IMAGINiT Technologies\Clarity Active Directory Sync
then run the ClarityADSynchService.exe application.
It should bring up a UI – you will have to hit: Analyze and then Update to force the sync.

Diagnostics

C:\ProgramData\IMAGINiT Technologies\Clarity Active Directory Synch\Logs

Active Directory Authentication - Clarity Asks the AD Server to Verify Clarity User

The setting for logging users in is controlled in the Clarity Web Portal

https://s3.amazonaws.com/IMAGINiTSoftware/Documentation/Clarity/2026/index.htm#t=System_Setup%2FAuthentication_Options.htm&rhsearch=Active%20Directory&rhhlterm=active%20directory

Server tab, Authentication

Here you will enter the AD Server Name and AD Domain Query location (See Notes below)

Notes:

• If you use the Active Directory Global Catalog, you can specify only GC: for the server (and leave the Domain Query blank). This will query the Global Catalog instead. For more information on this, see the Active Directory deployment guide.

• For a simpler failover, it is also possible to list multiple Active Directory Servers, separated by commas. The system will try each server in the provided sequence.

• When working with the Connect module, the Server/Authentication page also enables you to set several options for identifying users and determining access rights. For more information on this, see the Authentication Options, under the Clarity Security Overview.

Clarity AD Login Requirements

Basic Requirement:

• The user must exist in Clarity
• Their account must have the Active Directory checkbox selected

What We Are Checking For

Clarity AD Synch looks for 4 attributes to exist to be able to create a user:
- First Name
- Last Name
- Sam Account Name
- Email

In AD we must have the following fields, shown in green below, on the General tab and the login name (Pre-Windows 2000) on the Account tab.

When a user attempts to login:

• We ask the AD Server (This information is seen in the Clarity web portal, Server tab, Authentication):
  • Is this a valid username/password combination? 
  • If so, what is the user's email? (and then we match it in the Clarity user database).
• If we can’t find a match for any one of those things there will be an error

The error will show up in the AdminConsole log and looks similar to this:

INFO  2023-10-26 14:23:33,942 UserService            - Unable to find the Active Directory user: LOGINNAME
INFO  2023-10-26 14:23:33,942 etoryAuthenticatedUser - Unable to login user: LOGINNAME
INFO  2023-10-26 14:23:33,942 HomeController         - Unsuccessful login attempt for LOGINNAME: Unable to find the selected user account.
INFO  2023-10-26 14:29:36,280 UserService            - GetDirectorySearchResult(ADSERVERNAME, DC=DOMAIN,DC=LOCAL, Secure): Error retreiving Search result
System.DirectoryServices.DirectoryServicesCOMException (0x8007052E): The user name or password is incorrect.
…
   at AdministratorConsole.Core.Services.UserService.GetDirectorySearchResult(String ldapServer, String userId, String password, String ldapDomain, String ldapAuthType)

The user name or password is incorrect.

This is a generic error and does not necessarily mean exactly that, sometimes the real issue is that the User doesn’t have an email address in AD, this can happen if the user was added manually rather than with the sync tool.

Thanks!

Attempts to clear out cache and reset DC do not correct issue. on different task servers the issue replicates, running latest Clarity Client (26.0.12.0)

For example, after 3 errors in a row it will start sending an email to the coordinator so they can look into it. Then the second setting would kick after 6 days to disable the task if it was not fixed. 

It would also be nice if Clarity could auto send a report to someone, maybe the technical contacts, when it deactivates a task in case there is no coordinator set in the project users settings. 

When working with hubs across multiple regions, proper naming conventions are essential for smooth operation. We strongly recommend that customers use unique naming conventions for their hubs that clearly indicate the region where each hub is hosted. For example, you might name your hubs "CompanyName-US", "CompanyName-EMEA", or "CompanyName-Canada".

While Clarity may function with identically named hubs across different regions, this configuration has not been thoroughly tested and could lead to unexpected behavior. Using distinct names helps prevent confusion in Clarity and other integrated services, and ensures reliable performance across your organization's projects.

Wondering if Clarity team working with Autodesk found any issues with Clarity access to BIM 360 or ACC with Autodesk rebranding ACC to Forma?

Thanks,

Bruce

I'm trying to relaunch things this morning and nothing is moving forward. 

Canadian Server, Leap Lantic 691913 project

I am facing an issue with the Clarity ACC Docs to PDF task when attempting to export multiple Revit files at the same time.

Observed Behavior:

• When running the ACC Docs to PDF task for multiple Revit models, the task fails.
• The error indicates that Files are in use.
• I retried the export several times, but the same issue occurs consistently.

Using *.rvt in the end of any target folder path still includes it's subfolders.

What's Included in This Release?

Global Scheduling Controls
Administrators gain new oversight capabilities with global task scheduling enforcement. Set firm-wide limits on task frequency and timing to better balance workload distribution and maintain optimal system performance across your organization.

Direct ACC Publish Task
A new task type enables direct publishing to Autodesk Construction Cloud without launching Revit. Schedule model updates to ACC as frequently as your workflow demands while reducing computational overhead and processing time.

ACC Docs to PDF Automation
Automatically convert published ACC models into PDF documentation on your preferred schedule. Configure custom naming patterns, combine into one file, and output settings to ensure deliverables match your documentation standards without manual intervention.

Getting Started

SP2 is available immediately through Clarity's built-in update system. Launch Clarity 2026 and check for updates to access these capabilities.

You need to be logged in as a Global Admin to make these changes.

Settings

• Server tab, Settings, General tab, BIM360
• If you set this to True, you will want to fill in the name of the hub we will be looking for to create projects from, typically your default hub name.
• You can specify a Project Template to base the new projects off of.
  • The project template is used in a similar fashion as when you create a project in clarity and you copy from "tasks, settings, project parameters, etc. in the user interface.
  • It does not do anything related to the version of the project.
• 

Requirements

• We will use the default Oauth credentials, so that identity must meet the requirements for adding a project to Clarity for that project.
  • https://imaginit.helprace.com/i618-clarity-requirement-for-adding-360-acc-projects
• The Oauth must be valid
  • https://imaginit.helprace.com/i484-clarity-how-to-reset-the-360-oauth-credentials
• Because Clarity needs to know what version of Revit will be used with a particular BIM360/ACC Project, the default behavior is that it WILL NOT create the Clarity project until there is a Revit model in the project to indicate to Clarity what the Revit version should be.
  • That model should be published.
• Alternatively, there is a low-level monitoring service setting which can force Clarity to immediately create based on a specific version number - which can be changed later if necessary.
  • Keep in mind that this is the version that we will assume tasks should run as!
  • You will need to modify the version used in the project if it is not correct so Revit tasks will process on live models!
    • https://imaginit.helprace.com/i603-how-to-edit-a-360-project-in-clarity

Forcing Auto Create for a Set Version of Revit

If you want to force the creation, even if the version is incorrect, you will need to modify a config file on the host.

• Log onto the host as the service account identity.
• You can see the identity that is running the Monitoring Service from the Server tab, Security, General
  • 
• Browse to the following folder on the host.
  • C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service
• Make a copy of the following config file and rename the extension to .ORIG so we have a copy of the original file in case we need it.
  • 
  • MonitoringService.exe.config
• Modify the config file with Notepad or Notepad++ as shown in my screenshot and set the default version you want to use between the “”
  • 
• You may get a permission error when trying to save the file, if so, do a SaveAs to the desktop then drag it back into the original folder and overwrite the file.
  • Make sure it is set to Save As all types and not to append as txt
  • 
• Restart the Monitoring Service