58 lines
2 KiB
Go
58 lines
2 KiB
Go
// Copyright 2017 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
/*
|
|
Package auth authenticates a message using a secret key.
|
|
|
|
The Sum function, viewed as a function of the message for a uniform random
|
|
key, is designed to meet the standard notion of unforgeability. This means
|
|
that an attacker cannot find authenticators for any messages not authenticated
|
|
by the sender, even if the attacker has adaptively influenced the messages
|
|
authenticated by the sender. For a formal definition see, e.g., Section 2.4
|
|
of Bellare, Kilian, and Rogaway, "The security of the cipher block chaining
|
|
message authentication code," Journal of Computer and System Sciences 61 (2000),
|
|
362–399; http://www-cse.ucsd.edu/~mihir/papers/cbc.html.
|
|
|
|
auth does not make any promises regarding "strong" unforgeability; perhaps
|
|
one valid authenticator can be converted into another valid authenticator for
|
|
the same message. NaCl also does not make any promises regarding "truncated
|
|
unforgeability."
|
|
|
|
This package is interoperable with NaCl: https://nacl.cr.yp.to/auth.html.
|
|
*/
|
|
package auth
|
|
|
|
import (
|
|
"crypto/hmac"
|
|
"crypto/sha512"
|
|
)
|
|
|
|
const (
|
|
// Size is the size, in bytes, of an authenticated digest.
|
|
Size = 32
|
|
// KeySize is the size, in bytes, of an authentication key.
|
|
KeySize = 32
|
|
)
|
|
|
|
// Sum generates an authenticator for m using a secret key and returns the
|
|
// 32-byte digest.
|
|
func Sum(m []byte, key *[KeySize]byte) *[Size]byte {
|
|
mac := hmac.New(sha512.New, key[:])
|
|
mac.Write(m)
|
|
out := new([KeySize]byte)
|
|
copy(out[:], mac.Sum(nil)[:Size])
|
|
return out
|
|
}
|
|
|
|
// Verify checks that digest is a valid authenticator of message m under the
|
|
// given secret key. Verify does not leak timing information.
|
|
func Verify(digest []byte, m []byte, key *[KeySize]byte) bool {
|
|
if len(digest) != Size {
|
|
return false
|
|
}
|
|
mac := hmac.New(sha512.New, key[:])
|
|
mac.Write(m)
|
|
expectedMAC := mac.Sum(nil) // first 256 bits of 512-bit sum
|
|
return hmac.Equal(digest, expectedMAC[:Size])
|
|
}
|