diff --git a/content/guides/authorization/custom-app-approval.md b/content/guides/authorization/custom-app-approval.md index ae1316ecb..4b96512ab 100644 --- a/content/guides/authorization/custom-app-approval.md +++ b/content/guides/authorization/custom-app-approval.md @@ -75,7 +75,7 @@ copy it using the `copy` button. If you don't know your enterprise Admin, go to your Box [Account Settings][settings] page and scroll to the bottom. If an admin contact is set - you should see their contact information under "Admin Contact". + you should see their contact information under **Admin Contact**. ### As an Admin @@ -88,7 +88,7 @@ copy it using the `copy` button. #### Server Authentication Apps - ![Server tab](images/jwt_app_approval_flow.png) + ![Server tab](images/oauth_app_approval_flow.png) #### User Authentication Apps diff --git a/content/guides/authorization/images/jwt_app_approval_flow.png b/content/guides/authorization/images/jwt_app_approval_flow.png index cd604682a..31af54cff 100644 Binary files a/content/guides/authorization/images/jwt_app_approval_flow.png and b/content/guides/authorization/images/jwt_app_approval_flow.png differ diff --git a/content/guides/authorization/images/oauth_app_approval_flow.png b/content/guides/authorization/images/oauth_app_approval_flow.png index 3cf64aeda..72aad5cca 100644 Binary files a/content/guides/authorization/images/oauth_app_approval_flow.png and b/content/guides/authorization/images/oauth_app_approval_flow.png differ diff --git a/content/guides/authorization/images/reauthorize_app.png b/content/guides/authorization/images/reauthorize_app.png index 78666a370..8b5763a8d 100644 Binary files a/content/guides/authorization/images/reauthorize_app.png and b/content/guides/authorization/images/reauthorize_app.png differ diff --git a/content/guides/authorization/index.md b/content/guides/authorization/index.md index bc9d88b6e..94934f206 100644 --- a/content/guides/authorization/index.md +++ b/content/guides/authorization/index.md @@ -33,16 +33,16 @@ Admin authorization based on enabled enterprise settings. Subsequent steps are required if any of the following enterprise settings are enabled: -- Disable published Integrations by default -- Disable unpublished Integrations by default -- Require manual admin authorization for transactional access apps +- Disable published third party apps by default +- Disable unpublished apps by default +- Require manual Admin authorization for Limited Access Apps These [settings][setting] can be found by navigating to: -**Admin Console** > **Apps** > **Platform Apps** > click the ⚙ icon +**Admin Console** > **Integrations** > **Platform Apps Manager** > **Platform Apps Settings** button. - Published integrations are any applications that can be found in our App Center. + Published Platform Apps are any applications that can be found under Integrations. ## Required actions @@ -51,7 +51,7 @@ To see what steps an Admin must complete for a given app, review the following scenarios. -**Disable Integrations by default**: +**Disable published third party apps by default**: | Authentication Method | Enabled | Disabled | ------------------------------------------------ | ------------------------------------------- | -------------- | @@ -60,23 +60,23 @@ scenarios. |[Server Authentication (client credentials)][cc] | N/A | N/A | |[App Token Authentication][apptoken] | N/A | N/A | -**Disable unpublished integrations by default**: +**Disable unpublished apps by default**: | Authentication Method | Enabled | Disabled | ------------------------------------------------ | ----------------------------------------------------------------------------------- | --------------------------------------- | -|[OAuth 2.0][standauth] | Enable in **Apps** > **Platform Apps Manager** > **User Authentication Apps** > **Platform App** | Ready for use | -|[Server Authentication (with JWT)][jwt] | Authorize and enable in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > **Add Platform App** | Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > **Add Platform App** | -|[Server Authentication (client credentials)][cc] | Authorize and enable in **Apps** > **Platform Apps Manager** > **Server Authentication Apps** | Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > **Add Platform App** | -|[App Token Authentication][apptoken] | Authorize and enable in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > **Server Authentication Apps** > **Add Platform App** | Ready for use | +|[OAuth 2.0][standauth] | Enable in **Integrations** > **Platform Apps Manager** > **User Authentication Apps** > Select Platform App > Use **More** menu to enable the app. | Ready for use | +|[Server Authentication (with JWT)][jwt] | Authorize and enable in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** Select Platform App > Use **More** menu to authorize the app. | Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > Select Platform App > Use **More** menu to authorize the app. | +|[Server Authentication (client credentials)][cc] | Authorize and enable in **Apps** > **Platform Apps Manager** > **Server Authentication Apps** > Select Platform App > Use **More** menu to authorize the app.| Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > Select Platform App > Use **More** menu to enable the app. | +|[App Token Authentication][apptoken] | Authorize and enable in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** > **Server Authentication Apps** > Select Platform App > Use **More** menu to enable the app. | Ready for use | -**Require manual admin authorization for transactional access apps**: +**Require manual Admin authorization for Limited Access Apps**: | Authentication Method | Enabled | Disabled | | ------------------------------------------------ | ------------------------------------------------------------------------ | ---------------------------------------------------- | |[OAuth 2.0][standauth] | N/A | N/A | |[Server Authentication (with JWT)][jwt] | N/A | N/A | |[Server Authentication (client credentials)][cc] | N/A | N/A | -|[App Token Authentication][apptoken] | Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** | Automatically authorized and enabled upon creation | +|[App Token Authentication][apptoken] | Authorize in **Integrations** > **Platform Apps Manager** > **Server Authentication Apps** Select Platform App > Use **More** menu to authorize the app. | Automatically authorized and enabled upon creation | diff --git a/content/guides/authorization/limited-access-approval.md b/content/guides/authorization/limited-access-approval.md index 7bf3bdb8f..fc9f6327b 100644 --- a/content/guides/authorization/limited-access-approval.md +++ b/content/guides/authorization/limited-access-approval.md @@ -17,7 +17,7 @@ Limited Access Integrations are automatically authorized for use in an enterpris creation. However, if the enterprise setting to -**Require manual admin authorization for transactional access apps** is enabled, +**Require manual Admin authorization for Limited Access Apps** is enabled, an Admin must preform additional steps. ## Approval Notifications @@ -43,24 +43,25 @@ application. ### As a developer -As the developer, navigate to the **Configuration** tab for your application -in the [Developer Console][devconsole]. Scroll down to the OAuth 2.0 Credentials -section and copy the Client ID value to provide to a Box Admin. +1. Navigate to the **Configuration** tab for your application in the [Developer Console][devconsole]. +2. Scroll down to the OAuth 2.0 Credentials section and copy the **Client ID** value to provide to a Box Admin. + +Alternatively, hover over the application in the +[My Platform Apps][apps] view to look up the **ClientID** and then +copy it using the `copy` button. # Finding a Box Admin If you don't know your enterprise Admin, go to your Box [Account Settings][settings] page and scroll to the bottom. If an admin contact is set - you should see their contact information under "Admin Contact". + you should see their contact information under **Admin Contact**. ### As an Admin As a Box Admin, navigate to the [Admin Console][adminconsole] and -select the **Integrations** tab (1) from the left navigation panel. Then, click the -**Platform Apps** tab (2) at the top of your screen. On this screen, you will -see a **+** button in the top right corner to add a new app authorization. +select the **Integrations** > **Platform Apps Manager** > **Add Platform App** ![Apps tab](images/jwt_app_approval_flow.png) @@ -96,3 +97,4 @@ of the application name to **Reauthorize App**. [app-auth]: https://support.box.com/hc/en-us/articles/360043697014-Authorizing-Apps-in-the-Box-App-Approval-Process +[apps]: g://applications \ No newline at end of file diff --git a/content/guides/collaborations/connect-slack-to-group-collabs/1-configure-slack.md b/content/guides/collaborations/connect-slack-to-group-collabs/1-configure-slack.md index 97c5b1b58..5ee2f536b 100644 --- a/content/guides/collaborations/connect-slack-to-group-collabs/1-configure-slack.md +++ b/content/guides/collaborations/connect-slack-to-group-collabs/1-configure-slack.md @@ -18,7 +18,7 @@ This section will take you through the following steps. ## Create a minimal Slack app -Go to the **[Slack apps page][slack-apps]** and click **Create Platform App**. Add +Go to the **[Slack apps page][slack-apps]** and click **Create an App**. Add an **App Name**, select your **Development Slack Workspace** from the dropdown list where the bot will be deployed to, then click **Create App**. 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 2e36d313d..66c6baf55 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,14 +37,14 @@ valid for one hour before having to be manually refreshed. To create a new Box application that may be used to generate a developer token, use the following steps. - 1. Go to the [Developer Console][devconsole] - 2. Select **Create Platform App** - 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 Platform App** + 1. Go to the [Developer Console][devconsole]. + 2. Select **Create Platform App**. + 3. Select **Custom 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 Platform App**. 6. Go to the app's configuration by clicking **View Your Platform App**. 7. Optionally, scroll to the **Required Access Scopes** section of the same screen and select any additional permissions you want to enable for this application. - 8. At the top of the page click the button to **Save Changes** + 8. At the top of the page click the button to **Save Changes**. diff --git a/content/pages/platform/box-platform-101.md b/content/pages/platform/box-platform-101.md index ab0f94dc4..e9bccf1ff 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 platform app, limited access app, and custom skills. You +console. They include Custom App, Limited Access App, and Box Custom Skills. You can also create third party and web app integrations.