Documentation
¶
Index ¶
- func Decrypt(cipherStr string) (plain []byte, err error)
- func DecryptWithKey(key []byte, cipherStr string) ([]byte, error)
- func DiscardGeneratedKey() error
- func Encrypt(plain []byte) (cipherStr string, err error)
- func ExportKey() ([]byte, error)
- func KeyStatus() (path string, generated bool, err error)
- func ReloadKey()
- func ResetForTest()
- func RestoreKeyState(s KeyState)
- type AESGCMEncryptor
- type KeyState
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Decrypt ¶
Decrypt decodes base64 string and decrypts to plaintext. Expects format: base64(nonce | ciphertext | authtag)
func DecryptWithKey ¶
DecryptWithKey 用给定的 AES-256 密钥解 Encrypt 产生的密文,不碰进程里的密钥: 校验备份时要用备份里的密钥解它的数据库。
func DiscardGeneratedKey ¶
func DiscardGeneratedKey() error
DiscardGeneratedKey 删除本次启动新生成的密钥文件并停用它。启动检查发现库里已有旧密文时调用: 新密钥解不开旧数据,留着它,下次启动就会被当成正常密钥使用。
func Encrypt ¶
Encrypt encrypts plaintext and returns base64-encoded "nonce|ciphertext|authtag" All three components are packed into the base64 string for transport.
func KeyStatus ¶
KeyStatus 报告启动时密钥的来源,供运行时初始化做安全检查: path 是密钥文件路径(用 PT_TOOLS_SECRET_KEY 时为空),generated 表示本次启动新生成了密钥文件, err 非空表示密钥文件存在却无法使用。
func ResetForTest ¶
func ResetForTest()
ResetForTest re-reads the secret key from environment, intended for tests that need to switch the active key via t.Setenv across packages. Production code MUST NOT call this.
func RestoreKeyState ¶
func RestoreKeyState(s KeyState)
RestoreKeyState 把 SnapshotKeyState 记下的状态原样放回去,不读磁盘。
Types ¶
type AESGCMEncryptor ¶
type AESGCMEncryptor struct {
// contains filtered or unexported fields
}
type KeyState ¶
type KeyState struct {
// contains filtered or unexported fields
}
KeyState 是内存里密钥状态的原样快照:加密器、密钥文件路径、是否本进程新生成、读取错误、是否已经读过。
func SnapshotKeyState ¶
func SnapshotKeyState() KeyState
SnapshotKeyState 原样记下内存里的密钥状态(还没读过时先读一次,和 KeyStatus 一样)。