Configure Huddle user provisioning

Once you set up Single Sign-On (SSO), your next step as an administrator is to set up automated user provisioning. This lets you authorize, create, modify, or delete your user's identity once in G Suite. You can also see identity changes reflected in Huddle. 

Before you begin

Before you begin to set up automated user provisioning, contact Huddle Support and get the following details specific to your account:
  • Company ID
  • OAUTH2 Client-ID/Client-Secret for SCIM APIs
Set up user provisioning for the Huddle application
  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and then SAML apps.

    To see Apps on the Home page, you might have to click More controls at the bottom. 

  3. Open the Huddle application.
  4. Select the User provisioning section.
  5. In this section, click Set up user provisioning.
  6. In the Authorize window, enter the Client-ID and Client-Secret values you got from Huddle support.
  7. Click Authorize.
  8. In the Provide Huddle endpoint URL field, paste the company-id you got from Huddle support.
  9. Click Next.
  10. In the Map attributes dialog box:
    1. Next to the selected cloud directory attribute, click Down Arrow to map to the corresponding Huddle attribute. 
      Attributes marked with (*) must be mapped.
    2. Click Next.
  11. (Optional) In the Set provisioning scope dialog box, add a group to restrict provisioning to members of groups you define:
    1. Click the underscore and start entering your group name.
      A list of available groups appears. Selecting one adds it and opens another underscore to use to add another.
    2. If necessary, add more groups and choose a scope. 
    3. To remove any group you added, click Edit next to it.
  12. Once you’re done, click Finish.
  13. Review the information in the Provisioning summary dialog box, then click OK.
  14. Choose one of the following actions:
    • Click Activate provisioning.
    • If needed, first enable the Activate Provisioning button: 
      1. Set the app to On for everyone or On for some organizations.
        If the app is set to Off, this choice is grayed out.
      2. Reload the page, then click Activate provisioning.
  1. In the confirmation dialog box, click Activate.
Display user provisioning

Once provisioning is on, Google starts collecting usage information. You'll see the usage information section next to the User provisioning section. There won't be any numbers next to the event names until you enable provisioning.

The following event names provide the usage information for the last 30 days:

  • Users created
  • Users hard deleted
  • User failures

For more information, see Monitor user provisioning.

Edit provisioning scope

You may want to restrict the scope of provisioning to members of groups you define. 

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and then SAML apps.

    To see Apps on the Home page, you might have to click More controls at the bottom. 

  3. Open the Huddle application.
  4. Select the User provisioning section.
  5. In this section, click Edit provisioning scope.
    A new Set provisioning scope window appears. 
  6. In the Set provisioning scope dialog box, add a group to restrict provisioning to members of groups you define:
    1. Click the underscore and start entering your group name. 
      A list of available groups appears. Selecting one adds it and opens another underscore for you to add another.
    2. If necessary, add more groups. 
    3. (Optional) To remove a group you added, next to it, click  Edit.
  7. Once you’re done, click Finish.

The next time you click Edit provisioning scope under the User provisioning section, the groups you added appear in the Set provisioning scope window. If you turned on the Huddle application for a set of organizational units, the provisioning scope is restricted to those users in the added groups who are also members of those organizations.

Deactivate user provisioning

To disable user provisioning for the Huddle application without losing all the configuration information:

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and then SAML apps.

    To see Apps on the Home page, you might have to click More controls at the bottom. 

  3. Open the Huddle application.
  4. Select the User provisioning section.
  5. Under the User provisioning section, click Deactivate provisioning.
    A new Deactivate provisioning window appears.
  6. Click Deactivate
Define deprovisioning time frames

To define how long deprovisioning actions should be delayed before taking effect:

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and then SAML apps.

    To see Apps on the Home page, you might have to click More controls at the bottom. 

  3. Open the Huddle application.
  4. Select the User provisioning section.
  5. In this section, click Edit deprovisioning config.
    A new Deprovisioning configuration window appears.
  6. Choose how long deprovisioning actions should be delayed before taking effect. Select at least one of these options:
    1. When an app is turned off for the user, hard delete their account after [number of days].
    2. When a user is suspended on Google, hard delete their account after [number of days].
    3. When a user is deleted from Google, hard delete their account after [number of days].

      The amount of time before deprovisioning takes effect can be set to: within 24 hours or after one, 7, or 30 days.

      Tip: Always set more time before hard deleting a user's account than for suspending a user's account.
  7. Click Save to save your edited deprovisioning configuration.
Remove user provisioning

To disable user provisioning for the Huddle application and remove all the configuration information:

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and then SAML apps.

    To see Apps on the Home page, you might have to click More controls at the bottom. 

  3. Open the Huddle application.
  4. Select the User provisioning section.
  5. In this section, click Delete provisioning.
    A new Delete provisioning config window appears.
  6. Click Delete to both deactivate user provisioning and remove all the configuration information.
    Existing users on Huddle will not be deprovisioned.
Was this helpful?
How can we improve it?