1Accellion Google Drive App€¦ · To enable the app in Google Drive, you would need to follow a few steps as a G Suite administrator. Every menu option in Google Drive, for example,

1Accellion Google Drive App

Accellion Google Drive App

The Accellion Google Drive App is a business workflow that can be integrated into Google Drive. The app simplifies and secures any data sharing from Google Drive. Without leaving the Google Drive environment you can send, share copy and add from Accellion via the app.

To enable the app in Google Drive, you would need to follow a few steps as a G Suite administrator. Every menu option in Google Drive, for example, send, share/copy and add, is considered a “project”. This section describes how to create a project in the Google Admin console which will be displayed as a menu options on Google Drive.

Key Features of the Accellion Google Drive App

• Send file using Accellion

• Share copy using Accellion

• Add file from Accellion

Minimum Requirements

G Suite Business Edition Account

kiteworks User Account

In this section the following steps need to be followed to configure and publish the Accellion Google Drive App:

1 Create a Project or App

2 Enabling Google Drive API and G Suite Marketplace SDK for your Project

3 Configuring Google Drive API

Prior to configuring and deploying this application to the G Suite Marketplace, the OAuth consent and Credentials needs to be configured on the Credentials page.

a. Configuring the OAuth Consent Screen

b. Configuring Credentials

After you have configured the credentials a client ID is generated. This client ID will need to be entered in the kiteworks Admin UI, in the Client ID field on the Google Drive page under Client Management. This enables the kiteworks server to communicate with the Google APIs.

4 Downloading Accellion for Google Drive

5 Publish

Accellion Google Drive App Page 3


Create a Project or App

Create Apps in the Google APIs Dashboard. Perform the following steps to create an App.

1 Go to the Google console to create your project at https://console.cloud.google.com/.

2 In the Google dashboard, click Create.

3 The New Project window displays. Define your project, give it a Project Name and select the Location where you would like to save this project. Click Create.

In this example, project name: Share copy using Accellion is created.

4 Your new project displays under Notifications.


https://console.cloud.google.com/


Enabling Google Drive API and G Suite Marketplace SDK for your Project

Once the project is created it will display on top. Next, you need to enable the Google Drive API and G Suite Marketplace SDK for your project. Perform the following steps:

1 Click on the newly created project as shown below, to do so.

2 In the Share copy using Accellion page, click +ENABLE APIS AND SERVICES.

3 In the Search field type in Drive to locate Google Drive API. Click Google Drive API.

4 The Google Drive API for your project displays. Click the Enable button to enable the APIs for your project.

5 Next, you will need to enable the G Suite Marketplace SDK. To do so, go back to the Google dashboard of the new project you just created.



6 In the Search field type in Marketplace to locate it. Click G Suite Marketplace SDK.

7 The G Suite Marketplace SDK for your project displays. Click the Enable button to enable it.

The G Suite Marketplace SDK is enabled as shown below.

As shown in the following screen capture Google Drive API and G Suite Marketplace SDK are added for Share copy using Accellion.



Configuring Google Drive API

Perform the following steps to configure Google Drive API:

1 Click on Google Drive API on the page shown in the previous screen capture to view the page.

2 Click Drive UI Integration in the left panel. This is where the project is defined.

3 The Configuration page displays. Populate all the fields and upload icons for this project or application. On this page you will configure how your application appears in Google Drive. The fields are explained below.



Application Name - Type in a name for this application. In this example we are naming this application GSuite Admin Demo for GDrive.

Short Description - Type in a short description of the application.

Long Description - Type in a long description of the application.

Icons - Upload all the icons you will use for this application. After configuring these fields you can preview the appearance. You can even upload a document icon.

Drive integration - Populate these fields to configure how your application will integrate with Google Drive.

Authentication - Check this box to display the OAuth consent screen.

Open URL - The URL where the application is located.

Default MIME Types - Populate this field with default MIME types that is used by your organization. This field is optional.

Default File Extensions - Populate this field with default file extensions that is used by your organization. This field is optional. In this example, .pdf, .doc and .text file extensions are entered.

Secondary MIME Types and File Extensions - Populate this field with secondary MIME types and file extensions. This field is optional.

Creating Files - Check this box if you would like to allow users to create new files using this application.

Multiple File Support - Check this box if you would like users to open multiple files using a single instance of this application.

Importing - Check this box to allow users to open files that can be converted to a format that this application can open.

Mobile Browser Support - Check this box if this application can be launched in a mobile browser.

Team Drives Support - Check this box if this application works with files in Team Drives.

Click Save Changes. The Drive UI configuration completes and the icons that you uploaded are displayed.

Note Prior to configuring and deploying this application to the G Suite Marketplace, the OAuth consent and Credentials needs to be configured on the Credentials page.

The following links give you the details of the configuration settings for Share copy, Send and Add menu options.

Configuration Details for Share copy using Accellion

Configuration Details for Send File using Accellion

Configuration Details for Add Files using Accellion



Configuring the OAuth Consent Screen

The credentials for OAuth consent screen need to be configured. The consent screen tells your users who is requesting access to their data and what kind of data is being accessed. Click Credentials and then click OAuth consent screen. Populate all the fields on this page which are explained below.

Application type - Select the application type, if it will be Public or Internal.

Verification status - This is the verification status of your application. Verification is required if your Application Type is Public and the process may take up to several weeks.

Application name - Enter the name of the application asking for consent. In this example we are naming this application GSuite Admin Demo for GDrive.

Application logo - Upload the logo of your application.

Support email - This email address will be displayed on the consent screen.

Scopes for Google APIs - Add scope. Scopes allow your application to access your user's private data.

Authorized domains - Add domains to protect you and your users.

Application Homepage link - This link must be hosted on an authorized domain. It will display on the consent screen.

Application Privacy Policy link - This link must be hosted on an authorized domain. It will display on the consent screen.

Application Terms of Service link - This link must be hosted on an authorized domain. It will display on the consent screen.

Click Save. The OAuth consent screen is now configured.



Configuring Credentials

Once you have configured and saved the Configuring the OAuth Consent Screen, you will need to configure your credentials. Go to Credentials in the APIs & Services page and click Credentials, click Create Credentials and select OAuth Client ID.

The Create OAuth Client ID page displays. The fields are defined below.

Application Type - Web, Android, Chrome App, iOS or other.

Name - The name of the application. In this example, we have named it Web client 3.

Authorized JavaScript origins - This is path used for requests from the browser which is the origin URI of the client application. Type in the domain of your kiteworks server.

Authorized redirect URIs - This is the path in your application that users are redirected to after they have authenticated with Google. Again, type in the domain of your kiteworks server.



After populating the fields, click Create. The client ID and client secret are generated and display in the OAuth client window.

Copy this client ID. You will need to paste this client ID in the kiteworks Admin UI. In case you miss copying it, you can always get it from the Credentials page as shown below.

Enabling the kiteworks Server to Communicate with the Google Cloud APIs

Perform the following steps to enable your kiteworks server to communicate with the Google APIs:

1 Go to your kiteworks server Admin UI and click Application > Client Management > Plugins > Google Drive.

2 Paste the client ID you copied in the applicable project: Send, Share copy or Add Client ID field.

3 Click Save.

This identifies the kiteworks server as an authorized server enabling it to communicate with the Google APIs.



Downloading Accellion for Google Drive

From your kiteworks server Admin UI and click Application > Client Management > Plugins > Google Drive, and click the Downloads tab.

Click the Download button to save or open the zipped file. The file includes:

1 Accellion_for_Google_Drive_Plugin

2 Accellion for Google Drive App Admin Guide

3 Accellion for Google Drive: User's Guide

4 Accellion_for_Google_Drive_Plugin > Project Assets > Send (Configuration Details for Send File using Accellion: Icon row in the table).

5 Accellion_for_Google_Drive_Plugin > Project Assets > Share (Configuration Details for Share copy using Accellion: Icon row in the table).

6 Accellion_for_Google_Drive_Plugin > Project Assets > Add (Configuration Details for Add Files using Accellion: Icon row in the table).

Configuring G Suite Marketplace SDK

Perform the following steps to configure the G Suite Marketplace SDK:

1 Click on the hamburger icon on the top left to go to the Dashboard.



2 In the Dashboard, select G Suite Marketplace SDK. The G Suite Marketplace SDK page displays.

3 In the left panel select Configuration to view the page.

4 The fields configured on this page determine how your application displays in the G Suite Marketplace. Populate all the fields which are explained below and upload icons for this project or application.





Application info - displays with the Project number.

Select a language.

Application name - The name of the application. In this example we are naming this application GSuite Admin Demo for GDrive.

Application description - A description of the application.

Add language - You can add a language.

Enable individual install - If this checkbox is selected it will enable the end user to install. If it is not selected only the Admin will be able to install this application.

Application icons - You can browse and upload icons and preview your selection.

Icons of all resolutions are required to be uploaded.

Support URLs - Terms of service, Privacy policy, Setup, Admin config, Support and Deletion policy URLs can be entered. These fields are optional.

OAuth 2.0 scopes - Enter the OAuth 2.0 scope URLs for the Google API that your application will access.

Extensions - Select the checkbox for Universal navigation, Drive and Hangouts Chat bot and other Add-on extensions.

Google Analytics ID - Specify your Google Analytics ID if you would like to use one to track you listing.

Visibility - Select Public if you would like this application to be displayed in the public domain. Select My Domain if you would like this application to be displayed in your domain.

Click Save Changes to integrate your configuration with Google.

The following links give you the details configuring the G Suite Marketplace SDK for Share copy, Send and Add menu options.

Configuration Details for G Suite Marketplace API for sharing and copying files.

Configuration Details for G Suite Marketplace API for sending files.

Configuration Details for G Suite Marketplace API for adding files.

Publish

In the left panel select Publish to view the page. All the configurations on the Publish page need to be precise as these dictate how the application displays once it is published.



The Publish screen displays. Populate all the fields on this page which are explained below.

Publish status

Detailed Description

Choose language

Application detailed description

Add language

Application banner - Upload image for the banner. Note 220x140 pixels resolution is required. Resolution displayed on the screen is a requirement before publishing.

Screenshots - Add screenshots if required. Note 640x400 pixels resolution is required. Resolution displayed on the screen is a requirement before publishing.

Links and Information - YouTube video url, Application website are optional fields. Add the Developer website. Developer name, email, Help Url, Report issue Url are optional fields. Post install Tip is required if docs/sheets/slides/forms add-ons are used.

Reach Category - Select a category



Region - Select regions where you would like to publish this application.

Click Publish to publish your application.

Publish configuration details for sharing and copying files.

Publish configuration details for sending files.

Publish configuration details for adding files.

Locating and Using your Application

Once the application is published, go to https://admin.google.com to manage Google Suite to locate your application. In this example we are naming this application GSuite Admin Demo for GDrive.

Click on Apps as shown below. Depending on how many icons display on the console Apps could be displayed elsewhere on the screen. Click on MORE CONTROLS if you do not see Apps to locate it.


https://admin.google.com


The Apps page displays. Click on Additional Google services.

The Additional Google services page displays. Click ADD SERVICES. There are several other ways to get to the ADD SERVICES screen.

On the ADD SERVICES page scroll to the bottom of the page and click SHOP NOW under Other Services > G Suite Marketplace.



The G Suite Marketplace public domain page displays. Since your application is deployed in My Domain, click on the hamburger icon on the upper left panel of the screen and scroll down and select Mail.accellion.net Apps.

All the applications on mail.accellion.net Apps will display. Locate your application, in this example, it is the DEMO.

Click on the DEMO app you just created and click DOMAIN INSTALL.

Click Continue to complete the installation. A window displays informing you the application is being loaded.



Click the Terms of Service checkbox to select it and click Accept.

When the DEMO application is installed, click DONE.

Go to My Drive and open one of the default extensions selected for this application. In the following example, a .pdf file is selected. Click Open with > GSuite Admin Demo for GDrive. The application you created is successfully installed and displays as a menu option as shown below.



Configuration Details for Share copy using Accellion

Drive API - Drive UI Integration

Name Settings File Name

Application Name Share copy Using Accellion

Short Description (Optional) Accellion Share File for Drive

Long Description (Optional) Accellion Share File for Drive

Icons

Application Icon

256 x 256128 x 12864 x 6432 x 3216 x 16

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:

sharecopy_app_icon_256x256sharecopy_app_icon_128x128sharecopy_app_icon_64x64sharecopy_app_icon_32x32sharecopy_app_icon_16x16

Document Icon (Optional) 256 x 256128 x 12864 x 6432 x 3216 x 16

Drive Integration

Authentication No changes

Open URL https://<Hostname>/gdrive/copy

Default MIME Types (Optional)

Default File Extensions (Optional) txtdocdocxxlsxlsxpptpptxpdfxml

Secondary MIME Types (Optional)

Secondary File Extensions

Multiple File Support Checked

Importing Checked



Configuration Details for G Suite Marketplace API

Publish


Application Information Language: English

Application name: Accellion Share File for Drive

Application description: Share file securely using Accellion

Add Language: (Optional)

Application Icons

256x256128x128 96x9648x4832x32


sharecopy_gsuite_icon_128x128sharecopy_gsuite_icon_96x96sharecopy_gsuite_icon_64x64sharecopy_gsuite_icon_48x48sharecopy_gsuite_icon_32x32

Support URLs Terms of service URL: <hostname>

OAuth 2.0 scope No changes

Extensions Select Drive extensions

Editor Add-on extension No changes

Google Analytics ID

Visibility Select My Domain (Only available to users at <domain name>


Detailed Description Language: English

Application detailed description: Secured file sharing using Accellion


Application Banner

220x140


sharecopy_app_banner_220x140

Screenshots 640x400

Links and information No changes

Reach Type: UtilitiesCountry:USSingaporeIndonesia



Configuration Details for Send File using Accellion



Application Name Send using Accellion

Short Description (Optional) Accellion Send File for Drive

Long Description (Optional) Accellion Send File for Drive

Icons

Application icon

Note: Use “Send File using Accellion Application Icons” from the zipped file. 256 x 256

128 x 12864 x 6432 x 3216 x 16


sendfile_app_icon_256x256sendfile_app_icon_128x128sendfile_app_icon_64x64sendfile_app_icon_32x32sendfile_app_icon_16x16

Document icon (Optional) 256 x 256128 x 12864 x 6432 x 3216 x 16

Drive integration


Open URL https://<Hostname>/gdrive/send

Default MIME Types (Optional)

Default File Extensions (Optional)

txtdocdocxxlsxlsxpptpptxpdfxml



Multiple file support Checked

Importing Checked




Publish


Application Info Language: English

Application name: Accellion Send File

Application description: Send file securely using Accellion


Application Icons

128x12896x96646448x4832x32

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:sendfile_gsuite_icon_128x128sendfile_gsuite_icon_96x96sendfile_gsuite_icon_64x64sendfile_gsuite_icon_48x48sendfile_gsuite_icon_32x32





Google Analytics ID




Application detailed description: Send file using Accellion


Application Banner

220x140

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:sendfile_app_banner_220x140

Screenshots 640x400


Reach Type: Utilities

Country:

US

Singapore

Indonesia



Configuration Details for Add Files using Accellion



Application Name Add from Accellion

Short Description (Optional) Add from Accellion

Long Description (Optional) Add from Accellion

Icons

Application icon

256 x 256128 x 12864 x 6432 x 3216 x 16

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:addfile_app_icon_256x256addfile_app_icon_128x128addfile_app_icon_64x64addfile_app_icon_32x32addfile_app_icon_16x16

Document icon (Optional) 256 x 256128 x 12864 x 6432 x 3216 x 16

Drive integration


Open URL https://<Hostname>/gdrive/add

Default MIME Types (Optional) application/vnd.google-apps.folder

Default File Extensions (Optional)



Multiple file support

Importing Checked




Publish


Application Info Language: English

Application name: Add Files from Accellion

Application description: Add file from Accellion to Google drive


Application Icons

128x12896x9664x6448x4832x32

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:addfile_gsuite_icon_128x128addfile_gsuite_icon_96x96addfile_gsuite_icon_64x64addfile_gsuite_icon_48x48addfile_gsuite_icon_32x32





Google Analytics ID




Application detailed description: Add file from Accellion


Application Banner

220x140

Note: Download “Accellion_for_Google_Drive_Plugin.zip” file to obtain the icon files listed below, from the kiteworks Admin UI > Client Management page:addfile_app_banner_220x140

Screenshots 640x400


Reach Type: Utilities

Country:

US

Singapore

Indonesia


Documents

1Accellion Google Drive App€¦ · To enable the app in Google Drive, you would need to follow a few steps as a G Suite administrator. Every menu option in Google Drive, for example,