Branch name validation requires documentation and application messaging could be improved

XMLWordPrintable

    • 1
    • 1

      Branch name validation (configured at Bamboo Administration > Security Settings > Enable repository data validation) introduced in Bamboo 9.6.25, 10.2.18 and 12.1.6 causes any branch that does not conform to the following rules to fail:

      • First character must be a letter (a–z, A–Z), digit (0–9), or underscore (_)
      • Remaining characters may additionally include: ./-
         

      The following warning is presented to users in both the UI and application logs:

      2026-08-23 00:00:00,001 WARN [vcsMetadataDataViolationExecutor-pool-29-thread-1] [RepositoryVariableSecurityViolationEventListener]  Security violation in pull request: blocked Pull Request source branch 'feature/branch-name|more]-characters': Pull Request source branch contains characters not permitted by security validation (must start with alphanumeric or underscore; other allowed symbols: - / .) [source repository: 'Repository Name' (id=1234), target repository: 'Repository Name' (id=1234)]

      Release notes:

      The setting is not documented outside of the Security Settings UI and the messaging could be improved to be clearer and link to external documentation of the setting to disable the validation as it is currently unclear from the error how to disable it.

      Example:

      Security validation blocked pull request source branch 'feature/branch-name|more]-characters'. The branch name violates the repository data security policy. Unsupported characters found: |, ]. Branch names must start with a letter, digit, or underscore; all remaining characters must be letters, digits, underscores, periods (.), slashes (/), or hyphens (-). Expected pattern: ^[A-Za-z0-9_][A-Za-z0-9_./-]*$. [source repository: Repository Name (id=1234), target repository: Repository Name (id=1234)]

Validation can be disabled at Bamboo Administration > Security Settings > Enable repository data validation. Documentation: https://confluence.atlassian.com/bamboo/link-to-documentation.html

              Assignee:
              Unassigned
              Reporter:
              Jeremy Owen
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: