Getting Started with DeskDirector
Admin Console
Admin Console : Getting Started
Portal
Settings
Profile
Features
Enable/Disable Chat Callback Feature
Enabled/Disable Pre-Ticket Chat
Enable or Disable the 'Something Else' Option
Embedding Media as the Help Page
Tickets
Permissions
Portal Permissions in DeskDirector
FastTrack in DeskDirector
Setting Up and Using the VIP Priority
How to setup the Flag feature (ConnectWise)
Have Approvals go to Approvers according to site (ConnectWise)
Quotes (ConnectWise)
Invoices (ConnectWise)
Request Types
Forms
Getting started with DeskDirector Forms
DeskDirector Forms - Question Types in Detail
DeskDirector Forms - Dynamic Fields
DeskDirector Forms - Sections and Conditionals
DeskDirector Forms - Embed content
DeskDirector Forms - Title Automation
Importing Wufoo Forms to DD Forms
Companies
Contacts
Managing Contacts in DeskDirector
Exporting Contacts as CSV
Ticket Group Permissions
Contact Impersonation
Menus
Menu Items
Intro to Menu Items
Creating Menu Items
Extension Menu Security and Query Paramaters
Adding BiggerBrains Menu Item
Learning Center
Getting Started with the Learning Center
How to change the name of the Learning Center
Useful Learning Center Tips - Adding files from Google and Dropbox
Notebooks
Portal Access
Notifications
Desktop Installer
Feature Preview
Tech
System
Feature Configuration
Default Ticket Board and Source
Setting up your Approval Statuses
Adding a VIP Priority via the Admin Console
Automatic Contact Creation
Setting Reopened Ticket Status
Setting Status when Ticket is Closed
Change Ticket Status when Customer Adds Note
Hosts Configuration
PSA Integration (ConnectWise/Autotask)
Setting Office Hours
Enabling OAuth (Microsoft Login) for DeskDirector Portal
Logging in with Passwordless
Global Magic Token: Logging in via URL
Email Notifications Overview
Setting up Office 365 Mail Delivery
Setting up SMTP Server Mail Delivery
Getting Started with Email Template Engine - DeskDirector
Creating Custom Email Template
Setting Email Templates for Notification Events
Email Templates Auto Login Link
HTML Email Templates - ConnectWise
HTML Email Templates - Autotask
Integrations
BiggerBrains
ConnectBooster
ConnectWise Sell (previously Quosal)
How to configure ConnectWise Sell (previously Quosal) Order Porter integration
Adding ConnectWise Sell (previously Quosal) Order Porter link to opportunity
QuoteWerks
Wise-Pay
Microsoft Flow
How to setup the DeskDirector Flow Connector
How to share the DeskDirector Flow Connector
DeskDirector Flow Connector Reference
DeskDirector Flow Connector Ticket Event Payload Reference
Flow integration example - Microsoft Teams notifications
Flow integration example - DD Forms
Flow integration example - workflow with user interactions
Advanced
Deleting Orphaned Tickets
Developer Corner
Managing Webhooks
ConnectWise API Integration Tester
Autotask Data Sync
Diagnose Entities Tool
Analytics
Account
Tech Portal
Tech Portal : Getting Started
Tickets
Managing Tickets from the Tech Portal
Tech Portal Ticket Details
Creating a Ticket from the Tech Portal
Request more information (forms request) with Task Forms
Broadcasts
Chat
Getting Started with DeskDirector Chat
Handling Chat Requests
Viewing Chat History from the Tech Portal
Creating a Chat Session from the Tech Portal
Changing your Presence
"Pre-Ticket Chat" Feature
"Call me Back" Feature
Macros
Notifications
Client Portal
Client Portal : Getting Started
Contact Support
Creating a Ticket from the Client Portal
Submitting a Generic Ticket
Creating a Chat Session from the Client Portal
Viewing Chat History from the Client Portal
Tickets
Approvals
Quotes & Invoices
Learning Center
Notifications
Logging in to DeskDirector Workflow
Features
Tickets & Chats
Notifications & Broadcasts
Custom Forms & Request Types
Custom Branding
Custom Menus
Custom Email Templates
Approvals in DeskDirector
Easy Integrations
Advanced Authentication. No password, Single Sign On, MFA and beyond?
Analytics
Other DeskDirector Features
How Tos & FAQs
APIs and Integration
Creating an Integrator Login in ConnectWise (SOAP API)
Creating a ConnectWise RESTful API Key
ConnectWise 2019.5+
Creating an integrator API resource in Autotask
Autotask 2020.3 integration (API) resource migration
Authentication
How User Authentication works in DeskDirector
Setting/Resetting a Contact's Password
Logging in with Active Directory
Diagnosing Automatic Login Issues
Desktop Portal
Installing the DeskDirector Desktop Portal
Diagnosing DeskDirector Desktop Portal Issues
Diagnosing login problems using the new DDGetSID CLI tool
Antivirus Blocking DeskDirector Portal Installation
Troubleshooting your DeskDirector Portal installation
DD Portal for Mac: Labtech Deployment Guide
DDPortal removal tool - uninstalling Windows portals
Instance & Account Queries
Setting up your custom domain
3000 Contact Limit FAQs
Finding out what server your DeskDirector instance is on.
Administration Guide
How search works in DeskDirector products
Adding and removing features from your DD Portal Advantage plan
Portal and User Issues
User can't log in
DeskDirector Portal Browser Support
Contact can't login portal, the contact is missing in admin console but it is in ConnectWise
DeskDirector Tech Portal - How to take advantage of browser tabs
Add DeskDirector Tech Portal as a Custom Menu item inside ConnectWise Manage
Sign in with Microsoft Issue in Tech or Admin Console - "Need Admin Approval"
How do we set a landing page for the client portal?
Tickets
User can't see "All Tickets" option
Tickets are missing in DeskDirector but they are on my PSA
My customer is seeing deleted tickets in portal
Ticket Description missing on ConnectWise emails
Other Articles
Top 10 Request Types
Generic vs Customized Request Types
Using Markdown
Desktop Portal (Installed client) Vs. Web Portal (Web Client)
Outdated Articles
Advanced Use
DeskDirector API
Subscribing to Chat Webhooks
Portal Deep Linking
Webhook Example with Zapier
Chat Session Payload
Legacy URL Linking in DeskDirector
Get started with portal extension page demo
Dynamic content based on logged in user
Clean Tickets
Release Notes
Client Portal
Server
Tech Portal
Portal Release Notes - Windows/macOS
Differences Between Desktop Portal v2 and v3/v4
Portal Release Notes - Web Client
Glossary
- All Categories
- How Tos & FAQs
- Authentication
- How User Authentication works in DeskDirector
How User Authentication works in DeskDirector
Updated
by Edcel Ceniza
DeskDirector uses two different methods to authenticate a user when it starts up the very first time.
Inside an AD Domain (for DeskDirector Desktop Portal)
The first method is used when a user's PC is part of a domain and DeskDirector can query the Active Directory.
- User launches DeskDirector from the PC. DeskDirector automatically checks if the PC is a part of a Domain and contacts the nearest domain controller.
- DeskDirector retrieves relevant user information from Active Directory including default Email Address. It also determines the domain SID as part of this process.
- DeskDirector now contacts the DeskDirector server over HTTPS passing the user’s email address and the domain SID. DeskDirector server checks the domain SID against its internal database to confirm it is an authentic client. It also retrieves the ConnectWise CompanyID or Autotask Account from its internal database based on the domain SID.
- DeskDirector server uses the company detail along with the user’s email address to check if that user exists in ConnectWise or Autotask. If there is no contact found , it creates the contact in ConnectWise or Autotask. However, if there is a match it will use that information to determine the security rights for that user for various DeskDirector modules.
- Based on user permissions, different modules will be displayed on DeskDirector client. These permissions determine which tickets users are able to view in DeskDirector.
- Once the client is authenticated by DeskDirector server, an encrypted cookie is stored on the PC for future access server.
Outside an AD Domain (for both DeskDirector Desktop and Web Portal)
The second method is used when a user's PC is not part of domain, cannot contact the AD on first launch or they have no email address in AD.
- User launches DeskDirector from the PC.
- If Passwordless is enabled see here for details.
- If this is the first time user is launching DeskDirector, they will be asked for their ConnectWise portal username or Autotask email address, and the password set through the DeskDirector Admin Console. If the user does not know the password, he/she will be given an option to have it sent to their email address.
- DeskDirector contacts the DeskDirector server over the internet passing the portal username/password.
- DeskDirector server uses the portal username/password provided to determine the security rights for that user for various DeskDirector modules.
- Based on user permissions, different modules will be displayed on DeskDirector client. These permissions determine which tickets users are able to view in DeskDirector.
- Once the client is authenticated by DeskDirector server, an encrypted cookie is stored on the PC for future access. Therefore subsequent authentications from the DeskDirector client do not require a username/password and rely on the encrypted token.