If you're having trouble at any stage please contact us at support@skyformation.com. 

Preface

The goal of this guide is to add a new SkyFormation's Dropbox Business Cloud App Connector to your SkyFormation Platform.

Prerequisites

- Have the following information ready when onboarding the connector:

1. Required: Events Access Token
   Your Dropbox business account (team) access token for events monitoring (see below how to create it)
2. Optional: Members Access Token

           This token is needed only if you have the SkyFormation Unified Remediation API module
           and you would like to be able to execute remediation actions on your DropBox connector
           as suspend/unsuspend a user.

To create the Events Access Token follow the following instructions:

Add a DropBox application by following the guide at:
https://www.dropbox.com/developers/apps/create 

Choose the Dropbox Business API in the API section (section 1), and Team member file access in the type of access section (section 2). Name your application (in section 3) and click on Create App.
  

On the next screen, click on Generate in the OAuth2 section, under the title 

Generated access token. You will then see the Events Access Token required for the SkyFormation Dropbox Connector.

 

To create the Team Member Access Token follow the following instructions:

This token is needed only if you have the SkyFormation Unified Remediation API module
and you would like to be able to execute remediation actions on your Dropbox connector
such as suspend/unsuspend a user.

To create the token repeat the same steps (i.e. create another app) but this time, choose Team member management in section 2 of the app creation. All the other steps remain the same. At the end of the process you should have another access token, for user management. 

On-board SkyFormation for Dropbox business steps

1. Logon to your SkyFormation Platform:

2. Navigate via left navigation panel to "Settings" section

3. Navigate via New Settings left navigation panel to "Accounts" section

4. Click the "Add Account" bottom

5. At the "SELECT SERVICE TO ADD" choose "Dropbox" 

You will see the below screen:

5. Fill in the following information:

 - Tenant (relevant only for the multi-tenant SkyFormation edition)
       Choose the tenant the new connector will be attached to.     

  - Account Name
       Give the custom connector a meaningful name for you.
      This will become your application connector name displayed in the SkyFormation platform and
      added to entire events sent to your SIEM system from this connector as an identifier. 

      Example: 
      "dropbox-corp-file-sharing"     

    - Description
      Add any text that describe the specific application and meaning for the business.

      Example:
      "Corp file sharing app"

    - Events Access Token
       This is the token that you have generated in the prerequisite section during creating the               dropbox app, with the Team member file access. 

     - Members Access Token (optional)
       This is the token that you have generated in the prerequisite section during creating the               second dropbox app, with the Team member management access.

6. Test the settings correctness 

    Press the "TEST CONNECTION" button

    If you see a green OK sign appears as above you have completed the onboard successfully.

- Click "SAVE" button

7. Start the new connector

    When a new cloud connector is added its default state is STOPPED.

    To start it press its START button. 

DONE !