Let Oomnitza be your single source of truth!
You'll get complete visibility of your users as data from Box is automatically transformed into consumable information and actionable insights.
Connect Oomnitza and Box in minutes
Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:
- Configurable dashboards and list views of key user information
- Configurable reports to share information about your users with your colleagues and management
- Configurable workflows that you can easily create such as:
- Workflows for transferring ownership of folders
- Workflows for deactivating and deleting users
Before you start
Best practice
For the integration with Oomnitza, create a dedicated user account.
To stream Box data into Oomnitza, you must add your OAuth 2.0 credentials to the vault in Oomnitza.
To add your credentials in Oomnitza, you'll need:
- Client ID
- Client secret
- Scope
Don't forget to keep a copy of your client secret.
Useful links
Add credentials to the vault in Oomnitza
To authorize connections between Oomnitza and Box, complete these steps:
- Log into Oomnitza.
- Click Settings > Credentials, and then click Add new credential (+).
- Add the information details.
- Click the AUTHORIZATION tab.
- From the Authorization Type list, select OAuth 2.0.
- From the SaaS list, select Box.Box OAuth 2.0.
- Complete these actions:
- Enter your client ID.
- Enter your client secret.
- Enter the scope or set of permissions such as
manage_managed_users
. For more information about permissions, see Box scopes.
- Click Authenticate.
- Click CREATE.
You use the credentials that you added to create and customize your integrations with Oomnitza.
Info and connect details
- From the menu, click Settings.
- On the Integrations page, scroll down to the Extended section for User Integrations.
- Click NEW INTEGRATION.
- In the New User Integration sidebar, click Box.
- To integrate Oomnitza with the Box User Load, click APPLY and then click NEXT twice.
Connect page
Best practice
To ensure that only live user records are streamed from Box to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.
- Enter a descriptive name for the integration such as Box Users. That'll be the name of the user integration tile that is shown on the Integrations page.
- From the User Selection list, select User plus SaaS User.
- From the installation type list, select Cloud.
- From the Credentials list, select the credentials from the Oomnitza vault.
- From the Integration Preferences list, select Update only.
- Enter the name of the user of the integration.
- Click Next.
Mappings
Map the Box fields to Oomnitza fields and create custom mappings to get the user information that you need.
Standard Box to Oomnitza mappings
The following fields can be mapped to Oomnitza:
Address
Avatar Url
Connector Sync Time
Created At
Id
Job Title
Language
Login Name
Max Upload Size
Modified At
Name
Notification Email List
Phone
Space Amount
Space Used
Status
Timezone
User Type
Before you click NEXT, complete these action:
- Choose a user role, such as the Employee role.
- Associate the Login Name with the Email and Username fields.
- Map the ID field to the Box User ID field
Associate the Login Name with the Email and Username fields
- Right-click Login Name.
- Select Email and Username.
- Select the Email field as the Sync Key.
Map the ID field to the Box User ID field
- Right-click the Id field and select Add new Oomnitza users field.
- Enter Box User ID as the name of the field.
- Click CREATE.
Want to map more Box fields to Oomnitza?
Contact Support, or see Mapping extended connectors.
Schedule
By default, Box user data is streamed to Oomnitza once every day.
You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.
- Configure your schedule.
- Click FINISH.
A new tile is created for the integration on the Integrations page.
What to do next
If you want to see what information is collected now, click the tile on the Integrations page and click RUN.
Figure: Mock-up for illustration purposes
If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings.
Next
Check out the presets that you can use to automate repetitive tasks.
Use API and SaaS user presets to create workflows
To create workflows, you must have a Box business account.
Use API presets to create user workflows
To reduce costs by automating repetitive and complex tasks, take advantage of the built-in presets.
Complete these steps:
- Click Software > Workflow > SaaS user Role.
- Click Add (+). A Begin and End block is automatically added to the workspace.
- Enter a name and description.
- Click the Blocks tab.
- In the Integrations section, drag and drop the API block into the workspace.
- Click Edit on the API block.
- Enter Box to search for the presets.
- Select a preset:
- Box Deactivate User. Create a workflow that automatically deactivates a user account in Box that was deactivated in Oomnitza.
- Box Delete User. Create a workflow that automatically deletes a user account in Box that was deactivated in Oomnitza.
Important
For the delete workflow to work, any content that the user owns must be removed before the workflow is run. - Box Transfer Owned Folder. Create a workflow that automatically changes the owner of a Box folder. For example, you can run this workflow to change the owner of the folders of a user that you want to delete. You'll be prompted to enter the ID of the new owner of the folder.
- Configure and save your changes.
- Edit the Begin block to schedule and trigger the workflow. For example, you might add these rules:
- SaaS name equals Box
- Deactivated equals 1
- Connect the blocks.
- Validate, launch, and save your workflow.
Use the SaaS User Role Retrieval Role preset
Complete these steps:
- Click Software > Workflow > SaaS user Role.
- Click Add (+). A Begin and End block is automatically added to the workspace.
- Enter a name and description.
- Click the Blocks tab.
- In the Integrations section, drag and drop the SaaS User Role retrieval block into the workspace.
- Click Edit on the SaaS User Role retrieval block.
- Enter Box to search for the presets.
- Select the Box User Role and click the right arrow.
- Click SAVE.
- Connect the blocks.
- Validate, launch, and save your workflow.
Depending on the schedule and rules that you configured in the Begin block, all of the users that aren't found, or were deleted, or deactivated in Box are deactivated in Oomnitza.
Unleash the power of Oomnitza
To get valuable actionable insights that help you manage your assets and users, learn how to:
- Configure dashboards for your assets
- Configure custom reports
- Configure workflows for automating complex and repetitive tasks
Comments
0 comments
Please sign in to leave a comment.