Configurer Tink C++

Après avoir installé et configuré Tink, passez à Étapes suivantes.

Compatibilité

Compatible avec toutes les bibliothèques Également compatible avec Tink C++
Langue C++ >= 17 n/a
OS UbuntuLTS >= 20.04 (x86_64)
macOS >= 12.5 Monterey (x86_64)		 Windows Server >= 2019 (x86_64)
Compilateur GCC >= 7.5.0
Apple Clang >= 14		 MSVC >= 2019
Système de compilation Bazel >= 7 LTS CMake >= 3.22

Installation

Tink C++

La bibliothèque C++ principale est tink-cc, dont la dernière version est 2.4.0.

Bazel

Bzlmod

Ajoutez le code ci-dessous à votre fichier MODULE.bazel :

bazel_dep(name = "tink_cc", version = "2.4.0")

ESPACE DE TRAVAIL

Ajoutez le code ci-dessous à votre fichier WORKSPACE :

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "tink_cc",
    urls = ["https://github.com/tink-crypto/tink-cc/archive/refs/tags/v2.4.0.zip"],
    strip_prefix = "tink-2.4.0",
    sha256 = "06c4d49b0b1357f0b8c3abc77a7d920130dc868e4597d432a9ce1cda4f65e382",
)

load("@tink_cc//:tink_cc_deps.bzl", "tink_cc_deps")

tink_cc_deps()

load("@tink_cc//:tink_cc_deps_init.bzl", "tink_cc_deps_init")

tink_cc_deps_init()

CMake

Ajoutez tink-cc en tant que dépendance dans l'arborescence.

cmake_minimum_required(VERSION 3.22)
project(YourProject CXX)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_STANDARD 14)
include(FetchContent)

# Import Tink as an in-tree dependency.
FetchContent_Declare(
  tink
  URL       https://github.com/tink-crypto/tink-cc/archive/refs/tags/v2.4.0.zip
  URL_HASH  SHA256=06c4d49b0b1357f0b8c3abc77a7d920130dc868e4597d432a9ce1cda4f65e382
)
FetchContent_GetProperties(tink)
if(NOT googletest_POPULATED)
  FetchContent_Populate(tink)
    add_subdirectory(${tink_SOURCE_DIR} ${tink_BINARY_DIR} EXCLUDE_FROM_ALL)
endif()

add_executable(your_app your_app.cc)
target_link_libraries(your_app tink::static)

Extension AWS KMS

L'extension Tink C++ AWS KMS est tink-cc-awskms, dont la dernière version est 2.0.1.

Bazel

ESPACE DE TRAVAIL

Ajoutez le code ci-dessous à votre fichier WORKSPACE :

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "tink_cc",
    urls = ["https://github.com/tink-crypto/tink-cc/archive/refs/tags/v2.4.0.zip"],
    strip_prefix = "tink-2.4.0",
    sha256 = "06c4d49b0b1357f0b8c3abc77a7d920130dc868e4597d432a9ce1cda4f65e382",
)

load("@tink_cc//:tink_cc_deps.bzl", "tink_cc_deps")

tink_cc_deps()

load("@tink_cc//:tink_cc_deps_init.bzl", "tink_cc_deps_init")

tink_cc_deps_init()

http_archive(
    name = "tink_cc_awskms",
    urls = ["https://github.com/tink-crypto/tink-cc-awskms/archive/refs/tags/v2.0.1.zip"],
    strip_prefix = "tink-cc-awskms-2.0.1",
    sha256 = "366319b269f62af120ee312ce4c99ce3738ceb23ce3f9491b4859432f8b991a4",
)

load("@tink_cc_awskms//:tink_cc_awskms_deps.bzl", "tink_cc_awskms_deps")

tink_cc_awskms_deps()

Extension Google Cloud KMS

L'extension Tink C++ Google Cloud KMS est tink-cc-gcpkms, et la dernière version est 2.4.0.

Bazel

ESPACE DE TRAVAIL

Ajoutez le code ci-dessous à votre fichier WORKSPACE :

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "tink_cc_gcpkms",
    urls = ["https://github.com/tink-crypto/tink-cc-gcpkms/releases/download/v2.4.0/tink-cc-gcpkms-2.4.0.zip"],
    strip_prefix = "tink-cc-gcpkms-2.4.0",
    sha256 = "b2c7803b03fcce2d52b15e97f871155d477ccf88b2146337d54202defd074418",
)

load("@tink_cc_gcpkms//:tink_cc_gcpkms_deps.bzl", "tink_cc_gcpkms_deps")

tink_cc_gcpkms_deps()

load("@tink_cc_gcpkms//:tink_cc_gcpkms_deps_init.bzl", "tink_cc_gcpkms_deps_init")

tink_cc_gcpkms_deps_init(register_go = True)

Étapes suivantes

Une fois que vous avez terminé de configurer Tink, suivez les étapes d'utilisation standard de Tink :

  • Choisir une primitive : décidez quelle primitive utiliser en fonction de votre cas d'utilisation.
  • Gérer les clés : protégez vos clés avec votre KMS externe, générez des ensembles de clés et effectuez une rotation de vos clés.