Dukungan MariaDB Audit Plugin untuk MySQL

Amazon RDS menawarkan plugin audit untuk instans basis data MySQL berdasarkan MariaDB Audit Plugin sumber terbuka. Untuk informasi selengkapnya, lihat Repositori GitHub Audit Plugin untuk Server MySQL.

catatan

Plugin audit untuk MySQL didasarkan pada MariaDB Audit Plugin. Di sepanjang artikel ini, kami menyebutnya sebagai MariaDB Audit Plugin.

MariaDB Audit Plugin. mencatat aktivitas basis data, termasuk pengguna yang masuk ke basis data dan kueri yang dijalankan terhadap basis data. Catatan aktivitas basis data disimpan dalam file log.

catatan

Saat ini, MariaDB Plugin Audit hanya didukung untuk versi RDS for MySQL berikut:

• MySQL 8.0.28 dan versi 8.0 yang lebih tinggi

• Semua versi MySQL 5.7

Pengaturan opsi Audit Plugin

Amazon RDS mendukung pengaturan berikut untuk opsi MariaDB Audit Plugin.

Pengaturan opsi	Nilai valid	Nilai default	Deskripsi
SERVER_AUDIT_FILE_PATH	/rdsdbdata/log/audit/	/rdsdbdata/log/audit/	Lokasi file log. File log berisi catatan aktivitas yang ditentukan dalam SERVER_AUDIT_EVENTS. Untuk informasi selengkapnya, lihat Melihat dan mencantumkan file log basis data dan File log basis data MySQL.
SERVER_AUDIT_FILE_ROTATE_SIZE	1–1000000000	1000000	Ukuran dalam byte. Jika ukuran ini tercapai, file akan diputar. Untuk informasi selengkapnya, lihat Ikhtisar log basis data RDS for MySQL.
SERVER_AUDIT_FILE_ROTATIONS	0–100	9	Jumlah rotasi log yang akan disimpan ketika server_audit_output_type=file. Jika diatur ke 0, file log tidak akan pernah diputar. Untuk informasi selengkapnya, lihat Ikhtisar log basis data RDS for MySQL dan Mengunduh file log basis data.
SERVER_AUDIT_EVENTS	CONNECT, QUERY, QUERY_DDL, QUERY_DML, QUERY_DML_NO_SELECT, QUERY_DCL	CONNECT, QUERY	Jenis aktivitas yang akan dicatat di log. Penginstalan MariaDB Audit Plugin itu sendiri juga akan dicatat. CONNECT: Mencatat koneksi yang berhasil dan tidak berhasil ke basis data, dan pemutusan dari basis data. QUERY: Mencatat teks semua kueri yang dijalankan terhadap basis data. QUERY_DDL: Mirip dengan peristiwa QUERY, tetapi hanya mengembalikan kueri bahasa definisi data (DDL) (CREATE, ALTER, dan sebagainya). QUERY_DML: Mirip dengan peristiwa QUERY, tetapi hanya mengembalikan kueri bahasa manipulasi data (DML) (INSERT, UPDATE, dan sebagainya, serta SELECT). QUERY_DML_NO_SELECT: Mirip dengan peristiwa QUERY_DML, tetapi tidak mencatat kueri SELECT. Pengaturan QUERY_DML_NO_SELECT didukung hanya untuk RDS for MySQL 5.7.34 dan versi 5.7 yang lebih tinggi, serta versi 8.0.25 dan versi 8.0 yang lebih tinggi. QUERY_DCL: Mirip dengan peristiwa QUERY, tetapi hanya mengembalikan kueri bahasa kontrol data (DCL) (GRANT, REVOKE, dan sebagainya). Untuk MySQL, TABLE tidak didukung.
SERVER_AUDIT_INCL_USERS	Beberapa nilai yang dipisahkan koma	Tidak ada	Hanya menyertakan aktivitas dari pengguna tertentu. Secara default, aktivitas dicatat untuk semua pengguna SERVER_AUDIT_INCL_USERS dan SERVER_AUDIT_EXCL_USERS sama-sama bersifat eksklusif. Jika Anda menambahkan nilai ke SERVER_AUDIT_INCL_USERS, pastikan tidak ada nilai yang ditambahkan ke SERVER_AUDIT_EXCL_USERS.
SERVER_AUDIT_EXCL_USERS	Beberapa nilai yang dipisahkan koma	Tidak ada	Mengecualikan aktivitas dari pengguna tertentu. Secara default, aktivitas dicatat untuk semua pengguna SERVER_AUDIT_INCL_USERS dan SERVER_AUDIT_EXCL_USERS sama-sama bersifat eksklusif. Jika Anda menambahkan nilai ke SERVER_AUDIT_EXCL_USERS, pastikan tidak ada nilai yang ditambahkan ke SERVER_AUDIT_INCL_USERS. Pengguna rdsadmin membuat kueri basis data setiap detik untuk memeriksa kondisi basis data. Bergantung pada pengaturan Anda yang lain, aktivitas ini mungkin dapat menyebabkan ukuran file log Anda bertambah sangat besar dengan sangat cepat. Jika Anda tidak perlu mencatat aktivitas ini, tambahkan pengguna rdsadmin ke daftar SERVER_AUDIT_EXCL_USERS. catatan Aktivitas CONNECT selalu dicatat untuk semua pengguna meskipun pengguna ditentukan untuk pengaturan opsi ini.
SERVER_AUDIT_LOGGING	ON	ON	Pencatatan aktif. Satu-satunya nilai yang valid adalah ON. Amazon RDS tidak mendukung penonaktifan pencatatan. Jika Anda ingin menonaktifkan pencatatan, hapus MariaDB Audit Plugin. Untuk informasi selengkapnya, lihat Menghapus MariaDB Audit Plugin.
SERVER_AUDIT_QUERY_LOG_LIMIT	0–2147483647	1024	Batas panjang string kueri dalam sebuah catatan.

Menambahkan MariaDB Audit Plugin

Proses umum untuk menambahkan MariaDB Audit Plugin ke instans DB adalah sebagai berikut:

• Buat grup opsi baru, atau salin atau ubah grup opsi yang ada

• Tambahkan opsi ke grup opsi

• Kaitkan grup opsi dengan instans DB

Setelah menambahkan MariaDB Audit Plugin, Anda tidak perlu memulai ulang instans DB Anda. Setelah grup opsi aktif, audit akan segera dimulai.

penting

Penambahan MariaDB Plugin Audit ke instans DB dapat menyebabkan gangguan. Sebaiknya tambahkan MariaDB Audit Plugin selama waktu pemeliharaan atau selama waktu beban kerja basis data rendah.

Untuk menambahkan MariaDB Audit Plugin

1. Tentukan grup opsi yang ingin Anda gunakan. Anda dapat membuat grup opsi baru atau menggunakan grup opsi yang ada. Jika Anda ingin menggunakan grup opsi yang ada, lanjutkan ke langkah berikutnya. Jika tidak, buat grup opsi DB kustom. Pilih mysql untuk Mesin, dan pilih 5.7 atau 8.0 untuk Versi mesin utama. Untuk informasi selengkapnya, lihat Membuat grup opsi.

2. Tambahkan opsi MARIADB_AUDIT_PLUGIN ke grup opsi, lalu konfigurasi pengaturan opsi. Untuk informasi selengkapnya tentang cara menambahkan opsi, lihat Menambahkan opsi ke grup opsi. Untuk informasi selengkapnya tentang setiap pengaturan, lihat Pengaturan opsi Audit Plugin.

3. Terapkan grup opsi ke instans DB baru atau yang sudah ada.

   • Untuk instans DB baru, Anda menerapkan grup opsi saat Anda meluncurkan instans. Untuk informasi selengkapnya, lihat Membuat instans DB Amazon RDS.

   • Untuk instans DB yang ada, Anda menerapkan grup opsi dengan memodifikasi instans dan melampirkan grup opsi baru. Untuk informasi selengkapnya, lihat Memodifikasi instans DB Amazon RDS.

Format log Audit

File log direpresentasikan sebagai file variabel dipisahkan koma (CSV) dalam format UTF-8.

Tip

Entri file log tidak berurutan. Untuk mengurutkan entri, gunakan nilai stempel waktu. Untuk melihat peristiwa terbaru, Anda mungkin harus meninjau semua file log. Untuk fleksibilitas yang lebih besar dalam menyortir dan mencari data log, aktifkan pengaturan untuk mengunggah log audit ke CloudWatch dan lihat menggunakan antarmuka CloudWatch.

Untuk melihat data audit dengan lebih banyak jenis bidang dan dengan output dalam format JSON, Anda juga dapat menggunakan fitur Aliran Aktivitas Basis Data. Untuk informasi selengkapnya, lihat Memantau Amazon RDS dengan Aliran Aktivitas Basis Data.

File log audit meliputi informasi yang dipisahkan koma berikut dalam baris, dalam urutan yang ditentukan:

Bidang	Deskripsi
timestamp	YYYYMMDD diikuti oleh HH:MI:SS (waktu 24 jam) untuk peristiwa yang dicatat.
serverhost	Nama instans tempat peristiwa dicatat.
nama pengguna	Nama pengguna yang terhubung dengan pengguna.
host	Host yang terhubung ke pengguna.
connectionid	Nomor ID koneksi untuk operasi yang dicatat.
queryid	Nomor ID kueri, yang dapat digunakan untuk menemukan peristiwa tabel hubungan dan kueri terkait. Untuk peristiwa TABLE, beberapa baris ditambahkan.
operation	Jenis tindakan terekam. Kemungkinan nilainya adalah: CONNECT, QUERY, READ, WRITE, CREATE, ALTER, RENAME, dan DROP.
database	Basis data aktif, yang diatur oleh perintah USE.
object	Untuk peristiwa QUERY, nilai ini menunjukkan kueri yang dilakukan basis data. Untuk peristiwa TABLE, nilai ini menunjukkan nama tabel.
retcode	Kode hasil dari operasi yang dicatat.
connection_type	Status keamanan koneksi ke server. Kemungkinan nilainy adalah: 0 – Undefined 1— TCP/IP 2 – Soket 3 – Pipa bernama 4 – SSL/TLS 5 – Memori bersama Bidang ini disertakan hanya untuk RDS for MySQL versi 5.7.34 dan versi 5.7 yang lebih tinggi, serta semua versi 8.0.

Melihat dan mengunduh log MariaDB Audit Plugin.

Setelah mengaktifkan MariaDB Audit Plugin, Anda dapat mengakses hasilnya di file log dengan cara yang sama seperti Anda mengakses file log berbasis teks lainnya. File log audit terletak di /rdsdbdata/log/audit/. Untuk informasi tentang cara melihat file log di konsol, lihat Melihat dan mencantumkan file log basis data. Untuk informasi tentang cara mengunduh file log, lihat Mengunduh file log basis data.

Mengubah pengaturan MariaDB Audit Plugin

Setelah mengaktifkan MariaDB Plugin Audit, Anda dapat mengubah pengaturan. Untuk informasi selengkapnya tentang cara mengubah pengaturan opsi, lihat Memodifikasi pengaturan opsi. Untuk informasi selengkapnya tentang setiap pengaturan, lihat Pengaturan opsi Audit Plugin.

Menghapus MariaDB Audit Plugin

Amazon RDS tidak mendukung penonaktifan log di MariaDB Audit Plugin. Namun, Anda dapat menghapus plugin dari instans DB. Jika Anda menghapus MariaDB Audit Plugin, instans DB dimulai ulang secara otomatis untuk menghentikan audit.

Untuk menghapus MariaDB Audit Plugin dari instans DB, lakukan salah satu hal berikut:

• Hapus opsi MariaDB Plugin Audit dari grup opsi yang menjadi miliknya. Perubahan ini memengaruhi semua instans DB yang menggunakan grup opsi tersebut. Untuk informasi selengkapnya, lihat Menghapus opsi dari grup opsi

• Ubah instans DB dan tentukan grup opsi berbeda yang tidak menyertakan plugin. Perubahan ini memengaruhi instans DB tunggal. Anda dapat menentukan grup opsi default (kosong) atau grup opsi kustom yang berbeda. Untuk informasi selengkapnya, lihat Memodifikasi instans DB Amazon RDS.