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:
- 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.
- 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:
- Aktifkan autentikasi Cassandra untuk pertama kalinya, baik menggunakan pengguna Cassandra default (
cassandra:cassandra
) atau dengan membuat pengguna super yang benar-benar baru. Untuk melakukannya, ikuti langkah-langkah di bawah:- Ikuti langkah-langkah di Mengaktifkan autentikasi Cassandra untuk pertama kalinya.
- Update komponen Edge yang terhubung ke Cassandra dengan nama pengguna dan sandi Cassandra.
- Ubah sandi pengguna Cassandra yang ada.
Jika Anda telah mengaktifkan autentikasi Cassandra menggunakan kredensial Cassandra default (
cassandra:cassandra
), Anda dapat mengubah sandi dengan mengikuti langkah-langkah di bawah:- Ubah sandi untuk pengguna Cassandra.
- Update komponen Edge yang terhubung ke Cassandra dengan nama pengguna dan sandi Cassandra.
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:- Siapkan pusat data baru dengan kredensial Cassandra:Cassandra & CASS_AUTH=y default. Lihat Mengaktifkan autentikasi Cassandra untuk pertama kalinya.
- 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:
- Menyiapkan pusat data baru dengan kredensial Cassandra:Cassandra default & CASS_AUTH=y. Lihat Mengaktifkan autentikasi Cassandra untuk pertama kalinya.
- 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).
- 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:
- Siapkan pusat data baru tanpa autentikasi Cassandra.
- Ikuti langkah-langkah Mengaktifkan autentikasi Cassandra untuk pertama kalinya guna mengaktifkan autentikasi Cassandra di seluruh cluster (pasca-perluasan).
- 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:
- 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.
- 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.
- 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:
- 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:
- cassIP adalah alamat IP node Cassandra.
- 9042 adalah port Cassandra default.
- Pengguna default-nya adalah
cassandra
. - Sandi default-nya adalah
cassandra
. Jika Anda telah mengubah sandi, gunakan sandi saat ini. Jika sandi berisi karakter khusus, gabungkan dalam tanda kutip tunggal.
- Jalankan perintah berikut di perintah
cqlsh>
untuk memperbarui sandi:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
- Keluar dari alat
cqlsh
, seperti yang ditunjukkan contoh berikut:exit
- 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
- 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.