mirror of https://github.com/microsoft/onefuzz.git synced 2025-06-06 23:31:34 +00:00

History

Kanan B cad8e0e601 Support custom ado fields that mark work items as duplicate (#3467 )

* Add field to ado config for checking duplicate work items

* Make duplicate fields nullable and add it to python models

* Update broken tests

* Update docs to include new ado_duplicate_fields property

2023-10-03 11:51:39 -07:00

ado-work-items.json

Support custom ado fields that mark work items as duplicate (#3467 )

2023-10-03 11:51:39 -07:00

azure-pipelines.yml

Revert YML Param Changes. (#2906 )

2023-03-03 14:46:24 -08:00

README.md

Add example job pipelines (#778 )

2021-04-14 14:11:53 -04:00

README.md

Deploying OneFuzz jobs via ADO Pipelines

This pipeline uses an AAD Service Principal to authenticate to Onefuzz.

To create work items upon finding crashes, this pipeline uses a Azure Devops Personal Access Token to report any crashes found during fuzzing as Azure Devops Work Items.

Configuration

This example uses the Azure Devops Variable Group, named onefuzz-config, which can be shared across multiple pipelines. The following variables are defined in onefuzz-config:

endpoint: The Onefuzz Instance. This should be the URL of the instance, such as https://onefuzz-playground.azurewebsites.net.
client_id: The Client ID of the [service principal]((https://docs.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals).
client_secret: The Client Secret of the service principal.
ado_pat: The Azure Devops Personal Access Token. This should be a "secret" variable.

This example uses Azure Devops Runtime parameters, which are specific to this pipeline. The following parameters are defined in this pipeline:

onefuzz_project: The name of your project. As an example, "Browser". Unless otherwise specified, this defaults to sample.
onefuzz_target: The name of your target. As an example, "jpg-parser". Unless otherwise specified, this defaults to sample.
onefuzz_pool: The name of the fuzzing Pool to use. Unless otherwise specified, this defaults to linux.

Azure Devops Configuration

In the notification configuration, there are a few items that are hard-coded that you should update for your instance:

Replace INSERT_YOUR_ORG_HERE with the name of your Azure Devops organization.
Replace INSERT_YOUR_PROJECT_HERE with the name of your Azure Devops project.
Replace OneFuzz-Ado-Integration with the Area Path for your work items to be filed.