いますぐフォークしてオンライン編集し、このページのプルリクエストを送信します。 Github へのログインが必要です。これは小さな変更に適しています。大きな変更を加えたい場合は、通常の cloneの使用をお勧めします。

日本語版について

個人的な学習のために、dlang.orgを翻訳したサイトです。翻訳に際して、様々なサイトを参考にしています。

std.digest.hmac

This package implements the hash-based message authentication code (HMAC) algorithm as defined in RFC2104. See also the corresponding Wikipedia article.

License:

Boost License 1.0.

Source std/digest/hmac.d

Examples:

Template API HMAC implementation.

This implements an HMAC over the digest H. If H doesn't provide information about the block size, it can be supplied explicitly using the second overload.

This type conforms to std.digest.isDigest.

Compute HMAC over an input string

import std.ascii : LetterCase;
import std.digest : toHexString;
import std.digest.sha : SHA1;
import std.string : representation;

auto secret = "secret".representation;
assert("The quick brown fox jumps over the lazy dog"
        .representation
        .hmac!SHA1(secret)
        .toHexString!(LetterCase.lower) == "198ea1ea04c435c1246b586a06d5cf11c3ffcda6");

struct HMAC(H, size_t hashBlockSize) if (hashBlockSize % 8 == 0); template hmac(H) if (isDigest!H && hasBlockSize!H) auto hmac(H, size_t blockSize)(scope const(ubyte)[] secret) if (isDigest!H);

Overload of HMAC to be used if H doesn't provide information about its block size.

Examples:

import std.digest.sha : SHA1;
import std.string : representation;
string data1 = "Hello, world", data2 = "Hola mundo";
auto hmac = HMAC!SHA1("My s3cR3T keY".representation);
auto digest = hmac.put(data1.representation)
                  .put(data2.representation)
                  .finish();
static immutable expected = [
    197, 57, 52, 3, 13, 194, 13,
    36, 117, 228, 8, 11, 111, 51,
    165, 3, 123, 31, 251, 113];
writeln(digest); // expected

this(scope const(ubyte)[] secret);

Constructs the HMAC digest using the specified secret.

Examples:

import std.digest.sha : SHA1;
import std.string : representation;
auto hmac = HMAC!SHA1("My s3cR3T keY".representation);
hmac.put("Hello, world".representation);
static immutable expected = [
    130, 32, 235, 44, 208, 141,
    150, 232, 211, 214, 162, 195,
    188, 127, 52, 89, 100, 68, 90, 216];
writeln(hmac.finish()); // expected

ref HMAC!(H, blockSize) start() return;

Reinitializes the digest, making it ready for reuse.

Note The constructor leaves the digest in an initialized state, so that this method only needs to be called if an unfinished digest is to be reused.

Returns:

A reference to the digest for convenient chaining.

Examples:

import std.digest.sha : SHA1;
import std.string : representation;
string data1 = "Hello, world", data2 = "Hola mundo";
auto hmac = HMAC!SHA1("My s3cR3T keY".representation);
hmac.put(data1.representation);
hmac.start();                   // reset digest
hmac.put(data2.representation); // start over
static immutable expected = [
    122, 151, 232, 240, 249, 80,
    19, 178, 186, 77, 110, 23, 208,
    52, 11, 88, 34, 151, 192, 255];
writeln(hmac.finish()); // expected

ref HMAC!(H, blockSize) put(in ubyte[] data...) return;

Feeds a piece of data into the hash computation. This method allows the type to be used as an std.range.OutputRange.

Returns:

A reference to the digest for convenient chaining.

Examples:

import std.digest.hmac, std.digest.sha;
import std.string : representation;
string data1 = "Hello, world", data2 = "Hola mundo";
auto hmac = HMAC!SHA1("My s3cR3T keY".representation);
hmac.put(data1.representation)
    .put(data2.representation);
static immutable expected = [
    197, 57, 52, 3, 13, 194, 13,
    36, 117, 228, 8, 11, 111, 51,
    165, 3, 123, 31, 251, 113];
writeln(hmac.finish()); // expected

DigestType!H finish();

Resets the digest and returns the finished hash.

Examples:

import std.digest.sha : SHA1;
import std.string : representation;
string data1 = "Hello, world", data2 = "Hola mundo";
auto hmac = HMAC!SHA1("My s3cR3T keY".representation);
auto digest = hmac.put(data1.representation)
                  .put(data2.representation)
                  .finish();
static immutable expected = [
    197, 57, 52, 3, 13, 194, 13,
    36, 117, 228, 8, 11, 111, 51,
    165, 3, 123, 31, 251, 113];
writeln(digest); // expected

Library Reference

std.digest.hmac