Skip to main content
All CollectionsAppsConnecting your appsCloudAlly
Connect a business hub for CloudAlly
Connect a business hub for CloudAlly

This article describes how to connect a business hub to centrally manage the users and assets of CloudAlly from Cerby.

Cerby Team avatar
Written by Cerby Team
Updated over a week ago

Who can use this feature?

  • Workspace Owners, Super Admins, Admins, and Users

  • Only supported using the Cerby web app

As a user with any workspace role in Cerby, except Guest User and Login-Only, you can connect a business hub integration to centrally manage the users of CloudAlly.

When you connect the business hub, you become its Owner, and you can perform the following user and access management tasks through automated tasks executed by the Cerby bot:

  • Check for updates

  • Invite app members

  • Update app members’ roles

  • Remove app members

TIP: For more details about the automated tasks of a business hub, how it works, and the supported apps, read the article Explore Apps

This article provides instructions on how to connect a business hub for CloudAlly. For other app-specific articles and videos, review the Connecting your business hubs collection in the Cerby Help Center.


Requirements

The following are the requirements to connect a business hub:

  • A Cerby workspace

  • A Cerby user account with the Owner, Super Admin, Admin, or User role

  • Groups configured in your identity provider (IdP) if you want to leverage automatic user provisioning and deprovisioning from your apps based on group assignment events. For more information, read the article Manage app members from your IdP

  • An automation account, meaning an active user account with an Administrator role in CloudAlly to be used as a service account. For instructions and recommendations on how to create and configure this account, read the article Create an automation or service account for your business hub

  • The user management and login method for your business hub identified to select the corresponding option when connecting your app. For more information, read the User management and login method section of the article Explore Apps


Connect a business hub for CloudAlly

To connect a business hub for CloudAlly, you must complete the following main steps from the Cerby web app dashboard:

The following sections describe each main step.

1. Add a business hub and connect it to CloudAlly

To add a business hub and connect it to CloudAlly, you must complete the following steps:

  1. Log in to your corresponding Cerby workspace.

  2. Select the Business Hubs option from the left navigation drawer. The Business Hubs view is displayed.

  3. Click the Connect Business Hub button located at the top-right corner of the page. The Connect your Business Hubs to Cerby dialog box is displayed.

    TIP: You can select the Don’t show this again option to skip this step the next time you connect a new business hub.

  4. Click the Get started button. A wizard is displayed on the Select app page.

  5. Select Cloudally Tenant from the catalog. The Enter app details page is displayed on the wizard.

  6. Enter and select your app information in the corresponding fields:

    • Label in Cerby: It is the name to assign to your business hub in Cerby, and it will be displayed on the business hub card.

    • Internal unique label: It is a unique identifier that differentiates your business hub in Cerby from others for the same app. You must assign an alphanumeric value between 3 and 30 characters without symbols or special characters.

    • User management and login method: It is the way your users log in to the app and determines whether they must save their login credentials as a Cerby account connected to the business hub. You must select one of the following methods:

      • Single sign-on (SSO): Access is managed by your identity provider, and users log in with SSO authentication. They are not asked to save their credentials in Cerby.

      • Username and password: Cerby manages account security and access, and users log in with their credentials after saving them in Cerby.

  7. Click the Next button. The Select automation account page is displayed with a list of existing CloudAlly accounts.

  8. Select the automation account you have previously added to Cerby, as described in the Requirements section.

    NOTE: If you don’t have an automation account, you are prompted to add it. Make sure you read Cerby’s recommendations on how to configure it in the article Create an automation or service account for your business hub because you may need to add the account first and then, add the business hub.

  9. Click the Connect app button. The wizard closes, and a success message box is displayed.
    The corresponding business hub is also on the Business Hubs view.

2. Check for updates to import users and roles to Cerby

To check for updates in your app to identify and import users and roles to Cerby, you must complete the following steps:

  1. Select the Business Hubs option from the left navigation drawer. The Business Hubs view is displayed.

  2. Click the Settings icon of the corresponding business hub card. The business hub details page is displayed with the Settings tab activated.

  3. Click the Check for updates button located at the top right of the page. A message box is displayed with information about the process.

    NOTE: The check and import process may take a few minutes depending on the number of users, and because Cerby automatically matches users to their corresponding Cerby user account.

  4. Confirm that the automated task to check for updates has the “Completed” status by performing any of the following actions:

    • Click the More details button from the message box.

    • Select the Automation option from the left navigation drawer to open the Automation view with a list of automated tasks and their status.

NOTE: Cerby automatically performs daily checks for updates for all business hubs, but you can trigger them manually, as described in this section. When a user is deprovisioned from an IdP and a check for updates is performed, Cerby generates a report and sends business hub Owners an email to confirm their removal from the app. For more instructions, read the article Check for updates in your app and apply report.

3. Connect your CloudAlly user account to the business hub

To connect your CloudAlly user account to the business hub so Cerby can manage and protect it, you must complete the following steps:

  1. Select the Accounts option from the left navigation drawer. The Accounts view is displayed.

  2. Click the Log in button of the corresponding Cloudally Tenant account card. The Connect your Cloudally Tenant Account dialog box is displayed.

  3. Enter the login credentials of your CloudAlly user account.

  4. Click the Connect account button. The dialog box closes, and a success message box and a new account card are displayed.

The next step is 4. Manage unmatched users.

4. Manage unmatched users

During a check for updates, Cerby automatically matches app members to the Cerby user accounts that correspond to their email addresses, including existing guest users and local partners. Manual matching is required when apps don't provide email addresses and for app members using personal or external accounts that couldn’t be identified or are not in the corporate directory.

To view the status of the imported app members, you must complete the following steps:

  1. Select the Business Hubs option from the left navigation drawer. The Business Hubs view is displayed.

  2. Click the More options icon of the corresponding business hub card. A drop-down list is displayed.

  3. Select the View Members option from the list. The business hub details page is displayed with the Members tab activated.
    App members are displayed in the following tabs of the User Overview section:

    • Unmatched users: This tab displays the users who were not automatically matched.

    • Onboarded users: This tab displays the users matched to their Cerby user account.

    • Guest users: This tab displays the users who were matched to an existing Cerby user account but it doesn’t exist in the corporate directory, such as external collaborators.

For unmatched users, you can perform one of the following actions:

The following sections describe each action.

Match users

To match users, you must complete the following steps from the Unmatched users tab of the business hub details page:

  1. Click the Match user button of the corresponding user. The Match user dialog box is displayed.

  2. Enter the username or email address of the user you want to match and invite in the Match with field. The user is displayed on a list.

  3. Select the user from the list.

  4. Click the Next button. The Select Cerby role dialog box is displayed.

  5. Select the role to assign to the user on the business hub Cerby role drop-down list:

    1. Owner: This role enables sharing access and managing business hub settings in Cerby.

    2. Collaborator: This role enables only logging in to the app from Cerby.

  6. Click the Match user button. The dialog box closes, and a success message box is displayed. The user is moved to the Onboarded users tab.

Remove unmatched users

To remove unmatched users, you must complete the following steps from the Unmatched users tab of the business hub details page:

IMPORTANT: When removing an unmatched user, Cerby performs an automated task to revoke the user’s seat and permissions in CloudAlly.

  1. Click the More options icon of the corresponding user. A drop-down list is displayed.

  2. Select the Remove user option from the list. The Remove user? dialog box is displayed.

  3. Click the Remove user button. The dialog box closes, and a success message box is displayed. The user is removed from the app via an automated task.

Exempt unmatched users

Exempted users keep their user accounts or seats active in your app, but you cannot manage them through Cerby.

To exempt unmatched users, you must complete the following steps from the Unmatched users tab of the business hub details page:

  1. Click the More options icon of the corresponding user. A drop-down list is displayed.

  2. Select the Exempt user option from the list. The exempt user dialog box is displayed.

  3. Enter a reason for exempting the user in the Provide a reason field.

  4. Click the Exempt member button. The dialog box closes, and a success message box is displayed. The user is moved to the Exempted users tab.


Use your business hub

The following are the supported features of business hubs you can use:

Did this answer your question?