Managing integrated applications

As a tenant’s administrator, you manage applications that your Users can use on CafeX.

Integrated applications provide the following:

• They retrieve content that your organization stores in the integrated application, allowing workspace members to view it
• Applications appear in a workspace's Add menu
• They let your Users select content to share on any workspace that they are members of.

For each application you install, you specify the following:

• whether to enable the application for your Users.
• whether your Users can configure their own accounts to share content.

Depending on the application, you specify the following configuration:

• Configuration from your office suite integration.
• Configuration to access your organization’s application account.
• Configuration to allow your Users to configure their own accounts

Important:

Your configuration applies to all the Users of your organization. A member of your workspace from another organization can use their own applications regardless of your configuration.

If you permit your Users to configure their own accounts for an application, then they can associate any account, including personal accounts, with CafeX.

Understanding application authorization

If you share resources and content from an application, CafeX uses the appropriate method of authorization to access and retrieve information from the application on behalf of your organization’s Users.  Each application provides its own method to delegate access to its content. Some applications provide OAuth 2.0, others provide API keys or access tokens to retrieve content.  CafeX makes the content available for to those who have permission to see it.

CafeX Enterprise application

The CafeX office suite integration installs an enterprise application into your organization’s Microsoft, or Google account.

The CafeX enterprise application uses 2-legged OAuth to act on behalf of your organization’s Users.

CafeX has the following enterprise applications:

• Microsoft Office 365
• G Suite

Organization application accounts

To use some applications CafeX uses an API key, or an access token, to act on behalf of your organization’s Users. CafeX uses the application’s API to act on behalf of your organization’s Users.

CafeX uses application accounts for the following applications:

• Box
• Slack
• Zendesk

Users' own accounts

To use some applications CafeX require that your organization Users use their own accounts with CafeX.  To use these applications, CafeX uses 3-legged OAuth to act on behalf of your organization Users.

Installing an application

As a tenant’s administrator, to install an application:

1. From the menu, click Tenant settings
2. Click Management > Applications
3. From the available applications, click Install for any that you require.
4. The applications you install appear under the Applications heading, where you configure the following:
   • Box
   • Dropbox
   • Google Drive
   • Jira
   • Microsoft OneDrive
   • Microsoft SharePoint
   • Microsoft Teams
   • Salesforce
   • Slack
   • Smartsheets
   • Zendesk

Some applications require that you verify CafeX in order to use them.

You have to enable applications to let workspace members use them.

Your network administrator has to allow access to an application so that your Users can use the application as themselves. See the documentation that the application provides for this information.

CafeX does not require additional ports and protocols to use the applications that you install unless the application configuration specifies.

Configuring an integrated application

As a tenant’s administrator, to configure an application:

1. Open your profile menu > Tenant settings
2. Click the application to enable under Management > Applications
3. As you require:
   • Check Enabled—Workspace members can see the application the add menu.
   • Check Allow member accounts—All workspace members to add their own accounts to share content.
   • If necessary, set application configuration for your organization’s account.
     See:
     1. Configuring the Jira application
     2. Configuring the Slack application
     3. Configuring Zendesk application
4. Click Update.

Verifying your CafeX integration with applications

As an application administrator, before you start using the following applications, you have to verify each of your CafeX integrations with them:

• Box

Using alternative file viewers in CafeX

When you open a workspace resource, CafeX picks a suitable viewer to show the the content.

If your organization implements access controls to applications, Users of your organization may not be able to view content that members add to workspaces.

As an administrator, you can instruct CafeX not to use these applications and use the default CafeX viewer for Users of your organization. This is helpful if your organization Users work with other organizations that use resources from applications that you typically do not allow access to.

As an administrator you can you can instruct CafeX to not use the following application viewers:

• Google Drive
• Google Viewer

As an tenant administrator, to change the file viewer settings:

1. Open your profile menu > Tenant Settings > File viewers
2. Set the options that you require: