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

318 Revīzijas

10 Atzari

3 Laidieni

Sergey Agievich 9cfe68f348 Update vs projects		1 gadu atpakaļ
RPM	ee3204e41c Create libbee2.spec	3 gadi atpakaļ
cmd	bf25134457 started cmd/aead	2 gadi atpakaļ
doc	3a5aa2cefe update oids [doc/dumpasn1by.cfg]	4 gadi atpakaļ
img	01a1994ec9 update logo	4 gadi atpakaļ
include	328817f740 Update cmd/rng	2 gadi atpakaļ
src	61df00c444 Add Zed	2 gadi atpakaļ
test	184ca21ea7 Refactor cmd/sig	2 gadi atpakaļ
win	9cfe68f348 Update vs projects	1 gadu atpakaļ
.editorconfig	69685e1cae finish belt-che and fix botp-ocra	4 gadi atpakaļ
.gitignore	f7c6f527d2 fix bashPrgRatchet	4 gadi atpakaļ
.travis.yml	ee3074b209 Add bee2cmd/test call to travis.yml	2 gadi atpakaļ
AUTHORS.md	39351da5bd Update authors	2 gadi atpakaļ
CMakeLists.txt	328817f740 Update cmd/rng	2 gadi atpakaļ
LICENSE	4156b31eea Initial commit	9 gadi atpakaļ
README.md	a9ba5288c1 Improve formatting in README	2 gadi atpakaļ

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 data formats defined in the following standards:

STB 34.101.78 (bpki): a PKI profile.

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 released under the terms of the GNU General Public License version 3 (GNU GPLv3). See LICENSE for more information.

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