Upgrade the Bitbucket Cloud + Slack integration to granular permissions

[#1]

We are updating the Bitbucket Cloud + Slack Integration to use Slack’s shiny new granular permissions. This allows our app to ask for only the permissions it needs and makes it more reliable. For this update, action is required by Slack admins of workspaces using the Bitbucket Cloud + Slack integration.

What are granular permissions?

Slack has required that all integration apps update to support their new granular permissions model. Before granular permissions, “classic” apps using a bot token received a broad set of scopes, and developers did not have a way to pick and choose the information their app actually accessed. Now, with granular permissions, developers can specify only the exact, minimal scopes needed for their app to function

Apps using granular permissions are also more reliable as they can remain in a workspace even if the app installer leaves the company, reducing unwanted interruptions. Furthermore, granular permissions provide a wider set of scopes that we as developers can cherry-pick in the future to add cool new features that wouldn’t be possible with classic apps.

What do Slack admins need to do?

Slack Admins are required to upgrade permissions for the Bitbucket Cloud + Slack integration in their workspaces by December 11, 2020, when the old version of the integration will no longer work. Upgrading is super simple and should only take a minute.

What happens if an admin doesn’t upgrade?

We strongly recommend upgrading well before the deadline once the upgrade becomes available on November 30, 2020. Until an admin upgrades the app:

1. New users will not be able to log in to the app and access its features

2. Any new features will not be available to your team

3. On December 11, 2020, the old version of the app will no longer work, and Slack admins will continue to receive reminders to upgrade. Upgrading will immediately make the app work as expected.

How does a Slack admin upgrade the integration?

1. Two weeks before the upgrade becomes available, admins receive a message letting them know that they will need to upgrade the app soon.

2. On November 30, 2020, the upgrade becomes available and admins will receive the following message with a button to "Update permissions."

3. Clicking “Update permissions” will let admins view and accept the new granular permissions.

4. Click “Allow” and you’re all done! Your Bitbucket Cloud + Slack integration is now on Slack’s shiny new granular permissions 🎉 

You can disregard past update messages as you are on the most up-to-date and supported version of the app. New members will be able to log in, and you will have access to all new future features. 

Will upgrading the app cause any interruptions with the app or our Slack experience?

No. Upgrading will not negatively impact your app or Slack experience. There will be no interruptions. Everything will still continue to work as normal as you upgrade and after you upgrade.

[Marcelo Horacio Fortino]

Good job! Thanks.

[bnlawrence]

Unfortunately this mechanism is broken. if you use the same email for different slack workspaces, and you only want to do this on one of those workspaces, you can't ... at least not via this route.

Actually you can, but you have to notice the menu on the top right. The default appears to be whichever workspace you last logged into ... which may not be one you want to change at all.

[David Michelson]

@bnlawrence Thank you for the feedback!

Yes, if you use the same email for different Slack workspaces, you'll need to make sure that you're updating the app for the right Slack workspace in the top-right "Workspace Switcher." Good call out.

[jokanane]

One of my workspaces has not received the aforementioned message, which indeed was a very straightforward way of updating the permissions for many other workspaces.

Now, I do see buttons "Send admin reminder" and "Nudge admin to update", but not much happens. I see a notification "We have nudged your Slack workspace admin to update!", but that's all; I'm the admin and have not received anything more.

How can I update the permissions in this case?

Thanks.

[David Michelson]

@jokanane 

Thank you so much for your detailed issue - we're looking into it!

Instead of going through the Slack message, you can click this link to update permissions, it does the same thing as long as you have permission to install apps on your workspace: Update permissions.

Make sure in the top right corner that you are updating permissions for the right workspace!

Please let me know if you have any other questions.

[jokanane]

Worked perfectly, thanks!