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

373 提交历史

10 代码分支

3 版本发布

Aleksandr Zhirkevich 995aca2a2b reworked cmd_bacc		1 年之前
.github	1706187a22 Update actions/build	1 年之前
RPM	ee3204e41c Create libbee2.spec	3 年之前
cmd	995aca2a2b reworked cmd_bacc	1 年之前
doc	804bbe9802 Update doxygen config and fix doxygen syntax	1 年之前
img	01a1994ec9 update logo	4 年之前
include	995aca2a2b reworked cmd_bacc	1 年之前
src	995aca2a2b reworked cmd_bacc	1 年之前
test	cb6ed90309 Fix issues found by PVS-Studio	1 年之前
win	da35c2d3aa Move to the Apache 2.0 license	1 年之前
.editorconfig	69685e1cae finish belt-che and fix botp-ocra	4 年之前
.gitignore	6ec0fe5346 Update config files	1 年之前
.travis.yml	ee3074b209 Add bee2cmd/test call to travis.yml	2 年之前
AUTHORS.md	9447395ba5 Update AUTHORS and add badge to README	1 年之前
CMakeLists.txt	1706187a22 Update actions/build	1 年之前
LICENSE.txt	da35c2d3aa Move to the Apache 2.0 license	1 年之前
README.md	fc5a755dac Describe automated tools in README	1 年之前

Bee2: a cryptographic library

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):

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

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

STB 34.101.78 (bpki): a PKI profile.
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):

Coverage — test coverage;
ASan, ASanDbg — address sanitizer;
MemSan, MemSanDbg — memory sanitizer;
Check — strict compile rules.

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.

Automated tools

Platforms:

Github Actions;
Travis CI (archived).

Static analysis:

Code coverage:

CodeCov.

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.

README.md