Cloudability SaaS Connect Box to Cloudability SaaS

PURPOSE: Detailed info for admins (and Apptio internal) for exactly how to connect and ingest data from a particular source.

Whenever possible, this will all be on a single web page so that it can easily be output to PDF via "print", rather than managing a set of separate PDFs output from Flare.

What data is used by Cloudability SaaS from Box?

Box is integrated with Cloudability SaaS using the Box API.

For more information, refer to https://developer.box.com/reference/ .

Cloudability SaaS uses user and expense data from the Box API. The data is analyzed and displayed as useful insights in Cloudability SaaS .

The list of fields that are retrieved by the connector can be quite long and detailed. It's therefore in a drop-down so that it's easier to read through this intro if you're not wanting the detail:

View the data fields that are used by Cloudability SaaS from Box

Cloudability SaaS uses API calls to retrieve data from Box.

List user and enterprise events

For more information about this API call, refer to https://developer.box.com/reference/get-events/ .

Cloudability SaaS uses the data from the following fields:

chunk_size

entries

source (id)

event_id

next_stream_position

List enterprise users

For more information about this API call, refer to https://developer.box.com/reference/get-users/ .

Cloudability SaaS uses the data from the following fields:

total_count

limit

offset

entries

id

type

name

login

created_at

modified_at

language

timezone

space_amount

space_used

max_upload_size

status

job_title

phone

address

avatar_url

Request access token

For more information about this API call, refer to https://developer.box.com/reference/post-oauth2-token/ .

Cloudability SaaS uses the data from the following fields:

access_token

expires_in

refresh_token

token_type

Refresh access token

For more information about this API call, refer to https://developer.box.com/reference/post-oauth2-token--refresh/ .

Cloudability SaaS uses the data from the following fields:

access_token

expires_in

refresh_token

token_type

Calculated fields

Last login date

The last login date is based on the timestamp value returned from the get-events API call. For each audit log entry, the last login date is updated for the associated user.

If no audit log exist for that user then the date remains set to null.

Activity status

The last login date is used to determine when the user was last active; see Last login date .

If there is no last login date, then the user is marked as inactive.

Purchased license count

This value is set manually.

Used license count

The used license count is based on the number of users found by Cloudability SaaS with assigned licenses.

Before you start

Prerequisites, supported versions, , decisions you need to make (might XREFto a "best practice" topic or HREF to Community page)

Before you can integrate Box with Cloudability SaaS , you must have the following:

A Box account subscription at Starter (For Business Teams) level as a minimum.

For more information, refer to https://www.box.com/en-gb/pricing

The Box account must have Administrator permission levels.

For more information, refer to https://support.box.com/hc/en-us/articles/360043694174-Understanding-Administrator-and-Co-Administrator-Permissions.

Steps to connect

Connect Box to Cloudability SaaS .

Find the Box tile and select Connect .

Log in to Box.

Select Authorize .

Select Grant access to Box .

The browser will return to Cloudability SaaS .

Complete the steps in the License Wizard to add your Box license to Cloudability SaaS .

Confirm success

Use the wording below as a guide when describing a single connector. For example, a single application connected using an API connection.