Membuat data PTR untuk instance VM

Dengan data PTR yang dapat dikonfigurasi, Anda dapat menentukan data balik DNS yang terkait dengan alamat IP eksternal instance VM, sehingga aplikasi yang mengandalkan data ini dapat beroperasi sebagaimana mestinya.

Beberapa aplikasi memerlukan data DNS terbalik (data PTR) untuk menyelesaikan alamat IP ke nama domain. Misalnya, aplikasi yang menggunakan SMTP memerlukan data PTR yang mengarah ke domain dari mana email dikirim. Tanpa data tersebut, filter spam dapat menandai email dengan reputasi rendah, yang menyebabkan email tersebut masuk ke folder spam atau tidak terkirim sama sekali.

Anda hanya dapat menambahkan data PTR ke antarmuka jaringan utama instance VM. Data PTR tidak tersedia untuk frontend load balancer, Cloud NAT, atau alamat IP non-VM lainnya.

Catatan PTR IPv6 hanya tersedia jika antarmuka jaringan utama instance terhubung ke subnet stack ganda atau khusus IPv6 yang memiliki rentang alamat IPv6 eksternal. Untuk antarmuka jaringan dual-stack, Anda dapat memiliki catatan PTR IPv4 dan IPv6 terpisah.

Untuk membuat data PTR kustom untuk mengganti nama PTR DNS internal yang dibuat otomatis, lihat Zona pencarian balik yang dikelola.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init
    2. Set a default region and zone.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .

Verifikasi kepemilikan domain Anda

Sebelum membuat VM dengan data PTR kustom, verifikasi bahwa Anda adalah pemilik nama domain. Memverifikasi kepemilikan adalah tindakan keamanan untuk membuktikan kepada Google bahwa Anda adalah pemilik domain.

Anda dapat memverifikasi nama domain dengan 2 cara:

  • Jika memiliki Akun Google, Anda dapat melakukan verifikasi menggunakan Search Console.
  • Jika memiliki akun Google atau non-Google, Anda dapat melakukan verifikasi dengan menambahkan alamat IP VM ke konfigurasi DNS.

Verifikasi menggunakan Search Console

  1. Buka Search Console dan login menggunakan Akun Google yang akan Anda gunakan untuk menambahkan catatan PTR ke instance Anda. Anda dapat memverifikasi kepemilikan domain dengan beberapa akun.
  2. Masukkan nama domain PTR.
  3. Klik Lanjutkan.
  4. Ikuti petunjuknya, lalu klik Buka Properti.
  5. Klik Setelan (ada di menu sebelah kiri di dekat bagian bawah), lalu klik Verifikasi Kepemilikan.

Setelah Anda memverifikasi bahwa Anda adalah pemilik domain, di panel Setelan, klik Pengguna untuk melihat pemilik terverifikasi lainnya. Untuk menambahkan data PTR di domain lain, klik pemilih properti di sebelah kiri yang menampilkan domain Anda saat ini. Klik Tambahkan properti untuk menambahkan domain tersebut.

Jika nama domain Anda tidak langsung diverifikasi, gunakan Metode yang Direkomendasikan untuk mendapatkan verifikasi.

Verifikasi dengan menambahkan alamat IP VM ke konfigurasi DNS Anda

  1. Jika VM Anda belum ada, cadangkan alamat IP eksternal statis regional dan gunakan nanti selama pembuatan VM.
  2. Tambahkan data "A" dengan alamat IP eksternal VM ke konfigurasi DNS domain Anda.

Membuat instance VM dengan data PTR

Anda dapat menetapkan data PTR saat membuat instance baru. Untuk menambahkan data PTR untuk instance yang ada, baca Menambahkan data PTR.

Konsol

  1. Di konsol Trusted Cloud , buka halaman Create an instance.

    Buka halaman Buat instance

  2. Tentukan detail VM.

  3. Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:

    1. Luaskan bagian Networking.
    2. Buat satu atau beberapa antarmuka jaringan untuk digunakan dengan VM ini. Atau, Anda dapat menggunakan antarmuka jaringan default.
    3. Di bagian Antarmuka jaringan, luaskan antarmuka jaringan pertama, yang merupakan antarmuka jaringan utama.
    4. Di bagian Data PTR DNS publik, pilih setiap jenis data PTR yang ingin ditambahkan.
    5. Di kolom Nama domain PTR, masukkan nama domain untuk setiap jenis data PTR yang ingin Anda tambahkan.
    6. Di kolom Alamat IPv4 eksternal atau Alamat IPv6 eksternal, pilih alamat IP yang Anda cadangkan sebelumnya. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.
    7. Untuk mengonfirmasi setelan antarmuka jaringan, klik Selesai.
  4. Konfigurasi properti yang tersisa untuk VM baru Anda.

  5. Di bagian bawah halaman, klik Buat.

Setelah VM dimulai, Anda dapat menjalankan pencarian balik DNS di alamat IP eksternal VM untuk mengonfirmasi bahwa data PTR berfungsi seperti yang diharapkan.

gcloud

  • Untuk membuat instance baru dengan catatan PTR IPv4 terkait, gunakan perintah gcloud instances create.

    gcloud compute instances create INSTANCE_NAME \
        --image-family IMAGE_FAMILY \
        --image-project IMAGE_PROJECT \
        --public-ptr \
        --public-ptr-domain DOMAIN_NAME \
        --address=IP_ADDRESS
    

    Ganti kode berikut:

    • INSTANCE_NAME: nama instance VM baru.
    • IMAGE_FAMILY: salah satu kelompok image yang tersedia.
    • IMAGE_PROJECT: project yang menjadi dasar penyelesaian semua referensi gambar dan kelompok gambar. Trusted Cloud Jika Anda tidak memberikan nama project, project default saat ini akan digunakan.
    • DOMAIN_NAME: nama domain yang akan ditambahkan ke instance ini.
    • IP_ADDRESS: alamat IP yang sebelumnya Anda cadangkan. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.
  • Untuk membuat instance baru dengan data PTR IPv6 terkait, lakukan langkah-langkah berikut:

    1. Buat VM stack ganda atau khusus IPv6.
    2. Tambahkan data PTR IPv6.

REST

  • Untuk membuat instance baru dengan data PTR IPv4, buat permintaan POST ke metode instances.insert.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
    {
      "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
      "name": "INSTANCE_NAME",
      "disks": [
        {
          "initializeParams": {
            "sourceImage": "projects/debian-cloud/global/images/family/debian-10"
          },
          "boot": true
        }
      ],
      "networkInterfaces": [
        {
          "network": "NETWORK",
          "accessConfigs": [
            {
              "type": "ONE_TO_ONE_NAT",
              "name": "External NAT",
              "natIP": "IP_ADDRESS",
              "publicPtrDomainName": "DOMAIN_NAME",
              "setPublicPtr": true
            }
          ]
        }
      ]
    }
    

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.
    • ZONE: zona instance Anda.
    • MACHINE_TYPE: jenis mesin.
    • INSTANCE_NAME: nama instance.
    • NETWORK: URL jaringan.
    • IP_ADDRESS: alamat IP yang sebelumnya Anda cadangkan. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.
    • DOMAIN_NAME: nama domain yang akan ditambahkan.
  • Untuk membuat instance baru dengan data PTR IPv6, lakukan hal berikut:

    1. Buat VM stack ganda atau khusus IPv6.
    2. Tambahkan data PTR IPv6.

Menambahkan data PTR

Anda dapat menambahkan data PTR dengan memperbarui konfigurasi akses pada antarmuka jaringan utama, nic0, dari instance VM.

Konsol

  1. Di konsol Trusted Cloud , buka halaman VM instances.

    Buka instance VM

  2. Klik instance yang ingin diedit.

  3. Klik Edit.

  4. Di bagian Antarmuka jaringan, klik antarmuka jaringan utama.

  5. Di bagian Data PTR DNS publik, pilih setiap jenis data PTR yang ingin ditambahkan.

  6. Di kolom Nama domain PTR, masukkan nama domain untuk setiap jenis data PTR yang ingin ditambahkan.

  7. Klik Selesai, lalu klik Simpan.

gcloud

  1. Jika VM Anda tidak memiliki konfigurasi akses, tambahkan konfigurasi menggunakan perintah gcloud compute instances add-access-config.

    gcloud compute instances add-access-config INSTANCE_NAME
    

    Ganti INSTANCE_NAME dengan nama instance Anda.

  2. Perbarui konfigurasi akses untuk menambahkan data PTR menggunakan perintah gcloud compute instances update-access-config. Untuk menambahkan catatan PTR IPv4 dan IPv6, gunakan perintah berikut satu per satu.

    • Untuk IPv4:

      gcloud compute instances update-access-config INSTANCE_NAME \
          --public-ptr \
          --public-ptr-domain DOMAIN_NAME
      
    • Untuk IPv6:

      gcloud compute instances update-access-config INSTANCE_NAME \
          --ipv6-public-ptr-domain=DOMAIN_NAME
      

    Ganti kode berikut:

    • INSTANCE_NAME: nama instance yang akan diupdate.
    • DOMAIN_NAME: nama domain yang akan ditambahkan.

REST

  1. Jika VM Anda tidak memiliki konfigurasi akses, tambahkan konfigurasi akses dengan membuat permintaan POST ke metode instances.addAccessConfig.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addAccessConfig?networkInterface="nic0"
    
  2. Perbarui konfigurasi akses untuk menambahkan data PTR dengan membuat permintaan POST ke metode instances.updateAccessConfig. Untuk menambahkan data PTR IPv4 dan IPv6, buat permintaan berikut secara terpisah.

    • Untuk IPv4:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0
      {
        "setPublicPtr": true,
        "publicPtrDomainName": "DOMAIN_NAME",
        "type": "ONE_TO_ONE_NAT"
      }
      
    • Untuk IPv6:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0
      {
        "publicPtrDomainName": "DOMAIN_NAME",
        "type": "DIRECT_IPV6"
      }
      

    Ganti kode berikut:

    • PROJECT_ID: ID project.
    • ZONE: zona instance.
    • INSTANCE_NAME: nama instance.
    • DOMAIN_NAME: nama domain yang akan ditambahkan.

Menghapus data PTR

Untuk menghapus data PTR, perbarui konfigurasi akses pada antarmuka jaringan utama, nic0, dari instance VM. Saat Anda menghapus data PTR, Trusted Cloud akan merespons pencarian DNS terbalik dengan nama domain yang sepenuhnya memenuhi syarat secara default, yaitu googleusercontent.com.

Konsol

  1. Di konsol Trusted Cloud , buka halaman VM instances.

    Buka instance VM

  2. Klik instance yang ingin diedit.

  3. Klik Edit.

  4. Di bagian Antarmuka jaringan, klik antarmuka jaringan utama.

  5. Di bagian Data PTR DNS publik, hapus centang pada kotak untuk setiap jenis data PTR yang ingin dihapus.

  6. Klik Selesai, lalu klik Simpan.

gcloud

Untuk menghapus catatan PTR, gunakan perintah gcloud compute instances update-access-config. Untuk menghapus data PTR IPv4 dan IPv6, gunakan perintah berikut secara terpisah.

  • Untuk IPv4:

    gcloud compute instances update-access-config INSTANCE_NAME \
        --no-public-ptr
    
  • Untuk IPv6:

    gcloud compute instances update-access-config INSTANCE_NAME \
        --no-ipv6-public-ptr
    

Ganti INSTANCE_NAME dengan nama instance yang akan diupdate.

REST

Untuk menghapus data PTR, buat permintaan POST ke metode instances.updateAccessConfig. Untuk menghapus catatan PTR IPv4 dan IPv6, buat permintaan berikut secara terpisah.

  • Untuk IPv4:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0
    {
      "setPublicPtr": false,
      "type": "ONE_TO_ONE_NAT"
    }
    
  • Untuk IPv6:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0
    {
      "publicPtrDomainName": "",
      "type": "DIRECT_IPV6"
    }
    

Ganti kode berikut:

  • PROJECT_ID: ID project.
  • ZONE: zona instance.
  • INSTANCE_NAME: nama instance.

Batasan

  • Saat VM dimigrasikan ke host lain sebagai bagian dari proses migrasi langsung selama event pemeliharaan, logika data PTR tidak menangani beberapa kasus ekstrem dengan benar dan mengembalikan Data PTR DNS ke nama domain yang sepenuhnya memenuhi syarat (FQDN) googleusercontent.com. Untuk memulihkan fungsi, terapkan kembali data PTR.

  • Jika Anda menghentikan VM yang memiliki data PTR IPv6, pendaftaran data PTR IPv6 akan dibatalkan untuk sementara dan tidak terlihat di VM. Data akan ditambahkan kembali secara otomatis saat Anda memulai ulang VM.

Langkah berikutnya