Configure Kudos 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 Kudos.

Set up user provisioning for the Kudos 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 Kudos application.
  4. Select the User provisioning section.
  5. In this section, click Set up user provisioning.
  6. In Kudos, navigate to Account and then API
  7. Copy the API Token value
  8. Once you have the access token, in the text field within the Authorize dialog box, enter your access token.
  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 Kudos 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. (Optional) 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 Kudos 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 Kudos application for a set of organizational units, the provisioning scope will be restricted to those users in the added groups who are also members of those organizations.

Deactivate user provisioning

To disable user provisioning for the Kudos 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 Kudos 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 Kudos 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 Kudos 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 Kudos 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 Kudos will not be deprovisioned.
Was this helpful?
How can we improve it?