Permission Updates in BuildMaster 5.0

KB#1120: Last Updated Jan 15, 2018

The below applies to BuildMaster users upgrading to v5

Permissions in BuildMaster v5.0 are simpler than in previous versions, but in most cases, will be the same granularity. Previous versions had up to 66 "tasks", many of which were either conflated (Builds_ViewExecutionDetails & Builds_ViewPromotionDetails) or simply non-sensical individually (Admin_ManageExtensions without Admin_ControlService). In this version, there are only 27 individually-securable permissions.

Role Migration

As part of the UX overhaul, "Roles" have been renamed to "Tasks", and the names of the roles have been updated to sound more task-like.

Default Roles (Old) Default Tasks (5.0)
BuildMasterAdminister
AdministratorAdminister
DeveloperDeploy to Environment
View OnlyView Application
QA Analystremoved
-Coordinate Releases

If you modified any of the default roles but did not rename then, then they will renamed to the new task names. In addition, the role's individually-securable permissions (formerly, "tasks") will be reset to the new, default definitions.

If you don't want this to happen upon upgrade, then just rename your role to anything other than the default role or task name.

Custom Extensions

Though it is rare, custom extensions referencing the SecuredTask enumeration must be modified and rebuilt to reference a new task. Consult the full list below to see which new tasks may be appropriate for your use case.

Full Task Conversion List

Former "roles" that contained the tasks on the left will automatically be updated to include the new tasks on the right.

Former Task New Task
Admin_AdministrativeEdits Admin_ConfigureBuildMaster
Admin_Configure Admin_ConfigureBuildMaster
Admin_ControlService Admin_ConfigureBuildMaster
Admin_ManageExtensions Admin_ConfigureBuildMaster
Admin_ManageLicense Admin_ConfigureBuildMaster
Admin_ManageSecurity Admin_ConfigureBuildMaster
Admin_ViewBuildMasterEvents Admin_ConfigureBuildMaster
Applications_CreateApplication Admin_ManageApplications
Applications_EditApplication Applications_Manage
Applications_EditDeployable Applications_Manage
Applications_PurgeApplication Admin_ManageApplications
Applications_ViewOverview Applications_View
Builds_CreateBuild ReleasePackages_Create
Builds_ExecuteBuild ReleasePackages_Deploy
Builds_ForceBuild ReleasePackages_Force
Builds_ManageBuildSchedules Applications_Manage
Builds_OverridePromotionStatus ReleasePackages_Force
Builds_PromoteBuild ReleasePackages_Deploy
Builds_ReExecuteBuild ReleasePackages_Deploy
Builds_RejectBuild ReleasePackages_Manage
Builds_ViewArtifact Applications_View
Builds_ViewBuildHistory Applications_View
Builds_ViewBuildOverview Applications_View
Builds_ViewDebugLogs ReleasePackages_ViewDeploymentDebugLogs
Builds_ViewExecutionDetails ReleasePackages_ViewDeploymentLogs
Builds_ViewPromotionDetails ReleasePackages_ViewDeploymentLogs
ChangeControls_ManageChangeControls ChangeControls_Manage
ChangeControls_PerformAnyChangeControls ChangeControls_Manage
ChangeControls_ViewChangeControls Applications_View
ConfigurationFiles_DeployConfigurationFiles ConfigurationFiles_Deploy
ConfigurationFiles_EditConfigurationFile ConfigurationFiles_EditInstance
ConfigurationFiles_ManageConfigurationFiles Applications_Manage
ConfigurationFiles_ViewConfigurationFile ConfigurationFiles_ViewInstance
DatabaseChangeScripts_DeployChangeScript SqlScripts_Deploy
DatabaseChangeScripts_ManageChangeScripts SqlScripts_Manage
DatabaseChangeScripts_ManageDatabaseProviders Applications_Manage
DatabaseChangeScripts_ViewChangeScript SqlScripts_ViewContents
DatabaseChangeScripts_ViewDatabaseProvider Applications_Manage
Environments_ManageEnvironments Environments_Manage
Environments_ManageServers Environments_Manage
Environments_ViewEnvironment Environments_View
Environments_ViewServer Environments_View
Events_ManageAllNotifiers Admin_ConfigureBuildMaster
Events_ManageOwnNotifiers removed*
Issues_CloseIssue Issues_Manage
Issues_CreateIssue Issues_Manage
Issues_DeleteIssue Issues_Manage
Issues_EditIssue Issues_Manage
Issues_SyncIssues Issues_Manage
Issues_ViewIssue Applications_View
Plans_ManageGlobalPlans Plans_Manage
Plans_ManagePlans Plans_Manage
Plans_ViewActionDetails Plans_Manage
Plans_ViewGlobalPlans Plans_ViewContents
Plans_ViewPlan Plans_ViewContents
Providers_DeleteProvider Admin_ConfigureBuildMaster
Providers_ManageProviders Admin_ConfigureBuildMaster
Releases_AddNote Notes_Manage
Releases_DeleteNote Notes_Manage
Releases_EditNote Notes_Manage
Releases_ManageReleases Releases_Manage
Releases_ViewReleaseOverview Applications_View
Scripts_ManageScripts ScriptAssets_Manage
Scripts_ViewScripts ScriptAssets_ViewContents
Variables_CreateOrUpdateVariables removed*
Workflows_ManageWorkflows Pipelines_Manage

* 2 tasks were removed altogether:

  • Events_ManageOwnNotifiers - all users should be able to manage their own notifications
  • Variables_CreateOrUpdateVariables - variables should be controlled by privileges depending on the scope of the variable, i.e. Release variables with Releases_Manage and Application-level variables with Applications_Manage