Mengaktifkan autentikasi Cassandra

Secara default, Cassandra menginstal tanpa mengaktifkan autentikasi. Artinya, siapa pun yang memiliki akses ke server Cassandra Anda dapat mengkueri database Cassandra tanpa autentikasi apa pun. Anda dapat mengaktifkan autentikasi setelah menginstal Edge, atau sebagai bagian dari proses penginstalan.

Jika Anda memutuskan untuk mengaktifkan autentikasi di Cassandra tanpa memberikan kredensial Anda sendiri, Cassandra akan menggunakan kredensial default berikut:

  • nama pengguna = 'cassandra'
  • sandi = 'cassandra'

Anda dapat menggunakan akun pengguna ini, menetapkan sandi berbeda untuk akun pengguna ini, atau membuat pengguna Cassandra baru. Menambahkan, menghapus, dan mengubah pengguna dengan menggunakan pernyataan CREATE/ALTER/DROP USER Cassandra.

Untuk mengetahui informasi selengkapnya, lihat Perintah shell SQL Cassandra.

Mengaktifkan autentikasi Cassandra selama penginstalan

Anda dapat mengaktifkan autentikasi Cassandra saat penginstalan. Namun, meskipun dapat mengaktifkan autentikasi saat menginstal Cassandra, Anda harus selalu menggunakan nama pengguna dan sandi cassandra default (‘cassandra’:’cassandra’) selama penginstalan. Jika ingin menggunakan kredensial Cassandra non-default, Anda harus mengaktifkan kembali autentikasi Cassandra setelah penginstalan dengan mengikuti langkah-langkah yang tercantum di sini.

Jika Anda ingin mengaktifkan autentikasi Cassandra selama penginstalan Cassandra baru, sertakan properti di bawah dalam file konfigurasi untuk semua node Cassandra:

CASS_AUTH=y
CASS_USERNAME=cassandra
CASS_PASSWORD=cassandra

Selanjutnya, penginstalan akan menyiapkan Cassandra dengan autentikasi yang diaktifkan dan kredensial cassandra:cassandra default.

Setelah penginstalan awal selesai, Anda dapat mengikuti satu atau beberapa langkah berikut:

  • Buat pengguna alternatif yang akan digunakan untuk autentikasi Cassandra dengan mengikuti prosedur di sini.
  • Ubah sandi pengguna Cassandra default dengan mengikuti langkah-langkah di sini.
  • Instal komponen Edge yang menggunakan Cassandra untuk menggunakan kredensial yang Anda tetapkan di atas.

Komponen edge yang terhubung ke Cassandra

Komponen Edge berikut mengakses Cassandra:

  • Server Pengelolaan
  • Pemroses Pesan
  • Router
  • Server Qpid
  • Server Postgres

Instal komponen Edge saat autentikasi Cassandra diaktifkan

Jika autentikasi Cassandra diaktifkan saat Anda menginstal komponen Edge ini untuk pertama kalinya, Anda harus menyediakan setelan berikut dalam file konfigurasi senyap:

CASS_AUTH=Y
CASS_USERNAME=<valid username in Cassandra>
CASS_PASSWORD=<password for the above username>

Anda dapat mengubah kredensial Cassandra setelah menginstal Cassandra. Namun, jika telah menginstal Server Pengelolaan, Prosesor Pesan, Router, server Qpid, atau server Postgres, Anda juga harus mengupdate komponen tersebut agar dapat menggunakan kredensial baru, seperti yang dijelaskan di bagian berikutnya.

Memperbarui komponen Edge yang terhubung ke Cassandra

Gunakan prosedur berikut untuk mengupdate semua komponen Edge yang berkomunikasi dengan Cassandra dengan kredensial baru. Perlu diperhatikan bahwa Anda harus melakukan langkah ini sebelum benar-benar memperbarui kredensial Casandra:

  1. Pada node Server Pengelolaan, jalankan perintah berikut: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password

    Jika ingin, Anda dapat meneruskan file yang berisi nama pengguna dan sandi baru ke perintah:

    apigee-service edge-management-server store_cassandra_credentials  -f configFile

    dengan configFile berisi hal berikut:

    CASS_USERNAME=cassandra_username # Default is cassandra
CASS_PASSWORD='cassandra_password' # Default is cassandra; wrap in single quotes if it includes special characters.

    Perintah ini akan otomatis memulai ulang Server Pengelolaan.

  2. Ulangi langkah 1 untuk setiap layanan berikut:
    • Semua Pemroses Pesan
    • Semua Router
    • Semua server Qpid (edge-qpid-server)
    • Server postgres (edge-postgres-server)

    Saat Anda mengulangi langkah 1 untuk setiap layanan, ganti edge-management-server dalam perintah di atas dengan nama layanan yang sesuai. Misalnya, saat Anda menjalankan langkah untuk layanan Router, gunakan perintah berikut:

    /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra

    Aktifkan autentikasi Cassandra setelah penginstalan

    Bagian berikut menjelaskan cara mengaktifkan autentikasi Cassandra setelah penginstalan.

    Mengaktifkan autentikasi Cassandra di satu penyiapan pusat data

    Untuk penyiapan Apigee berbasis pusat data tunggal yang sudah menginstal Cassandra, Anda dapat:

    Catatan: Pengguna 'Cassandra' adalah pengguna khusus di Cassandra. Autentikasi yang menggunakan pengguna ini memerlukan konsistensi QUORUM. Lihat Tentang tingkat konsistensi Cassandra.

    Mengaktifkan autentikasi Cassandra saat ada beberapa pusat data

    Saat memperluas pusat data, ikuti langkah-langkah dalam salah satu skenario berikut, bergantung pada skenario yang sesuai dengan penyiapan Anda.

    Skenario 1: Pusat data yang ada telah mengaktifkan autentikasi Cassandra

    Jika autentikasi Cassandra sudah diaktifkan di pusat data yang ada dengan kredensial cassandra:cassandra default, ikuti langkah-langkah berikut:

    1. Siapkan pusat data baru dengan kredensial Cassandra:Cassandra & CASS_AUTH=y default. Lihat Mengaktifkan autentikasi Cassandra untuk pertama kalinya.
    2. Instal komponen Edge di pusat data yang baru dengan menggunakan kredensial Cassandra default.

    Jika autentikasi Cassandra sudah diaktifkan di pusat data yang ada dengan kredensial non-default, ikuti langkah-langkah berikut:

    1. Menyiapkan pusat data baru dengan kredensial Cassandra:Cassandra default & CASS_AUTH=y. Lihat Mengaktifkan autentikasi Cassandra untuk pertama kalinya.
    2. Ikuti langkah-langkah Mengaktifkan autentikasi Cassandra untuk pertama kalinya untuk menggunakan kembali kredensial dari pusat data yang ada (jika kredensial yang ada menggunakan kredensial non-default).
    3. Instal komponen Edge di pusat data baru menggunakan kredensial Cassandra non-default.

    Skenario 2: Autentikasi Cassandra di pusat data yang ada tidak diaktifkan

    Jika autentikasi cassandra tidak diaktifkan, lakukan langkah-langkah berikut:

    1. Siapkan pusat data baru tanpa autentikasi Cassandra.
    2. Ikuti langkah-langkah Mengaktifkan autentikasi Cassandra untuk pertama kalinya guna mengaktifkan autentikasi Cassandra di seluruh cluster (pasca-perluasan).
    3. Update komponen Edge yang terhubung ke Cassandra dengan mengikuti langkah-langkah di sini.

    Mengaktifkan autentikasi Cassandra untuk pertama kalinya

    Gunakan prosedur berikut untuk mengaktifkan autentikasi Cassandra untuk pertama kalinya, atau untuk membuat nama pengguna dan sandi Cassandra baru:

    1. Buat file konfigurasi senyap dengan konten yang ditampilkan di bawah: 
      # Specify IP address or DNS name of cassandra node
IP1=192.168.1.1
IP2=192.168.1.2
IP3=192.168.1.3

# Must resolve to IP address or DNS name of host
HOSTIP=$(hostname -i)

# Set to ‘y’ to enable Cassandra authentication.
CASS_AUTH=y # Possible values are ‘y/n’

# Cassandra username. If it does not exist, this user would be created as a SUPERUSER
CASS_USERNAME=cassandra # Default value is cassandra
# Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
CASS_PASSWORD=cassandra # Default value is cassandra

# Space-separated IP/DNS names of the Cassandra hosts
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Username of an existing C* user. Only needed if you have disabled or change details of the default cassandra user(‘cassandra’)
CASS_EXISTING_USERNAME=cassandra  # The default username is cassandra
# Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
CASS_EXISTING_PASSWORD=cassandra  # The default password is cassandra

# Cassandra port
CASS_PORT=9042 # The default port is 9042.
    2. Login ke node Cassandra pertama dan jalankan perintah berikut: 
      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Secara opsional, Anda dapat meneruskan properti sebagai argumen perintah ke skrip, seperti yang ditunjukkan pada contoh berikut:

      CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=cassandra CASS_EXISTING_PASSWORD=cassandra CASS_USERNAME=cassandra CASS_PASSWORD=cassandra  CASS_HOSTS="192.168.1.1:1,1 192.168.1.2:1,1 192.168.1.3:1,1" apigee-service apigee-cassandra enable_cassandra_authentication

      Catatan:

      • Untuk kredensial Cassandra default, perintah di atas mengaktifkan autentikasi Cassandra dan memulai ulang Cassandra.
      • Untuk kredensial non-default, perintah ini juga mengubah faktor replikasi, membuat superuser, dan menjalankan perbaikan pada keyspace system_auth.
    3. Ulangi langkah 1 dan 2 pada semua node Cassandra satu per satu.

    Mengubah kredensial Cassandra setelah menginstal Cassandra

    Untuk mengubah kredensial Cassandra setelah menginstal Cassandra:

    1. Login ke salah satu node Cassandra menggunakan alat cqlsh dan kredensial default. Anda hanya perlu mengubah sandi di satu node dan sandi akan disiarkan ke semua node Cassandra dalam ring: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

      Dengan keterangan:

      1. cassIP adalah alamat IP node Cassandra.
      2. 9042 adalah port Cassandra default.
      3. Pengguna default-nya adalah cassandra.
      4. Sandi default-nya adalah cassandra. Jika Anda telah mengubah sandi, gunakan sandi saat ini. Jika sandi berisi karakter khusus, gabungkan dalam tanda kutip tunggal.
    2. Jalankan perintah berikut di perintah cqlsh> untuk memperbarui sandi: 
      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
    3. Keluar dari alat cqlsh, seperti yang ditunjukkan contoh berikut: 
      exit
    4. Jika Anda belum menginstal Server Pengelolaan, Prosesor Pesan, Router, server Qpid, atau server Postgres, tetapkan properti berikut dalam file konfigurasi, lalu instal komponen tersebut: 
      CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD
    5. Jika Anda telah menginstal Server Pengelolaan, Prosesor Pesan, Router, server Qpid, atau server Postgres, lihat Mereset Sandi Edge untuk mengetahui prosedur update komponen tersebut agar menggunakan sandi baru.