security-devops-azdevops

KO | EN

gitlite — search

#python #typescript #cli #llm #hacktoberfest #golang #ai #ai-agents #nextjs #esp32 #tui #go

security-devops-azdevops

★ 85 Open GitHub ↗

Microsoft Security DevOps extension for Azure DevOps.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Microsoft Security DevOps for Azure DevOps

An extension for Azure DevOps that contributes a build task to run the [Microsoft Security DevOps CLI](https://aka.ms/msdo-nuget).

* Installs the Microsoft Security DevOps CLI
* Installs the latest Microsoft security policy
* Installs the latest Microsoft and 3rd party security tools
* Automatic or user-provided configuration of security tools
* Execution of a full suite of security tools
* Normalized processing of results into the SARIF format
* Build breaks and more
* Captures the [container images pushed in a build run](https://learn.microsoft.com/azure/defender-for-cloud/container-image-mapping)
  * In Azure DevOps, this requires the [Microsoft Defender for DevOps Container Mapping extension](https://marketplace.visualstudio.com/items?itemName=ms-securitydevops.ms-dfd-code-to-cloud) to extract metadata from pipelines, such as the container's digest ID and name, for connecting DevOps entities with their related cloud resources. This extension is automatically shared and installed with organizations that are [connected to Microsoft Defender for Cloud](https://learn.microsoft.com/azure/defender-for-cloud/quickstart-onboard-devops). If an organization is not connected to Defender for Cloud, there is **no way** to configure this functionality as it does not work with manual modification of the Microsoft Security DevOps extension. Attempting to configure it through Microsoft Security DevOps may cause unexpected issues.

## Basic

Add the `MicrosoftSecurityDevOps` build task to your pipeline's yaml:

```yaml
steps:
- task: MicrosoftSecurityDevOps@1
```

# Tools

| Name | Language | License |
| --- | --- | --- |
| [AntiMalware](https://www.microsoft.com/en-us/windows/comprehensive-security) | code, artifacts | - |
| [Bandit](https://github.com/PyCQA/bandit) | python | [Apache License 2.0](https://github.com/PyCQA/bandit/blob/master/LICENSE) |
| [BinSkim](https://github.com/Microsoft/binskim) | binary - Windows, ELF | [MIT License](https://github.com/microsoft/binskim/blob/main/LICENSE) |
| [Checkov](https://github.com/bridgecrewio/checkov) | Terraform, Terraform plan, Cloudformation, AWS SAM, Kubernetes, Helm charts, Kustomize, Dockerfile, Serverless, Bicep, OpenAPI, ARM Templates, OpenTofu  | [Apache 2.0](https://github.com/bridgecrewio/checkov/blob/main/LICENSE) |
| [ESlint](https://github.com/eslint/eslint) | JavaScript | [MIT License](https://github.com/eslint/eslint/blob/main/LICENSE) |
| [IaCFileScanner](https://learn.microsoft.com/azure/defender-for-cloud/iac-template-mapping) | Terraform, CloudFormation, ARM Template, Bicep	| - |
| [Template Analyzer](https://github.com/Azure/template-analyzer) | Infrastructure-as-code (IaC), ARM templates, Bicep files | [MIT License](https://github.com/Azure/template-analyzer/blob/main/LICENSE.txt) |
| [Terrascan](https://github.com/accurics/terrascan) | Infrastructure-as-Code (IaC), Terraform (HCL2), Kubernetes (JSON/YAML), Helm v3, Kustomize, Dockerfiles, CloudFormation | [Apache License 2.0](https://github.com/accurics/terrascan/blob/master/LICENSE) |
| [Trivy](https://github.com/aquasecurity/trivy) | Container Images, Infrastructure as Code (Iac) | [Apache License 2.0](https://github.com/aquasecurity/trivy/blob/main/LICENSE) |

## Contributing

This project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

### Running it locally

Make sure to have a supported version of [node and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) installed in your system.
After cloning the repo, you can install all dependencies by running this command.
> npm install

Note: If you run into `401 - Unauthorized` error, then you will need to login to the `https://npm.pkg.github.com/` by running this command - 
> npm login --registry=https://npm.pkg.github.com

More info [here](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry).

All other commands are specified in the [`package.json`](./package.json) file.
```json
 "scripts": {
        "build": "dotnet build ./build.proj",
        "compile": "dotnet build ./build.proj /t:Compile",
        "compile-tests": "dotnet build ./build.proj /t:CopyTestHelpers",
        "compile-and-test": "dotnet build ./build.proj /t:Test /p:RunTests=true",
        "test": "npx mocha **/*.tests.js"
    }
```

You can execute them by using `npm run` commands.
For example: `npm run build` will execute the `dotnet build ./build.proj` command and generate a vsix file with your changes for testing.

### Testing the extension

To test the extension after making changes in an ADO pipeline run -

1) Make the changes and compile the code. If no errors, a vsix file will be generated.
Eg:
```ps
PS C:\Users\larohra\source\repos\security-devops-azdevops> npm run build

> microsoft-security-devops-azdevops@1.11.1 build
> dotnet build ./build.proj

MSBuild version 17.9.6+a4ecab324 for .NET
...

=== Completed operation: create extension ===
   - VSIX: C:\Users\larohra\source\repos\security-devops-azdevops\bin\debug\microsoft-security-devops-azdevops-debug.1.11.0.2.vsix
   - Extension ID: microsoft-security-devops-azdevops-larohra
   - Extension Version: 1.11.0.2
   - Publisher: ms-secdevops-test

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:00:12.94
```

2) Publish the vsix in your marketplace account (Create a new publisher account if you dont have one) - https://marketplace.visualstudio.com/manage/

3) Share the debug extension with your organization - https://learn.microsoft.com/en-us/azure/devops/extend/publish/overview?view=azure-devops#share-your-extension

4) Install the extension in your org - https://learn.microsoft.com/en-us/azure/devops/extend/publish/overview?view=azure-devops#install-your-extension

5) Add it to the pipeline run and run the build.
Sample: 
```yaml
  - task: MicrosoftSecurityDevOps@1
    displayName: 'Test Container Mapping End'
    timeoutInMinutes: 2
    condition: always()
```

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
trademarks or logos is subject to and must follow 
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.

security-devops-azdevops

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README