From 25014ff427129cb24be11313104dfea9d92637b0 Mon Sep 17 00:00:00 2001 From: Nik Charlebois Date: Tue, 7 Jan 2020 15:22:04 -0500 Subject: [PATCH] Initial --- .gitignore | 350 ------------------ CODE_OF_CONDUCT.md | 9 - LICENSE | 2 +- .../MSFT_SFPendingReboot.psm1 | 88 +++++ .../MSFT_SFPendingReboot.schema.mof | 5 + .../MSFT_SFPendingReboot/readme.md | 4 + .../Modules/ServiceFabricsDSC.Common.psm1 | 103 ++++++ .../ServiceFabricDSC/ServiceFabricDSC.psd1 | 116 ++++++ README.md | 15 +- SECURITY.md | 41 -- 10 files changed, 318 insertions(+), 415 deletions(-) delete mode 100644 .gitignore delete mode 100644 CODE_OF_CONDUCT.md create mode 100644 Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.psm1 create mode 100644 Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.schema.mof create mode 100644 Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/readme.md create mode 100644 Modules/ServiceFabricDSC/Modules/ServiceFabricsDSC.Common.psm1 create mode 100644 Modules/ServiceFabricDSC/ServiceFabricDSC.psd1 delete mode 100644 SECURITY.md diff --git a/.gitignore b/.gitignore deleted file mode 100644 index dfcfd56..0000000 --- a/.gitignore +++ /dev/null @@ -1,350 +0,0 @@ -## Ignore Visual Studio temporary files, build results, and -## files generated by popular Visual Studio add-ons. -## -## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore - -# User-specific files -*.rsuser -*.suo -*.user -*.userosscache -*.sln.docstates - -# User-specific files (MonoDevelop/Xamarin Studio) -*.userprefs - -# Mono auto generated files -mono_crash.* - -# Build results -[Dd]ebug/ -[Dd]ebugPublic/ -[Rr]elease/ -[Rr]eleases/ -x64/ -x86/ -[Aa][Rr][Mm]/ -[Aa][Rr][Mm]64/ -bld/ -[Bb]in/ -[Oo]bj/ -[Ll]og/ -[Ll]ogs/ - -# Visual Studio 2015/2017 cache/options directory -.vs/ -# Uncomment if you have tasks that create the project's static files in wwwroot -#wwwroot/ - -# Visual Studio 2017 auto generated files -Generated\ Files/ - -# MSTest test Results -[Tt]est[Rr]esult*/ -[Bb]uild[Ll]og.* - -# NUnit -*.VisualState.xml -TestResult.xml -nunit-*.xml - -# Build Results of an ATL Project -[Dd]ebugPS/ -[Rr]eleasePS/ -dlldata.c - -# Benchmark Results -BenchmarkDotNet.Artifacts/ - -# .NET Core -project.lock.json -project.fragment.lock.json -artifacts/ - -# StyleCop -StyleCopReport.xml - -# Files built by Visual Studio -*_i.c -*_p.c -*_h.h -*.ilk -*.meta -*.obj -*.iobj -*.pch -*.pdb -*.ipdb -*.pgc -*.pgd -*.rsp -*.sbr -*.tlb -*.tli -*.tlh -*.tmp -*.tmp_proj -*_wpftmp.csproj -*.log -*.vspscc -*.vssscc -.builds -*.pidb -*.svclog -*.scc - -# Chutzpah Test files -_Chutzpah* - -# Visual C++ cache files -ipch/ -*.aps -*.ncb -*.opendb -*.opensdf -*.sdf -*.cachefile -*.VC.db -*.VC.VC.opendb - -# Visual Studio profiler -*.psess -*.vsp -*.vspx -*.sap - -# Visual Studio Trace Files -*.e2e - -# TFS 2012 Local Workspace -$tf/ - -# Guidance Automation Toolkit -*.gpState - -# ReSharper is a .NET coding add-in -_ReSharper*/ -*.[Rr]e[Ss]harper -*.DotSettings.user - -# TeamCity is a build add-in -_TeamCity* - -# DotCover is a Code Coverage Tool -*.dotCover - -# AxoCover is a Code Coverage Tool -.axoCover/* -!.axoCover/settings.json - -# Visual Studio code coverage results -*.coverage -*.coveragexml - -# NCrunch -_NCrunch_* -.*crunch*.local.xml -nCrunchTemp_* - -# MightyMoose -*.mm.* -AutoTest.Net/ - -# Web workbench (sass) -.sass-cache/ - -# Installshield output folder -[Ee]xpress/ - -# DocProject is a documentation generator add-in -DocProject/buildhelp/ -DocProject/Help/*.HxT -DocProject/Help/*.HxC -DocProject/Help/*.hhc -DocProject/Help/*.hhk -DocProject/Help/*.hhp -DocProject/Help/Html2 -DocProject/Help/html - -# Click-Once directory -publish/ - -# Publish Web Output -*.[Pp]ublish.xml -*.azurePubxml -# Note: Comment the next line if you want to checkin your web deploy settings, -# but database connection strings (with potential passwords) will be unencrypted -*.pubxml -*.publishproj - -# Microsoft Azure Web App publish settings. Comment the next line if you want to -# checkin your Azure Web App publish settings, but sensitive information contained -# in these scripts will be unencrypted -PublishScripts/ - -# NuGet Packages -*.nupkg -# NuGet Symbol Packages -*.snupkg -# The packages folder can be ignored because of Package Restore -**/[Pp]ackages/* -# except build/, which is used as an MSBuild target. -!**/[Pp]ackages/build/ -# Uncomment if necessary however generally it will be regenerated when needed -#!**/[Pp]ackages/repositories.config -# NuGet v3's project.json files produces more ignorable files -*.nuget.props -*.nuget.targets - -# Microsoft Azure Build Output -csx/ -*.build.csdef - -# Microsoft Azure Emulator -ecf/ -rcf/ - -# Windows Store app package directories and files -AppPackages/ -BundleArtifacts/ -Package.StoreAssociation.xml -_pkginfo.txt -*.appx -*.appxbundle -*.appxupload - -# Visual Studio cache files -# files ending in .cache can be ignored -*.[Cc]ache -# but keep track of directories ending in .cache -!?*.[Cc]ache/ - -# Others -ClientBin/ -~$* -*~ -*.dbmdl -*.dbproj.schemaview -*.jfm -*.pfx -*.publishsettings -orleans.codegen.cs - -# Including strong name files can present a security risk -# (https://github.com/github/gitignore/pull/2483#issue-259490424) -#*.snk - -# Since there are multiple workflows, uncomment next line to ignore bower_components -# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) -#bower_components/ - -# RIA/Silverlight projects -Generated_Code/ - -# Backup & report files from converting an old project file -# to a newer Visual Studio version. Backup files are not needed, -# because we have git ;-) -_UpgradeReport_Files/ -Backup*/ -UpgradeLog*.XML -UpgradeLog*.htm -ServiceFabricBackup/ -*.rptproj.bak - -# SQL Server files -*.mdf -*.ldf -*.ndf - -# Business Intelligence projects -*.rdl.data -*.bim.layout -*.bim_*.settings -*.rptproj.rsuser -*- [Bb]ackup.rdl -*- [Bb]ackup ([0-9]).rdl -*- [Bb]ackup ([0-9][0-9]).rdl - -# Microsoft Fakes -FakesAssemblies/ - -# GhostDoc plugin setting file -*.GhostDoc.xml - -# Node.js Tools for Visual Studio -.ntvs_analysis.dat -node_modules/ - -# Visual Studio 6 build log -*.plg - -# Visual Studio 6 workspace options file -*.opt - -# Visual Studio 6 auto-generated workspace file (contains which files were open etc.) -*.vbw - -# Visual Studio LightSwitch build output -**/*.HTMLClient/GeneratedArtifacts -**/*.DesktopClient/GeneratedArtifacts -**/*.DesktopClient/ModelManifest.xml -**/*.Server/GeneratedArtifacts -**/*.Server/ModelManifest.xml -_Pvt_Extensions - -# Paket dependency manager -.paket/paket.exe -paket-files/ - -# FAKE - F# Make -.fake/ - -# CodeRush personal settings -.cr/personal - -# Python Tools for Visual Studio (PTVS) -__pycache__/ -*.pyc - -# Cake - Uncomment if you are using it -# tools/** -# !tools/packages.config - -# Tabs Studio -*.tss - -# Telerik's JustMock configuration file -*.jmconfig - -# BizTalk build output -*.btp.cs -*.btm.cs -*.odx.cs -*.xsd.cs - -# OpenCover UI analysis results -OpenCover/ - -# Azure Stream Analytics local run output -ASALocalRun/ - -# MSBuild Binary and Structured Log -*.binlog - -# NVidia Nsight GPU debugger configuration file -*.nvuser - -# MFractors (Xamarin productivity tool) working folder -.mfractor/ - -# Local History for Visual Studio -.localhistory/ - -# BeatPulse healthcheck temp database -healthchecksdb - -# Backup folder for Package Reference Convert tool in Visual Studio 2017 -MigrationBackup/ - -# Ionide (cross platform F# VS Code tools) working folder -.ionide/ diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md deleted file mode 100644 index c72a574..0000000 --- a/CODE_OF_CONDUCT.md +++ /dev/null @@ -1,9 +0,0 @@ -# Microsoft Open Source Code of Conduct - -This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). - -Resources: - -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) -- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns diff --git a/LICENSE b/LICENSE index 3d8b93b..4b1ad51 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License - Copyright (c) Microsoft Corporation. + Copyright (c) Microsoft Corporation. All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.psm1 b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.psm1 new file mode 100644 index 0000000..82c4c5f --- /dev/null +++ b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.psm1 @@ -0,0 +1,88 @@ +function Get-TargetResource +{ + [CmdletBinding()] + [OutputType([System.Collections.Hashtable])] + param + ( + [Parameter(Mandatory = $true)] + [System.String] + $NodeName + ) + + Write-Verbose -Message "Getting Information about reboot state for node {$NodeName}" + + $IsInCluster = $false + try + { + Connect-ServiceFabricCluster -ErrorAction Stop + $IsInCluster = $true + } + catch + { + Write-Verbose -Message "The current Node {$NodeName} is not joined to a Service Fabric Cluster." + } + $result = @{ + NodeName = $NodeName + IsInCluster = $IsInCluster + PendingReboot = Test-SFPendingReboot + } + return $result +} + +function Set-TargetResource +{ + [CmdletBinding()] + param + ( + [Parameter(Mandatory = $true)] + [System.String] + $NodeName + ) + + Write-Verbose -Message "Processing reboot request for Node {$NodeName}" + + $currentValues = Get-TargetResource @PSBoundParameters + + if ($currentValues.PendingReboot -and $currentValues.IsInCluster) + { + Write-Verbose -Message "Service Fabric Node {$NodeName} is already in a cluster. ` + Creating a repair job to handle the reboot operation." + try + { + Start-ServiceFabricRepairTask -NodeName $NodeName -NodeAction Reboot + } + catch + { + throw $_ + } + } + elseif ($currentValues.PendingReboot -and -not $currentValues.IsInCluster) + { + Write-Verbose -Message "Node {$NodeName} is not joined to a Service Fabric cluster. Forcing Reboot." + $global:DSCMachineStatus = 1 + } + else + { + Write-Verbose -Message "Node {$NodeName} is not pending a reboot. No action taken." + } +} + +function Test-TargetResource +{ + [CmdletBinding()] + [OutputType([System.Boolean])] + param + ( + [Parameter(Mandatory = $true)] + [System.String] + $NodeName + ) + + Write-Verbose -Message "Testing to see if Node {$NodeName} needs to be rebooted." + + $CurrentValues = Get-TargetResource @PSBoundParameters + + return !($CurrentValues.PendingReboot) +} + +Export-ModuleMember -Function *-TargetResource diff --git a/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.schema.mof b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.schema.mof new file mode 100644 index 0000000..bc75aef --- /dev/null +++ b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/MSFT_SFPendingReboot.schema.mof @@ -0,0 +1,5 @@ +[ClassVersion("1.0.0.0"), FriendlyName("SFPendingReboot")] +class MSFT_SFPendingReboot : OMI_BaseResource +{ + [Key, Description("The name of the Service Fabric node.")] string NodeName; +}; diff --git a/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/readme.md b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/readme.md new file mode 100644 index 0000000..c5773c9 --- /dev/null +++ b/Modules/ServiceFabricDSC/DSCResources/MSFT_SFPendingReboot/readme.md @@ -0,0 +1,4 @@ +# Description + +Handles the reboot of Nodes in a Service Fabric cluster by detecting if +a node is joined to a cluster and creating a Reboot repair job. diff --git a/Modules/ServiceFabricDSC/Modules/ServiceFabricsDSC.Common.psm1 b/Modules/ServiceFabricDSC/Modules/ServiceFabricsDSC.Common.psm1 new file mode 100644 index 0000000..463b908 --- /dev/null +++ b/Modules/ServiceFabricDSC/Modules/ServiceFabricsDSC.Common.psm1 @@ -0,0 +1,103 @@ +function Test-SFPendingReboot +{ + # The list of registry keys that will be used to determine if a reboot is required + $rebootRegistryKeys = @{ + ComponentBasedServicing = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\' + WindowsUpdate = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\' + PendingFileRename = 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\' + ActiveComputerName = 'HKLM:\SYSTEM\CurrentControlSet\Control\ComputerName\ActiveComputerName' + PendingComputerName = 'HKLM:\SYSTEM\CurrentControlSet\Control\ComputerName\ComputerName' + } + + $componentBasedServicingKeys = (Get-ChildItem -Path $rebootRegistryKeys.ComponentBasedServicing).Name + + if ($componentBasedServicingKeys) + { + $componentBasedServicing = $componentBasedServicingKeys.Split('\') -contains 'RebootPending' + } + else + { + $componentBasedServicing = $false + } + + $windowsUpdateKeys = (Get-ChildItem -Path $rebootRegistryKeys.WindowsUpdate).Name + + if ($windowsUpdateKeys) + { + $windowsUpdate = $windowsUpdateKeys.Split('\') -contains 'RebootRequired' + } + else + { + $windowsUpdate = $false + } + + $pendingFileRename = (Get-ItemProperty -Path $rebootRegistryKeys.PendingFileRename).PendingFileRenameOperations.Length -gt 0 + $activeComputerName = (Get-ItemProperty -Path $rebootRegistryKeys.ActiveComputerName).ComputerName + $pendingComputerName = (Get-ItemProperty -Path $rebootRegistryKeys.PendingComputerName).ComputerName + $pendingComputerRename = $activeComputerName -ne $pendingComputerName + + if ($SkipCcmClientSDK) + { + $ccmClientSDK = $false + } + else + { + $invokeCimMethodParameters = @{ + NameSpace = 'ROOT\ccm\ClientSDK' + ClassName = 'CCM_ClientUtilities' + Name = 'DetermineIfRebootPending' + ErrorAction = 'Stop' + } + + try + { + $ccmClientSDK = Invoke-CimMethod @invokeCimMethodParameters + } + catch + { + Write-Warning -Message ($script:localizedData.QueryCcmClientUtilitiesFailedMessage -f $_) + } + + $ccmClientSDK = ($ccmClientSDK.ReturnValue -eq 0) -and ($ccmClientSDK.IsHardRebootPending -or $ccmClientSDK.RebootPending) + } + + $results = @{ + SkipComponentBasedServicing = $SkipComponentBasedServicing + ComponentBasedServicing = $componentBasedServicing + SkipWindowsUpdate = $SkipWindowsUpdate + WindowsUpdate = $windowsUpdate + SkipPendingFileRename = $SkipPendingFileRename + PendingFileRename = $pendingFileRename + SkipPendingComputerRename = $SkipPendingComputerRename + PendingComputerRename = $pendingComputerRename + SkipCcmClientSDK = $SkipCcmClientSDK + CcmClientSDK = $ccmClientSDK + } + + $rebootRequired = $false + + foreach ($rebootTrigger in $results) + { + $skipTriggerName = 'Skip{0}' -f $rebootTrigger.Name + $skipTrigger = $pendingRebootState.$skipTriggerName + + if ($skipTrigger) + { + Write-Verbose -Message "Reboot Skipped" + } + else + { + if ($pendingRebootState.$($rebootTrigger.Name)) + { + Write-Verbose -Message "Reboot pending due to {$($rebootTrigger.Name)}" + $rebootRequired = $true + } + } + } + + $pendingRebootState += @{ + RebootRequired = $rebootRequired + } + + return $pendingRebootState +} diff --git a/Modules/ServiceFabricDSC/ServiceFabricDSC.psd1 b/Modules/ServiceFabricDSC/ServiceFabricDSC.psd1 new file mode 100644 index 0000000..b9a0b13 --- /dev/null +++ b/Modules/ServiceFabricDSC/ServiceFabricDSC.psd1 @@ -0,0 +1,116 @@ +# +# Module manifest for module 'ServiceFabricDsc' +# +# Generated by: Microsoft Corporation +# +# Generated on: 07/01/2020 +# + +@{ + + # Script module or binary module file associated with this manifest. + # RootModule = '' + + # Version number of this module. + ModuleVersion = '1.0.0.0' + + # ID used to uniquely identify this module + GUID = '689a9f3f-c92f-498d-a7f5-f50b26025737' + + # Author of this module + Author = 'Microsoft Corporation' + + # Company or vendor of this module + CompanyName = 'Microsoft Corporation' + + # Copyright statement for this module + Copyright = '(c) 2020 Microsoft Corporation. All rights reserved.' + + # Description of the functionality provided by this module + Description = 'This DSC module is used to handle the reboot operations for Service Fabric nodes.' + + # Minimum version of the Windows PowerShell engine required by this module + PowerShellVersion = '5.1' + + # Name of the Windows PowerShell host required by this module + # PowerShellHostName = '' + + # Minimum version of the Windows PowerShell host required by this module + # PowerShellHostVersion = '' + + # Minimum version of Microsoft .NET Framework required by this module + # DotNetFrameworkVersion = '' + + # Minimum version of the common language runtime (CLR) required by this module + # CLRVersion = '' + + # Processor architecture (None, X86, Amd64) required by this module + # ProcessorArchitecture = '' + + # Modules that must be imported into the global environment prior to importing this module + # RequiredModules = @() + + # Assemblies that must be loaded prior to importing this module + # RequiredAssemblies = @() + + # Script files (.ps1) that are run in the caller's environment prior to importing this module. + # ScriptsToProcess = @() + + # Type files (.ps1xml) to be loaded when importing this module + # TypesToProcess = @() + + # Format files (.ps1xml) to be loaded when importing this module + # FormatsToProcess = @() + + # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess + NestedModules = @("modules\ServiceFabricDSC.Common.psm1") + + # Functions to export from this module + #FunctionsToExport = '*' + + # Cmdlets to export from this module + CmdletsToExport = @("Test-SFPendingReboot") + + # Variables to export from this module + #VariablesToExport = '*' + + # Aliases to export from this module + #AliasesToExport = '*' + + # List of all modules packaged with this module + # ModuleList = @() + + # List of all files packaged with this module + # FileList = @() + + # HelpInfo URI of this module + # HelpInfoURI = '' + + # Default prefix for commands exported from this module. Override the default prefix using Import-Module -prefix. + # DefaultCommandPrefix = '' + + # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell. + PrivateData = @{ + + PSData = @{ + + # Tags applied to this module. These help with module discovery in online galleries. + Tags = @('DesiredStateConfiguration', 'DSC', 'DSCResource') + + # A URL to the license for this module. + LicenseUri = 'https://github.com/Microsoft/ServiceFabricDSC/blob/master/LICENSE' + + # A URL to the main website for this project. + ProjectUri = 'https://github.com/Microsoft/ServiceFabricDSC' + + # A URL to an icon representing this module. + # IconUri = '' + + # ReleaseNotes of this module + ReleaseNotes = "" + } # End of PSData hashtable + + } # End of PrivateData hashtable +} + + diff --git a/README.md b/README.md index b81a84e..2748b69 100644 --- a/README.md +++ b/README.md @@ -1,14 +1 @@ - -# 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. +# ServiceFabricDSC diff --git a/SECURITY.md b/SECURITY.md deleted file mode 100644 index 7ab49eb..0000000 --- a/SECURITY.md +++ /dev/null @@ -1,41 +0,0 @@ - - -## Security - -Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). - -If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below. - -## Reporting Security Issues - -**Please do not report security vulnerabilities through public GitHub issues.** - -Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report). - -If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc). - -You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). - -Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: - - * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) - * Full paths of source file(s) related to the manifestation of the issue - * The location of the affected source code (tag/branch/commit or direct URL) - * Any special configuration required to reproduce the issue - * Step-by-step instructions to reproduce the issue - * Proof-of-concept or exploit code (if possible) - * Impact of the issue, including how an attacker might exploit the issue - -This information will help us triage your report more quickly. - -If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://microsoft.com/msrc/bounty) page for more details about our active programs. - -## Preferred Languages - -We prefer all communications to be in English. - -## Policy - -Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/en-us/msrc/cvd). - -