Open in the explorer

Set maximum Kerberos SSPI context token buffer size

Définir la taille maximale de la mémoire tampon des jetons de contexte SSPI Kerberos

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › System › Kerberos FR: Configuration ordinateur › Stratégies › Modèles d'administration › Système › Kerberos
Supported on
At least Windows Server 2003 operating systems or Windows XP Professional FR: Au minimum Windows Server 2003 ou Windows XP Professionnel
ADMX file
Kerberos.admx
Internal name
Kerberos/MaxTokenSize

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.

French text from Windows 11 26H2

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
StateValue written
EnabledREG_DWORD = 1
DisabledREG_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 2147483647

Disable

# 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 DWord

Revert 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 SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Maximum sizeTaille maximaleMaxTokenSizeNumeric boxdecimalMaxTokenSizeREG_DWORD
Required · Min: 12000 · Max: 2147483647 · Default (UI): 48000

Availability