Permission Updates in BuildMaster 5.0
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) |
|---|---|
| BuildMaster | Administer |
| Administrator | Administer |
| Developer | Deploy to Environment |
| View Only | View Application |
| QA Analyst | removed |
| – | 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 notificationsVariables_CreateOrUpdateVariables– variables should be controlled by privileges depending on the scope of the variable, i.e. Release variables withReleases_Manageand Application-level variables withApplications_Manage
