PIBIO_ENGINE_IDENTIFY_FEATURE_SET_SECURE_FN

Windows Biometric Framework によって呼び出され、現在の特徴セットからテンプレートを構築し、データベース内で一致するテンプレートを検索します。一致するテンプレートが見つかった場合、エンジンアダプターは Identity、SubFactor、Authorization、AuthorizationSize の各フィールドを設定する必要があります。

何らかの理由でキーを使用できない場合は、WINBIO_E_INVALID_KEY_IDENTIFIER を返す必要があります。WINBIO_E_INVALID_KEY_IDENTIFIER が返されると、センサーと TPM は再プロビジョニングされます。

Authorization バッファーには、次の SHA256_HMAC が格納されます。

SHA256_HMAC(Key, SHA256(Nonce || 0xffffffe2 || SHA256(AccountSid)))

• Key

  Key は、EngineAdapterCreateKey によって渡され、KeyIdentifier パラメーターで識別される HMAC キーです。

• Nonce

  Nonce は、Nonce パラメーターです。

• 0xffffffe2

  ビッグエンディアン形式の 32 ビット符号なし整数です。

• AccountSid

  Identity パラメーターが参照するユーザーのアカウント SID です。SID のバイト列は WINBIO_IDENTITY 構造体から取得できます。

例

SHA256 HMAC の計算を擬似コードで実装した例を次に示します。

// Hash the AccountSid.
    assert(Identity->Type == WINBIO_ID_TYPE_SID);
    hashHandle = CreateHash(SHA256_ALGORITHM);
    HashData(
        hashHandle, 
        Identity->Value.AccountSid.Data, 
        Identity->Value.AccountSid.Size);
    identityHash = FinishHash(hashHandle);

    // Hash the parameters.
    BYTE bytes[] = {0xff, 0xff, 0xff, 0xe2};
    hashHandle = CreateHash(SHA256_ALGORITHM);
    HashData(hashHandle, Nonce, NonceSize);
    HashData(hashHandle, bytes, sizeof(bytes));
    HashData(hashHandle, identityHash, SHA256_DIGEST_LENGTH);
    parameterHash = FinishHash(hashHandle);

    // Calculate the authorization HMAC
    key, keySize = GetKeyFromIdentifier(KeyIdentifier, KeyIdentifierSize);
    hashHandle = CreateHash(HMAC_SHA256_ALGORITHM, key, keySize);
    HashData(hashHandle, parameterHash, SHA256_DIGEST_LENGTH);
    authorization = FinishHash(hashHandle);