Dropbox App Guide

Product: Workbench

Dropbox Configuration
To enable candidate access to their Dropbox accounts when applying by using mobile devices, clients must create and configure their own Dropbox app. The Dropbox app needs to be submitted to Dropbox for testing and approval of production status. After production status is approved by Dropbox, there is no limit on the number of candidates accessing the Dropbox app by using BrassRing Talent Gateways per day. By creating their own app, clients can display their branding on the Dropbox authentication page.
Create a Dropbox App
  1. Access the Dropbox developers page: https://www.dropbox.com/developers, select My Apps, and insert your Dropbox log in credentials.
  2. Select Create App.
  3. Select Choose an API > Dropbox API.
  4. Select Full Dropbox– Access to all files and folders in a user's Dropbox access.
  5. Insert a name for the Dropbox App. Enter an appropriate name that matches your company name to get your app approved for production.
  6. Select Create App.
  7. The App details opens, select Enable additional users, increase the limit to 500 users and select Ok.
  8. Take a note of the App key and App secret as these are required to be entered into Workbench by the IBM Representative.
  9. Add the Redirect URLs and the Chooser/Saver domains to match the staging or production environment in the two fields. Add the URLs without spaces or commas with each URL on a new line.
    1. Redirect URLS:
      • https://sjobs.brassring.com
      • https://sstagingjobs.brassring.com
      • https://stagingkrb-sjobs.brassring.com
      • https://krb-sjobs.brassring.com
    2. Chooser/Saver domains:
      • sjobs.brassring.com
      • sstagingjobs.brassring.com
      • stagingkrb-sjobs.brassring.com
      • krb-sjobs.brassring.com
  10. Select the Branding tab
    1. Upload the logo for the App in the App Icons field and select Save Changes.
  11. You have now configured the app for staging. The Dropbox App client settings, must now be enabled and configured by an IBM Representative.
Client and Workbench settings
  1. Client Settings can only be configured by your IBM representative. Contact your IBM representative with a request to enable the Dropbox App client settings in the Staging Environment. Include the App Key and secret details so the IBM Representative can enter them.
  2. Synchronize the Talent Gateways after these changes and you can access the Dropbox through the API. For more information on syncing changes with Talent Gateways, see Synchronize Changes with Talent Gateways.
  3. You should now test the app is working as expected.
Applying for Production Status
  • Dropbox’s requirement for reviewing the application for production status is that the app should be linked with at least 50 users. You can apply for production status before this requirement is met, but the review happens only after a minimum of 50 users are linked to the app.
  • While applying for production status, you must give a detailed description of how your company is to use the Dropbox App and a Job Apply URL for the Talent Gateway configured with Dropbox App in staging for them to test the app. Dropbox does not approve the app for production unless these details are provided accurately.
  1. To apply with Dropbox for production status, open the Dropbox for developers page:https://www.dropbox.com/developers.
  2. Access the App details page and select Applying for Production Status.
  3. Enter the details as described:
    1. Confirmation: Select My app will need to link with more than 50 Dropbox users.
    2. Description: Insert This app is an applicant tracking system where candidates apply for jobs.
    3. Dropbox Integration: Insert: Job applications sometimes require candidates to submit various documents. During the process of job application, candidates might access their Dropbox account by using this app and upload the documents that they might have stored in their respective Dropbox accounts.
    4. Website: Insert Yes.
    5. Platform(s): Select Web from the list of options and insert the URL of the BrassRing Talent Gateway in which Dropbox can be accessed.
    6. Testing instructions: Insert the detailed steps here for your Talent Gateway workflow, so that the testing team at Dropbox can follow them for testing your app.
      1. Provide the Staging Talent Gateway URL and one or two test candidate credentials to log in to the Talent Gateway.
      2. Describe how to search for a job, apply, how to create a profile, select the resume, upload a file by logging in to Dropbox.
      3. Provide the entire flow that lets the Dropbox testing team know how a candidate is using the Dropbox by using the Talent Gateway.
    7. Test account credentials: Provide the test account credentials
    8. Testing conditions: Select I have provided either test account login info or a link to a test build or a link to screenshots or a screencast detailing my app’s integration with Dropbox.
    9. Request early review: This is an optional field. If needed enter a reason as to why your app needs to be reviewed before 50 users are included.
    10. Select Submit app.
  4. After receiving confirmation from Dropbox that the app has been upgraded to production status, contact your IBM Representative to insert the App Key and App Secret values in the Workbench Client Settings in the Production environment. If any of the values that are entered do not match with the values provided by Dropbox API, then an error message is displayed as opposed to Dropbox authentication page. Your organization should use only SSL-encrypted Talent Gateways for responsive apply in order to use the Dropbox feature.
Email WatsonTalentTraining@us.ibm.com if you have a suggestion for improvement, or encounter an issue on this documentation. Include the product and page title in your email.