Melakukan autentikasi dan terhubung ke database

Persyaratan koneksi

Hal berikut diperlukan untuk klien Firestore dengan kompatibilitas MongoDB:

• Driver harus terhubung dalam mode load balanced. Hal ini mencegah driver mencoba memahami topologi server yang terhubung.
• Driver harus terhubung dengan SSL yang diaktifkan.
• Driver harus menonaktifkan operasi tulis yang dapat dicoba ulang. Firestore dengan kompatibilitas MongoDB saat ini tidak mendukung operasi tulis yang dapat dicoba ulang.

Mengambil string koneksi

String koneksi database bergantung pada UID database, lokasi database, dan mekanisme autentikasi. Petunjuk berikut menjelaskan cara string koneksi dibuat.

String koneksi yang tepat bergantung pada mekanisme autentikasi, tetapi string koneksi dasar menggunakan format berikut:

mongodb://UID.LOCATION.firestore.goog:443/DATABASE_ID?loadBalanced=true&tls=true&retryWrites=false

Anda bisa mendapatkan string koneksi dasar dengan salah satu cara berikut:

gcloud firestore databases describe \
--database=DATABASE_ID \
--format='yaml(locationId, uid)'

Gunakan string koneksi dasar dan salah satu metode berikut untuk mengautentikasi dan terhubung ke database Anda:

• Nama pengguna dan sandi (SCRAM)
• Akun layanan Compute Engine
• Library Autentikasi Google

Menghubungkan dengan Nama pengguna dan sandi (SCRAM)

Ikuti langkah-langkah berikut untuk membuat kredensial pengguna untuk database Anda dan terhubung ke database Anda.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna membuat pengguna, minta administrator untuk memberi Anda peran IAM userCredsAdmin (roles/datastore.userCredsAdmin) di database Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat pengguna dan terhubung ke database

Untuk membuat pengguna untuk database Firestore dengan kompatibilitas MongoDB, gunakan salah satu metode berikut:

Gunakan string koneksi berikut untuk terhubung ke database Anda dengan SCRAM:

mongodb://USERNAME:PASSWORD@UID.LOCATION.firestore.goog:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false

Ganti kode berikut:

• USERNAME: nama pengguna.
• PASSWORD: sandi yang Anda buat untuk pengguna ini.
• UID: UID database.
• LOCATION: lokasi database.
• DATABASE_ID: ID database.

Menghubungkan dengan Library Google Auth

Contoh kode berikut mendaftarkan pengendali callback OIDC menggunakan Google Cloud library OAuth standar.

Library ini memungkinkan Anda menggunakan sejumlah jenis autentikasi yang berbeda (Kredensial Default Aplikasi, Workload Identity Federation).

Hal ini memerlukan penambahan library autentikasi sebagai dependensi:

// Maven
<dependency>
  <groupId>com.google.auth</groupId>
  <artifactId>google-auth-library-oauth2-http</artifactId>
  <version>1.19.0</version>
</dependency>

// Gradle
implementation 'com.google.auth:google-auth-library-oauth2-http:1.19.0'

Contoh kode berikut menunjukkan cara menghubungkan:

val db = MongoClients.create(
    connectIgnite(
      "DATABASE_UID",
      "LOCATION"
    ).build()
  ).getDatabase("DATABASE_ID")


/**
 * Creates a connection to a Firestore with MongoDB Compatibility database.
 * @param databaseUid The uid of the database to connect to as a string. For example: f116f93a-519c-208a-9a72-3ef6c9a1f081
 * @param locationId The location of the database to connect to, for example: nam5, us-central1, us-east4 etc...
 * @param environment Whether to try and fetch an auth credential from the GCE VM metadata service or whether to call gcloud.
 */
private static MongoClientSettings.Builder connectIgnite(
  String databaseUid: String
  String locationId:String
): MongoClientSettings.Builder {
  MongoCredential credential =
    MongoCredential.createOidcCredential(null)
      .withMechanismProperty(
        MongoCredential.OIDC_CALLBACK_KEY,
        new MongoCredential.OidcCallback() {
          @Override
          MongoCredential.OidcCallbackResult onRequest(
MongoCredential.OidcCallbackContext context) {
     // Customize this credential builder for additional credential types.
     GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
            return new MongoCredential.OidcCallbackResult(
         credentials.getAccessToken().getTokenValue(),
         Duration.between(Instant.now(),
credentials.getAccessToken().getExpirationTime().toInstant()));
          }
        },
      );
  return MongoClientSettings.builder()
    .hosts(listOf(ServerAddress(
        "$databaseUid.$locationId.firestore.goog", 443)))
    .credential(credential)
    .applyToClusterSettings(builder ->
         builder.mode(ClusterConnectionMode.LOAD_BALANCED))
    ).applyToSslSettings(ssl -> ssl.enabled(true));
}

Ganti kode berikut:

• DATABASE_UID: nama project Anda.
• LOCATION: lokasi database Anda.
• DATABASE_ID ID database.

Menghubungkan dari VM Compute Engine

Anda dapat melakukan autentikasi dan terhubung ke database menggunakan akun layanan Compute Engine. Untuk melakukannya, buat kebijakan IAM untuk Google Cloud project yang berisi database Anda.

Sebelum memulai

Konfigurasikan akun layanan yang dikelola pengguna untuk VM Anda:

• Untuk mengonfigurasi akun layanan selama pembuatan VM, lihat Membuat VM yang menggunakan akun layanan yang dikelola pengguna.
• Untuk mengonfigurasi akun layanan di VM yang ada, lihat Mengubah akun layanan yang ditambahkan.

Catat email akun layanan Anda.

Mengonfigurasi kredensial

Untuk memberikan peran roles/datastore.user ke akun layanan untuk operasi baca dan tulis ke Firestore, jalankan perintah berikut:

gcloud projects add-iam-policy-binding PROJECT_NAME --member="SERVICE_ACCOUNT_EMAIL" --role=roles/datastore.user

Ganti kode berikut:

• PROJECT_NAME: nama project Anda.
• SERVICE_ACCOUNT_EMAIL: alamat email untuk akun layanan yang Anda buat.

Membuat string koneksi

Gunakan format berikut untuk membuat string koneksi:

mongodb://DATABASE_UID.LOCATION.firestore.goog:443/DATABASE_ID?loadBalanced=true&tls=true&retryWrites=false&authMechanism=MONGODB-OIDC&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:FIRESTORE

Ganti kode berikut:

• DATABASE_UID: nama project Anda.
• LOCATION: lokasi database Anda.
• DATABASE_ID ID database.

Untuk informasi selengkapnya tentang cara mengambil UID dan lokasi, lihat Mengambil string koneksi.

Terhubung dengan token akses sementara

Anda dapat menggunakan token akses Google Cloud sementara untuk menjalankan alat diagnostik seperti mongosh. Anda dapat menggunakan gcloud auth print-access-token untuk melakukan autentikasi dengan token akses jangka pendek. Token ini berlaku selama satu jam.

Misalnya, gunakan perintah berikut untuk terhubung ke database Anda dengan mongosh:

mongosh --tls \
      --username access_token --password $(gcloud auth print-access-token) \
      'mongodb://UID.LOCATION.firestore.goog:443/DATABASE_ID?loadBalanced=true&authMechanism=PLAIN&authSource=$external&retryWrites=false'

Ganti kode berikut:

• DATABASE_UID: UID database
• LOCATION: lokasi database
• DATABASE_ID: ID database