spenpal opened a new issue, #806:
URL: https://github.com/apache/incubator-devlake-website/issues/806

   ## Documentation Scope
   The Bitbucket Cloud configuration documentation needs to be updated to 
reflect the migration from App passwords (deprecated) to API tokens.
   
   **Affected documentation:** 
https://devlake.apache.org/docs/Configuration/BitBucket/#api-token
   
   ## Describe the Change
   Update the Bitbucket authentication documentation to reflect that Bitbucket 
is deprecating App passwords in favor of API tokens:
   
   - **September 9, 2025**: Creation of App passwords will be discontinued
   - **June 9, 2026**: All existing App passwords will be deactivated
   
   The documentation currently describes authentication using "Username and App 
Password" but needs to be updated to cover:
   
   1. **API token authentication** (new recommended method)
      - How to generate API tokens in Bitbucket
      - Required scopes for API tokens:
        - Account:Read
        - Workspace membership:Read
        - Repositories:Read
        - Projects:Read
        - Pull requests:Read
        - Issues:Read
        - Pipelines:Read
        - Runners:Read
      - How to configure DevLake to use API tokens
   
   2. **Migration guidance**
      - Clear warnings about App password deprecation timeline
      - Instructions for users to migrate from App passwords to API tokens
   
   3. **Update section headings and screenshots**
      - Change "Username and App Password" to reflect API token authentication
      - Update any screenshots showing App password configuration
   
   ## Screenshots
   Current documentation shows App password authentication:
   
![bitbucket-app-password-permissions](/img/ConfigUI/bitbucket-app-password-permissions.jpeg)
   
   ## Additional context
   This documentation update is related to the feature implementation tracked 
in: https://github.com/apache/incubator-devlake/issues/8520
   
   The upstream issue provides detailed context about Bitbucket's deprecation 
timeline and the required API token scopes.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to