Mengaktifkan autentikasi Cassandra

Secara default, Cassandra diinstal 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:

  • username = 'cassandra'
  • password = 'cassandra'

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

Untuk mengetahui informasi selengkapnya, lihat Perintah shell Cassandra SQL.

Mengaktifkan autentikasi Cassandra selama penginstalan

Anda dapat mengaktifkan autentikasi Cassandra pada waktu penginstalan. Namun, meskipun Anda 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

Penginstalan kemudian akan menyiapkan Cassandra dengan autentikasi yang diaktifkan dan dengan 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
  • Message Processor
  • Router
  • Server Qpid
  • Server Postgres

Menginstal komponen Edge saat autentikasi Cassandra diaktifkan

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

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 Anda telah menginstal Server Pengelolaan, Message Processor, Router, server Qpid, atau server Postgres, Anda juga harus memperbarui komponen tersebut untuk menggunakan kredensial baru, seperti yang dijelaskan di bagian berikutnya.

Mengupdate komponen Edge yang terhubung ke Cassandra

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

  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 Message Processor
    • 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

    Mengaktifkan autentikasi Cassandra setelah penginstalan

    Bagian berikut menjelaskan cara mengaktifkan autentikasi Cassandra setelah penginstalan.

    Mengaktifkan autentikasi Cassandra pada penyiapan pusat data tunggal

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

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

    Mengaktifkan autentikasi Cassandra jika ada beberapa pusat data

    Saat memperluas pusat data, ikuti langkah-langkah di 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 di bawah:

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

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

    1. Siapkan 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 guna menggunakan kembali kredensial dari pusat data yang ada (jika yang ada menggunakan kredensial non-default).
    3. Instal komponen Edge di pusat data baru menggunakan kredensial Cassandra non-default.

    Skenario 2: Pusat data yang ada tidak mengaktifkan autentikasi Cassandra

    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 untuk mengaktifkan autentikasi Cassandra di seluruh cluster (setelah 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 otomatis 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

      Atau, Anda dapat meneruskan properti sebagai argumen perintah ke skrip, seperti yang ditunjukkan dalam 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 akan 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 pada satu node dan sandi tersebut akan disiarkan ke semua node Cassandra dalam ring: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

      Dengan:

      1. cassIP adalah alamat IP node Cassandra.
      2. 9042 adalah port Cassandra default.
      3. Pengguna default adalah cassandra.
      4. Sandi default-nya adalah cassandra. Jika Anda telah mengubah sandi sebelumnya, gunakan sandi saat ini. Jika sandi berisi karakter khusus, apit sandi dengan tanda kutip tunggal.
    2. Jalankan perintah berikut di prompt 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, Message Processor, 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, Pemroses Pesan, Router, server Qpid, atau server Postgres, lihat Mereset Sandi Edge untuk mengetahui prosedur memperbarui komponen tersebut agar menggunakan sandi baru.