Set maximum Kerberos SSPI context token buffer size
Définir la taille maximale de la mémoire tampon des jetons de contexte SSPI Kerberos
Explanation
This policy setting allows you to set the value returned to applications which request the maximum size of the SSPI context token buffer size.
The size of the context token buffer determines the maximum size of SSPI context tokens an application expects and allocates. Depending upon authentication request processing and group memberships, the buffer might be smaller than the actual size of the SSPI context token.
If you enable this policy setting, the Kerberos client or server uses the configured value, or the locally allowed maximum value, whichever is smaller.
If you disable or do not configure this policy setting, the Kerberos client or server uses the locally configured value or the default value.
Note: This policy setting configures the existing MaxTokenSize registry value in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Parameters, which was added in Windows XP and Windows Server 2003, with a default value of 12,000 bytes. Beginning with Windows 8 the default is 48,000 bytes. Due to HTTP's base64 encoding of authentication context tokens, it is not advised to set this value more than 48,000 bytes.
Ce paramètre de stratégie vous permet de définir la valeur retournée aux applications qui demandent la limite maximale de la taille de la mémoire tampon pour les jetons de contexte SSPI.
La taille de la mémoire tampon des jetons de contexte détermine la taille maximale des jetons de contexte SSPI qu’une application doit prévoir et allouer. Selon le traitement des demandes d’authentification et selon les appartenances aux groupes, la mémoire tampon peut être plus petite que la taille réelle des jetons de contexte SSPI.
Si vous activez ce paramètre de stratégie, le client ou le serveur Kerberos utilise soit la valeur configurée, soit la valeur maximale autorisée localement, en fonction de celle qui est la plus faible.
Si vous désactivez ce paramètre de stratégie ou si vous ne le configurez pas, le client ou le serveur Kerberos utilise la valeur configurée localement ou la valeur par défaut.
Remarque : ce paramètre de stratégie configure la valeur de Registre existante MaxTokenSize dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Parameters, ajoutée à Windows XP et Windows Server 2003 avec une valeur par défaut de 12 000 octets. À partir de Windows 8, la valeur par défaut est de 48 000 octets. En raison de l’encodage base64 du protocole HTTP pour les jetons de contexte d’authentification, il est déconseillé de définir cette valeur au-delà de 48 000 octets.
Registry
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters- Value name
EnableMaxTokenSize
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_DWORD = 0 |
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: Kerberos/MaxTokenSize
$k = 'HKLM:\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableMaxTokenSize' -Value 1 -Type DWord
# Maximum size
Set-ItemProperty -Path $k -Name 'MaxTokenSize' -Value 48000 -Type DWord # between 12000 and 2147483647Disable
# Disable: Kerberos/MaxTokenSize
$k = 'HKLM:\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableMaxTokenSize' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": Kerberos/MaxTokenSize
$k = 'HKLM:\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters'
Remove-ItemProperty -Path $k -Name 'EnableMaxTokenSize' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'MaxTokenSize' -ErrorAction SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Maximum sizeTaille maximaleMaxTokenSize | Numeric boxdecimal | MaxTokenSize | REG_DWORD | Required · Min: 12000 · Max: 2147483647 · Default (UI): 48000 |