Perintah Kustom

Halaman ini mencakup modul Perintah Kustom Webmin, yang dapat digunakan untuk membuat tombol untuk menjalankan perintah shell yang sering digunakan.

Isi

Modul Perintah Kustom

Sebagian besar administrator sistem suka membuat skrip shell untuk melakukan tugas-tugas umum, seperti mencadangkan database atau menambahkan pengguna baru. Karena setiap sistem dan organisasi berbeda, akan selalu ada tugas yang tidak dapat dilakukan oleh alat umum seperti Webmin semudah skrip kustom sederhana. Sayangnya, skrip yang dijalankan pada baris perintah tidak mudah digunakan oleh pengguna yang tidak berpengalaman.

Modul Perintah Kustom memungkinkan Anda membuat antarmuka web sederhana untuk skrip dan perintah shell, sehingga dapat dijalankan dari dalam Webmin dengan mengklik tombol. Ini juga memungkinkan Anda untuk menentukan parameter dari berbagai jenis untuk setiap perintah yang dapat dimasukkan oleh pengguna dan diganti ke dalam perintah shell. Ini dapat digunakan untuk memberikan argumen atau input tambahan ke skrip yang dijalankan, tergantung pada pilihan yang dibuat oleh pengguna sebelum menjalankannya.

Fitur lain dari modul ini adalah kemampuan untuk mendefinisikan editor file, sehingga file yang sering diubah dapat diedit melalui antarmuka web Webmin. Anda juga dapat menentukan perintah yang akan dijalankan sebelum dan sesudah file diedit, sehingga dapat divalidasi, disalin, atau dicadangkan sebelum diedit.

Mungkin fitur yang paling berguna dari modul ini adalah dukungan kontrol aksesnya. Anda dapat memberikan hak kepada pengguna Webmin lain untuk menggunakan beberapa atau semua perintah dan editor, sementara hanya memberikan izin kepada Anda sendiri dan administrator tepercaya lainnya untuk membuat dan mengedit perintah. Ini berarti bahwa pengguna lain hanya dapat menjalankan skrip dan mengedit file yang Anda izinkan, tetapi tanpa hak root penuh.

Tidak seperti kebanyakan modul lainnya, modul ini tidak berurusan dengan konfigurasi beberapa server atau layanan terpisah. Oleh karena itu, ia memiliki antarmuka pengguna dan fungsionalitas yang sama persis di semua versi Unix yang dapat dijalankan oleh Webmin.

Saat Anda memasukkan modul dari kategori Lainnya, halaman utamanya menampilkan semua perintah khusus dan editor file yang ada, beserta parameternya. Tangkapan layar di bawah ini menunjukkan contoh dari sistem dengan 1 editor file dan 8 perintah yang ditentukan, dua di antaranya memiliki parameter. Jika Anda belum pernah menggunakan modul sebelumnya, halaman akan kosong.

Modul Perintah Kustom

Anda dapat menjalankan perintah apa pun yang ditampilkan di halaman utama hanya dengan mengklik tombolnya. Namun, jika perintah memiliki bidang parameter atau pilihan, Anda harus mengisinya atau membuat pilihan yang sesuai sebelum menjalankannya. Ketika tombol diklik, Anda akan dibawa ke halaman yang menunjukkan al output dari perintah, sehingga Anda dapat melihat apakah itu berhasil atau gagal.

Untuk menggunakan editor file, cukup klik tombolnya di halaman utama. Ini akan membawa Anda ke formulir pengeditan yang menunjukkan konten file saat ini, yang dapat Anda ubah secara bebas. Setelah selesai, klik tombol Simpan tombol di bawah kotak teks untuk menulis isi file baru.

Membuat perintah baru

Untuk membuat perintah baru yang dapat dijalankan menggunakan tombol di halaman utama modul, langkah-langkah yang harus dilakukan adalah :

1. Klik pada Buat perintah khusus baru link di atas atau di bawah tombol yang ada. Ini akan memunculkan formulir pembuatan yang ditunjukkan pada gambar di bawah ini.
2. Masukkan deskripsi singkat untuk perintah Anda ke dalam Deskripsi bidang. Teks apa pun yang Anda masukkan akan muncul di tombol perintah di halaman utama. Anda juga dapat memasukkan teks tambahan (termasuk tag HTML) ke dalam kotak teks yang lebih besar di bawahnya, untuk ditampilkan di bawah tombol.
3. Dalam Perintah bidang, masukkan skrip shell atau perintah yang ingin Anda jalankan. Semua metakarakter shell standar {| border="1" |- didukung, seperti ||, &, . Untuk memasukkan beberapa perintah, |} pisahkan dengan ; atau &&. Jika perintah Anda memiliki parameter (ditetapkan pada langkah 10), parameter tersebut akan diubah menjadi variabel lingkungan saat perintah dijalankan. Jadi jika Anda memiliki parameter yang disebut foo, semua kemunculan $foo dalam string perintah akan diganti dengan apa pun yang dimasukkan pengguna untuk parameter itu. Misalnya, perintah yang memungkinkan pengguna untuk menyentuh pengguna mana pun di sistem mungkin terlihat seperti finger $user .
4. Secara default, perintah akan berjalan di direktori Webmin untuk modul ini. Untuk mengubahnya, batalkan pilihan Default untuk Jalankan di direktori bidang dan masukkan jalur yang berbeda ke dalam kotak teks di sebelahnya.
5. Dalam Jalankan sebagai pengguna bidang, masukkan nama pengguna Unix yang menjalankan perintah sebagai. Anda dapat memilih pengguna Webmin sebagai gantinya, yang akan menyebabkannya berjalan sebagai pengguna Unix dengan nama yang sama dengan pengguna Webmin yang menjalankannya. Ketika perintah dijalankan, biasanya tidak memiliki akses ke variabel lingkungan yang sama dengan yang dimiliki pengguna Unix jika dia masuk melalui telnet atau SSH. Namun, jika Anda memeriksa Gunakan lingkungan pengguna pilihan maka semua variabel yang diatur dalam .profile, .cshrc dan file login pengguna lainnya akan tersedia. Webmin menjalankan perintah dengan su, yang beralih ke pengguna, mengeksekusi shell-nya dan kemudian mengeksekusi perintah.
6. Jika perintah Anda menghasilkan output HTML yang ingin Anda tampilkan di browser saat dijalankan, ubah bidang *Command output HTML?* menjadi Ya . Jika tidak, Webmin akan keluar dari semua tag HTML di output, yang merupakan hal yang benar untuk dilakukan untuk perintah yang hanya menghasilkan teks biasa.
7. Untuk mengontrol penempatan perintah baru di halaman depan modul, masukkan nomor untuk Pemesanan di halaman utama pilihan. Perintah diurutkan sehingga yang memiliki angka tertinggi muncul lebih dulu. Jika Default dipilih, nomor urut dianggap nol. Jika Anda tidak mengatur nomor pemesanan untuk perintah kustom Anda, perintah tersebut akan ditampilkan sesuai urutan pembuatannya.
8. Untuk mencegah pengguna melihat perintah shell yang sebenarnya sedang dijalankan saat tombolnya diklik, setel bidang *Sembunyikan perintah saat menjalankan?* ke Ya . Ini adalah ide yang bagus jika perintah Anda berisi kata sandi atau informasi sensitif lainnya yang ingin Anda sembunyikan dari pengguna.
9. Agar perintah muncul di modul Perintah Kustom Usermin, ubah Tersedia di Usermin? bidang ke Ya . Lihat UserminConfiguration untuk informasi lebih lanjut tentang cara menginstal dan mengkonfigurasi Usermin.
10. Jika Anda ingin perintah Anda memiliki parameter yang dapat diatur pengguna di halaman utama, Anda harus mengisi Parameter perintah bagian. Setiap baris dalam tabel di bagian ini menentukan satu parameter, dan untuk setiap baris informasi berikut harus dimasukkan :

    Nama

    Nama unik pendek untuk parameter ini, yang dapat digunakan dalam Perintah bidang (diawali dengan $) untuk menunjukkan di mana nilai yang dimasukkan oleh pengguna harus diganti. Nama hanya boleh terdiri dari huruf, angka, dan karakter _.

    Deskripsi

    Teks yang akan melabeli parameter pada halaman utama modul. Ini dapat berisi karakter apa pun termasuk tag HTML, tetapi tidak boleh terlalu panjang.

    Jenis

    Menu ini mengontrol bagaimana parameter ditampilkan pada halaman utama modul, dan input apa yang diperbolehkan. Pilihan yang paling umum adalah Teks , tetapi semua opsi yang tersedia dan artinya tercakup dalam Jenis parameter bagian di bawah.

    Parameter kutipan?

    Jika disetel ke Ya , nilai yang dimasukkan oleh pengguna akan dikutip dengan karakter " sebelum substitusi. Saat membuat perintah baru, hanya tersedia satu baris kosong untuk memasukkan satu parameter. Untuk menambahkan lebih banyak, Anda perlu mengedit ulang perintah setelah menyimpannya .

11. Terakhir, setelah Anda selesai memasukkan detail perintah baru Anda, klik tombol Buat tombol. Selama tidak ada kesalahan dalam formulir, Anda akan kembali ke halaman utama modul di mana tombol perintah baru akan terlihat

Membuat perintah kustom baru

Setelah perintah dibuat, Anda dapat mengeditnya dengan mengklik Edit perintah link di bawahnya pada halaman utama modul. Semua bidang yang dijelaskan di atas dapat diubah, dan parameter tambahan ditambahkan. Setelah Anda selesai membuat perubahan, klik Simpan tombol di bagian bawah halaman. Atau untuk menghilangkan perintah tersebut, klik tombol Hapus tombol di pojok kanan bawah.

Jenis parameter

Untuk setiap parameter dalam perintah, Anda dapat memilih jenis dari menunya di bawah Jenis kolom. Opsi yang tersedia dan artinya adalah :

Teks

bidang input teks

args [teks default untuk bidang teks]

Pengguna

bidang masukan nama pengguna

args [nama pengguna default untuk bidang pengguna]

UID

bidang masukan id pengguna

args [ID pengguna default untuk bidang UID]

Grup

bidang masukan nama grup

args [nama default untuk bidang grup]

GID

bidang masukan id grup

args [ID grup default untuk bidang GID]

Berkas

file (sisi server) pilih bidang input

args [default /path/to/server/file]

Direktori

direktori (sisi server) pilih bidang input

args [default /path/to/server/directory/]

Opsi..

ya | tidak ada bidang boolean

args ["nilai yang akan diteruskan jika Ya dipilih"]

Sandi

bidang masukan sandi

args [sandi default]

Menu..

pilihan pilih menu bidang input

args [/path/to/option/file.txt]

opsi menu tercantum dalam file. Berikan path dan nama file ke file /path/to/myMenu_options.txt di kolom Type parameter args. File myMenu_options.txt berisi satu opsi per baris sebagai "kunci" "nilai". "Kunci" adalah apa yang diteruskan ke skrip perintah khusus Anda. "Nilai" adalah apa yang ditampilkan kepada pengguna.

Unggah

file (sisi pengguna) pilih bidang input

args [jalur/file default]

Kotak teks

bidang input textarea

args [teks default untuk kotak Teks]

Multi menu..

opsi bersarang pilih bidang masukan

args Seperti jenis Menu, tetapi memungkinkan beberapa pilihan

Banyak menu multi..

bidang input pemilihan bertingkat kompleks

args Sama seperti Multi Menu, tetapi cukup tinggi untuk menampilkan semua opsi

Menu kiri-kanan..

kiri <-> widget menu kanan

args Fungsinya sama dengan Multi Menu, tetapi menampilkan opsi di kiri dan nilai yang dipilih di kanan

Tanggal

bidang input pilih tanggal

args [tanggal default dalam format YYYY-MM-DD]

Tombol kirim

kirim tombol perintah

args Hanya sebuah tombol

Membuat editor file baru

Untuk menambahkan tombol baru ke halaman utama modul untuk mengedit file, Anda harus mengikuti langkah berikut :

1. Klik pada Buat editor file baru link di atas atau di bawah tombol yang ada. Ini akan memunculkan formulir pembuatan editor yang ditunjukkan pada gambar di bawah ini.
2. Masukkan deskripsi singkat untuk file yang akan diedit ke dalam Deskripsi bidang. Teks apa pun yang Anda masukkan akan muncul di tombol editor di halaman utama. Anda juga dapat memasukkan teks tambahan (termasuk tag HTML) ke dalam kotak teks yang lebih besar di bawahnya, untuk ditampilkan di bawah tombol.
3. Masukkan path lengkap ke file yang akan diedit ke dalam bidang *File untuk diedit*. File belum tentu harus ada.
4. Agar pemilik file berubah saat disimpan, setel bidang *Kepemilikan file* ke Pengguna dan masukkan nama pengguna Unix dan nama grup ke dalam bidang di sebelahnya. Ini sangat berguna saat mengedit file yang belum ada, sehingga kepemilikan file yang baru dibuat diatur dengan benar. Jika Anda membiarkan bidang disetel ke Biarkan apa adanya , kepemilikan file tidak akan berubah saat disimpan. File yang baru dibuat akan dimiliki oleh root.
5. Untuk mengubah izin akses file saat disimpan, setel Izin file bidang ke Setel ke oktal dan masukkan izin (seperti 700 atau 664 ) ke bidang di sebelahnya. Untuk Anda pilih Biarkan saja , izin file tidak akan diubah saat disimpan. Izin pada file yang baru dibuat bergantung pada umask proses Webmin.
6. Untuk menjalankan perintah tepat sebelum file disimpan oleh pengguna, isi kolom *Perintah untuk dijalankan sebelum menyimpan *. Ini bisa berguna untuk membuat salinan cadangan, memeriksa file dari RCS atau apa pun yang dapat Anda buat.
7. Demikian pula, untuk menjalankan perintah tepat setelah file disimpan, isi kolom C*command untuk dijalankan setelah menyimpan*. Ini dapat berguna untuk memvalidasi konten file, menyalinnya ke sistem lain, atau memeriksanya kembali ke RCS.
8. Untuk mengontrol penempatan tombol editor baru di halaman depan modul, masukkan nomor untuk opsi *Pemesanan di halaman utama*. Perintah dan editor diurutkan sehingga yang memiliki jumlah tertinggi muncul lebih dulu. Jika Default dipilih, nomor urut dianggap nol. Jika Anda tidak menyetel nomor pemesanan untuk editor file mana pun, mereka akan ditampilkan sesuai urutan pembuatannya.
9. Agar editor muncul di modul Perintah Kustom Usermin, ubah Tersedia di Usermin? bidang ke Ya . Lihat UserminConfiguration untuk informasi lebih lanjut tentang cara menginstal dan mengkonfigurasi Usermin.
10. Terakhir, klik tombol Simpan tombol. Jika tidak ada kesalahan dalam formulir, Anda akan kembali ke halaman utama modul yang akan menyertakan tombol untuk editor baru.

Membuat editor file baru

Setelah editor dibuat, Anda dapat mengeditnya dengan mengklik tautan *Edit file editor * di bawahnya pada halaman utama modul. Setelah Anda selesai membuat perubahan, klik Simpan tombol di bagian bawah halaman. Atau untuk menghapus editor, klik Hapus tombol di pojok kanan bawah.

Kontrol akses modul

Opsi kontrol akses dalam modul Perintah Kustom dirancang untuk memungkinkan pengguna Master Webmin memberikan hak kepada beberapa pengguna lain untuk menjalankan perintah yang dipilih, tetapi tidak mengedit atau membuatnya. Dari sudut pandang keamanan, tidak masuk akal untuk memberikan izin kepada pengguna yang tidak tepercaya untuk membuat perintah kustomnya sendiri, karena itu akan memungkinkan dia untuk menjalankan perintah apa pun sebagai root dan dengan demikian membahayakan keamanan seluruh sistem. Demikian pula, Anda dapat membatasi editor file yang dapat digunakan pengguna Webmin, dan mencegahnya membuat editor baru.

Setelah Anda membuat pengguna atau grup dengan akses ke modul Perintah Kustom (seperti yang dijelaskan dalam bab 52), langkah-langkah yang harus diikuti untuk membatasi aksesnya adalah :

1. Dalam modul Pengguna Webmin, klik Perintah Kustom di sebelah nama pengguna atau grup yang ingin Anda beri akses. Ini akan memunculkan formulir kontrol akses untuk modul.
2. Ubah Dapatkah mengedit konfigurasi modul? kolom ke Tidak .
3. Kecuali Anda ingin pengguna dapat menjalankan semua perintah dan menggunakan semua editor, atur Perintah yang dapat dijalankan pengguna ini bidang ke Dipilih dan pilih yang boleh dia gunakan dari daftar di bawah ini. Sebagai alternatif, Anda dapat memilih *Semua kecuali yang dipilih* dan memilih dari daftar perintah yang tidak boleh dia gunakan. Semua yang lain akan tersedia untuknya.
4. Ubah Dapatkah membuat dan mengedit perintah? kolom ke Tidak .
5. Klik tombol Simpan tombol. Pengaturan kontrol akses akan diaktifkan dan Anda akan kembali ke halaman utama modul Pengguna Webmin.

Jika Anda ingin memberikan akses ke perintah dan editor khusus yang dipilih ke sejumlah besar pengguna, solusi yang lebih baik mungkin adalah menginstal Usermin, yang memungkinkan setiap pengguna Unix untuk masuk. Perintah apa saja yang Tersedia di Usermin? bidang disetel ke Ya akan terlihat di modul Perintah Kustom Usermin, dan bekerja dengan cara yang persis sama. Lihat Konfigurasi Usermin untuk informasi lebih lanjut tentang Usermin dan bagaimana hal itu dapat dikonfigurasi untuk membatasi pengguna Unix mana yang dapat menjalankan perintah khusus.