ตั้งค่า 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 เป็นทรัพยากร Dependency ได้โดยเพิ่มรายการต่อไปนี้ในไฟล์ 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 ได้รับการรองรับอย่างเต็มรูปแบบตั้งแต่ระดับ API 24 เป็นต้นไป Tink ส่วนใหญ่คาดว่าจะทำงานได้ตั้งแต่ API ระดับ 23 เป็นต้นไป ส่วนที่ Tink ไม่ทำงานทันทีที่ติดตั้งในระดับ API 23 ได้แก่

• ไลบรารี JWT ต้องใช้ API ระดับ 24 เนื่องจากใช้คลาสต่างๆ เช่น java.util.Optional ข้อจำกัดนี้หลีกเลี่ยงได้ด้วยกระบวนการ Desugaring

• API บางรายการใน com.google.crypto.tink.streamingaead ใช้ SeekableByteBufferChannel ซึ่งใช้ได้ตั้งแต่ระดับ API 24 เท่านั้น

เนื่องจากเหตุผลทางเทคนิค เราจึงทดสอบ Tink บน Android ในโครงสร้างพื้นฐานภายในของ Google เท่านั้น เราไม่คาดว่าจะเกิดปัญหาใดๆ จากการดำเนินการนี้ แต่หากคุณพบปัญหา โปรดแจ้งปัญหา

Tink Android ไม่ต้องมีการกำหนดค่า ProGuard

Gradle

คุณสามารถใช้ tink-android จาก Gradle ได้โดยทำดังนี้

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

ส่วนขยาย AWS KMS

ส่วนขยาย AWS KMS ของ Tink Java คือ 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

คุณสามารถติดตั้งอาร์ติแฟกต์ Maven ของ com.google.crypto.tink:tink-awskms ควบคู่ไปกับ 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

ส่วนขยาย Google Cloud KMS ของ Tink Java คือ 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

คุณสามารถติดตั้งอาร์ติแฟกต์ Maven com.google.crypto.tink:tink-gcpkms ควบคู่ไปกับ 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, การยืนยันฝั่งเซิร์ฟเวอร์ของโฆษณาที่มีการให้รางวัลของ Google AdMob และ RFC 8291 - การเข้ารหัสข้อความสำหรับ 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

คุณสามารถติดตั้งอาร์ติแฟกต์ Maven ของ com.google.crypto.tink:apps-* ได้โดยใช้เครื่องมือ 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 ภายนอก สร้างคีย์เซ็ต และหมุนเวียนคีย์