Tink (Java)

Факты и проверки, на которых они основаны

Ничего из приведённого ниже не скопировано из документации. 20 октября 2026 г. проверка content/libraries/verify/tink/run.sh запустила Tink (Java) 1.24.0 в образе контейнера maven:3.9.16-eclipse-temurin-25; содержимое страницы должно совпадать с выводом проверки, а у каждого факта приведены соответствующие строки вывода.

• Кодировка подписи ECDSA

  der

  Подписи ECDSA_P256 записаны в DER после префикса вывода.

  Что записала проверка

  fact ecdsa-signature-encoding = der

• Префикс подписи

  tink-5-byte

  Стандартные шаблоны добавляют в начало 5-байтовый префикс (0x01 и идентификатор ключа), и 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

  Открытый ключ, импортированный из PEM через SignaturePemKeysetReader, проверял только подписи DER; подпись raw r‖s не проходила проверку, пока её не перекодировали в DER.

  Что записала проверка

  fact pem-import-encoding = der

• Nonce в ECDSA

  random

  Случайный nonce: две подписи одного сообщения различаются.

  Что записала проверка

  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 для 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

  SPKI в PEM через SignaturePemKeysetReader; в остальных случаях ключи хранятся в наборах ключей 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");
    }
}