Configure Unlock 1Password with JumpCloud

With 1Password Business, you can bring single sign-on (SSO) authentication to your team members by connecting JumpCloud with 1Password using Unlock with SSO.

Unlock with SSO doesn’t include automated provisioning. If you want to create users and groups, manage access, and suspend 1Password users with your identity provider, learn how to automate provisioning using SCIM.

Before you begin

Before you begin, review the considerations and requirements for Unlock with SSO.

These steps were recorded in April 2024 and may have changed since. Refer to the JumpCloud documentation  for the most up-to-date steps.

Step 1: Add the 1Password SSO application to JumpCloud

1.1: Create the application

To get started, sign in to the JumpCloud Admin Portal  and follow these steps:

1. In the sidebar, choose User Authentication > SSO Applications, then click Add New Application.
2. Type “OIDC” in the search field and choose Custom OIDC App, then click Next.
3. Enter a name for your application in the Display Label field and optionally add a logo.
4. Click Next, then choose Configure Application.
5. In the SSO tab, fill out the following fields:
   • Redirect URIs:
     • Copy and paste https://YOUR_DOMAIN.1password.com/sso/oidc/redirect/, then change the domain placeholder to your sign-in address. If your 1Password account is in a different region, change .com to .ca or .eu accordingly.
     • Copy and paste onepassword://sso/oidc/redirect. This allows your team members to sign in to the 1Password apps with SSO.
   • Client Authentication Type: Choose Public (None PKCE).
   • Login URL: Enter your sign-in address.
6. Continue to the next step to map attributes.

1.2: Add attribute mappings and user groups

In the Attribute Mapping section when you create the app, select the Email and Profile mappings, then follow these steps:

1. Click User Groups and make sure the groups you want to sign in to 1Password with SSO are selected.
2. Click Activate in the bottom right. You’ll see the application’s details.
3. Copy the Client ID and continue to the next step.

Step 2: Configure Unlock with SSO

1. Open a new browser tab or window and sign in to your account on 1Password.com.
2. Click Policies in the sidebar, then choose Unlock 1Password with Identity Provider.
3. Choose Other from the list of identity providers and click Next.
4. Select JumpCloud from list, then fill out its information:
   • Paste the Client ID from your JumpCloud application page.
   • Paste the following for the well-known URL: https://oauth.id.jumpcloud.com/.well-known/openid-configuration
5. Click Next and test the connection. You’ll be directed to the JumpCloud user portal to sign in, then returned to 1Password. This verifies connectivity between 1Password and JumpCloud.

If the connection test doesn’t work, make sure you’re signing in as a regular user in JumpCloud and the email address matches the one your 1Password account uses.

Step 3: Specify which team members will unlock 1Password with JumpCloud and set a grace period

After you configure Unlock with SSO, you’ll be redirected to the settings page in your 1Password account. Before you configure your settings, you’ll need to create groups for the team members who will unlock 1Password with JumpCloud:

1. Create a custom group.

   Give the group a descriptive name, like "JumpCloud SSO", for clarity.

2. Add team members to the group.

   If you plan to invite additional team members to test Unlock with JumpCloud at a later date, create a new custom group for each additional set of testers.

The group(s) you create don’t have to be permanent, and you can eventually set your whole team to unlock with SSO once some groups have successfully migrated.

3.1: Choose who will unlock with JumpCloud

By default, “People unlocking 1Password with an identity provider” is set to “No one”. This allows you to gradually migrate your team to unlock with JumpCloud. To specify which team members will unlock 1Password with JumpCloud, select one of the options:

• No one: To turn off Unlock with JumpCloud, select No one.
• Only groups you select: Only the team members in groups you choose will sign in with JumpCloud. Learn how to use custom groups in 1Password Business.
• Everyone except: groups you exclude: All team members, except owners and groups you choose to exclude, will sign in with JumpCloud. Existing users in this scope will be prompted to switch to Unlock with JumpCloud. New users, except those in excluded groups, will use their JumpCloud username and password when joining 1Password. Owners will sign in with an account password and Secret Key.
• Everyone except: guests: All team members, except owners and guests, will sign in with JumpCloud. All existing users will be prompted to switch to Unlock with JumpCloud, and all new users will use their JumpCloud username and password when joining 1Password. Guests and owners will sign in with an account password and Secret Key.
• Everyone: Guests and all team members, except owners, will sign in with JumpCloud. All existing users will be prompted to switch to Unlock with JumpCloud, and all new users will use their JumpCloud username and password when joining 1Password.

3.2: Set a grace period

Team members who already have 1Password accounts will need to switch to unlock with JumpCloud. Specify the number of days before team members must switch. Consider the following when you set the grace period:

• By default, the grace period is set to 5 days. It can be set to 1 to 30 days.
• The grace period begins when an administrator adds a group after they choose the Only groups you select option or when an administrator configures Unlock with JumpCloud for everyone on the team. You’ll see the grace period listed next to each group configured to unlock with JumpCloud.
• If a team member belongs to more than one group, their grace period is determined by the first group set up with SSO, even if the grace periods are different for those groups.
• If you add a team member who hasn’t set up unlock with SSO to a group with an expired grace period, you or another administrator will need to recover their account so they can sign in again using SSO.
• If you edit the length of the grace period, it’ll be prolonged or shortened from the original date you configured the group to unlock with SSO.
• If you need to configure more team members to unlock with JumpCloud after the initial setup, create a new custom group with an active grace period. This will make sure newly assigned team members won’t need their accounts recovered.

Manage settings

To manage your settings, sign in to your account on 1Password.com, then click Policies in the sidebar and choose Unlock 1Password with Identity Provider.

Configuration

To change your configuration with JumpCloud, click Edit Configuration, then follow the onscreen instructions to set up Unlock with SSO. You can only set up one identity provider to unlock with SSO.

You can only save an identity provider configuration after you've successfully tested the connection. Changes won't be saved if you can't successfully authenticate with JumpCloud. This prevents you from losing access to 1Password.

People assignments and biometrics

Click Edit at the bottom of the settings page to change which users are assigned to unlock 1Password with JumpCloud.

• To specify which team members will unlock 1Password with JumpCloud, select an option in the Who can unlock 1Password with an identity provider section.

  "Only groups you select" is recommended. Learn how to use custom groups in 1Password Business. To turn off Unlock with SSO, select No one.

• Specify the number of days before team members must switch to unlocking with JumpCloud.

  The default grace period is 5 days. If a team member doesn't migrate to Unlock with JumpCloud before the end of the grace period, they must contact their administrator to recover their account.

• To allow team members to unlock with Touch ID, Face ID, Windows Hello, and other biometrics, select Allow people to unlock 1Password using biometrics. Specify the number of days or weeks before they’ll be asked to sign in to JumpCloud again.

  When biometric unlock is turned on, your team members can access 1Password while offline, until the time period specified. Vault access will be online-only after the elapsed period.

Click Review Changes to verify your choices, then click Save.

Next steps

To use Unlock with JumpCloud yourself, get started with Unlock 1Password with JumpCloud as a team member.

Learn how to unlock 1Password with JumpCloud on all of your devices and link additional apps and browsers to your account.

Get help

You can find your Client ID on the application details you created in step 1.

If a team member is moved from a group that unlocks with JumpCloud to one that doesn’t, they’ll be prompted to create an account password and download their Emergency Kit.

Get help if you need to switch to a new identity provider after you set up Unlock with SSO.

Learn more

• About 1Password Unlock with SSO
• Understanding Unlock with SSO security
• Add and remove team members
• Use custom groups in 1Password Business
• If you’re having trouble unlocking 1Password with SSO