Contrôler l’utilisation de l’API Web Serial
Vérifié avec Mozilla Firefox v8.2 — mis à jour le 10 juillet 2026
Pris en charge sur : Firefox 151 ou supérieur
Chemin dans la console GPO
Configuration ordinateur\Modèles d'administration\Mozilla\Firefox Configuration utilisateur\Modèles d'administration\Mozilla\Firefox Description
Si cette stratégie est activée, vous pouvez contrôler si les sites web peuvent demander l’accès aux ports série. Remarque : si d’autres stratégies sont configurées et que celle-ci ne l’est pas, l’API Web Serial est bloquée par défaut.
Registre
HKLM
Software\Policies\Mozilla\Firefox HKCU
Software\Policies\Mozilla\Firefox Générateur d'exports
BETAConfigurez l'état, la portée et les options, puis générez les sorties .reg, PowerShell, Intune et SCCM — ou ajoutez le paramètre à une collection multi-paramètres.
Ces exports écrivent le registre — ce n'est pas une GPO managée. ⓘ
Appliquer les deux portées crée une configuration ambiguë (la portée ordinateur prévaut sur la portée utilisateur). Ne le faites que volontairement.
Fichier .reg
Windows Registry Editor Version 5.00
; Exported from gporais.com
; Policy: Contrôler l’utilisation de l’API Web Serial
; State: Enabled
; Scope: Computer (HKLM)
; Supported on: Firefox 151 ou supérieur
[HKEY_LOCAL_MACHINE\Software\Policies\Mozilla\Firefox]
"DefaultSerialGuardSetting"=dword:00000002Autres formats (PowerShell, Intune, SCCM)
PowerShell
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
$path = 'HKLM:\Software\Policies\Mozilla\Firefox'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'DefaultSerialGuardSetting' -Value 2 -Type DWordIntune XML
Aucune correspondance directe Policy CSP / OMA-URI pour cette stratégie. Utilisez l'onglet Intune Remediation, ou importez l'ADMX dans Intune.Intune Remediation
# === Detection script ===
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Mozilla\Firefox' -Name 'DefaultSerialGuardSetting' -Expected 2 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
$path = 'HKLM:\Software\Policies\Mozilla\Firefox'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'DefaultSerialGuardSetting' -Value 2 -Type DWordScripts SCCM
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
# SCCM Configuration Item guidance:
# Create a Configuration Item of type "Setting: Script".
# Discovery script: use the Detection script below.
# Remediation script: use the Remediation script below.
# Compliance rule: the Discovery script output equals 'Compliant'.
# === Detection script ===
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Mozilla\Firefox' -Name 'DefaultSerialGuardSetting' -Expected 2 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Contrôler l’utilisation de l’API Web Serial
# State: Enabled
# Scope: Computer (HKLM)
# Supported on: Firefox 151 ou supérieur
$path = 'HKLM:\Software\Policies\Mozilla\Firefox'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'DefaultSerialGuardSetting' -Value 2 -Type DWordVous construisez une collection multi-paramètres ? Ajoutez ce paramètre et générez des exports combinés (.reg, PowerShell, GPO).