This document covers all information related to the Box connector.
Scope | Purpose |
---|---|
Read all files/folders in Box | List all files from user drives |
Read and write all files and folders stored in Box | Required to download file content into Glean (despite saying write). |
Manage users | List users and associated group memberships |
Manage groups | List all groups |
Manage enterprise properties | Crawl recent enterprise logs activity to ingest newly created/modified data |
Admin can make calls on behalf of Users | Use the As-User header, to distribute rate limits between different owners of files. |
Use Case | Endpoint | Documentation |
---|---|---|
Refresh access token https://api.box.com/oauth2/token | Refresh an Access Token using its client ID, secret, and refresh token. | Refresh access token - Box API |
Use Case | Endpoint | Documentation |
---|---|---|
List enterprise users https://api.box.com/2.0/users | Determine which users (and associated content) need to be indexed. | List enterprise users - Box API |
List groups for enterprise https://api.box.com/2.0/groups | Fetch all groups within a tenant (for permissions). | List groups for enterprise - Box API |
List Enterprise Users https://api.box.com/2.0//:group_id/memberships | Determine which users are members of which group (for permissions). | List members of group - Box API |
Use Case | Endpoint | Documentation |
---|---|---|
List items in folder https://api.box.com/2.0/folders/:folder_id/items | List all items and content within a folder for indexing. | List items in folder - Box API |
Get file information https://api.box.com/2.0/files/:file_id | Retrieve metadata for each specific item for indexing. | Get file information - Box API |
List file collaborations https://api.box.com/2.0/files/:file_id/collaborations | Retrieve a list of all users with access to an item (for permissions). | List file collaborations - Box API |
Use Case | Endpoint | Documentation |
---|---|---|
List user and enterprise events https://api.box.com/2.0/events | Fetch activity data for each user for ranking signals (12 month limit). | List user and enterprise events - Box API |