Tink Java را راه اندازی کنید

پس از نصب و راه‌اندازی Tink، مراحل بعدی را ادامه دهید.

تینک جاوا

کتابخانه اصلی جاوا tink-java است که آخرین نسخه آن ۱.۱۹.۰ است. Tink Java از جاوا ۱۱ یا جدیدتر پشتیبانی می‌کند.

ماون

شما می‌توانید Tink Java را با استفاده از Maven وارد کنید:

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>tink</artifactId>
  <version>1.19.0</version>
</dependency>

بازل

کاربران Bazel می‌توانند با اضافه کردن موارد زیر در فایل MODULE.bazel خود، Tink Java را به عنوان یک وابستگی اضافه کنند:

  bazel_dep(name = "tink_java", version = "1.19.0")

  git_override(
      module_name = "tink_java",
      remote = "https://github.com/tink-crypto/tink-java",
      tag = "v1.19.0",
  )

تینک اندروید

کتابخانه اصلی اندروید tink-java است که آخرین نسخه آن ۱.۱۹.۰ است.

اندروید تینک از سطح API 24 به بعد کاملاً پشتیبانی می‌شود. انتظار می‌رود اکثر بخش‌های تینک از سطح API 23 به بعد کار کنند. بخش‌هایی که تینک با سطح API 23 به طور پیش‌فرض روی آنها اجرا نمی‌شود عبارتند از:

  • کتابخانه JWT به API سطح ۲۴ نیاز دارد زیرا از کلاس‌هایی مانند java.util.Optional استفاده می‌کند. این محدودیت را می‌توان با desugaring برطرف کرد.

  • برخی از APIها در com.google.crypto.tink.streamingaead از SeekableByteBufferChannel استفاده می‌کنند که فقط از سطح API 24 در دسترس است.

به دلایل فنی، ما Tink را فقط روی اندروید و در زیرساخت داخلی گوگل آزمایش می‌کنیم. به همین دلیل انتظار نداریم مشکلی پیش بیاید، اما اگر با مشکلی مواجه شدید، لطفاً مشکل خود را ثبت کنید.

اندروید تینک نیازی به پیکربندی پروگارد ندارد.

گرادل

می‌توانید از tink-android از Gradle استفاده کنید:

dependencies {
  implementation 'com.google.crypto.tink:tink-android:1.19.0'
}

افزونه AWS KMS

افزونه‌ی Tink Java AWS KMS، tink-java-awskms است که آخرین نسخه آن ۱.۱۱.۰ می‌باشد.

ماون

می‌توانید افزونه‌ی Tink Java AWS KMS را با استفاده از Maven اضافه کنید:

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-awskms</artifactId>
    <version>1.11.0</version>
  </dependency>
</dependencies>

بازل

مصنوع انتشار Maven

شما می‌توانید با استفاده از ابزار rules_jvm_external ابزار Maven artifact مربوط com.google.crypto.tink:tink-awskms در کنار com.google.crypto.tink:tink نصب کنید.

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:tink:1.19.0",
        "com.google.crypto.tink:tink-awskms:1.11.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

ساخت از منبع

اگر می‌خواهید tink-awskms از منبع بسازید، مثلاً برای پین کردن یک کامیت خاص، می‌توانید آن را به عنوان یک http_archive در فایل WORKSPACE خود قرار دهید:

# ...

http_archive(
    name = "tink_java",
    urls = ["https://github.com/tink-crypto/tink-java/releases/download/v1.19.0/tink-java-1.19.0.zip"],
    strip_prefix = "tink-java-1.19.0",
    sha256 = "196d7437806151eff3e74997bdf3b39e5ec025ca90ca793c1bd24ef1953cdce0",
)

load("@tink_java//:tink_java_deps.bzl", "TINK_MAVEN_ARTIFACTS", "tink_java_deps")

tink_java_deps()

load("@tink_java//:tink_java_deps_init.bzl", "tink_java_deps_init")

tink_java_deps_init()

http_archive(
    name = "tink_java_awskms",
    urls = ["https://github.com/tink-crypto/tink-java-awskms/releases/download/v1.11.0/tink-java-awskms-1.11.0.zip"],
    strip_prefix = "tink-java-awskms-1.11.0",
    sha256 = "18f8faa7ba0019fc584f9e03f94221ebbcc83f059568d2277a4866003153e151",
)

load("@tink_java_awskms//:tink_java_awskms_deps.bzl", "TINK_JAVA_AWSKMS_MAVEN_ARTIFACTS")

maven_install(
    artifacts = TINK_MAVEN_ARTIFACTS + TINK_JAVA_AWSKMS_MAVEN_ARTIFACTS + [
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

افزونه‌ی مدیریت دانش گوگل کلود

افزونه‌ی Tink Java Google Cloud KMS، tink-java-gcpkms است که آخرین نسخه آن ۱.۱۰.۰ می‌باشد.

ماون

می‌توانید افزونه‌ی Tink Java Google Cloud KMS را با استفاده از Maven اضافه کنید:

<dependencies>
  <dependency>
    <groupId>com.google.crypto.tink</groupId>
    <artifactId>tink-gcpkms</artifactId>
    <version>1.10.0/version>
  </dependency>
</dependencies>

بازل

مصنوع انتشار Maven

شما می‌توانید با استفاده از ابزار rules_jvm_external ابزار Maven artifact مربوط com.google.crypto.tink:tink-gcpkms در کنار com.google.crypto.tink:tink نصب کنید.

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:tink:1.19.0",
        "com.google.crypto.tink:tink-gcpkms:1.10.0",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

ساخت از منبع

اگر می‌خواهید tink-gcpkms از منبع بسازید، مثلاً برای پین کردن یک کامیت خاص، می‌توانید آن را به عنوان یک http_archive در فایل WORKSPACE خود قرار دهید:

# ...

http_archive(
    name = "tink_java",
    urls = ["https://github.com/tink-crypto/tink-java/releases/download/v1.19.0/tink-java-1.19.0.zip"],
    strip_prefix = "tink-java-1.19.0",
    sha256 = "196d7437806151eff3e74997bdf3b39e5ec025ca90ca793c1bd24ef1953cdce0",
)

load("@tink_java//:tink_java_deps.bzl", "TINK_MAVEN_ARTIFACTS", "tink_java_deps")

tink_java_deps()

load("@tink_java//:tink_java_deps_init.bzl", "tink_java_deps_init")

tink_java_deps_init()

http_archive(
    name = "tink_java_gcpkms",
    urls = ["https://github.com/tink-crypto/tink-java-gcpkms/releases/download/v1.10.0/tink-java-gcpkms-1.10.0.zip"],
    strip_prefix = "tink-java-gcpkms-1.10.0",
    sha256 = "ad85625cc4409f2f6ab13a8eef39c965501585e9323d59652cce322b3d2c09a2",
)

load("@tink_java_gcpkms//:tink_java_gcpkms_deps.bzl", "TINK_JAVA_GCPKMS_MAVEN_ARTIFACTS")

maven_install(
    artifacts =  TINK_MAVEN_ARTIFACTS + TINK_JAVA_GCPKMS_MAVEN_ARTIFACTS + [
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

برنامه‌های جاوا تینک

کتابخانه Tink Java Apps پیاده‌سازی‌هایی برای توکن روش پرداخت گوگل ، تأیید سمت سرور تبلیغات پاداشی گوگل ادموب و RFC 8291 - رمزگذاری پیام برای وب پوش (Web Push) با نسخه ۱.۱۲.۲ به عنوان آخرین نسخه ارائه می‌دهد.

ماون

می‌توانید کتابخانه Tink Java Apps را با استفاده از Maven اضافه کنید: 

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-webpush</artifactId>
  <version>1.12.2</version>
</dependency>

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-paymentmethodtoken</artifactId>
  <version>1.12.2</version>
</dependency>

<dependency>
  <groupId>com.google.crypto.tink</groupId>
  <artifactId>apps-rewardedads</artifactId>
  <version>1.12.2</version>
</dependency>

بازل

شما می‌توانید هر یک از مصنوعات com.google.crypto.tink:apps-* Maven را با استفاده از ابزار rules_jvm_external نصب کنید. 

# ...

maven_install(
    artifacts = [
        "com.google.crypto.tink:apps-webpush:1.12.2",
        "com.google.crypto.tink:apps-paymentmethodtoken:1.12.2",
        "com.google.crypto.tink:apps-rewardedads:1.12.2",
        # ... other dependencies ...
    ],
    repositories = [
        "https://maven.google.com",
        "https://repo1.maven.org/maven2",
    ],
)

مراحل بعدی

پس از اتمام راه‌اندازی Tink، مراحل استاندارد استفاده از Tink را ادامه دهید:

  • یک عنصر اولیه انتخاب کنید - بر اساس مورد استفاده خود تصمیم بگیرید که از کدام عنصر اولیه استفاده کنید.
  • مدیریت کلیدها - از کلیدهای خود با KMS خارجی خود محافظت کنید، مجموعه کلیدها را ایجاد کنید و کلیدهای خود را بچرخانید