Page Comparison

EmpowerID Box connector allows organizations to bring the user and group data in their Box system to EmpowerID, where it can be managed and synchronized with data in any connected back-end user directories. Once connected, you can manage this data from EmpowerID in the following ways:

• Account Management
  • Inventory Box user accounts
  • Create, Update and Delete Box user accounts
  • Enable and Disable Box user accounts
    
    
• Group Management
  • Inventory Box groups
  • Inventory Box group memberships
  • Create and Delete Box groups
  • Add and Remove members to and from Box groups
    
    
• Attribute Flow
  Users in Box are inventoried as accounts in EmpowerID. The below table shows the attribute mappings of Box user attributes to EmpowerID Person attributes.
  
  

Additionally, EmpowerID provides Provisioning policies or Resource Entitlements that allow you to automatically provision Box accounts for any person within your organization based on your policy requirements.

This topic demonstrates how to connect EmpowerID to Box and is divided into the following activities:

• Registering EmpowerID as an application in Box – This generates an API Key for managing the user and group information within Box. 
• Creating a Box account store in EmpowerID – Account stores are objects in EmpowerID that you use to connect EmpowerID to external directories.
• Configuring Attribute Flow Rules for the Box Account Store – Attribute Flow Rules allow you to specify which system has greater authority for effecting changes to user attributes.
• Enabling EmpowerID to Inventory Box
• Turning on the Account Inbox Permanent Workflow – The Account Inbox is a permanent workflow that retrieves user accounts in external systems and either joins those user accounts to existing EmpowerID Persons or provisions new EmpowerID Persons from those user accounts based on the logic of the Join and Provision Rules.
• Monitoring Inventory

Anchor
registerempowerid registerempowerid

To register EmpowerID as an application in Box

1. Login in https://app.box.com/developers/console.
2. Click Dev Console and then click Create New App.
   Image Removed
   Image Added
   
   
3. Select Enterprise Integration and click Next.
   Image Removed
   Image Added
   
   
4. On the Authentication Method page, select OAuth 2.0 with JWT (Server Authentication) and then click Next.
   Image Removed
   Image Added
   
   
5. Name the app and then click Create App.
   Image Removed
   Image Added
   
   Box creates the app and generates developer token.
   Image Removed
   Image Added
   
   

6. Click View Your App.
   
   This directs you to the Configuration page.
   Image Removed
   Image Added
   
   

7. Under Application Access, select Enterprise.
   Image Removed
   Image Added
   
   
8. Under Application Scopes, select the options shown below.
   Image Removed
   Image Added
9. Under Advanced Features, select Perform Action as Users and Generate User Access Tokens.

10. Under Add and Manage Public Keys, click Generate a Public/Private Keypair. 
    
    

    Info
    When you click Generate a Public/Private Keypair, Box will send a Verification code to the mobile number linked to the account. To use this feature, Two-factor authentication must be enabled on Box.

    
    
    Image RemovedImage Added
    
    

11. Enter the code sent to your mobile number.
12. Back on the Configuration page, under App Settings, click Download as JSON.
    Image Removed Add and manage public keys, download the JSON file generated by Generate a public/private keypair.
13. Save your changes and then point your browser to https://app.box.com.
14. Select Admin Console from sidebar.
15. Select Enterprise Settings and then click the Apps tab.
    Image Removed
    Image Added
    
    
16. Under Custom Applications, click Authorize New App and wait about 10 minutes before proceeding to the next step.
17. Copy the value for the ClientID of the application from the JSON file you downloaded above.
18. Paste the ClientID in the API Key field of the App Authorization dialog and then click Next.
    Image Removed
    Image Added
    
    
19. Click Authorize.
    Image Removed
    Image Added
    
    

After registering EmpowerID in Box, the next step is to create a Box account store in EmpowerID.

Anchor
boxaccountstore boxaccountstore

To create a Box account store in EmpowerID

1. From the navigation sidebar of the EmpowerID Web interface, expand Admin > Applications and Directories and then click Account Stores and Systems.
2. On the Account Stores page, click Create Account Store.
   Image Removed
   Image Added
   
   
3. Under System Types, search for Box.
4. Click Box.com to select the type and then click Submit.
   Image Removed
   Image Added
   
   
5. On the Box Settings page that appears, do the following:
   1. Enter a Name in the Name field.
   2. Enter a UPN Suffix in the UPN Suffix field.
   3. Click Choose File and upload the application JSON file you downloaded from Box.
   4. Click Submit.
      Image Removed
      Image Added
      
      

Anchor
accountinbox accountinbox

To enable the Account Inbox permanent workflow

1. From the Navigation Sidebar of the EmpowerID Web interface, expand Admin > EmpowerID Servers and Settings and click Permanent Workflows.
2. From the Permanent Workflows page, click the Display Name link for Account Inbox.
   Image Removed
   Image Added
   
   
3. From the View One page for the workflow that appears, click the edit link for the workflow.
   Image Removed
   Image Added
   
   
4. From the Permanent Workflow Details form that appears, select Enabled and then click Save. Based on the default settings applied to the workflow, EmpowerID will process 1000 of the user accounts in the Account Inbox every ten minutes, provisioning Person objects from those user accounts and joining them together based on the Join and Provision rules applied to the account store.
   Image Removed
   Image Added

Anchor
monitorinventory monitorinventory

To monitor inventory

1. From Navigation Sidebar, expand System Logs > Policy Inbox Logs and click Account Inbox.
   
   The Account Inbox page appears. This page provides tabbed views of all information related to processing new user accounts discovered in a connected account store during inventory. An explanation of these tabs follows.
   Image Removed
   Image Added

• Dashboard - This tab provides a quick summary of account inbox activity.
• Not Processed - This tab displays a grid view of all inventoried user accounts not yet used to provision a new EmpowerID Person or joined to an existing Person. Any accounts that fail to meet the Join and Provision rules are displayed here as well.
• Failed - This tab displays a grid view of any account joining or provisioning failures.
• Ignored - This tab displays a grid view of all accounts ignored by the account inbox. Accounts are ignored if they do not qualify as user accounts.
• Joined - This tab displays a grid view of all accounts joined to an EmpowerID Person. Joins occur based on the Join rules applied to the account store.
• Processed - This tab displays a grid view of all accounts that have been used to either provision a new EmpowerID Person or joined to an existing EmpowerID Person.
• Provisioned - This tab displays a grid view of all accounts that have been used to provision an EmpowerID Person. Provisioning occurs based on the Provision rules applied to the account store.
• Orphans - This tab displays a grid view of all user accounts without an EmpowerID Person.
• All - This tab displays a grid view of all user accounts and the status of those accounts in relation to the Account Inbox.