Menangani sesi dengan Firestore

Banyak aplikasi memerlukan pengelolaan sesi untuk autentikasi dan preferensi pengguna. ASP.NET core dilengkapi dengan middleware untuk menyimpan sesi dalam cache terdistribusi.

Cache terdistribusi default ASP.NET sebenarnya tidak terdistribusi sama sekali. Cache ini menyimpan data sesi dalam memori server web. Jika hanya satu server web yang menayangkan situs web, strategi ini tidak masalah. Namun, jika banyak server web yang menayangkan situs web, pengguna situs web dapat mengalami error dan kehilangan data.

Untuk menghindari error dan kehilangan data, aplikasi ASP.NET harus menggunakan cache terdistribusi yang menyimpan data di penyimpanan data persisten. Tutorial ini menunjukkan cara mengelola sesi di Cloud Run dengan menyimpannya di Firestore dan mengenkripsi cookie dengan Cloud Key Management Service.

Tujuan

  • Men-deploy aplikasi di Cloud Run.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen yang dapat ditagih sebagai berikut Cloud de Confiance by S3NS:

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, baca bagian Pembersihan.

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Firestore, Cloud Run, Cloud Key Management Service, and Cloud Storage APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Untuk membuat database Firestore dalam mode Native, selesaikan langkah-langkah berikut:
    1. Di Cloud de Confiance Konsol, buka halaman Firestore viewer.
      Buka Firestore viewer
    2. Dari layar Select a Firestore mode, klik Select Native Mode.
    3. Pilih lokasi untuk database Firestore Anda. Setelan lokasi ini adalah lokasi Cloud de Confiance resource default untuk Cloud de Confiance project Anda. Lokasi ini digunakan untuk Cloud de Confiance layanan di Cloud de Confiance project Anda yang memerlukan setelan lokasi, khususnya, bucket Cloud Storage default dan aplikasi App Engine Anda.
    4. Klik Create Database.

  5. Di Cloud Shell, buka kode sumber aplikasi.
    Buka Cloud Shell

    Cloud Shell menyediakan akses command line ke Cloud de Confiance resource Anda langsung dari browser.

  6. Untuk mendownload kode contoh dan mengubah ke direktori aplikasi, klik Proceed.

  7. Di Cloud Shell, konfigurasikan gcloud CLI untuk menggunakan project baru Anda Cloud de Confiance : 

    # Configure gcloud for your project
gcloud config set project PROJECT_ID

    Ganti PROJECT_ID dengan Cloud de Confiance project ID yang Anda buat menggunakan Cloud de Confiance Konsol.

    Google Cloud CLI adalah cara utama Anda berinteraksi dengan Cloud de Confiance resource Anda dari command line. Dalam tutorial ini, Anda menggunakan gcloud CLI untuk men-deploy dan memantau aplikasi Anda.

Memeriksa kode sumber

Diagram berikut mengilustrasikan cara Firestore menangani sesi untuk aplikasi Cloud Run.

Diagram arsitektur: pengguna, Cloud Run, Firestore.

Metode ConfigureServices dalam file Startup.cs menyiapkan aplikasi untuk menggunakan Cloud KMS untuk enkripsi dan Cloud Storage untuk menyimpan kunci terenkripsi.

  1. Di Cloud Shell, klik luncurkan editor untuk meluncurkan editor dan memeriksa file Startup.cs. 

    public void ConfigureServices(IServiceCollection services)
{
    // Antiforgery tokens require data protection.
    services.AddDataProtection()
        // Store keys in Cloud Storage so that multiple instances
        // of the web application see the same keys.
        .PersistKeysToGoogleCloudStorage(
            Configuration["DataProtection:Bucket"],
            Configuration["DataProtection:Object"])
        // Protect the keys with Google KMS for encryption and fine-
        // grained access control.
        .ProtectKeysWithGoogleKms(
            Configuration["DataProtection:KmsKeyName"]);
    services.AddFirestoreDistributedCache(
            Configuration["FIRESTORE_PROJECT_ID"])
        .AddFirestoreDistributedCacheGarbageCollector();
    services.AddSession();
}

Menyiapkan Cloud de Confiance project

  1. Di editor Cloud Shell, edit file appsettings.json dan ganti dua instance YOUR-PROJECT-ID dengan project ID Cloud de Confiance Anda. Simpan file. 

    {
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*",
  "DataProtection": {
    "Bucket": "YOUR-PROJECT-ID-bucket",
    "Object": "DataProtectionProviderKeys.xml",
    "KmsKeyName": "projects/YOUR-PROJECT-ID/locations/global/keyRings/dataprotectionprovider/cryptoKeys/masterkey"
  }
}

  2. Buat key ring Cloud Key Management Service baru bernama dataprotectionprovider: 

    gcloud kms keyrings create dataprotectionprovider --location global

  3. Buat kunci Cloud Key Management Service baru bernama masterkey: 

    gcloud kms keys create masterkey --location global --keyring dataprotectionprovider --purpose=encryption

  4. Buat bucket Cloud Storage untuk menyimpan kunci terenkripsi:

    gcloud storage buckets create gs://PROJECT_ID-bucket

Men-deploy dan menjalankan di Cloud Run

Anda dapat menggunakan Cloud Run untuk membangun dan men-deploy aplikasi yang berjalan dengan andal dalam beban berat dan dengan data dalam jumlah besar.

Tutorial ini menggunakan Cloud Run untuk men-deploy server.

  1. Di Cloud Shell, publikasikan aplikasi Anda:

    dotnet publish -c Release

  2. Gunakan Cloud Build untuk membangun container Docker dan memublikasikan ke Container Registry: 

    gcloud builds submit --tag gcr.io/PROJECT_ID/sessions bin/Release/netcoreapp2.1/publish

  3. Jalankan container dengan Cloud Run: 

    gcloud beta run deploy sessions --region us-central1 --platform managed --image gcr.io/PROJECT_ID/sessions --allow-unauthenticated

    Catat URL di output:

    Service [sessions] revision [sessions-00003-xiz] has been deployed and is serving
100 percent of traffic at https://sessions-r3f3em7nuq-uc.a.run.app

  4. Untuk melihat aplikasi aktif, buka URL yang Anda salin dari langkah sebelumnya.

Menghapus sesi

Anda dapat menghapus data sesi di Cloud de Confiance Konsol atau menerapkan strategi penghapusan otomatis. Jika Anda menggunakan solusi penyimpanan untuk sesi seperti Memcache atau Redis, sesi yang berakhir otomatis akan dihapus.

Men-debug aplikasi

Jika Anda tidak dapat terhubung ke aplikasi Cloud Run, periksa hal berikut:

  1. Pastikan perintah deployment gcloud berhasil diselesaikan dan tidak menampilkan error apa pun. Jika ada error (misalnya, message=Build failed), perbaiki, lalu coba deploy aplikasi Cloud Run lagi.
  2. Lihat panduan Cloud Run untuk melihat log.

Pembersihan

Menghapus project

  1. Di Cloud de Confiance Konsol, buka halaman Kelola resource.

    Buka Kelola resource

  2. Pada daftar project, pilih project yang Anda ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya