In a Windows console:
rem Set environment variables
SET CORECLR_ENABLE_PROFILING=1
SET CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
SET DD_APPSEC_ENABLED=true
SET DD_APM_TRACING_ENABLED=false
rem Start application
dotnet.exe example.dll
Run the following PowerShell command as administrator to configure the necessary environment variables in the registry HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment and restart IIS.
$target=[System.EnvironmentVariableTarget]::Machine
[System.Environment]::SetEnvironmentVariable("DD_APPSEC_ENABLED","true",$target)
[System.Environment]::SetEnvironmentVariable("DD_APM_TRACING_ENABLED","false",$target)
net stop was /y
net start w3svc
Or, for IIS services exclusively, on WAS and W3SVC with Powershell as an administrator, run:
$appsecPart = "DD_APPSEC_ENABLED=true DD_APM_TRACING_ENABLED=false"
[string[]] $defaultvariable = @("CORECLR_ENABLE_PROFILING=1", "CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}", $appsecPart)
function Add-AppSec {
param (
$path
)
$v = (Get-ItemProperty -Path $path).Environment
If ($v -eq $null) {
Set-ItemProperty -Path $path -Name "Environment" -Value $defaultvariable
}
ElseIf (-not ($v -match $appsecPart)) {
$v += " " + $appsecPart;
Set-ItemProperty -Path $path -Name "Environment" -Value $v
}
}
Add-AppSec -path "HKLM:SYSTEM\CurrentControlSet\Services\WAS\"
Add-AppSec -path "HKLM:SYSTEM\CurrentControlSet\Services\W3SVC\"
net stop was /y
net start w3svc
Or, to avoid editing registry keys, edit the application settings in the web.config file of your application:
<configuration>
<appSettings>
<add key="DD_APPSEC_ENABLED" value="true"/>
<add key="DD_APM_TRACING_ENABLED" value="false"/>
</appSettings>
</configuration>
This can also be done at the IIS application pools level in the applicationHost.config file, usually in C:\Windows\System32\inetsrv\config\:
<system.applicationHost>
<applicationPools>
<add name="DefaultAppPool">
<environmentVariables>
<add name="DD_APPSEC_ENABLED" value="true" />
<add name="DD_APM_TRACING_ENABLED" value="false" />
</environmentVariables>
(...)
Add the following to your application configuration:
DD_APPSEC_ENABLED=true
DD_APM_TRACING_ENABLED=false
Update your configuration container for APM by adding the following arguments in your docker run command:
docker run [...] -e DD_APPSEC_ENABLED=true -e DD_APM_TRACING_ENABLED=false [...]
Add the following environment variable values to your container Dockerfile:
ENV DD_APPSEC_ENABLED=true
ENV DD_APM_TRACING_ENABLED=false
Update your deployment configuration file for APM and add the Application & API Protection environment variables:
spec:
template:
spec:
containers:
- name: <CONTAINER_NAME>
image: <CONTAINER_IMAGE>/<TAG>
env:
- name: DD_APPSEC_ENABLED
value: "true"
- name: DD_APM_TRACING_ENABLED
value: "false"
Update your ECS task definition JSON file, by adding these in the environment section:
"environment": [
...,
{
"name": "DD_APPSEC_ENABLED",
"value": "true"
},
{
"name": "DD_APM_TRACING_ENABLED",
"value": "false"
}
]
Add the following lines to your container Dockerfile:
ENV DD_APPSEC_ENABLED=true
ENV DD_APM_TRACING_ENABLED=false
