Adding your Box credentials to Oomnitza

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.

To add your credentials in Oomnitza, you'll need:

• Client ID
• Client secret
• Scope

To obtain your Client ID and secret, complete the following steps:

1. Log in to your Box developer account, or sign up for a free trial
2. In the sidebar, click My Apps
3. Click Create New App
4. Click Custom App
5. Select User Authentication OAuth 2.0
6. Enter an app name
7. Click Create App
8. In the Configuration tab, copy your Client ID and Client secret. 
9. Enterhttps://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_urlas the redirect URI.
10. Select the Manage Users and Read and write all files and folders stored in Box scopes in the Application Scopes section.
11. Save your changes.

Tip
Don't forget to keep a copy of your client ID and secret, and store it securely. 

Useful links

Box OAuth 2.0

Box scopes

Box API Reference

Add credentials to the vault in Oomnitza

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration. 
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. Add the information details.
2. Click the AUTHORIZATION tab.
3. Ensure that OAuth 2.0 is selected as the Authorization type.
4. Ensure that Box is selected from the SaaS list.
5. Complete these actions:
   • Enter your client ID.
   • Enter your client secret.
   • Enter a space-separated list of scopes such as manage_managed_users root_readwrite. For more information about permissions, see Box scopes.
6. Click Authenticate. 
7. Click CREATE. 

You use the credentials that you added to create and customize your integrations with Oomnitza.