Bee2 – это криптографическая библиотека, которая реализует алгоритмы и протоколы, определённые в стандартах Республики Беларусь. http://apmi.bsu.by/resources/tools.html

Sergey Agievich 4d760227ab Update doxygen files 6 天之前
.github acf7fa384f Update workflows/build 10 月之前
RPM ee3204e41c Create libbee2.spec 3 年之前
cmd 3eee58fa4d Improve formatting 4 月之前
doc 4d760227ab Update doxygen files 6 天之前
dockerfiles 0a0cd88927 Update dockerfiles and fix memory leak (#53) 6 月之前
img 01a1994ec9 update logo 4 年之前
include 2eea7e5bb2 Add uxxBitrev() functions 6 天之前
src 2eea7e5bb2 Add uxxBitrev() functions 6 天之前
test 2eea7e5bb2 Add uxxBitrev() functions 6 天之前
win 3eee58fa4d Improve formatting 4 月之前
.editorconfig 69685e1cae finish belt-che and fix botp-ocra 4 年之前
.gitignore cd3530a8d2 Ignore IDE-specific project settings 1 年之前
AUTHORS.md 4c3ea5dada Update AUTHORS 8 月之前
CMakeLists.txt bb8a7eb6ba Revert BUILD_PIC to CMakeLists 5 月之前
Docker.md d3571e12ab Update Docker.md 1 年之前
LICENSE.txt da35c2d3aa Move to the Apache 2.0 license 1 年之前
README.md 4d760227ab Update doxygen files 6 天之前
docker-bake.json 1a4ea94521 Add Docker support for build and test (#6) 1 年之前

README.md

Bee2: a cryptographic library

Github Actions Build Status Coverity Static Analysis Coverage Analysis

What is Bee2?

Bee2 is a cryptographic library which implements cryptographic algorithm and protocols standardized in Belarus.

Bee2 fully supports the following standards (see apmi.bsu.by/resources/std.html):

  1. STB 34.101.31 (belt): data encryption and integrity algorithms.
  2. STB 34.101.45 (bign): digital signature and key transport algorithms over elliptic curves.
  3. STB 34.101.47 (brng): cryptographic algorithms of pseudorandom number generation + one-time passwords.
  4. STB 34.101.60 (bels): secret sharing algorithms.
  5. STB 34.101.66 (bake): key establishment protocols over elliptic curves.
  6. STB 34.101.77 (bash): sponge-based algorithms.

Bee2 partially supports cryptographic mechanisms and data formats defined in the following standards:

  1. STB 34.101.78 (bpki): a PKI profile.
  2. STB 34.101.79 (btok): cryptographic tokens.

Additionally, Bee2 implements digital signature algorithms standardized in Russia and Ukraine.

Build

mkdir build
cd build
cmake [-DCMAKE_BUILD_TYPE={Release|Debug|Coverage|ASan|ASanDbg|MemSan|MemSanDbg|Check}]\
      [-DBUILD_FAST=ON]\
      [-DBASH_PLATFORM={BASH_32|BASH_64|BASH_AVX2|BASH_AVX512|BASH_NEON}]\
      ..
make
[make test]
[make install]

Note. To build on Windows you need to specify compiler and use the compiler-specific make command. The following example is for the MinGW compiler:

mkdir build
cd build
cmake [-DCMAKE_BUILD_TYPE={Release|Debug|Coverage|ASan|ASanDbg|MemSan|MemSanDbg|Check}]\
      [-DBUILD_FAST=ON]\
      [-DBASH_PLATFORM={BASH_32|BASH_64|BASH_AVX2|BASH_AVX512|BASH_NEON}]\
      -G "MinGW Makefiles"\
      ..
mingw32-make
[mingw32-make test]
[mingw32-make install]

Build types (Release by default):

The BUILD_FAST option (OFF by default) switches from safe (constant-time) functions to fast (non-constant-time) ones.

The BASH_PLATFORM option (BASH_64 by default) requests to use a specific implementation of the STB 34.101.77 algorithms optimized for a given hardware platform. The request may be rejected if it conflicts with other options.

License

Bee2 is distributed under the Apache License version 2.0. See Apache 2.0 or LICENSE for details.

Third-party code

Automated tools

Platforms:

Static analysis:

Code coverage:

Related projects

  • Bee2evp: an OpenSSL engine over Bee2;
  • Bee2j: a Java wrapper over Bee2.

What is the logo?

The logo of Bee2 is taken from a self-portrait engraving by Francysk Skaryna, the famous Belarusian medieval printer, enlightener, translator and writer. The engraving is full of riddles, mysteries and cryptograms. One version is that a bee in the right-bottom corner, our logo, designates the constellation known as Apes (Latin for bees) in Skaryna's time. This constellation was later renamed in Musca Borelias (Latin for northern fly) and then absorbed by Aries.