Tink 설정

소스에서 Tink를 빌드하거나 언어별 패키지를 사용할 수 있습니다. 다음 안내에 따라 시작해 보세요.

Tink 설치 및 설정을 완료한 후 이 페이지 끝에 있는 다음 단계를 계속 진행합니다.

C++

Tink는 다음과 같은 C++ 라이브러리를 제공합니다.

Tink C++ (tink-cc)

Tink C++는 다음에 종속됩니다.

Tink C++는 다음을 지원합니다.

  • C++ >= 14
  • OS:
    • UbuntuLTS >= 20.04 (x86_64)
    • macOS 12.5 Monterey 이상 (x86_64)
    • Windows Server 2019 이상 (x86_64)
  • 컴파일러:
    • GCC >= 7.5.0
    • Apple Clang >= 14
    • MSVC >= 2019
  • 빌드 시스템:

CMake

tink-cc를 트리 내 종속 항목으로 추가해야 합니다. 예를 들면 다음과 같습니다.

cmake_minimum_required(VERSION 3.13)
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.3.0.zip
  URL_HASH  SHA256=363ce671ab5ce0b24f279d3647185597a25f407c3608db007315f79f151f436b
)
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)

Bazel

Bzlmod

모듈과 함께 Bazel을 사용하는 경우 MODULE.bazel 파일에 다음을 추가합니다.

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

워크스페이스

WORKSPACE 파일과 함께 Bazel을 사용하는 경우 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.3.0.zip"],
    strip_prefix = "tink-2.3.0",
    sha256 = "363ce671ab5ce0b24f279d3647185597a25f407c3608db007315f79f151f436b",
)

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

Tink C++ AWS KMS 확장 프로그램 (tink-cc-awskms)

Tink C++ Google Cloud KMS는 다음에 종속됩니다.

Tink C++ AWS KMS는 다음을 지원합니다.

  • C++ >= 14
  • OS:
    • UbuntuLTS >= 20.04 (x86_64)
    • macOS 12.5 Monterey 이상 (x86_64)
  • 컴파일러:
    • GCC >= 7.5.0
    • Apple Clang >= 14
  • 빌드 시스템:

Bazel

프로젝트의 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.3.0.zip"],
    strip_prefix = "tink-2.3.0",
    sha256 = "363ce671ab5ce0b24f279d3647185597a25f407c3608db007315f79f151f436b",
)

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

Tink C++ Google Cloud KMS 확장 프로그램 (tink-cc-gcpkms)

Tink C++ Google Cloud KMS는 다음에 종속됩니다.

Tink C++ Google Cloud KMS는 다음을 지원합니다.

  • C++ >= 14
  • OS:
    • UbuntuLTS >= 20.04 (x86_64)
    • macOS 12.5 Monterey 이상 (x86_64)
  • 컴파일러:
    • GCC >= 7.5.0
    • Apple Clang >= 14
  • 빌드 시스템:

Bazel

프로젝트의 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.3.0/tink-cc-gcpkms-2.3.0.zip"],
    strip_prefix = "tink-cc-gcpkms-2.3.0",
    sha256 = "5af0d0a502afc346bbaa40f226e8f3b28fe3f5def696cbaaa7bc13702af78901",
)

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)

Go

Tink는 다음 Go 라이브러리를 제공합니다.

모든 Tink Go 라이브러리는 표준 Go 도구 또는 Bazel과 함께 사용할 수 있는 Go 모듈로 게시됩니다.

Tink Go (tink-go)

Go 도구

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

go get github.com/tink-crypto/tink-go/v2@v2.2.0

공식 Go 문서를 참고하세요.

Tink Go AWS KMS 확장 프로그램 (tink-go-awskms)

Go 도구

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

go get github.com/tink-crypto/tink-go-awskms/v2@2.1.0

공식 Go 문서를 참고하세요.

Tink Go Google Cloud KMS 확장 프로그램 (tink-go-gcpkms)

Go 도구

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

go get github.com/tink-crypto/tink-go-gcpkms/v2@v2.2.0

공식 Go 문서를 참고하세요.

Tink Go HashiCorp Vault 확장 프로그램 (tink-go-hcvault)

Go 도구

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

go get github.com/tink-crypto/tink-go-hcvault/v2@v2.2.0

공식 Go 문서를 참고하세요.

자바

Tink Java 및 확장 프로그램 설정

ObjC

GitHub의 HOWTO를 참고하세요.

Python

Tink Python 라이브러리인 tink-py는 macOS (x86-64 및 ARM64), Linux (x86-64 및 ARM64), Windows (x86-64)에서 Python 3.8 이상을 지원합니다. 최신 버전은 1.10.0입니다. Pip를 사용하여 로컬에 설치하거나 Bazel과 함께 사용할 수 있습니다.

Tink Python은 AWS KMS, Google Cloud KMS, HashiCorp Vault와 통합을 제공합니다.

PIP

다음 명령어를 실행하여 PyPI에서 시스템용 Tink Python 바이너리 출시 버전을 설치할 수 있습니다.

pip3 install tink==1.10.0
# Core Tink + Google Cloud KMS extension.
pip3 install tink[gcpkms]==1.10.0
# Core Tink + AWS KMS extension.
pip3 install tink[awskms]==1.10.0
# Core Tink + HashiCorp Vault KMS extension.
pip3 install tink[hcvault]==1.10.0
# Core Tink + all the KMS extensions.
pip3 install tink[all]==1.10.0

환경에 바이너리 패키지가 게시되지 않은 경우 pip은 PyPI에 게시된 소스 배포를 사용하여 프로젝트를 빌드하는 방법을 자동으로 사용합니다. 이 경우 프로젝트를 성공적으로 빌드하려면 Bazel 또는 Bazelisk와 protobuf 컴파일러가 설치되어 있어야 합니다.

Bazel

Bazel 사용자는 다음과 같이 WORKSPACE 파일에 Tink Python을 포함할 수 있습니다.

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

http_archive(
    name = "tink_py",
    urls = ["https://github.com/tink-crypto/tink-py/releases/download/v1.10.0/tink-py-1.10.0.zip"],
    strip_prefix = "tink-py-1.10.0",
    sha256 = "767453aae4aad6de4fbb4162992184aa427b7b27864fe9912c270b24c673e1cc",
)

load("@tink_py//:tink_py_deps.bzl", "tink_py_deps")
tink_py_deps()

load("@rules_python//python:repositories.bzl", "py_repositories")
py_repositories()

load("@tink_py//:tink_py_deps_init.bzl", "tink_py_deps_init")
tink_py_deps_init("tink_py")

다음 단계

Tink 설정을 완료한 후 표준 Tink 사용 단계를 계속 진행합니다.

  • 원시 유형 선택: 사용 사례에 따라 사용할 원시 유형을 결정합니다.
  • 키 관리 – 외부 KMS로 키 보호, 키 집합 생성, 키 순환