Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

/sys/tools

Конечные точки /sys/tools представляют собой общий набор инструментов.

1. Генерация случайных байтов

Эта конечная точка возвращает высококачественные случайные байты указанной длины.

Метод

Путь

POST

/sys/tools/random(/:source)(/:bytes)

1.1. Параметры

  • bytes (int: 32) – указывает количество возвращаемых байтов. Это значение можно указать как в теле запроса, так и в составе URL.

  • format (string: "base64") – задаёт кодировку выходных данных. Допустимые варианты: hex или base64.

  • source (string: "platform") - указывает источник запрашиваемых байтов. platform - значение по умолчанию, источник байтов из источника энтропии платформы. all - смешивает байты из всех доступных источников.

Пример тела запроса:
{
  "format": "hex"
}
Пример запроса:
curl \
  --header "X-Vault-Token: ..." \
  --request POST \
  --data @payload.json \
  http://127.0.0.1:8200/v1/sys/tools/random/164
Пример ответа:
{
  "data": {
    "random_bytes": "dGhlIHF1aWNrIGJyb3duIGZveAo="
  }
}

2. Хэш-данные

Эта конечная точка возвращает криптографический хеш заданных данных, используя указанный алгоритм.

Метод

Путь

POST

/sys/tools/hash(/:algorithm)

2.1. Параметры

  • algorithm (string: "sha2-256") – указывает используемый алгоритм хеширования. Его также можно указать в URL. Поддерживаемые в настоящее время алгоритмы:

    • sha2-224

    • sha2-256

    • sha2-384

    • sha2-512

    • sha3-224

    • sha3-256

    • sha3-384

    • sha3-512

В режиме FIPS 140-2 следующие алгоритмы не сертифицированы и поэтому не должны использоваться: sha3-224, sha3-256, sha3-384, и sha3-512.

  • input (string: <required>) – задает входные данные в кодировке base64.

  • format (string: "hex") – указывает выходную кодировку. Может быть либо hex, либо base64.

2.2. Пример тела запроса

{
  "input": "adba32=="
}
Пример запроса:
curl \
  --header "X-Vault-Token: ..." \
  --request POST \
  --data @payload.json \
  http://127.0.0.1:8200/v1/sys/tools/hash/sha2-512
Пример ответа:
{
  "data": {
    "sum": "dGhlIHF1aWNrIGJyb3duIGZveAo="
  }
}