Onboarding

Keeper MSP Onboarding Process

White Glove Provisioning

The following section covers the creation of a managed company to be managed by the MSP as opposed to handing off the instance to the client for future administration and management.

Schema Design

It's best to start a design by looking at your overall customer base across all account and extract as much commonalty as possible. We are looking for common requirements across all MC's. The closer all the MC's are to each other, the easier they will be to administer as a whole. Our goal is to create a templated procedure which can be re-used by future MC's.

In the table below, we can use a role named "Vault Transfer Required" across all the MC's. At first look, one might be tempted to create a role named "2FA" to handle each MC's different 2FA requirement. However, this naming is ambiguous as Keeper has over a dozen 2FA options. For long term platform management, it's best to name roles for the exact setting(s) they enforce. Our goal is consistent role naming and results across all MC's.

Roles are all about platform administration, so they will have a lot of commonality across MC's. On the other hand, due to varying business requirements, Teams and Shared Folders tend to be MC specific. In the table below we would create one shared folder for each Team present in a given MC. Unlike the table, try and use a common naming convention across all MC. Resist creating an "AP" team in one MC and a "Accounts Payable" team in another.

MC

Roles

Teams

Shares

MC1

Vault Transfer Required 2FA Required

Master Password Complexity

IT

HR

AP

Share per team

MC2

Vault Transfer Required 2FA Optional

No mobile device access

Accounts Payable

AP

Share per team

MC3

Vault Transfer Required

Office access only

N/A

Sales

IT

AP

Create a New Managed Company

From the console interface, create a new managed company, decide on a provisioning method and create any desired roles and teams.

Additionally, create any desired MC customizations including corporate logo and or customized email invitations.

Nodes & Provisioning Methodology

Once the "MC" had been created, a provisioning method need to be chosen as this will effect the node structure. If Single Sign-On or Advance Provisioning will be utilized, a node needs to be added to host the provisioning method. For our example, we will use basic master password access and manual provisioning so no additional nodes will be required.

Note: On-Prem SSO Connect & AD Bridge require an administrator account within the managed company to bind the service. When setting up one of the fore-mentioned services, the administrators email tells the service which instance to bind to.

Create Roles

Create all desired Roles within the admin console. Roles are stackable, i.e., users can belong to multiple roles and will receive the lest permissive outcome of the summed roles. Keeper recommends naming your roles for the function they provide as opposed to a business unit or geo location. If a role enforces vault transfer, name it "Vault Transfer"

MSP administrative Vault Transfer passthrough

If configured correctly, the platform can allow members of the top-level MSP default "Keeper Administrator" role to perform vault transfers for a managed company without the need for a unique administrator account within the managed company. The administrative Vault Transfer passthrough can be enabled by:

  1. Enable the "Transfer Account" option within the "Administrative Permissions" for the default top level "Keeper Administrator" role.

  2. Perform the same operation for the default "Keeper Administrator" role within the managed company.

  3. Within the managed company's user account transfer role, select "Keeper Administrator" as the "Eligible Role".

If the client managed company wishes to restrict the vault transfer ability to only certainly members of their organization and prevent the MSP from preforming the action, create and use a role other than the default "Keeper Administrator" as the "Eligible Role". The MSP passthrough will only work with the default administrator roles provided by Keeper. To set up local transfer rights only:

  1. Create a new role within the managed company.

  2. Enable "Transfer Account" option within the "Administrative Permissions" of the new role.

  3. Use the new role as the "Eligible Role" for the "user" role where account transfer will be enabled.

Details on setting up vault transfer are available here: Account Transfer Policy.

Any roles with the "Set as Default Role for Node and Sub Nodes "Create Teams" option enabled will be automatically assigned to all new users. Users can also be indirectly added to roles via team memberships as roles can contain to both users and teams.

For small companies, often, only two roles are required. An administrative role for platform administration and a second for the general user base. Keeper recommends enabling the following minimum "role enforcement" policies:

"Keeper Administer" Role (predefined)

Setting Group

Setting

Value

Login Settings

Length

Minimum 12 characters

Login Settings

Expier

90 days

Two-Factor

Require use of two factor

On

Two-Factor

All Platforms

Require code every login

Account Settings

Disable Stay Logged in

On

Account Settings

Logout Timers (all)

10 Minutes

Account Settings

Allow IP List

See note below

Transfer Account

Enable Account Transfer

On

Note - Administrative access can be restricted to the MC's public facing egress IP addresses by creating an "Allow IP List" This will require an administrator to be on the MC's LAN or VPN to administer the platform.

"Default" user role

Setting Group

Setting

Value

Login Settings

Length

Minimum10 characters

Login Settings

Expier

90 days

Two-Factor

Require use or two factor

See note below

Two-Factor

All Platforms

See note below

Sharing & Uploading

Prevent sharing outside Enterprise

On

Sharing & Uploading

Prevent exporting of records

On

Account Settings

Prevent users from changing email

On

Account Settings

Disable Stay Logged in

On

Account Settings

Logout Timers (all)

15 to 90 Minutes

Transfer Account

Enable Account Transfer

On

Transfer Account

Eligible role

Keeper Administrator

Generally, two-factor is configured for master password based authentication. Try and encourage your clients to adopt "Require code at every login" policy settings, especially for mobile devices. "Require code at every 30 days" is often used for desktop clients. If using SSO authentication with two-factor enabled at the idP, it can be off or un-configured . By default, users can still opt to setup and use two-factor unless all the "available" methods are explicitly disabled within the enforcement policy.

By default, user invitations are sent upon account creation. If you wish to suppress the invitations until a later date, preform the following steps:

  1. Within the MC, create a new role. For this example, we name the role "Suppress Emails Invitations".

  2. Open the roles "Enforcement Policies" dialog.

  3. Select "Account Settings".

  4. Enable the "Disable email invitations" option and click "done".

  5. Check / enable the "Set as Default Role for Node and Sub Nodes" option. This is to ensure the role will be applied to the user upon first login.

Create Teams

Teams offer the ability to group users for sharing and applying additional sharing options. If using SCIM provisioning you can indirectly add users to roles via team to role assignments.

  1. Create all desired Teams.

  2. Add any applicable role mappings as needed.

Pre-Deploy Keeper Applications and Extensions

Prior to onboarding users, you may wish to distribute certain Keeper's browser extensions, desktop and mobile apps. Details on centralized software distribution methods are covered here.

Configure Reporting & Alerts for "Plus" MC's

Managed Companies with a "plus" license type have access to Keeper's Advanced reporting and Alerts module. SEIM log forwarding, alerts and custom reports should be created as needed. Please see: MSP Best Practice Reports and Alerts.

Onboard Users

Keeper offers several options for onboarding users. Multiple methods can be used in parallel.

Account Recovery

Due to Keeper's zero-knowledge architecture, additional configuration may be required for account recovery. If SSO is in use, the administrator can perform an end-user password reset via the IdP's user management interface. Master Password based users do not have this option so extra steps are required to ensure recover is possible if needed. The first option for Master Password based users is a self-service solution by providing a recovery phrase. A recovery phrase is a simple, auto-generated set of 24 words that was configured when setting up their vault. If the user has forgotten their recovery phrase and vault transfer has been configured by the administrator and accepted by the end user, you can use the following procedure to recover the account: Password Recovery Via Vault Transfer

Configure Logging and Custom Reporting & Alerts

Keeper's Advanced Reporting and Alerts Module (ARAM) is available to managed companies with a "plus" license type. SIEM and Syslog forwarding configurations are covered here: Reporting & Alerts (SIEM). Best practice and example reports and alerts are covered here: Best Practices.

Last updated