Пакет fips140

• import "crypto/fips140"
• Обзор
• Указатель

Обзор

Пакет fips140 предоставляет информацию о криптографическом модуле Go, соответствующем FIPS 140-3, и режиме FIPS 140-3.

Подробнее см. в документации по FIPS 140-3.

Указатель

• func Enabled() bool
• func Enforced() bool
• func Version() string
• func WithoutEnforcement(f func())

Файлы пакета

enforcement.go fips140.go

func Enabled 1.24

func Enabled() bool

Enabled сообщает, работают ли криптографические библиотеки в режиме FIPS 140-3.

Это можно настроить во время выполнения с помощью параметра GODEBUG "fips140". Если установлено значение "on", режим FIPS 140-3 включен. Если установлено значение "only", функции криптографии, не одобренные для использования, дополнительно будут возвращать ошибки или вызывать панику.

Это нельзя изменить после запуска программы.

func Enforced 1.26

func Enforced() bool

Enforced сообщает, включен ли строгий режим соблюдения требований FIPS 140-3. Строгий режим включается, если программа запущена с GODEBUG=fips140=only и соблюдение требований не было отключено вызовом WithoutEnforcement.

func Version 1.26

func Version() string

Version возвращает версию криптографического модуля Go, соответствующего FIPS 140-3 (например, "v1.0.0"), указанную в политике безопасности модуля, если сборка выполняется с замороженным модулем, заданным с помощью GOFIPS140. В противном случае возвращается "latest". Если используется псевдоним (например, "inprogress"), возвращается фактически разрешенная версия.

Возвращаемая версия может не обеспечивать уникальную идентификацию замороженного модуля, использованного для сборки программы, если существуют несколько копий замороженного модуля с одной и той же версией. Уникальный идентифицирующий суффикс версии можно найти, проверив значение параметра GOFIPS140 в runtime/debug.BuildInfo.Settings.

func WithoutEnforcement 1.26

func WithoutEnforcement(f func())

WithoutEnforcement отключает строгий режим соблюдения требований FIPS 140-3 на время выполнения f. Вызов WithoutEnforcement, когда строгий режим не включен (не задано GODEBUG=fips140=only или вызов уже выполняется внутри WithoutEnforcement), ничего не делает.

Действие WithoutEnforcement распространяется на все горутины, запущенные во время выполнения f.

Поскольку этот вызов отключает соблюдение требований, его следует применять только к функциям с четко ограниченной областью действия.