Permission Updates in BuildMaster 5.0
This document only applies to users upgrading from BuildMaster v5 and is a companion to Upgrading from BuildMaster v5.
Permissions in BuildMaster v5.0 are simpler than in previous versions, but in most cases the granularity is the same. Previous versions had up to 66 "tasks", many of which were either merged (Builds_ViewExecutionDetails & Builds_ViewPromotionDetails) or simply nonsensical (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 changed any of the default roles but did not rename them, they will be renamed to the new task names. Also, the role's customizable permissions (formerly "tasks") are reset to the new default definitions.
If you do not want this to happen during the upgrade, simply rename your role to something 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