Google Workspace - Role Assignments Actions
  • 12 Feb 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Google Workspace - Role Assignments Actions

  • Dark
    Light
  • PDF

Article Summary

Google Workspace - Role Assignments Actions adds or deletes role assignments in Google Workspace.

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

General Settings

  • Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
  • Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
  • Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
  • Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
  • Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

  • Use Adapter Credentials - Select this option to use the first connected GSuite adapter credentials.
Note:

To use this option, you must successfully configure a Google Workspace adapter connection.

Required Fields

These fields must be configured to run the Enforcement Set.

  • Role Assignment Action - Select if you want to Create or Delete the role.

  • Role ID - The numeric ID of the role you want to assign or remove. You can locate this by navigating to https://admin.google.com/ac/roles, selecting the role, and copying the parameter from this parameter in the URL:
    RoleID

  • Instance Name - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.

Additional Fields

These fields are optional.

  • ORG Unit ID - IF you want to create or delete the role only for users that belong to a specific organizational unit, enter the relevant ORG Unit ID.
    To get the Org Unit ID for the role
    1. Navigate to https://admin.google.com/ac/orgunits
    2. Right-click the ORG Unit ID name.
    3. Select Inspect.
    4. Locate the parameter in the "data-row-id" corresponding to the ORG unit.
    GSuite_ORG_UnitID

  • Customer ID - Default option is "my_customer", but you can change the default value to your real Google customer ID.

  • Tunnel Name - For Axonius-hosted (SaaS) deployments. Select the tunnel through which to connect to perform the action.

  • Use the scheduling options to execute Enforcement Actions on specific dates and times. You can also configure repeat schedules.

    For more details, see Scheduling Enforcement Set Runs.

Note:

If Use stored credentials from the Google Workspace is not enabled, these fields are required.

  • Email of an admin account to impersonate - The email of your Google Workspace admin.
  • Account Profile Name - Name of your Google account profile
  • JSON Key pair for the service account - Upload the JSON file you created for your service account. For more details, refer to Google Workspace adapter.

APIs

Axonius uses the Google Workspace - Directory API: Role Assignments.

Required Permissions

This action requires permission to add a user to a group.

Also, this action requires that you enter the following scope in your Google account's Domain Wide Delegation for the Client ID used for this connection (inside the JSON file):
'https://www.googleapis.com/auth/admin.directory.rolemanagement'


For more details about other Enforcement Actions available, see Action Library.



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.