This guide is designed as an implementation playbook, not a theory article.
It combines:
- Delivery operating model practices
- Azure Boards structure and governance
- Git branching and pull request controls
- CI/CD architecture in Azure Pipelines
- Secure-by-design controls and permissions
- Implementation-ready scripts and templates
Who This Is For
- Engineering managers and platform leads
- DevOps engineers and SRE teams
- Security and compliance teams partnering with delivery
- Team leads setting standards across multiple repos/projects
How To Use This Guide
- Read the operating model and target-state first.
- Implement Boards + Repos controls together.
- Add pipeline templates and environment checks.
- Roll out secure-by-design controls in phases.
- Use the scripts and templates section as your starter kit.
Expanded Table of Contents
- Operating Model and Target State
- Azure Boards Best Practices
- Repos, Branching, and PR Strategy
- Pipelines, Environments, and Approval Gates
- Secure by Design: Permissions, Secrets, and Scanning
- Security Model Summary
- Identity and Authentication
- Authorization and Permissions
- Service Connection Security
- Secrets and Variables
- Secure Pipeline Input Handling
- Code, Dependency, and Secret Scanning
- Agent and Infrastructure Security
- Bypass and Break-Glass Governance
- Security Operations Metrics
- Quick Security Checklist
- Implementation Scripts and Templates
- Prerequisites
- Script: Create Core Branch Policies (PowerShell + Azure CLI)
- Script: Policy-As-Code via Configuration File
- Template: Secure Pipeline Entry (
extends) - Template: CodeQL Scanning Starter
- Template: Dependency Scanning Starter
- Example: Deployment with Environment Gate
- Script: Find Repositories Missing Branch Policy Baseline
- Script: Enumerate Projects and Group Membership (Audit Starter)
- Implementation Notes
- Rollout Plan and Maturity Model
Reference Sources
This playbook is aligned with current Microsoft documentation, including:
- Azure Boards security model and permissions
- Azure Repos branch policies and branching guidance
- Azure Pipelines security guidance, templates, environments, approvals/checks
- Authentication/authorization and security groups guidance
- GitHub Advanced Security for Azure DevOps (secret, dependency, code scanning)
Where this guide makes choices (for example, branching model or gate strictness), those choices are opinionated implementation recommendations intended to be practical in enterprise teams.