Auto login signs your people into the Kadence Agent when they start their computer, using the identity your company already trusts — Microsoft Entra or Okta on Windows and Mac, and Google Workspace on Chromebooks. There's no Kadence password and no Kadence sign-in form.
On Windows with Entra, it's silent from the very first launch. On a Mac, on a Chromebook, or with Okta, the first launch asks for one step — every launch after that is silent.
Auto login supports Windows and macOS with Microsoft Entra or Okta, and ChromeOS with Google Workspace.
If your company uses Google Workspace as its identity provider on Mac or Windows, auto login isn't available yet.
What Your People Will See
The first launch depends on platform and identity provider. Every launch after that is silent.
Platform + Identity Provider | First Launch |
Windows + Entra | Nothing — not even the first time. The Windows sign-in already holds the credential the agent uses. |
macOS + Entra | A Microsoft account picker — the person picks their account, no password.
The Mac must be registered with Entra through Company Portal (Step 4c). |
Windows + Okta | An embedded window shows the Okta sign-in once.
With Okta Verify or FastPass, there's nothing to type. |
macOS + Okta | The browser opens for one Okta sign-in. |
ChromeOS + Google Workspace | Google's sign-in sheet opens once — the person picks the work account they're signed in to the Chromebook with, and confirms. No password.
ChromeOS doesn't open Android apps at sign-in, so people open the agent from the shelf (Step 4d pins it there). |
If auto login can't run on a device — the configuration is missing, or the sign-in is declined — the agent quietly shows its normal sign-in screen instead.
One exception: if a person's identity is verified but their email doesn't match anyone in your Kadence workspace, the agent shows "Contact your admin." On a Chromebook, the agent shows its normal sign-in screen instead. See Troubleshooting below.
Before You Begin
This guide is for IT administrators. It covers the one-time setup: prepare your identity provider, configure Kadence, generate your device configuration, and roll it out with your device management (MDM) service.
You'll need:
An administrator for your identity provider (Entra, Okta or Google Workspace), for your MDM, and for Kadence (directory-sync access)
Managed devices — Auto login runs only on devices your company manages through an MDM service, or on Chromebooks managed through the Google Admin console — never on unmanaged or personal machines
Supported systems — macOS 26 or later, Windows 10/11, and ChromeOS. For Entra, Windows devices must be Microsoft Entra joined. Chromebooks must allow Android apps, and people must sign in to them with a managed Google Workspace account
Your Kadence workspace connected to your login provider — once this is complete, you'll be able to generate the required configuration files and deploy them
Kadence generates the device configuration for you as standard files — an Apple configuration profile for macOS and Windows policy settings — so any MDM can deploy them. For Chromebooks, Kadence gives you a short configuration to paste into the Google Admin console.
Step 1: Prepare Your Identity Provider
Pick the identity provider your company already uses for Kadence sign-in on Windows and Mac, and follow that section. If you also have Chromebooks, follow Option C as well.
Option A: Microsoft Entra
Kadence ships its own Entra application, so you don't create one or share a client secret. You grant it permission to run in your tenant and, on Macs, add the Microsoft sign-in extension.
Grant admin consent to the Kadence Desktop Agent application in your Entra tenant. Have an Entra admin visit this URL and click Grant.
Note your Entra tenant ID (Directory ID) — you'll paste it into Kadence in Step 2. Find it in the Entra admin center under Overview for your tenant.
Windows devices need no further identity setup, as long as they're Microsoft Entra joined. The Windows sign-in already holds the credential the agent uses.
macOS devices need the Microsoft Enterprise SSO plug-in and Company Portal. You'll deploy both through your MDM in Step 4, and each user signs into Company Portal once to register their Mac — this is standard Microsoft setup.
Kadence configures the identity token claims on its side. You don't need to set optional claims in Entra.
Option B: Okta
Create a dedicated Okta application for the agent. Keep it separate from the Okta application you already use for Kadence browser sign-in — the two must not be shared.
In the Okta Admin Console, go to Applications → Create App Integration.
Choose OIDC — OpenID Connect, then application type Native Application. Select this exactly — a Native app uses PKCE and holds no client secret, which is what the agent needs.
Under Grant type, tick Authorization Code and Refresh Token. The refresh token is what lets later launches stay silent.
Set the Sign-in redirect URI to exactly:
co.kadence.kadence-agent:/callbackUnder Assignments, assign the application to the people or groups who will use the agent.
Check the application's sign-on policy lets your assigned users authenticate. The one-time first-launch sign-in follows this policy.
When the application is created, note two values for Step 2:
Your Okta org URL (for example
https://your-company.okta.com) — use the plain org URL, not a custom authorization server addressThe application's Client ID
Option C: Google Workspace (Chromebooks)
Kadence ships its own Google sign-in client, so there's nothing to create in Google Cloud and no client ID to enter.
Note the Google Workspace domains your people sign in with — for example
your-company.com. You'll enter them in Step 2.
Only accounts from these domains can sign in. Personal Gmail accounts can't.
Each person's Google account email must match their email in Kadence.
Step 2: Configure Auto Login in Kadence
In Kadence, open Settings → Integrations → Auto login (directory-sync access required).
Choose your identity provider and enter its details:
For Chromebooks, also turn on Enable ChromeOS and enter your Google Workspace domains from Step 1, one per line. ChromeOS works alongside your Entra or Okta settings, so choose one of those as well.
Email claim order is optional. Leave the defaults unless your directory puts a person's real email somewhere other than the standard claim — for example, an Entra tenant synced from on-premises Active Directory, where the sign-in name is the reliable value. If unsure, leave it as is.
Click Save.
You enter these values once. Kadence puts the right values into the device configuration for you in Step 3, so there's nothing to copy by hand and nothing to keep in sync across two places.
Test with one person first. A wrong value here stops auto login for your whole workspace — confirm it works for a single user before rolling out to everyone.
Step 3: Generate Your Device Configuration
Kadence builds the exact configuration file each platform needs, filled in with your workspace's values. You don't write these by hand — they're standard formats any MDM can deploy.
On the same auto login settings screen, use Download configuration.
Download the file for each platform you deploy to:
macOS:
kadence-agent.mobileconfig— an Apple configuration profileWindows: a zip containing
kadence-agent-intune.ps1(a device policy script for Intune or any MDM that runs scripts) andkadence-agent-policy.reg(for on-premises fleets using Group Policy). Deploy one of the two, not both.ChromeOS: there's no file. The ChromeOS section of the auto login card shows a short JSON configuration with your Kadence tenant ID and region. Use Copy required JSON configuration.
The configuration contains no passwords or secrets. It tells the agent which identity provider, which Kadence workspace, and which region to use.
Step 4: Deploy With Your MDM
Deploy three things: the Kadence Agent app, the auto login configuration from Step 3, and — for Entra on macOS — Microsoft's sign-in extension.
The configuration files are standard formats, so any MDM handles them.
The steps below use Microsoft Intune as a worked example — the same items apply in any MDM, each deploying the platforms it manages.
For Chromebooks, you deploy the app and its configuration from the Google Admin console instead — see 4d.
4a. The Kadence Agent App
Install the latest agent. These links always point at the current production build:
macOS (covers Intel and Apple Silicon):
https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-universal.pkgWindows (64-bit):
https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-x64.msiWindows (Arm):
https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-arm64.msiChromeOS: Kadence Agent for ChromeOS on Google Play, installed through the Google Admin console (4d)
Deploy the file as an app and assign it to your device or user groups.
In Intune: add the .pkg as a macOS app and the .msi as a Windows app.
4b. The Auto Login Configuration
macOS: deploy kadence-agent.mobileconfig from Step 3 as a configuration profile, assigned to the same devices as the agent.
Any MDM that accepts a custom Apple configuration profile takes this file unchanged.
In Intune: Devices → Configuration → Create → macOS → Templates → Custom, and upload the .mobileconfig.
Windows: deploy kadence-agent-intune.ps1 from the zip as a device policy script, assigned to the same devices. It runs in the system context and writes the agent's policy settings under HKLM\SOFTWARE\Policies\Kadence\Agent.
On-premises fleets can deploy kadence-agent-policy.reg through Group Policy instead. Deploy one, not both.
In Intune: Devices → Scripts and remediations → Platform scripts → Windows, upload the .ps1, and assign it.
4c. macOS with Entra Only: The Microsoft Sign-In Extension
Windows with Entra, macOS with Okta, and Windows with Okta need no sign-in extension — skip 4c for those. ChromeOS needs none either.
For Entra on Macs, the device also needs Microsoft's own sign-in components.
These are Microsoft's, not any one MDM's, so any MDM that supports the macOS single sign-on extension payload can deliver them.
Deploy Company Portal for macOS as a macOS app.
Deploy a Single sign-on app extension profile of type Microsoft Entra ID, assigned to your Macs.
This is Microsoft's Enterprise SSO plug-in, so every field is a fixed Microsoft value — not something Kadence provides — and is the same for every organization:
Field | Value |
Extension Identifier |
|
Team Identifier |
|
Type | Redirect |
URLs |
|
Each user signs into Company Portal once. This registers the Mac with Entra and is the one-time step behind the "one account picker" first launch.
4d. ChromeOS: The Google Admin Console
On Chromebooks, the Google Admin console installs the agent and delivers its configuration in one place.
If your Chromebooks don't run Android apps yet, go to Devices → Chrome → Apps & extensions → User app settings, allow users to install Android apps, and click Save.
Go to Devices → Chrome → Apps & extensions → Users & browsers, and select the organizational unit your Chromebook users belong to.
Click Add → Add from Google Play, search for Kadence Agent for ChromeOS, click Select, then Accept.
Under Installation policy, choose Force install + pin to ChromeOS taskbar.
Under Managed configuration, paste the JSON from Step 3 exactly as Kadence shows it.
Click Save.
The agent reads its configuration when it opens. After you change it, close and reopen the agent.
Step 5: Confirm It Works
On a test device that has the app and the configuration, sign the user in and start the Kadence Agent.
Expect the first-launch step for that platform and provider (see What Your People Will See above), then a signed-in agent.
Restart the device and start the agent again. This time it should sign in with nothing shown.
If the agent shows its normal sign-in screen instead, see Troubleshooting below.
Troubleshooting
The agent shows the normal sign-in screen
The agent shows the normal sign-in screen
Auto login couldn't run and fell back safely. Common causes:
The device configuration is missing, or was changed by hand and is now invalid. Re-download it from Kadence (Step 3) and redeploy it unchanged.
Auto login isn't yet enabled for your workspace. Confirm with your Kadence contact.
The device is unmanaged, or is on a platform or identity provider that auto login doesn't support. Those users keep the normal sign-in.
ChromeOS: the agent shows the normal sign-in screen
ChromeOS: the agent shows the normal sign-in screen
Check each of these:
The managed configuration is on Kadence Agent for ChromeOS, in the organizational unit the person belongs to, and matches the JSON Kadence shows (Step 3). Close and reopen the agent after any change.
Enable ChromeOS is on in Kadence, and the person's Google Workspace domain is in your list (Step 2).
The person exists in Kadence under the same email as their Google account. On a Chromebook, a mismatch shows the normal sign-in screen, not "Contact your admin."
The person closed Google's sign-in sheet without choosing an account. Close and reopen the agent to see it again.
One person is asked to "Contact your admin"
One person is asked to "Contact your admin"
Their identity was verified, but their email doesn't match any Kadence user in your workspace. Check that the person exists in Kadence under the same email your identity provider holds for them.
Okta: nobody can sign in silently
Okta: nobody can sign in silently
Confirm the agent's Okta application grants offline_access and has both Authorization Code and Refresh Token grant types (Step 1, Option B).
Entra on macOS: the account picker or a sign-in comes back every launch
Entra on macOS: the account picker or a sign-in comes back every launch
The Mac isn't staying registered with Entra. Confirm Company Portal is installed and the user has signed into it, and that the Single sign-on app extension profile is assigned (Step 4c).
Entra: no Entra user can sign in
Entra: no Entra user can sign in
Confirm admin consent was granted to the Kadence Desktop Agent application in your tenant (Step 1, Option A).
Need Help?
For setup support, reach out to:
📩 [email protected]











