Tink (Java)

事実とその根拠となるチェック

以下の内容はドキュメントからの転記ではありません。2026年10月20日に、チェック content/libraries/verify/tink/run.sh がコンテナイメージ maven:3.9.16-eclipse-temurin-25 内で Tink (Java) 1.24.0 を実行しました。このページの内容はその出力と一致していなければならず、各事実には該当する出力行を示しています。

• ECDSA 署名のエンコーディング

  der

  ECDSA_P256 の署名は、出力プレフィックスの後に続く DER です。

  チェックによる記録

  fact ecdsa-signature-encoding = der

• 署名のプレフィックス

  tink-5-byte

  デフォルトのテンプレートは 5 バイトのプレフィックス（0x01 と鍵 ID）を先頭に付けます。JDK はこれを Invalid encoding for signature で拒否しました。

  チェックによる記録

  fact output-prefix = tink-5-byte
  evidence output-prefix: ECDSA_P256 signature starts with 0x01 followed by the 4-byte key id, then the DER signature
  evidence output-prefix: ECDSA_P256_IEEE_P1363 signature: 69 bytes (5-byte prefix + 64)
  evidence output-prefix: ECDSA_P256 signature given to the JDK with the prefix: SignatureException: Invalid encoding for signature

• RAW テンプレートのエンコーディング

  ieee-p1363

  ECDSA_P256_RAW は 64 バイトの IEEE P1363 形式の r‖s を出力しました（プレフィックスなし、DER ではありません）。この署名は SHA256withECDSAinP1363Format で検証できました。

  チェックによる記録

  fact raw-template-encoding = ieee-p1363
  evidence raw-template-encoding: ECDSA_P256_RAW signature: 64 bytes, parses as DER: false
  evidence raw-template-encoding: ECDSA_P256_RAW signature verifies in the JDK's SHA256withECDSAinP1363Format: true

• PEM インポート後の署名エンコーディング

  der

  SignaturePemKeysetReader で PEM からインポートした公開鍵では、DER 署名しか検証できませんでした。生の r‖s 署名は、DER に再エンコードするまで検証に失敗しました。

  チェックによる記録

  fact pem-import-encoding = der

• ECDSA の nonce

  random

  nonce はランダムです。同じメッセージへの 2 つの署名は異なります。

  チェックによる記録

  fact ecdsa-nonce = random

• 署名時の low-S

  either

  s は正規化されません。64 個の署名の中に high-S の値が現れました。

  チェックによる記録

  fact ecdsa-low-s-sign = either

• 検証時の high-S

  accepts-high-s

  s を n − s に置き換えた署名も検証を通りました。

  チェックによる記録

  fact ecdsa-low-s-verify = accepts-high-s

• 署名呼び出しがハッシュする対象

  hashes-message

  プリミティブはメッセージに署名します。ダイジェストに署名する API はありません。

  チェックによる記録

  fact ecdsa-prehash = hashes-message

• 不正な形式の ECDSA 署名

  throws

  不正な形式の署名に対しては GeneralSecurityException: invalid signature がスローされます。

  チェックによる記録

  fact ecdsa-malformed-signature = throws
  evidence ecdsa-malformed-signature: GeneralSecurityException: invalid signature

• ECDSA の曲線

  P-256P-384P-521

  P-256、P-384、P-521 のテンプレートで署名と検証ができました。

  チェックによる記録

  fact ecdsa-curves = P-256, P-384, P-521

• EdDSA

  Ed25519

  出力プレフィックスあり・なしの Ed25519 テンプレートがあります。

  チェックによる記録

  fact eddsa = Ed25519

• ポスト量子アルゴリズム

  none

  Tink for Java 1.24.0 には ML-DSA と SLH-DSA のテンプレートが登録されていません。

  チェックによる記録

  fact pqc = none
  evidence pqc: ML_DSA_65: GeneralSecurityException: Name ML_DSA_65 does not exist
  evidence pqc: SLH_DSA_SHA2_128S: GeneralSecurityException: Name SLH_DSA_SHA2_128S does not exist

• 公開鍵の形式

  spki-pem

  SignaturePemKeysetReader で SPKI の PEM を読み込めます。それ以外の鍵は Tink の鍵セットで管理されます。

  チェックによる記録

  fact public-key-formats = spki-pem
  evidence public-key-formats: SPKI PEM through SignaturePemKeysetReader, then verifying the RAW template's raw signature: GeneralSecurityException: invalid signature
  evidence public-key-formats: the same signature re-encoded as DER against the PEM-imported key: ok
  evidence public-key-formats: Tink JSON public keyset round trip: ok

• キーセットの形式

  tink-jsontink-binary

  鍵セットは Tink JSON またはバイナリの protobuf としてシリアライズされます。公開鍵セットは JSON を介した書き出しと読み戻しができました。

  チェックによる記録

  fact keyset-format = tink-json, tink-binary

使い方

import com.google.crypto.tink.KeyTemplates;
import com.google.crypto.tink.KeysetHandle;
import com.google.crypto.tink.PublicKeySign;
import com.google.crypto.tink.PublicKeyVerify;
import com.google.crypto.tink.RegistryConfiguration;
import com.google.crypto.tink.signature.SignatureConfig;
import java.nio.charset.StandardCharsets;

public class Usage {
    public static void main(String[] args) throws Exception {
        SignatureConfig.register();
        byte[] message = "order #1042 approved".getBytes(StandardCharsets.UTF_8);

        // Default templates prepend a 5-byte key-id prefix that no other library expects.
        KeysetHandle tinkOnly = KeysetHandle.generateNew(KeyTemplates.get("ECDSA_P256"));
        byte[] prefixed = tinkOnly.getPrimitive(RegistryConfiguration.get(), PublicKeySign.class).sign(message);

        // For signatures other systems verify, pick a *_WITHOUT_PREFIX / *_RAW template.
        KeysetHandle portable = KeysetHandle.generateNew(KeyTemplates.get("ECDSA_P256_IEEE_P1363_WITHOUT_PREFIX"));
        byte[] raw = portable.getPrimitive(RegistryConfiguration.get(), PublicKeySign.class).sign(message);
        portable.getPublicKeysetHandle().getPrimitive(RegistryConfiguration.get(), PublicKeyVerify.class).verify(raw, message);

        System.out.println("prefixed first byte: 0x0" + prefixed[0] + ", portable signature: " + raw.length + " bytes, verified");
    }
}