> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta Desktop Password Sync User Experience

> Walk through the Okta Desktop Password Sync user experience. See what users encounter when syncing their macOS password with Okta credentials.

<Callout icon="apple" color="#B84A7A" iconType="regular">This guide applies to Mac computers</Callout>

### About Okta Desktop Password Sync

Okta Desktop Password Sync for macOS allows users to synchronize their local macOS account password with their Okta password, providing seamless authentication across systems.

### How It Works

Desktop Password Sync for macOS allows users to synchronize their local macOS account password with their Okta password. This integration ensures that when users change their Okta password, their local macOS password automatically updates to match, eliminating the need to manually update passwords across systems.

### Prerequisites

* Before registering Okta Verify and setting up Desktop Password Sync, ensure Touch ID has been set up on your computer.

### Initial Registration

<Steps>
  <Step title="Start Registration">
    A notification will be presented showing Registration Required. Click **Register**.

    <Frame>
      <img src="https://mintcdn.com/iru/oxRcYXnzj6p6Lxvi/assets/media/images/zz6jlk1etw4bjgb2of1nrzyyq7sekeedpg.png?fit=max&auto=format&n=oxRcYXnzj6p6Lxvi&q=85&s=488b91e619ffcd6dec2c7984ae1bf031" alt="Okta Desktop Password Sync registration notification showing the Registration Required message and Register button that needs to be clicked to start the setup process" width="738" height="198" data-path="assets/media/images/zz6jlk1etw4bjgb2of1nrzyyq7sekeedpg.png" />
    </Frame>
  </Step>

  <Step title="Enter Current Password">
    Enter your current computer password when prompted.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0254PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=d6f6fdc57a8efda1320627e73c4a453d" alt="macOS password prompt dialog showing the password field where users need to enter their current computer password for Okta Desktop Password Sync registration" width="685" height="809" data-path="assets/media/images/Kandji-Support-KB-0254PM.png" />
    </Frame>
  </Step>

  <Step title="Set Up Okta Verify">
    Start the Okta Verify setup process by clicking **Set up** in the popup window.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0256PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=a3d8b7c730401eba81f09b1c14d3c75f" alt="Okta Verify setup popup window showing the Set up button that needs to be clicked to begin the Okta Verify configuration process" width="724" height="729" data-path="assets/media/images/Kandji-Support-KB-0256PM.png" />
    </Frame>
  </Step>

  <Step title="Continue in Browser">
    You will continue the process in your web browser.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0257PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=e6a3b5b2a6d6ebf55e2478d04d56c550" alt="Okta Desktop Password Sync setup screen showing the message that the process will continue in the web browser" width="727" height="739" data-path="assets/media/images/Kandji-Support-KB-0257PM.png" />
    </Frame>
  </Step>

  <Step title="Log Into Okta">
    Log into your Okta account in your web browser.

    <Frame>
      <img src="https://mintcdn.com/iru/eqrMRa098FywfIL4/assets/media/images/sylfhlok8twshcbssvocrob_y-3ittvh0w.png?fit=max&auto=format&n=eqrMRa098FywfIL4&q=85&s=ae54b1a571f0278493fb01e462933702" alt="Okta login page in web browser showing the username and password fields where users need to authenticate with their Okta credentials" width="2952" height="2010" data-path="assets/media/images/sylfhlok8twshcbssvocrob_y-3ittvh0w.png" />
    </Frame>
  </Step>

  <Step title="Enable Touch ID">
    Once your identity is verified you can close your web browser window. You will be prompted to enable Touch ID.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0258PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=5d114f6de40bf78729c6b6bb113f01fe" alt="Touch ID setup prompt showing the option to enable Touch ID for Okta Desktop Password Sync authentication" width="724" height="736" data-path="assets/media/images/Kandji-Support-KB-0258PM.png" />
    </Frame>
  </Step>

  <Step title="Authenticate for Sync">
    Next, you will be prompted to authenticate to sync your Okta password to your local account. Click **Continue**.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-02589PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=139d89143228794af668c96b97a20729" alt="Okta Desktop Password Sync authentication prompt showing the Continue button to proceed with password synchronization" width="723" height="735" data-path="assets/media/images/Kandji-Support-KB-02589PM.png" />
    </Frame>
  </Step>

  <Step title="Sign In to Sync">
    Click **Sign In** on the notification that appears.

    <Frame>
      <img src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/ourw7ykznrapblugd7pz-1uro757e8g75w.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=cf7beb551f11c59ca82bf6889e675af0" alt="Okta Desktop Password Sync sign-in notification showing the Sign In button that needs to be clicked to authenticate" width="750" height="202" data-path="assets/media/images/ourw7ykznrapblugd7pz-1uro757e8g75w.png" />
    </Frame>
  </Step>

  <Step title="Enter Okta Password">
    Enter your Okta password and click **Sign in**.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0251PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=533f63f2a9ee921fc015b95727c876a9" alt="Okta password entry dialog showing the password field and Sign in button for authenticating with Okta credentials" width="708" height="759" data-path="assets/media/images/Kandji-Support-KB-0251PM.png" />
    </Frame>
  </Step>

  <Step title="Confirm Synchronization">
    You will see a notification letting you know your password has been synchronized.

    <Frame>
      <img src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/nwsmabm45dtx2ucsxewqm2nvlnpn67u4ug.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3c345a1026b1067c10c53d8ed2a2cd1c" alt="Okta Desktop Password Sync success notification confirming that the password has been synchronized successfully" width="748" height="200" data-path="assets/media/images/nwsmabm45dtx2ucsxewqm2nvlnpn67u4ug.png" />
    </Frame>
  </Step>
</Steps>

### Password Changes

In Users & Groups settings, in the Password field, the Change button is not available. This is to help keep your Mac password in sync with your Okta password. If your Okta password changes, there are a few ways to change your Mac password to match your Okta password.

<Note>
  Until you update your password, you will continue to use your old password to log in to your Mac.
</Note>

#### Okta Verify Notification

<Steps>
  <Step title="Authentication Required">
    When you see the **Authentication Required** notification, click **Sign In**.

    <Frame>
      <img src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/ndbwlbnyfiabohb4prqu-hbf9bazarx2_g.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=ccf7437556a054de6ad02ef2692ecd6f" alt="Okta Desktop Password Sync authentication required notification showing the Sign In button for password updates" width="752" height="190" data-path="assets/media/images/ndbwlbnyfiabohb4prqu-hbf9bazarx2_g.png" />
    </Frame>
  </Step>

  <Step title="Enter New Password">
    Enter your new Okta password and click **Sign In**.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0251PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=533f63f2a9ee921fc015b95727c876a9" alt="Okta password entry dialog showing the password field and Sign In button for entering the new Okta password" width="708" height="759" data-path="assets/media/images/Kandji-Support-KB-0251PM.png" />
    </Frame>
  </Step>

  <Step title="Confirm Update">
    You will see a notification that your password has been updated.

    <Frame>
      <img src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/m5-j3yxoo8099738dlmk0aot_4kjyzhraq.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=2175b2e19b3bd535b1023e94e7eb97c4" alt="Okta Desktop Password Sync success notification confirming that the password has been updated successfully" width="746" height="198" data-path="assets/media/images/m5-j3yxoo8099738dlmk0aot_4kjyzhraq.png" />
    </Frame>
  </Step>
</Steps>

#### Lock Screen

You can use your new Okta password at the macOS Lock Screen (not the FileVault unlock screen or Login Window) which will automatically update the local account password on successful authentication.

<Frame>
  <img src="https://mintcdn.com/iru/31OfB-o1LvAjxToj/assets/media/images/AefezKJUv14tcYAl1YO9vDpmM_rOKEHIzg.png?fit=max&auto=format&n=31OfB-o1LvAjxToj&q=85&s=5a80e0e2d62b246a55db5048463567a5" alt="macOS Lock Screen showing the password field where users can enter their new Okta password to automatically update their local account password" width="1540" height="1000" data-path="assets/media/images/AefezKJUv14tcYAl1YO9vDpmM_rOKEHIzg.png" />
</Frame>

### System Settings (macOS 14+ Only)

<Steps>
  <Step title="Open System Settings">
    After your password is changed in Okta, open **System Settings** and select **Users & Groups**.
  </Step>

  <Step title="Access User Details">
    Click the **info** icon next to your user name.

    <Frame>
      <img src="https://mintcdn.com/iru/pt004fUbT6GTF1kl/assets/media/images/Kandji-Support-KB-0932AM.png?fit=max&auto=format&n=pt004fUbT6GTF1kl&q=85&s=5e3265a08573e64ee549c1dbb9d7fde6" alt="macOS System Settings Users & Groups page showing the info icon next to the user name that needs to be clicked to access user details" width="1616" height="1435" data-path="assets/media/images/Kandji-Support-KB-0932AM.png" />
    </Frame>
  </Step>

  <Step title="Authenticate Platform SSO">
    In the **Platform Single Sign-on** section, click **Authenticate**.

    <Frame>
      <img src="https://mintcdn.com/iru/pt004fUbT6GTF1kl/assets/media/images/Kandji-Support-KB-0933AM.png?fit=max&auto=format&n=pt004fUbT6GTF1kl&q=85&s=b0a6b4a6b90e654ddaf3af22415a123a" alt="macOS System Settings user details page showing the Platform Single Sign-on section with the Authenticate button that needs to be clicked" width="1615" height="1442" data-path="assets/media/images/Kandji-Support-KB-0933AM.png" />
    </Frame>
  </Step>

  <Step title="Enter New Password">
    Enter your new Okta password when prompted.

    <Frame>
      <img src="https://mintcdn.com/iru/UzJ56q8TtGBboKzK/assets/media/images/Kandji-Support-KB-0251PM.png?fit=max&auto=format&n=UzJ56q8TtGBboKzK&q=85&s=533f63f2a9ee921fc015b95727c876a9" alt="macOS password prompt dialog showing the password field where users need to enter their new Okta password for synchronization" width="708" height="759" data-path="assets/media/images/Kandji-Support-KB-0251PM.png" />
    </Frame>
  </Step>

  <Step title="Confirm Synchronization">
    You will see a notification that your password has been synchronized.

    <Frame>
      <img src="https://mintcdn.com/iru/oxRcYXnzj6p6Lxvi/assets/media/images/vi9da5_fxwzvdev8ymek5acg_xufgfnbhq.png?fit=max&auto=format&n=oxRcYXnzj6p6Lxvi&q=85&s=0952db9e4370fd46ac77c9e3d80237c2" alt="Okta Desktop Password Sync success notification confirming that the password has been synchronized successfully through System Settings" width="748" height="200" data-path="assets/media/images/vi9da5_fxwzvdev8ymek5acg_xufgfnbhq.png" />
    </Frame>
  </Step>
</Steps>

### Considerations

**Touch ID Requirements**: Touch ID must be set up on your computer before registering Okta Verify and setting up Desktop Password Sync.

**Password Management**: The Change button in Users & Groups settings is disabled to maintain synchronization between your Okta password and local macOS password.

**Lock Screen vs. Login Window**: Password updates work at the macOS Lock Screen but not at the FileVault unlock screen or Login Window.

**System Settings Method**: The System Settings method for password synchronization is only available on macOS 14 and later versions.
