إعداد Tink Java

بعد تثبيت Tink وإعدادها، انتقِل إلى الخطوات التالية.

Tink Java

مكتبة Java الأساسية هي tink-java، وآخر إصدار لها هو 1.24.0. يتوافق Tink Java مع الإصدار 11 من Java أو الإصدارات الأحدث.

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 بالكامل بدءًا من المستوى 24 لواجهة برمجة التطبيقات. من المتوقّع أن تعمل معظم أجزاء Tink بدءًا من المستوى 23 لواجهة برمجة التطبيقات. في ما يلي الأجزاء التي لا تعمل فيها Tink تلقائيًا مع المستوى 23 من واجهة برمجة التطبيقات:

• تتطلّب مكتبة JWT المستوى 24 لواجهة برمجة التطبيقات لأنّها تستخدم فئات مثل java.util.Optional. يمكن تجنُّب هذا القيد من خلال إزالة التجميل اللغوي.

• تستخدم بعض واجهات برمجة التطبيقات في com.google.crypto.tink.streamingaead SeekableByteBufferChannel، وهي متاحة فقط من المستوى 24 من واجهة برمجة التطبيقات.

لأسباب فنية، نختبر 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

يمكنك تثبيت عنصر 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

إضافة 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

يمكنك تثبيت عنصر 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 - تشفير الرسائل لإشعارات الويب، مع توفّر الإصدار 1.15.0 كأحدث إصدار.

Maven

يمكنك تضمين مكتبة تطبيقات Tink Java باستخدام 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:

• اختيار عنصر أساسي: اختَر العنصر الأساسي الذي تريد استخدامه استنادًا إلى حالة الاستخدام.
• إدارة المفاتيح: يمكنك حماية مفاتيحك باستخدام خدمة إدارة المفاتيح الخارجية، وإنشاء مجموعات مفاتيح، وتغيير مفاتيحك