Dropbox App Guide - IBMmedia.kenexa.com/Training/TSBR/APIDocs/DropboxAppGuideV3.pdf · Dropbox App...

IBM® Kenexa® BrassRing® on Cloud

Dropbox App Guide Version 1.0

Release Date: November 2016


Dropbox App Guide

© Copyright IBM® Corporation 2016. All rights reserved. I

Edition Notice

Note: Before using this information and the product it supports, read the information in the Notices section at the end of this document.

This edition applies to IBM® Kenexa® [Product Name] and to all subsequent releases and modifications until otherwise indication in new editions.

Licensed Materials - Property of IBM

© Copyright IBM® Corporation, 2016.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.


[Document Title] Guide

© Copyright IBM® Corporation 2016. All rights reserved. II

Table of Contents

Edition Notice ......................................................................................................................................................... I

DROPBOX CONFIGURATION ....................................................................................... 2

Dropbox Configuration on BrassRing Workbench: ................................................................................................. 2

Steps to create a Dropbox App: ............................................................................................................................. 2

Applying for Production Status: ............................................................................................................................. 4

After achieving Production Status .......................................................................................................................... 7

Notices .................................................................................................................................................................. 8 Trademarks .......................................................................................................................................................... 9


[Document Title] Guide

© Copyright IBM® Corporation 2016. All rights reserved. III

List of Figures

None


Dropbox App Guide

© Copyright IBM® Corporation 2016. All rights reserved. I

List of Tables

None


Dropbox App Guide

© Copyright IBM® Corporation 2016. All rights reserved. 2

Dropbox Configuration

To enable candidate access to their Dropbox accounts while applying via 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 via BrassRing Talent Gateways per day. By creating their own app, clients can display their branding on the Dropbox authentication page.

Dropbox Configuration on BrassRing Workbench:

BrassRing Workbench Path: Admin > Manage Clients > Edit Client Settings

Steps to create a Dropbox App:

1. Go to Dropbox developers page: https://www.dropbox.com/developers 2. Select My Apps and provide your Dropbox log in credentials. 3. Select Create App

4. Provide values for the following fields on the Create a new app on the Dropbox Platform screen:

Choose an API > select “Dropbox API”

Choose the type of access you need > “Full Dropbox– Access to all files and folders in a user's Dropbox”

Name your app > Enter the name that you would want to give your Dropbox App. You need to enter an appropriate name that matches your company name to get your app approved for production.

5. Select “Create App” button. 6. The next screen displays all the details of the app.

https://www.dropbox.com/developers


Dropbox Guide


7. Development users displays Only you. Here, select Enable additional users. The limit then increases to 500 users. Select Okay.

8. App key and App secret that are created for this App are also displayed in this page. Make a note of the same.

9. Add the respective redirect URLs to match that of staging/ production to the app in two fields:

Redirect URLs (available in Table 1) and

Chooser/Saver domains (available in Table 2)

10. In the Branding tab, upload the logo for the App in the “App Icons” field as per your pixel requirement and select “Save Changes”.

11. App info gets saved and you are now routed automatically to the “Settings” page. 12. Take the values from App key and App secret and enter them in the respective client

setting fields in Dropbox Configuration on BrassRing Workbench:– ‘Edit client settings’ page.

13. Synchronize the Talent Gateways after these changes and you can access the Dropbox through the API.

14. Test this app, apply with Dropbox for production status using the “Applying for

Production Status:” button on the App details page. 15. Dropbox’s requirement for reviewing the application for production status is that the

app should be linked with at least 50 users. You may 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.

16. While applying for production status, you must give a detailed description of how your company will use the Dropbox App and a Job Apply URL for the TG configured with Dropbox App in staging for them to test the app. Dropbox will not approve the app for production unless these details are provided accurately.

Table 1 List of URLs

Redirect URLs

(Add these URLs without spaces or commas each in a new line)

https://sjobs.brassring.com https://sstagingjobs.brassring.com https://stagingkrb-sjobs.brassring.com https://krb-sjobs.brassring.com https://krbcn-sjobs.brassring.com.cn

Table 2 List of URLs

Chooser/Saver domains

(Add these URLs without spaces or commas each in a new line)

sjobs.brassring.com sstagingjobs.brassring.com stagingkrb-sjobs.brassring.com krb-sjobs.brassring.com krbcn-sjobs.brassring.com.cn


Dropbox Guide


Applying for Production Status:

Please note that Dropbox changes this screen and the questions without any notice.

The sample responses provided here are for illustrative purposes. Please use your discretion and provide responses that are relevant and supportive to your organization’s policies while applying for production status.

Clients that create a Dropbox app of their own must test that app in the Staging environment with at least one user. After testing the App, they are required to apply for production status for their App by taking the following steps.


Dropbox Guide



Dropbox Guide


Confirmation

In this section, select the checkbox My app will need to link with more than 50 Dropbox users.

Description

What does your app do?

Response: This app is an applicant tracking system where candidates apply for jobs.

Dropbox Integration:

How does your app use the Dropbox API:

Response: Job applications sometimes require candidates to submit various documents. During the process of job application, candidates may access their Dropbox account via this app and upload the documents that they might have stored in their respective Dropbox accounts.

Website:

Does your app have its own website?

Response: Yes

Platform(s):

Select Web from the list of options.

Provide the URL of the mobile optimized BrassRing Talent Gateway in which Dropbox can be accessed.

Testing instructions:

How can we try your app’s Dropbox integration?

Write down the detailed steps here for your client’s Talent Gateway workflow, so that the testing team at Dropbox can follow them for testing your app.

Provide client’s Staging Talent Gateway URL and one or two test candidate credentials to login to the Talent Gateway.

Describe how to search for a job, apply, how to create a profile, select the resume, upload a file by logging into Dropbox.


Dropbox Guide


Provide the entire flow which lets the Dropbox testing team know how a candidate is using the Dropbox via the Talent Gateway.

Test account credentials

Provide the test account credentials

Testing conditions

Check the option 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

Request early review

This is an optional field. You can either this field or provide a reason as to why your app needs to be reviewed before 50 users are included.

Select Submit app

After achieving Production Status

After receiving confirmation from Dropbox that the app has been upgraded to production status, you must enter the App Key and App Secret values in the Dropbox App Key and Dropbox App Secret fields in the Client Settings section of BrassRing Workbench in the Production environment. If any of the values provided by the client do not match with the values provided by Dropbox API, then an error message is displayed as opposed to Dropbox authentication page. Clients should use only SSL-encrypted Talent Gateways for responsive apply in order to use the Dropbox feature.


Dropbox Guide


Notices

This information was developed for products and services offered in the U.S.A and other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing

Legal and Intellectual Property Law

IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.


Dropbox Guide


Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation 5 Technology Park Drive Westford Technology Park Westford, MA 01886

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Trademarks

These terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

IBM

AIX

Sametime

WebSphere

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

Dropbox App Guide - IBMmedia.kenexa.com/Training/TSBR/APIDocs/DropboxAppGuideV3.pdf · Dropbox App...

Documents

Transcript of Dropbox App Guide - IBMmedia.kenexa.com/Training/TSBR/APIDocs/DropboxAppGuideV3.pdf · Dropbox App...