Enterprise Recon 2.0.28

OneDrive

This section covers the following topics:

General Requirements

  • Proxy Agent host with direct Internet access.
  • Cloud service-specific access keys.

OneDrive for Business

To scan OneDrive for Business, you must add your Office 365 organization as a Target. Each user’s OneDrive for Business account is represented internally by Microsoft as a "My Site" Site Collection. For ER2 to scan the OneDrive for Business user account, we have to be granted permissions to scan these Site Collections.

On the Web Console, browsing an added OneDrive for Business Target lists all Office 365 user accounts. Select only user accounts that have OneDrive for Business enabled to add them as scan locations. Scanning a user account that does not have OneDrive for Business enabled will result in ER2 reporting it as an inaccessible location.

Licensing

OneDrive for Business accounts are licensed as Office 365 Targets. See Licensing for more information.

Preparing to Add Target Location

Before adding OneDrive for Business as a Target, you have to perform the following on your Office 365 organization:

  1. Add OneDrive for Business user accounts to a group
  2. Add secondary Site Collection Administrator to all OneDrive for Business user accounts

To automate the above steps, see Configuring OneDrive for Business Organization for ER 2.0.26.

Once done, see Set OneDrive for Business as a Target Location.

Add OneDrive for Business user accounts to a group

  1. Create a new Office 365 group. This group will be used to hold all Office 365 users with OneDrive for Business enabled. Name it "ER2OneDrive" or similar. See Microsoft: Create an Office 365 group in the admin center for more information.
  2. Connect to SharePoint Online using the SharePoint Online Management Shell. Using the Management Shell, get a list of all Office 365 users with OneDrive for Business enabled. See Microsoft: How to display a list of OneDrive for Business site collections for more information.
  3. Add the list of Office 365 users with OneDrive for Business enabled to the "ER2OneDrive" group.

Add secondary Site Collection Administrator to all OneDrive for Business user accounts

  1. Create a service account to scan OneDrive for Business, or use an existing service account. This service account should be assigned Global Administrator permissions.

  2. Add the service account as a secondary administrator for the "My Site" Site Collection on all target OneDrive for Business accounts.

    1. Connect to the SharePoint Online Admin Center.
    2. Navigate to user profiles > Manage User Profiles.
    3. Search for a specific user profile and click on Manage site collection owners.
    4. In the site collection owners window, add the service account as the secondary site collection administrator.
    5. Repeat this for all OneDrive for Business accounts.

Set OneDrive for Business as a Target Location

  1. From the New Search page, Add Targets.
  2. In the Select Target Type dialog box, select OneDrive.
  3. In the OneDrive Details section, fill in the following fields:
    er2-add-cloud-onedrive-1.png

    Field Description
    OneDrive Domain

    Enter the email address of your service account.

    This service account must be a Global Administrator that has been assigned as a Site Collection Administrator for all Target OneDrive for Business accounts.

    OneDrive Account Authorization Obtain the OneDrive access code:
    1. In OneDrive Details, click on OneDrive Account Authorization. This opens the OneDrive account authorization page in a new browser window.
    2. Log into your Microsoft account.
    3. Click Yes.
    4. Copy the Access Code.

    Access Code Enter the Access Code obtained during OneDrive Account Authorization.
    Agent to act as proxy host Select a Proxy Agent host with direct Internet access.
  4. Click Test. If ER2 can connect to the Target, the button changes to a Commit button.
  5. Click Commit to add the Target.
  6. Click on the arrow next to the newly added OneDrive for Business Target to display a list of groups.
  7. Select the "ER2OneDrive" group.

  8. Click Next to continue configuring your scan.

Add a Path for OneDrive for Business

  1. Set OneDrive for Business as a Target Location.
  2. In the Select Locations section, select your OneDrive Target location and click Edit.
  3. In the Edit OneDrive Location dialog box, enter the Path to scan. Use the following syntax:

    Path Syntax
    All users in a group <group_name>
    All files from specific user <group_name/user_name>
    Specific folder from specific user <group_name/user_name/folder_name>
    Specific file from specific user <group_name/user_name[/<folder_name>]/file_name.txt>
  4. Click on OneDrive Account Authorization and follow the on-screen instructions. Enter the Access Code obtained into the Access Code field.

  5. Click Test and then Commit to save the path to the Target location.