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

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

Tink Java

کتابخانه اصلی Java tink-java با 1.24.0 به‌عنوان جدیدترین نسخه است. Tink Java از Java 11 یا جدیدتر پشتیبانی می‌کند.

Maven

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

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

Bazel

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

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

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

Tink Android

کتابخانه اصلی Android tink-java با 1.24.0 به‌عنوان جدیدترین نسخه است.

Tink Android از سطح ای‌پی‌آی ۲۴ به‌طور کامل پشتیبانی می‌شود. انتظار می‌رود اکثر بخش‌های Tink از سطح میانای برنامه‌سازی کاربردی ۲۳ به بعد کار کنند. بخش‌هایی که Tink در سطح میانای برنامه‌سازی کاربردی ۲۳ به‌طور پیش‌فرض اجرا نمی‌شود عبارت‌اند از:

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

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

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

Tink Android به پیکربندی proguard نیاز ندارد.

Gradle

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

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

افزونه AWS KMS

افزونه Tink Java AWS KMS tink-java-awskms است و 2.2.0 جدیدترین نسخه آن است.

Maven

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

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

Bazel

خروجی ساختاریافته نسخه Maven

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

# ...

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

Google Cloud KMS Extension

افزونه Tink Java Google Cloud KMS tink-java-gcpkms است و 1.12.0 جدیدترین نسخه آن است.

Maven

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

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

Bazel

خروجی ساختاریافته نسخه Maven

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

# ...

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

ساختن از منبع

موارد زیر را به فایل MODULE.bazel خود اضافه کنید.

bazel_dep(name = "tink_java_gcpkms")

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

برنامه‌های Tink Java

کتابخانه Tink Java Apps پیاده‌سازی‌هایی برای Google Payment Method Token، Server-Side Verification of Google AdMob Rewarded Ads، و RFC 8291 - Message Encryption for Web Push با 1.15.0 به‌عنوان جدیدترین نسخه ارائه می‌دهد.

Maven

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

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

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

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

Bazel

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

# ...

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

مراحل بعدی

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

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