INTEGRITY Документация

Мониторинг Auditor

Key Transparency Auditor от Cloudflare проверяет доказательства аудита Log и предоставляет для них подпись. После этого Log может распространить эти подписи среди своих конечных пользователей, что даёт им уверенность в том, что ключи не были подделаны.

Чтобы проверить нашу работу, вы можете использовать Plexi ↗, CLI инструмент, который позволяет любому пользователю выполнять локальную проверку доказательств через публичный API.

Возможности

Установка

Окружение Команда CLI
Cargo ↗ (Rust 1.81+) cargo install plexi

Использование

Используйте --help опцию, чтобы узнать больше о командах и их параметрах.

plexi [OPTIONS] <COMMAND>

Настройка remote аудитора

plexi не поставляется со стандартным remote аудитора, поэтому вам нужно будет выбрать свой собственный.

Сделать это можно, либо передав --remote-url=<REMOTE> или задав PLEXI_REMOTE_URL переменную окружения.

Ниже приведён типичный пример remote:

Название Remote
Cloudflare https://plexi.key-transparency.cloudflare.com

Если вы развернули собственный аудитор, вы можете добавить remote, оформив Issue в GitHub ↗.

Список отслеживаемых Log

Аудитор отслеживает сразу несколько Log. Чтобы узнать, какие Log отслеживает аудитор, выполните следующую команду:

plexi ls --remote-url 'https://plexi.key-transparency.cloudflare.com'
whatsapp.key-transparency.v1

Аудит подписи

Key Transparency Auditor подтверждает действительность Log, обеспечивая уникальность эпох и проверяя связанное с ними доказательство.

plexi audit предоставляет информацию о заданной эпохе и её действительности. Она может выполнить локальный аудит, чтобы подтвердить поведение аудитора.

Например, чтобы проверить Log WhatsApp, аудируемый Cloudflare Auditor, выполните следующую команду:

> plexi audit --remote-url 'https://plexi.key-transparency.cloudflare.com' --namespace 'whatsapp.key-transparency.v1' --long
Namespace
  Name               : whatsapp.key-transparency.v1
  Ciphersuite        : ed25519(protobuf)

Signature (2024-09-23T16:53:45Z)
  Epoch height      	: 489193
  Epoch digest      	: cbe5097ae832a3ae51ad866104ffd4aa1f7479e873fd18df9cb96a02fc91ebfe
  Signature         	: fe94973e19da826487b637c019d3ce52f0c08093ada00b4fe6563e2f8117b4345121342bc33aae249be47979dfe704478e2c18aed86e674df9f934b718949c08
  Signature verification: success
  Proof verification	: success