Halaman ini menjelaskan cara membuat dan mengelola profil keamanan
berjenis url-filtering
menggunakan konsol Google Cloud dan Google Cloud CLI.
Sebelum memulai
- Anda harus mengaktifkan Network Security API di project Anda.
- Instal gcloud CLI jika Anda ingin menjalankan contoh command line
gcloud
dalam panduan ini.
Peran
Untuk mendapatkan izin yang diperlukan untuk membuat, melihat, memperbarui, atau menghapus profil keamanan, minta administrator untuk memberi Anda peran IAM yang diperlukan di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.
Membuat profil keamanan pemfilteran URL
Saat membuat profil keamanan pemfilteran URL (profil keamanan jenis
url-filtering
), Anda dapat menentukan nama profil keamanan
sebagai string atau sebagai ID URL unik. URL unik untuk profil keamanan cakupan organisasi dapat dibuat dalam format berikut:
organization/ORGANIZATION_ID/locations/LOCATION/securityProfiles/SECURITY_PROFILE_NAME
Jika Anda menggunakan ID URL unik untuk nama profil keamanan, organisasi dan lokasi profil keamanan sudah disertakan dalam ID URL. Namun, jika Anda hanya menggunakan nama profil keamanan, Anda harus menentukan organisasi dan lokasi secara terpisah. Untuk mengetahui informasi selengkapnya tentang ID URL unik, lihat spesifikasi profil keamanan.
Konsol
Di konsol Google Cloud , buka halaman Security profiles.
Di menu pemilih project, pilih organisasi Anda.
Pilih tab Profil keamanan.
Klik Buat profil.
Masukkan nama di kolom Name.
Opsional: Masukkan deskripsi di kolom Deskripsi.
Untuk membuat profil keamanan Cloud Next Generation Firewall Enterprise, di bagian Purpose, pilih Cloud NGFW Enterprise.
Untuk membuat profil keamanan pemfilteran URL, di bagian Type, pilih URL Filtering.
Di bagian Filter URL, klik tombol Buat filter URL.
Di panel Buat filter URL, tentukan detail berikut:
- Prioritas: tentukan prioritas filter URL.
- Tindakan: tentukan tindakan yang dilakukan Cloud NGFW pada traffic.
- Izinkan: mengizinkan koneksi yang cocok dengan URL.
- Tolak: menolak koneksi yang cocok dengan URL.
- Daftar URL: tentukan daftar URL atau string pencocokan. Setiap entri string pencocok atau URL harus muncul di barisnya sendiri tanpa spasi atau pembatas. Setiap entri hanya dapat terdiri dari domain. Untuk mengetahui informasi selengkapnya tentang string pencocok, lihat String pencocok untuk URL.
Klik Buat.
gcloud
Buat file YAML dengan konten berikut:
name: NAME type: PROFILE_TYPE urlFilteringProfile: urlFilters: - filteringAction: ACTION priority: PRIORITY urls: URL[,URL,...]
Ganti kode berikut:
NAME
: nama profil keamanan pemfilteran URL; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.PROFILE_TYPE
: jenis profil keamanan,url-filtering
atauthreat-prevention
.ACTION
: tentukan salah satu tindakan berikut:allow
: mengizinkan koneksi yang cocok dengan URLdeny
: menolak koneksi yang cocok dengan URL
PRIORITY
: prioritas filter URL yang berkisar dari 0 hingga 2147483647.URLs
: daftar string pencocok yang dipisahkan koma. Misalnya,www.example.com
danwww.altostrat.com
.
Untuk membuat profil keamanan pemfilteran URL, jalankan perintah
gcloud network-security security-profiles import
:gcloud network-security security-profiles import NAME \ --location LOCATION \ --source FILE_NAME \ --organization = ORGANIZATION_ID
Atau, Anda dapat membuat profil keamanan pemfilteran URL tanpa file YAML menggunakan perintah
gcloud network-security security-profiles url-filtering create
:gcloud network-security security-profiles url-filtering create NAME \ --location LOCATION \ --organization ORGANIZATION_ID \ --description DESCRIPTION
Ganti kode berikut:
NAME
: nama profil keamanan pemfilteran URL; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.Jika Anda menggunakan ID URL unik untuk flag
NAME
, Anda dapat menghilangkan flagLOCATION
danORGANIZATION
.LOCATION
: lokasi profil keamanan pemfilteran URL.Lokasi selalu ditetapkan ke
global
. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaLOCATION
.FILE_NAME
: nama file YAML. Contoh,url-filtering-sp.yaml
.ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat. Jika menggunakan ID URL unik untuk flagname
, Anda dapat menghapus flagORGANIZATION_ID
.DESCRIPTION
: deskripsi opsional untuk profil keamanan pemfilteran URL.
Misalnya, cuplikan kode berikut menunjukkan contoh profil keamanan pemfilteran URL yang mengizinkan permintaan ke
www.example.com
danwww.altostrat.com
, tetapi menolak permintaan ke semua domain lainnya:url_filtering_profile: url_filters: - filtering_action: ALLOW priority: 1000 urls: ['www.example.com', 'www.altostrat.com'] # the following URL filter is implicit and will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
Filter URL penolakan implisit
Profil keamanan pemfilteran URL selalu menyertakan filter URL default dengan prioritas terendah (2147483647) yang menolak semua koneksi yang tidak cocok dengan filter URL dengan prioritas yang lebih tinggi. Cuplikan kode berikut menunjukkan contoh filter URL penolakan implisit:
url_filtering_profile: url_filters: # user-specified URL filters - filtering_action: DENY priority: 1000 urls: ['www.example.com','www.altostrat.com'] - filtering_action: ALLOW priority: 2000 urls: ['www.example.org','www.example.net'] # implicit deny URL filter that will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
Anda dapat melihat filter URL penolakan implisit saat melihat atau mengekspor profil keamanan filter URL. Anda tidak dapat mengubah atau menghapus filter implisit. Misalnya,
jika Anda ingin mengubah tindakan default profil dari DENY
(diterapkan oleh filter implisit) menjadi ALLOW
, Anda harus menambahkan filter eksplisit yang
diproses Cloud NGFW sebelum filter implisit.
url_filtering_profile: url_filters: # user-specified filters - filtering_action: DENY priority: 1000 urls: ['www.example.com','www.altostrat.com'] # explicit allow URL filter that you can add - filtering_action: ALLOW priority: 2000 urls: ['*'] # implicit deny URL filter that will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
String pencocok untuk URL
String pencocokan adalah nilai yang Anda tentukan di kolom urls
filter URL. Anda dapat menentukan satu atau beberapa string pencocok di dalam filter URL.
Karakter pengganti
Setiap string pencocokan dalam daftar URL mendukung karakter pengganti (*) dengan cara yang terbatas.
- Setiap string pencocok hanya dapat mendukung satu tanda bintang (*) sehingga tanda bintang tersebut menjadi karakter pertama atau satu-satunya.
Tanda bintang (*) dapat memiliki interpretasi berikut:
Tanda bintang (*) sebelum titik (.) menunjukkan semua subdomain domain.
Misalnya, string pencocok
*.example.com
cocok dengana.example.com
dana.b.c.example.com
, tetapi tidak cocok denganexample.com
.url_filtering_profile: url_filters: # user-specified filters - filtering_action: ALLOW priority: 1000 urls: ['*.example.com'] # implicit deny URL filter that will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
Pada contoh sebelumnya, Cloud NGFW mengizinkan traffic ke subdomain
example.com
, tetapi menolak traffic keluar lainnya.Tanda bintang (*) sebelum label menunjukkan domain dan semua subdomain.
Misalnya, string pencocokan
*example.com
cocok dengana.example.com
,a.b.c.example.com
, sertaexample.com
.url_filtering_profile: url_filters: # user-specified filters - filtering_action: ALLOW priority: 1000 urls: ['*example.com'] # implicit deny URL filter that will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
Pada contoh sebelumnya, Cloud NGFW mengizinkan traffic ke
example.com
serta subdomainexample.com
, tetapi menolak traffic keluar lainnya.Cloud NGFW tidak menafsirkan tanda bintang (*) sebagai karakter pengganti ekspresi reguler.
Misalnya,
*example.test
tidak cocok dengannewexample.test
ataua.newexample.test
. Hanya cocok denganexample.test
dan subdomainexample.test
.Satu tanda bintang (*) tanpa karakter lain menunjukkan kecocokan untuk semua permintaan.
Misalnya, string pencocok di filter URL izinkan eksplisit berprioritas terendah hanya berisi tanda bintang (*) dan memiliki tindakan
ALLOW
yang menggantikan tindakan defaultDENY
. Hal ini terjadi karena filter URL penolakan implisit menerapkanDENY
default untuk permintaan apa pun yang tidak cocok dengan filter URL prioritas yang lebih tinggi.Filter URL dengan prioritas tertinggi—yang berupa
ALLOW
eksplisit atauDENY
implisit—menentukan apakah Cloud NGFW mengizinkan atau menolak koneksi saat tidak memiliki informasi SNI atau domain. Hal ini dapat terjadi dengan traffic HTTP yang tidak dienkripsi, atau saat pemeriksaan TLS dinonaktifkan untuk header pesan terenkripsi.url_filtering_profile: url_filters: # user-specified filters - filtering_action: DENY priority: 1000 urls: ['www.example.com','www.altostrat.com'] # explicit allow URL filter that you can add - filtering_action: ALLOW priority: 2000 urls: ['*'] # implicit deny URL filter that will be processed last - filtering_action: DENY priority: 2147483647 urls: ['*']
Batasan
- String pencocokan mewakili domain atau subdomain.
- String pencocok tidak mendukung karakter garis miring (/). Misalnya:
www.example.com/images
. - String pencocokan tidak mendukung skema atau nama protokol. Misalnya:
http://www.example.com
. - String pencocokan tidak mendukung nomor port. Misalnya:
www.example.com:80
. - String pencocokan hanya mendukung huruf, angka, dan karakter khusus ASCII: tanda hubung (-), titik (.), dan tanda bintang (*).
Anda harus menggunakan Punycode untuk mengonversi nama domain yang berisi karakter selain huruf, angka, tanda hubung (-), titik (.), atau tanda bintang (*) ASCII. Punycode adalah standar encoding yang mengubah nama domain Unicode menjadi format yang kompatibel dengan ASCII.
Jika Anda memiliki dua label atau lebih, gunakan titik (.) untuk memisahkannya. Label dapat berisi satu atau beberapa tanda hubung (-); namun, label tidak boleh diawali atau diakhiri dengan tanda hubung. Setiap label dapat menyertakan maksimum 63 karakter.
Filter URL tidak mendukung penggunaan titik di awal nama domain atau titik berurutan dalam string pencocokan. Filter URL mengizinkan titik di akhir URL, tetapi Cloud NGFW menghapusnya sebelum menyimpan filter URL.
Cloud NGFW mengonversi string pencocok menjadi huruf kecil sebelum menyimpan filter URL. Cloud NGFW tidak melakukan normalisasi lainnya.
Setiap nama domain dapat berisi maksimum 255 karakter.
Melihat profil keamanan pemfilteran URL
Anda dapat melihat detail profil keamanan pemfilteran URL tertentu dalam organisasi.
Konsol
Di konsol Google Cloud , buka halaman Security profiles.
Pilih tab Profil keamanan. Tab ini menampilkan daftar profil keamanan yang dikonfigurasi.
Klik profil keamanan jenis Pemfilteran URL untuk melihat detail profil.
gcloud
Untuk melihat detail profil keamanan pemfilteran URL, gunakan perintah
gcloud network-security security-profiles url-filtering describe
:
gcloud network-security security-profiles url-filtering describe NAME \ --organization ORGANIZATION_ID \ --location LOCATION \
Ganti kode berikut:
NAME
: nama profil keamanan jenisurl-filtering
yang ingin Anda deskripsikan; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaORGANIZATION_ID
.LOCATION
: lokasi profil keamanan pemfilteran URL. Lokasi selalu ditetapkan keglobal
. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaLOCATION
.
Mencantumkan profil keamanan pemfilteran URL
Anda dapat mencantumkan semua profil keamanan pemfilteran URL dalam organisasi.
Konsol
Di konsol Google Cloud , buka halaman Security profiles.
Pilih tab Profil keamanan. Tab ini menampilkan daftar profil keamanan yang dikonfigurasi.
gcloud
Untuk mencantumkan semua profil keamanan pemfilteran URL, gunakan perintah
gcloud network-security security-profiles url-filtering list
:
gcloud network-security security-profiles url-filtering list \ --organization ORGANIZATION_ID \ --location LOCATION
Ganti kode berikut:
ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat.LOCATION
: lokasi profil keamanan pemfilteran URL. Lokasi selalu ditetapkan keglobal
.
Menghapus profil keamanan pemfilteran URL
Anda dapat menghapus profil keamanan pemfilteran URL dengan menentukan nama, lokasi, dan organisasi. Namun, jika profil keamanan dirujuk oleh grup profil keamanan, profil keamanan tersebut tidak dapat dihapus.
Konsol
Di konsol Google Cloud , buka halaman Security profiles.
Pilih tab Profil keamanan. Tab ini menampilkan daftar profil keamanan yang dikonfigurasi.
Pilih profil keamanan yang ingin Anda hapus, lalu klik Hapus.
Klik Delete lagi untuk mengonfirmasi.
gcloud
Untuk menghapus profil keamanan pemfilteran URL, gunakan perintah
gcloud network-security security-profiles url-filtering delete
:
gcloud network-security security-profiles url-filtering delete NAME \ --organization ORGANIZATION_ID \ --location LOCATION
Ganti kode berikut:
NAME
: nama profil keamanan pemfilteran URL yang ingin Anda hapus; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat. Jika menggunakan ID URL unik untuk flagNAME
, Anda dapat menghapus flagORGANIZATION_ID
.LOCATION
: lokasi profil keamanan pemfilteran URL.Lokasi selalu ditetapkan ke
global
. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaLOCATION
.
Mengimpor profil keamanan pemfilteran URL
Anda dapat mengimpor profil keamanan pemfilteran URL (yang dibuat khusus atau diekspor sebelumnya) dari file YAML. Saat mengimpor profil keamanan pemfilteran URL, jika profil dengan nama yang sama sudah ada, Cloud NGFW akan memperbarui profil yang ada.
gcloud
Untuk mengimpor profil keamanan pemfilteran URL dari file YAML, gunakan perintah
gcloud network-security security-profiles import
:
gcloud network-security security-profiles import NAME \ --organization ORGANIZATION_ID \ --location LOCATION \ --source FILE_NAME
Ganti kode berikut:
NAME
: nama profil keamanan jenisurl-filtering
yang ingin Anda impor; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.Jika Anda menggunakan ID URL unik untuk flag
NAME
, Anda dapat menghilangkan flagORGANIZATION_ID
danLOCATION
.ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaORGANIZATION_ID
.LOCATION
: lokasi profil keamanan pemfilteran URL. Lokasi selalu ditetapkan keglobal
. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaLOCATION
.FILE_NAME
: jalur ke file YAML yang berisi data ekspor konfigurasi untuk profil keamanan pemfilteran URL. Misalnya,url-filtering-sp.yaml
.File YAML tidak boleh berisi kolom hanya output. Atau, Anda dapat menghapus tanda
source
untuk membaca dari input standar.
Mengekspor profil keamanan pemfilteran URL
Anda dapat mengekspor profil keamanan pemfilteran URL ke file YAML. Misalnya, alih-alih menggunakan antarmuka pengguna untuk mengubah profil keamanan yang besar, Anda dapat menggunakan fungsi ini untuk mengekspor profil keamanan, mengubahnya dengan cepat, dan mengimpornya kembali.
gcloud
Untuk mengekspor profil keamanan pemfilteran URL ke file YAML, gunakan perintah
gcloud network-security security-profiles export
:
gcloud network-security security-profiles export NAME \ --organization ORGANIZATION_ID \ --location LOCATION \ --destination FILE_NAME
Ganti kode berikut:
NAME
: nama profil keamanan jenisurl-filtering
yang ingin Anda ekspor; Anda dapat menentukan nama sebagai string atau sebagai ID URL unik.Jika Anda menggunakan ID URL unik untuk flag
NAME
, Anda dapat menghilangkan flagORGANIZATION_ID
danLOCATION
.ORGANIZATION_ID
: organisasi tempat profil keamanan pemfilteran URL dibuat. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaORGANIZATION_ID
.LOCATION
: lokasi profil keamanan pemfilteran URL. Lokasi selalu ditetapkan keglobal
. Jika Anda menggunakan ID URL unik untuk tandaNAME
, Anda dapat menghapus tandaLOCATION
.FILE_NAME
: jalur ke file YAML tempat Cloud NGFW akan mengekspor konfigurasi untuk profil keamanan pemfilteran URL. Contohnya,url-filtering-sp.yaml
Data konfigurasi yang diekspor tidak berisi kolom hanya output. Atau, Anda dapat menghilangkan tanda
destination
untuk menulis ke output standar.