diff --git a/content/guides/applications/app-types/index.md b/content/guides/applications/app-types/index.md index 1478ef57c..1fc7c5a44 100644 --- a/content/guides/applications/app-types/index.md +++ b/content/guides/applications/app-types/index.md @@ -7,7 +7,7 @@ alias_paths: - /docs/get-started-with-the-box-api - /docs/app-management - /docs/configuring-box-platform - - /guides/applications/custom-apps/ + - /guides/applications/platform-apps - /guides/applications/limited-access-apps/ - /guides/applications/custom-skills/ --- @@ -33,7 +33,7 @@ create. [jwt]: g://authentication/jwt [apptoken]: g://authentication/app-token [devtoken]: g://authentication/tokens/developer-tokens -[custom-apps]: g://applications/app-types/custom-apps +[custom-apps]: g://applications/app-types/platform-apps [custom-skills]: g://applications/app-types/custom-skills [ccg]: g://authentication/client-credentials [laa]: g://applications/app-types/limited-access-apps diff --git a/content/guides/applications/app-types/custom-apps.md b/content/guides/applications/app-types/platform-apps.md similarity index 81% rename from content/guides/applications/app-types/custom-apps.md rename to content/guides/applications/app-types/platform-apps.md index 093e3ffd5..8ef8a6cdf 100644 --- a/content/guides/applications/app-types/custom-apps.md +++ b/content/guides/applications/app-types/platform-apps.md @@ -12,18 +12,18 @@ related_guides: - authentication/client-credentials --- -# Custom App +# Platform App -Custom Apps encompass most use cases and is the most flexible application type. +Platform Apps encompass most use cases and is the most flexible application type. -A custom application typically presents Box functionality to a user within a +A platform application typically presents Box functionality to a user within a custom interface. Box offers pre-built, customizable user interface components, known as [UI Elements][uie], for functionality like browsing, searching, and previewing content. ## Authentication methods -Custom Apps support [OAuth 2.0][oauth2], [JWT][jwt], and +Platform Apps support [OAuth 2.0][oauth2], [JWT][jwt], and [Client Credentials Grant][cc]. @@ -32,7 +32,7 @@ Custom Apps support [OAuth 2.0][oauth2], [JWT][jwt], and ## When to use -A Custom App is best used when the application: +A Platform App is best used when the application: - Wants to use [OAuth 2.0][oauth2], [JWT][jwt] or [Client Credentials Grant][cc] for authentication. - Wants to upload and download files @@ -42,13 +42,13 @@ A Custom App is best used when the application: ## Use cases -Example use cases for a Custom App include: +Example use cases for a Platform App include: - A file vault in an application that allows an end user to access files that have been shared with them, while also providing access for employees to the same files through the Box Web app. An example of this is financial advisor sharing statements and investment prospectuses with investors that can be viewed and commented on within a - custom application. + platform application. - A file upload feature in an application that allows an end user to submit and upload files from within a custom-built application to Box. These uploads then initiate a business process with the Box Web app. @@ -58,10 +58,10 @@ Example use cases for a Custom App include: ## Approval -Custom Apps may require approval before use. +Platform Apps may require approval before use. - Learn how to approve Custom Apps + Learn how to approve Platform Apps [oauth2]: g://authentication/oauth2 diff --git a/content/guides/applications/app-types/select.md b/content/guides/applications/app-types/select.md index 964973c34..2804d5f40 100644 --- a/content/guides/applications/app-types/select.md +++ b/content/guides/applications/app-types/select.md @@ -22,18 +22,18 @@ You cannot change this selection later on. ![App Type Selection](images/select-app-type.png) -## Custom App +## Platform App | | | | -------------------------- | ---------------------------------------------------------------------------- | | **Authentication methods** | [OAuth 2.0][oauth2], [JWT][jwt], or [Client Credentials Authentication][ccg] | | **Notable Features** | Webhooks, Integrations, and Web App Integrations | -Custom App encompasses most use cases and is the most flexible option. +Platform App encompasses most use cases and is the most flexible option. This application type allows for interaction with our 150+ endpoints. For example, downloading/uploading, searching, applying metadata and more. -Learn more about Custom Apps +Learn more about Platform Apps ## Limited Access App @@ -65,7 +65,7 @@ from files uploaded to Box. [oauth2]: g://authentication/oauth2 [jwt]: g://authentication/jwt [app-token]: g://authentication/app-token -[custom-apps]: g://applications/app-types/custom-apps +[custom-apps]: g://applications/app-types/platform-apps [dev-console]: https://app.box.com/developers/console [view-app]: g://embed/box-view [ccg]: g://authentication/client-credentials diff --git a/content/guides/applications/web-app-integrations/configure.md b/content/guides/applications/web-app-integrations/configure.md index 9fd052a53..733f6a886 100644 --- a/content/guides/applications/web-app-integrations/configure.md +++ b/content/guides/applications/web-app-integrations/configure.md @@ -14,7 +14,7 @@ notes: |- # Create Web App Integration -This guide explains how to set up a Web App Integration with a Custom App. +This guide explains how to set up a Web App Integration with a Platform App. Server-side integration is no longer supported. @@ -26,7 +26,7 @@ You will be able to deactivate them and change the implementation to a new one. ## Create an OAuth 2.0 Application -Navigate to the [Developer Console][devconsole] and create a [Custom App][ca] +Navigate to the [Developer Console][devconsole] and create a [Platform App][ca] that leverages [OAuth 2.0 authentication][custom-oauth2]. ## Create a New Integration @@ -141,7 +141,7 @@ note that the URL must be publicly accessible on the internet. To make a Box integration publicly available it needs to be listed in the App Center. Follow the [Integrations][integrations] guide for more details. -[ca]: g://applications/app-types/custom-apps +[ca]: g://applications/app-types/platform-apps [pu]: g://applications/web-app-integrations/types [uid]: page://platform/appendix/locating-values/#user-ids [fid]: page://platform/appendix/locating-values/#content-ids diff --git a/content/guides/authentication/app-token/app-token-setup.md b/content/guides/authentication/app-token/app-token-setup.md index c4b6b5234..f81db8861 100644 --- a/content/guides/authentication/app-token/app-token-setup.md +++ b/content/guides/authentication/app-token/app-token-setup.md @@ -9,7 +9,7 @@ related_guides: - authorization/custom-app-approval required_guides: - authentication/select - - applications/app-types/custom-apps + - applications/app-types/platform-apps related_resources: [] alias_paths: - /guides/applications/app-types/custom-apps/app-token-setup diff --git a/content/guides/authentication/client-credentials/client-credentials-setup.md b/content/guides/authentication/client-credentials/client-credentials-setup.md index 54beb71b7..ff7a8034b 100644 --- a/content/guides/authentication/client-credentials/client-credentials-setup.md +++ b/content/guides/authentication/client-credentials/client-credentials-setup.md @@ -18,7 +18,7 @@ alias_paths: ## Prerequisites -To set up a Custom App using server-side authentication, you will need to ensure +To set up a Platform App using server-side authentication, you will need to ensure you have access to the [Developer Console][devconsole] from your Box enterprise account. Alternatively, you may sign up for a [developer account][devaccount]. @@ -31,7 +31,7 @@ Select **Create Platform App**. ### Select application type -Select **Custom App** from the list of application types. A modal will appear to +Select **Platform App** from the list of application types. A modal will appear to prompt a selection for the next step. @@ -88,7 +88,7 @@ approval. More information on this process is available in our [authorization guide][app-auth]. - Learn how to authorize a Custom Application + Learn how to authorize a Platform Application ## Basic configuration diff --git a/content/guides/authentication/client-credentials/index.md b/content/guides/authentication/client-credentials/index.md index 842d1a043..ff82d2ac7 100644 --- a/content/guides/authentication/client-credentials/index.md +++ b/content/guides/authentication/client-credentials/index.md @@ -20,7 +20,7 @@ verify your application's identity using a client ID and client secret. ## Prerequisites -- A Custom Application using Server Authentication (with Client Credentials Grant) authentication in the Box [Developer Console][devconsole] +- A Platform Application using Server Authentication (with Client Credentials Grant) authentication in the Box [Developer Console][devconsole] - [2FA][2fa] enabled on your Box account for viewing and copying the application's client secret from the configuration tab - The application is [authorized][auth] in the Box Admin Console diff --git a/content/guides/authentication/index.md b/content/guides/authentication/index.md index 094a766f6..8fc59d3c2 100644 --- a/content/guides/authentication/index.md +++ b/content/guides/authentication/index.md @@ -15,7 +15,7 @@ console. | Box Application Type | Authentication methods | | ---------------------------- | ------------------------------------------------------------------- | -| [Custom App][custom-app] | [OAuth 2.0][oauth2], [JWT][jwt], or [Client Credentials Grant][ccg] | +| [Platform App][custom-app] | [OAuth 2.0][oauth2], [JWT][jwt], or [Client Credentials Grant][ccg] | | [Limited Access App][la] | [App token][apptoken] | | [Custom Skill][custom-skill] | No authentication method selection needed | @@ -42,7 +42,7 @@ curl https://api.box.com/2.0/users/me \ [jwt]: g://authentication/jwt [apptoken]: g://authentication/app-token [devtoken]: g://authentication/tokens/developer-tokens -[custom-app]: g://applications/app-types/custom-apps +[custom-app]: g://applications/app-types/platform-apps [custom-skill]: g://applications/app-types/custom-skills [la]: g://applications/app-types/select/#limited-access-app [ccg]: g://authentication/client-credentials diff --git a/content/guides/authentication/jwt/index.md b/content/guides/authentication/jwt/index.md index b4a87bdd4..12a294da6 100644 --- a/content/guides/authentication/jwt/index.md +++ b/content/guides/authentication/jwt/index.md @@ -22,7 +22,7 @@ designed to allow powerful server-to-server authentication. ![The JWT flow](./jwt-flow.png) -Server-side authentication using JWT is only available to the Custom Application +Server-side authentication using JWT is only available to the Platform Application [app type][app-type]. This authentication method does not require end-user interaction and, if granted the proper privileges, can be used to act on behalf of any user in an enterprise. diff --git a/content/guides/authentication/jwt/jwt-setup.md b/content/guides/authentication/jwt/jwt-setup.md index 942052674..7935eb518 100644 --- a/content/guides/authentication/jwt/jwt-setup.md +++ b/content/guides/authentication/jwt/jwt-setup.md @@ -5,7 +5,7 @@ related_guides: - authentication/jwt required_guides: - authentication/select - - applications/app-types/custom-apps + - applications/app-types/platform-apps - authorization/custom-app-approval related_resources: [] alias_paths: diff --git a/content/guides/authentication/jwt/without-sdk.md b/content/guides/authentication/jwt/without-sdk.md index 30792f848..745b45d20 100644 --- a/content/guides/authentication/jwt/without-sdk.md +++ b/content/guides/authentication/jwt/without-sdk.md @@ -41,7 +41,7 @@ using a public and private key pair. ### Prerequisites -- A Custom Application using JWT authentication within the [Developer Console][devconsole] +- A Platform Application using JWT authentication within the [Developer Console][devconsole] - A private key configuration file named `config.json`, which can be downloaded from the configuration tab of the [Developer Console][devconsole] - Ensure your application is [authorized][auth] within the Box Admin Console diff --git a/content/guides/authentication/oauth2/oauth2-setup.md b/content/guides/authentication/oauth2/oauth2-setup.md index edc50de67..f1f48d741 100644 --- a/content/guides/authentication/oauth2/oauth2-setup.md +++ b/content/guides/authentication/oauth2/oauth2-setup.md @@ -6,7 +6,7 @@ related_guides: - authentication/oauth2/oauth2-setup required_guides: - authentication/select - - applications/app-types/custom-apps + - applications/app-types/platform-apps related_resources: [] alias_paths: - /docs/setting-up-an-oauth-app @@ -15,7 +15,7 @@ alias_paths: # Setup with OAuth 2.0 -A Custom App can be set up to use client-side [OAuth 2.0][oauth2] authentication. +A Platform App can be set up to use client-side [OAuth 2.0][oauth2] authentication. Learn how OAuth 2.0 authentication works @@ -23,7 +23,7 @@ A Custom App can be set up to use client-side [OAuth 2.0][oauth2] authentication ## Prerequisites -To set up a Custom App using OAuth 2.0 authentication, you will need to ensure +To set up a Platform App using OAuth 2.0 authentication, you will need to ensure you have access the [Developer Console][devconsole] from your Box enterprise account. Alternatively, you may sign up for a [developer account][devaccount]. @@ -36,7 +36,7 @@ Log into Box and go to the ### Select application type -Select **Custom App** from the list of application types. A modal will appear to +Select **Platform App** from the list of application types. A modal will appear to prompt a selection for the next step. diff --git a/content/guides/authentication/oauth2/without-sdk.md b/content/guides/authentication/oauth2/without-sdk.md index c05bda81e..d0c52634a 100644 --- a/content/guides/authentication/oauth2/without-sdk.md +++ b/content/guides/authentication/oauth2/without-sdk.md @@ -42,7 +42,7 @@ using the `as-user` header. Before continuing you will need to complete the following steps: -- Create a Custom App within the Box Developer Console, which leverages the OAuth 2.0 authentication method. +- Create a Platform App within the Box Developer Console, which leverages the OAuth 2.0 authentication method. - Navigate to the configuration tab for the application to copy the `client_id` and `client_secret` values. - Ensure at least one redirect URI is configured in the configuration tab for the application. diff --git a/content/guides/authentication/select.md b/content/guides/authentication/select.md index 3c0fed288..fa20e8183 100644 --- a/content/guides/authentication/select.md +++ b/content/guides/authentication/select.md @@ -21,7 +21,7 @@ The following authorization methods are available to each Box application type. | Box Application Type | Supports OAuth 2.0? | JWT? | Client Credentials? | App Token? | | ---------------------------- | ------------------- | ---- | ------------------- | ---------- | -| [Custom App][custom-app] | Yes | Yes | Yes | No | +| [Platform App][custom-app] | Yes | Yes | Yes | No | | [Limited Access App][la-app] | No | No | No | Yes | | [Custom Skill][custom-skill] | No | No | No | No | @@ -157,6 +157,6 @@ authentication the token defaults to the application's Service Account. -[custom-app]: g://applications/app-types/custom-apps +[custom-app]: g://applications/app-types/platform-apps [custom-skill]: g://applications/app-types/custom-skills [la-app]: g://applications/app-types/limited-access-apps diff --git a/content/guides/authentication/sso.md b/content/guides/authentication/sso.md index e434b7a36..b39684d1e 100644 --- a/content/guides/authentication/sso.md +++ b/content/guides/authentication/sso.md @@ -5,7 +5,7 @@ related_guides: - authentication/oauth2 - authentication/jwt - authentication/app-token - - applications/app-types/custom-apps + - applications/app-types/platform-apps - applications/app-types/custom-skills required_guides: [] related_resources: [] @@ -19,9 +19,9 @@ Many Box Enterprises use **Single Sign On** (SSO) to authenticate Box Platform interact with an SSO provider depends on the type of application being built. -## Custom Apps with Client-side Authentication +## Platform Apps with Client-side Authentication -When users authenticate with a [Custom App][custom_app] configured to use +When users authenticate with a [Platform App][custom_app] configured to use [OAuth 2.0][oauth2] Box will detect if the enterprise is configured to use SSO. If it is, Box will redirect the user to their browser and display the enterprise's configured SSO log-in screen. @@ -47,14 +47,14 @@ having a Box account matching the email address passed via SAML. set to required, even if it is only used for platform use cases. -## Custom Apps with Server-side Authentication +## Platform Apps with Server-side Authentication -For [Custom Apps][custom_app] that use [JWT][jwt] or +For [Platform Apps][custom_app] that use [JWT][jwt] or [Client Credentials Grant][ccg] and [Limited Access Apps][la-app] that use [App Token][app_token] authentication, SSO is not used to authenticate with Box. -Custom Apps using server-side authentication only use server-to-server API +Platform Apps using server-side authentication only use server-to-server API calls to communicate with Box. In this scenario, the way in which an end user is authenticated is determined by the application and not by Box. @@ -89,6 +89,6 @@ therefore SSO is not involved. [ccg]: g:///authentication/client-credentials [la-app]: guide://applications/web-app-integrations [app_token]: g://authentication/app-token -[custom_app]: g://applications/app-types/custom-apps +[custom_app]: g://applications/app-types/platform-apps [custom_skills]: g://applications/app-types/custom-skills [jwt]: g://authentication/jwt/jwt-setup diff --git a/content/guides/authentication/tokens/index.md b/content/guides/authentication/tokens/index.md index e3a4ab7f3..3008d21b4 100644 --- a/content/guides/authentication/tokens/index.md +++ b/content/guides/authentication/tokens/index.md @@ -38,9 +38,9 @@ Token. | Box Application Type | How to get Access Token | | ------------------------------------- | ------------------------------------------------ | -| Custom App + OAuth 2.0 | [Explicit user grant][oauth2-with-sdk] | -| Custom App + JWT | [Exchange a JWT assertion][jwt-with-sdk] | -| Custom App + Client Credentials Grant | [Use client ID and client secret][clientcred] | +| Platform App + OAuth 2.0 | [Explicit user grant][oauth2-with-sdk] | +| Platform App + JWT | [Exchange a JWT assertion][jwt-with-sdk] | +| Platform App + Client Credentials Grant | [Use client ID and client secret][clientcred] | | Limited Access App + App Token | Configure token in [Developer Console][devcon] | | Custom Skill | Access Token in event payload | diff --git a/content/guides/authorization/custom-app-approval.md b/content/guides/authorization/custom-app-approval.md index 4b96512ab..9281ebc21 100644 --- a/content/guides/authorization/custom-app-approval.md +++ b/content/guides/authorization/custom-app-approval.md @@ -12,7 +12,7 @@ alias_paths: - /guides/applications/custom-apps/app-approval --- -# Custom App Approval +# Platform App Approval Server authentication applications using [JWT][jwt] or [Client Credentials Grant][ccg] must be authorized by a Box Admin before use. @@ -31,7 +31,7 @@ the authorization and enablement status of your application. ## Approval Notifications A semi-automated process to submit an app approval is available in the Developer -Console for all custom application types. +Console for all platform application types. ### Server authentication apps diff --git a/content/guides/authorization/platform-app-approval.md b/content/guides/authorization/platform-app-approval.md index 0546cfd4c..23f3349bb 100644 --- a/content/guides/authorization/platform-app-approval.md +++ b/content/guides/authorization/platform-app-approval.md @@ -81,9 +81,9 @@ copy it using the `copy` button. ### As an Admin 1. Navigate to the [Admin Console][adminconsole] and select the **Apps** tab (1) from the left navigation panel. -2. Click the **Custom Apps Manager** tab (2) at the top of your screen. +2. Click the **Platform Apps Manager** tab (2) at the top of your screen. 3. For both Server and User Authentication Apps screens, click the **Add App** (3) button in the top right corner to add a new app. -4. Alternatively, you can use the Custom Apps Manager table menu (4) to authorize and enable apps. +4. Alternatively, you can use the Platform Apps Manager table menu (4) to authorize and enable apps. #### Server Authentication Apps diff --git a/content/guides/box-ai/ai-tutorials/prerequisites.md b/content/guides/box-ai/ai-tutorials/prerequisites.md index cbeb491de..000e14012 100644 --- a/content/guides/box-ai/ai-tutorials/prerequisites.md +++ b/content/guides/box-ai/ai-tutorials/prerequisites.md @@ -82,7 +82,7 @@ calls. [token]: g://authentication/tokens/developer-tokens [scope]: g://api-calls/permissions-and-errors/scopes [oauthscopes]: g://api-calls/permissions-and-errors/scopes#scopes-oauth-2-authorization -[createapps]: g://applications/app-types/custom-apps +[createapps]: g://applications/app-types/platform-apps [postman]: g://tooling/postman [form]: https://forms.gle/Nsh3TwM3W8qg4U35A [authorization]: g://authorization diff --git a/content/guides/cli/quick-start/1-create-oauth-app.md b/content/guides/cli/quick-start/1-create-oauth-app.md index 02d085bb7..f69502c63 100644 --- a/content/guides/cli/quick-start/1-create-oauth-app.md +++ b/content/guides/cli/quick-start/1-create-oauth-app.md @@ -103,7 +103,7 @@ extra steps to set up. * You either selected to create a new **Box App** * Signed up for a developer account (Optional) - * Had us create a **Custom App** for you that uses **OAuth 2.0** authentication + * Had us create a **Platform App** for you that uses **OAuth 2.0** authentication * Had us set up the **redirect URL** for the application * Or you selected to use an **existing Box App** diff --git a/content/guides/collaborations/connect-slack-to-group-collabs/2-configure-box.md b/content/guides/collaborations/connect-slack-to-group-collabs/2-configure-box.md index aaa017bb7..96bb71584 100644 --- a/content/guides/collaborations/connect-slack-to-group-collabs/2-configure-box.md +++ b/content/guides/collaborations/connect-slack-to-group-collabs/2-configure-box.md @@ -33,7 +33,7 @@ collaborators to files and folders in Box. 1. Go to the [Developer Console][devconsole] 2. Select **Create New App** - 3. Select **Custom App** as the type of application to create, and click **Next** + 3. Select **Platform App** as the type of application to create, and click **Next** 4. Select **OAuth 2.0 with JWT** as the authentication method, and click **Next** 5. Give your Box app a unique name and click **Create App** 6. Go to the app's configuration by clicking **View Your App**. diff --git a/content/guides/docgen/docgen-getting-started.md b/content/guides/docgen/docgen-getting-started.md index 021639119..cfdd8b7ba 100644 --- a/content/guides/docgen/docgen-getting-started.md +++ b/content/guides/docgen/docgen-getting-started.md @@ -63,7 +63,7 @@ or other clients, such as [Postman][postman], to make calls. [token]: g://authentication/tokens/developer-tokens -[createapps]: g://applications/app-types/custom-apps +[createapps]: g://applications/app-types/platform-apps [postman]: g://tooling/postman [settings]: https://support.box.com/hc/en-us/articles/4404822772755-Enterprise-Settings-Content-Sharing-Tab#h_01FYQGK5RW42T07GV985MQ9E9A [template-addin]: https://support.box.com/hc/en-us/articles/36587535449747-Installing-Box-Doc-Gen-Add-in diff --git a/content/guides/getting-started/first-application.md b/content/guides/getting-started/first-application.md index 819c539f6..62884e84e 100644 --- a/content/guides/getting-started/first-application.md +++ b/content/guides/getting-started/first-application.md @@ -15,12 +15,12 @@ If this is your first application, you will be prompted to get started. ## Choose application type The first step is to select the application type you want to create. -In this guide we use the **Custom App** option, as most of our partners +In this guide we use the **Platform App** option, as most of our partners use this type for their integrations. ## Choose the authentication method -After you choose the **Custom App**, you need to [select an authentication +After you choose the **Platform App**, you need to [select an authentication method][auth] that your app will use. In this guide we use the [**User Authentication (OAuth 2.0)**][oauth2] option, as most of our partners use this type for their integrations. diff --git a/content/guides/integration-mappings/slack-mappings/setup.md b/content/guides/integration-mappings/slack-mappings/setup.md index 3ee2b09f4..ea834401c 100644 --- a/content/guides/integration-mappings/slack-mappings/setup.md +++ b/content/guides/integration-mappings/slack-mappings/setup.md @@ -63,5 +63,5 @@ Authorization: Bearer {developer_token} [4]: g://authentication/oauth2/oauth2-setup [5]: https://app.box.com/developers/console [6]: e://get-integration-mappings-slack -[7]: g://applications/app-types/custom-apps +[7]: g://applications/app-types/platform-apps [8]: g://authentication/tokens/developer-tokens \ No newline at end of file diff --git a/content/guides/mobile/ios/quick-start/3-configure-box-app.md b/content/guides/mobile/ios/quick-start/3-configure-box-app.md index 1afd247b5..215b0d1ff 100644 --- a/content/guides/mobile/ios/quick-start/3-configure-box-app.md +++ b/content/guides/mobile/ios/quick-start/3-configure-box-app.md @@ -37,7 +37,7 @@ valid for one hour before having to be manually refreshed. 1. Go to the [Developer Console][devconsole] > **My Platform Apps**. 2. Select **Create Platform App**. - 3. Select **Custom App** as the type of application to create, and click **Next**. + 3. Select **Platform App** as the type of application to create, and click **Next**. 4. Enter the **App Name**, an optional **Description** and **Purpose** of the App. Confirm with **Next**. 5. Select **User Authentication (OAuth 2.0)** as the authentication method, and click **Create App** 8. Optionally, scroll to the **Application Scopes** section of the same screen and select any additional permissions you want to enable for this application. diff --git a/content/guides/tooling/postman/quick-start/2-configure-box-app.md b/content/guides/tooling/postman/quick-start/2-configure-box-app.md index 11665e48a..3866d8742 100644 --- a/content/guides/tooling/postman/quick-start/2-configure-box-app.md +++ b/content/guides/tooling/postman/quick-start/2-configure-box-app.md @@ -2,7 +2,7 @@ type: quick-start hide_in_page_nav: true related_guides: - - applications/app-types/custom-apps + - applications/app-types/platform-apps --- # Configure a Box App @@ -108,7 +108,7 @@ extra steps to set up. * You either selected to create a new **Box App** * Signed up for a developer account (Optional) - * Had us create **Custom App** for you that uses **OAuth 2.0** authentication + * Had us create **Platform App** for you that uses **OAuth 2.0** authentication * Had us set up the **redirect URL** for the application * Or you selected to use an **existing Box App** diff --git a/content/guides/users/provision/architecture.md b/content/guides/users/provision/architecture.md index cada93235..4d3a9a106 100644 --- a/content/guides/users/provision/architecture.md +++ b/content/guides/users/provision/architecture.md @@ -29,7 +29,7 @@ for users, and instead, can use a Service Account in more of an automation capacity. - # Box Custom Application Requirements + # Box Platform Application Requirements When creating your JWT-based custom Box application for this recipe, you'll need to enable the following scopes: **Manage users**, **Manage groups**, diff --git a/content/pages/platform/application-types.md b/content/pages/platform/application-types.md index bb2c5a291..8859b34e1 100644 --- a/content/pages/platform/application-types.md +++ b/content/pages/platform/application-types.md @@ -9,14 +9,14 @@ Box offers various application types to cater to different needs and use cases in application development. Each provides different capabilities and authentication method options. -## Custom App +## Platform App -[Custom Apps][custom_app] are versatile and can accommodate most use cases. +[Platform Apps][custom_app] are versatile and can accommodate most use cases. They allow developers to present Box functionalities within a custom interface. Box provides customizable UI Elements for tasks like browsing, searching, and previewing content. These apps support OAuth 2.0, JWT, and Client Credentials -Grant for authentication. Custom Apps are ideal for applications that need to +Grant for authentication. Platform Apps are ideal for applications that need to access both their own and others' files, upload and download files, and potentially be listed in the Box Integrations. @@ -67,7 +67,7 @@ sections in the Integrations, and they can also be unpublished if necessary. Next step -[custom_app]: g://applications/app-types/custom-apps +[custom_app]: g://applications/app-types/platform-apps [limited_app]: g://applications/app-types/limited-access-apps [skills]: g://applications/app-types/custom-skills [web_app]: g://applications/web-app-integrations diff --git a/content/pages/platform/authentication-methods.md b/content/pages/platform/authentication-methods.md index 661282723..19195695b 100644 --- a/content/pages/platform/authentication-methods.md +++ b/content/pages/platform/authentication-methods.md @@ -16,7 +16,7 @@ The following authorization methods are available to each Box application type. | Box Application Type | Supports OAuth 2.0? | JWT? | Client Credentials? | App Token? | | ---------------------------- | ------------------- | ---- | ------------------- | ---------- | -| Custom App | Yes | Yes | Yes | No | +| Platform App | Yes | Yes | Yes | No | | Limited Access App | No | Yes | No | Yes | | Custom Skill | No | No | No | No | @@ -48,7 +48,7 @@ You can find a great Python OAuth 2.0 tutorial on [GitHub][python_oauth]. JSON Web Tokens (JWT) is the most common server-side authentication method for the Box API. [JWT][jwt], an open standard, enables robust server-to-server -authentication. This method, exclusive to Custom Apps, does not involve +authentication. This method, exclusive to Platform Apps, does not involve end-user interaction. It allows an app, if granted appropriate privileges, to act on behalf of any user in an enterprise, thus facilitating powerful and seamless integrations. Upon approval by an administrator, a JWT application diff --git a/content/pages/platform/box-glossary.md b/content/pages/platform/box-glossary.md index 72d96a749..16fabe2ea 100644 --- a/content/pages/platform/box-glossary.md +++ b/content/pages/platform/box-glossary.md @@ -38,7 +38,7 @@ to find out what a term means, this is your one stop page. | Collection | | A collection of items, including files and folders. The contents of a collection can be explored in a similar way to which the contents of a folder is explored. | | [Content Manager][content-manager] | | A feature in the Admin Console that allows you to: search for and download files and folders in your organization, browse by user to see the files and folders they can access, move files between folders, invite collaborators to folders, get shared links and modify access levels, and delete files and folders from any user’s trash. | | [Co-admin][co-admin] | | A user other than the main admin, who has a subset of administrative privileges. Co-admins can perform the same duties as the organization’s admin, but they cannot make changes to the Admin’s permissions or other co-admins' permissions. The default access levels for co-admins include only the ability to manage users and groups, but they can be modified on a per-user basis. | -| [Custom App][custom-app] | | A tailored application that extends the functionality of Box by integrating with other tools and systems. It's used to streamline workflows and enhance collaboration. It can be created in the Developer Console and has several authentication methods available. | +| [Platform App][custom-app] | | A tailored application that extends the functionality of Box by integrating with other tools and systems. It's used to streamline workflows and enhance collaboration. It can be created in the Developer Console and has several authentication methods available. | | Developer | Programmer | A skilled professional who designs, builds, and maintains software applications or systems and has access to the Developer Console. In Box, the developer can have an admin role. | | [Developer Console][dev-console] | | A portal that allows developers to create, debug, test, and monitor their applications by providing real-time insights into code execution and system performance. | | Enterprise | Repository, content store, file cabinet, Docbase, vault | Enterprise in Box is a comprehensive suite of tools and services provided by Box for large organizations, offering secure file storage, collaboration features, access controls, workflow automation, compliance enforcement, and analytics. It enables efficient document management and teamwork while ensuring data security within an enterprise setting. | @@ -97,7 +97,7 @@ to find out what a term means, this is your one stop page. [shield]: https://www.box.com/en-gb/shield [skills]: g://skills [classification]: g://metadata/classifications -[custom-app]: g://applications/app-types/custom-apps +[custom-app]: g://applications/app-types/platform-apps [webhook]: g://webhooks [limited-app]: g://applications/app-types/limited-access-apps [service-account]: page://platform/user-types/#service-account diff --git a/content/pages/platform/box-platform-101.md b/content/pages/platform/box-platform-101.md index 7bf525e06..544cbb296 100644 --- a/content/pages/platform/box-platform-101.md +++ b/content/pages/platform/box-platform-101.md @@ -97,7 +97,7 @@ web app, they should be able to access it using the API. ### Application Type There are three main types of applications that can be created in the developer -console. They include Custom App, Limited Access App, and Box Custom Skills. You +console. They include Platform App, Limited Access App, and Box Custom Skills. You can also create third party and web app integrations. diff --git a/content/pages/platform/user-types.md b/content/pages/platform/user-types.md index 0378dbd06..f5bbc8d4d 100644 --- a/content/pages/platform/user-types.md +++ b/content/pages/platform/user-types.md @@ -192,7 +192,7 @@ Account. A Service Account is also automatically generated when a Limited Access App is created in the [Developer Console][dc]. This Service Account has some additional -restrictions that a Service Account associated with a Custom App does not. +restrictions that a Service Account associated with a Platform App does not. - All content used within the Limited Access App must be uploaded and owned by the Service Account - The Service Account can not access any other user's information or content diff --git a/docs/markdown.md b/docs/markdown.md index b4b374fd3..e14cf7e98 100644 --- a/docs/markdown.md +++ b/docs/markdown.md @@ -165,7 +165,7 @@ names. ## Standards for Box terminology -* Custom App refers to the type of app selected in the create new app flow +* Platform App refers to the type of app selected in the create new app flow whereas custom application refers to the custom solution built by the customer * Access Token * Box Admin