Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Permission Updates in BuildMaster 5.0

view on GitHub
Outdated Content (BuildMaster v5)

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)
BuildMasterAdminister
AdministratorAdminister
DeveloperDeploy to Environment
View OnlyView Application
QA Analystremoved
-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 TaskNew Task
Admin_AdministrativeEditsAdmin_ConfigureBuildMaster
Admin_ConfigureAdmin_ConfigureBuildMaster
Admin_ControlServiceAdmin_ConfigureBuildMaster
Admin_ManageExtensionsAdmin_ConfigureBuildMaster
Admin_ManageLicenseAdmin_ConfigureBuildMaster
Admin_ManageSecurityAdmin_ConfigureBuildMaster
Admin_ViewBuildMasterEventsAdmin_ConfigureBuildMaster
Applications_CreateApplicationAdmin_ManageApplications
Applications_EditApplicationApplications_Manage
Applications_EditDeployableApplications_Manage
Applications_PurgeApplicationAdmin_ManageApplications
Applications_ViewOverviewApplications_View
Builds_CreateBuildReleasePackages_Create
Builds_ExecuteBuildReleasePackages_Deploy
Builds_ForceBuildReleasePackages_Force
Builds_ManageBuildSchedulesApplications_Manage
Builds_OverridePromotionStatusReleasePackages_Force
Builds_PromoteBuildReleasePackages_Deploy
Builds_ReExecuteBuildReleasePackages_Deploy
Builds_RejectBuildReleasePackages_Manage
Builds_ViewArtifactApplications_View
Builds_ViewBuildHistoryApplications_View
Builds_ViewBuildOverviewApplications_View
Builds_ViewDebugLogsReleasePackages_ViewDeploymentDebugLogs
Builds_ViewExecutionDetailsReleasePackages_ViewDeploymentLogs
Builds_ViewPromotionDetailsReleasePackages_ViewDeploymentLogs
ChangeControls_ManageChangeControlsChangeControls_Manage
ChangeControls_PerformAnyChangeControlsChangeControls_Manage
ChangeControls_ViewChangeControlsApplications_View
ConfigurationFiles_DeployConfigurationFilesConfigurationFiles_Deploy
ConfigurationFiles_EditConfigurationFileConfigurationFiles_EditInstance
ConfigurationFiles_ManageConfigurationFilesApplications_Manage
ConfigurationFiles_ViewConfigurationFileConfigurationFiles_ViewInstance
DatabaseChangeScripts_DeployChangeScriptSqlScripts_Deploy
DatabaseChangeScripts_ManageChangeScriptsSqlScripts_Manage
DatabaseChangeScripts_ManageDatabaseProvidersApplications_Manage
DatabaseChangeScripts_ViewChangeScriptSqlScripts_ViewContents
DatabaseChangeScripts_ViewDatabaseProviderApplications_Manage
Environments_ManageEnvironmentsEnvironments_Manage
Environments_ManageServersEnvironments_Manage
Environments_ViewEnvironmentEnvironments_View
Environments_ViewServerEnvironments_View
Events_ManageAllNotifiersAdmin_ConfigureBuildMaster
Events_ManageOwnNotifiersremoved*
Issues_CloseIssueIssues_Manage
Issues_CreateIssueIssues_Manage
Issues_DeleteIssueIssues_Manage
Issues_EditIssueIssues_Manage
Issues_SyncIssuesIssues_Manage
Issues_ViewIssueApplications_View
Plans_ManageGlobalPlansPlans_Manage
Plans_ManagePlansPlans_Manage
Plans_ViewActionDetailsPlans_Manage
Plans_ViewGlobalPlansPlans_ViewContents
Plans_ViewPlanPlans_ViewContents
Providers_DeleteProviderAdmin_ConfigureBuildMaster
Providers_ManageProvidersAdmin_ConfigureBuildMaster
Releases_AddNoteNotes_Manage
Releases_DeleteNoteNotes_Manage
Releases_EditNoteNotes_Manage
Releases_ManageReleasesReleases_Manage
Releases_ViewReleaseOverviewApplications_View
Scripts_ManageScriptsScriptAssets_Manage
Scripts_ViewScriptsScriptAssets_ViewContents
Variables_CreateOrUpdateVariablesremoved*
Workflows_ManageWorkflowsPipelines_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