View a markdown version of this page

Mengkonfigurasi SSL/TLS sertifikat untuk koneksi Aurora DSQL - Amazon Aurora DSQL

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengkonfigurasi SSL/TLS sertifikat untuk koneksi Aurora DSQL

Aurora DSQL memerlukan semua koneksi untuk menggunakan enkripsi Transport Layer Security (TLS). Untuk membuat koneksi aman, sistem klien Anda harus mempercayai Otoritas Sertifikat Akar Amazon (Amazon Root CA 1). Sertifikat ini sudah diinstal sebelumnya pada banyak sistem operasi. Bagian ini memberikan petunjuk untuk memverifikasi sertifikat Amazon Root CA 1 pra-instal pada berbagai sistem operasi, dan memandu Anda melalui proses menginstal sertifikat secara manual jika belum ada.

Sebaiknya gunakan PostgreSQL versi 17.

penting

Untuk lingkungan produksi, sebaiknya gunakan mode verify-full SSL untuk memastikan tingkat keamanan koneksi tertinggi. Mode ini memverifikasi bahwa sertifikat server ditandatangani oleh otoritas sertifikat tepercaya dan bahwa nama host server cocok dengan sertifikat.

Memverifikasi sertifikat pra-instal

Di sebagian besar sistem operasi, Amazon Root CA 1 sudah diinstal sebelumnya. Untuk memvalidasi ini, Anda dapat mengikuti langkah-langkah di bawah ini.

Linux (RedHat/CentOS/Fedora)

Jalankan perintah berikut di terminal Anda:

trust list | grep "Amazon Root CA 1"

Jika sertifikat diinstal, Anda melihat output berikut:

label: Amazon Root CA 1

macOS

  1. Buka Pencarian Spotlight (Com mand+ Space)

  2. Cari Akses Gant ungan Kunci

  3. Pilih A kar Sistem di bawah Gantungan Kunci Sistem

  4. Cari Amazon Root CA 1 di daftar sertifikat

Windows

catatan

Karena masalah yang diketahui dengan klien Windows psql, menggunakan sertifikat root sistem (sslrootcert=system) dapat mengembalikan kesalahan berikut:SSL error: unregistered scheme. Anda dapat mengikuti Menghubungkan dari Windows sebagai cara alternatif untuk terhubung ke cluster Anda menggunakan SSL.

Jika Amazon Root CA 1 tidak diinstal di sistem operasi Anda, ikuti langkah-langkah di bawah ini.

Memasang sertifikat

Jika Amazon Root CA 1 sertifikat tidak diinstal sebelumnya pada sistem operasi Anda, Anda harus menginstalnya secara manual untuk membuat koneksi aman ke cluster Aurora DSQL Anda.

Instalasi sertifikat Linux

Ikuti langkah-langkah berikut untuk menginstal sertifikat Amazon Root CA pada sistem Linux.

  1. Unduh Sertifikat Root:

    wget https://www.amazontrust.com/repository/AmazonRootCA1.pem
  2. Salin sertifikat ke toko kepercayaan:

    sudo cp ./AmazonRootCA1.pem /etc/pki/ca-trust/source/anchors/
  3. Perbarui penyimpanan kepercayaan CA:

    sudo update-ca-trust
  4. Verifikasi instalasi:

    trust list | grep "Amazon Root CA 1"

Instalasi sertifikat macOS

Langkah-langkah instalasi sertifikat ini bersifat opsional. Ini Instalasi sertifikat Linux juga berfungsi untuk macOS.

  1. Unduh Sertifikat Root:

    wget https://www.amazontrust.com/repository/AmazonRootCA1.pem
  2. Tambahkan sertifikat ke gantungan kunci Sistem:

    sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain AmazonRootCA1.pem
  3. Verifikasi instalasi:

    security find-certificate -a -c "Amazon Root CA 1" -p /Library/Keychains/System.keychain

Menghubungkan dengan SSL/TLS verifikasi

Sebelum mengonfigurasi SSL/TLS sertifikat untuk koneksi aman ke cluster Aurora DSQL Anda, pastikan Anda memiliki prasyarat berikut.

  • PostgreSQL versi 17 diinstal

  • AWS CLI dikonfigurasi dengan kredensional yang sesuai

  • Informasi titik akhir cluster Aurora DSQL

Menghubungkan dari Linux

  1. Buat dan atur token otentikasi:

    export PGPASSWORD=$(aws dsql generate-db-connect-admin-auth-token --region=your-cluster-region --hostname your-cluster-endpoint)
  2. Hubungkan menggunakan sertifikat sistem (jika sudah diinstal sebelumnya):

    PGSSLROOTCERT=system \ PGSSLMODE=verify-full \ psql --dbname postgres \ --username admin \ --host your-cluster-endpoint
  3. Atau, sambungkan menggunakan sertifikat yang diunduh:

    PGSSLROOTCERT=/full/path/to/root.pem \ PGSSLMODE=verify-full \ psql --dbname postgres \ --username admin \ --host your-cluster-endpoint
catatan

Untuk selengkapnya tentang pengaturan PGSSLMODE, lihat sslmode dalam dokumentasi PostgreSQL 17 Database Connection Control Functions. https://www.postgresql.org/docs/current/libpq-connect.html

Menghubungkan dari macOS

  1. Buat dan atur token otentikasi:

    export PGPASSWORD=$(aws dsql generate-db-connect-admin-auth-token --region=your-cluster-region --hostname your-cluster-endpoint)
  2. Hubungkan menggunakan sertifikat sistem (jika sudah diinstal sebelumnya):

    PGSSLROOTCERT=system \ PGSSLMODE=verify-full \ psql --dbname postgres \ --username admin \ --host your-cluster-endpoint
  3. Atau, unduh sertifikat root dan simpan sebagai root.pem (jika sertifikat tidak diinstal sebelumnya)

    PGSSLROOTCERT=/full/path/to/root.pem \ PGSSLMODE=verify-full \ psql —dbname postgres \ --username admin \ --host your_cluster_endpoint
  4. Hubungkan menggunakan psql:

    PGSSLROOTCERT=/full/path/to/root.pem \ PGSSLMODE=verify-full \ psql —dbname postgres \ --username admin \ --host your_cluster_endpoint

Menghubungkan dari Windows

Menggunakan Command Prompt

  1. Hasilkan token otentikasi:

    aws dsql generate-db-connect-admin-auth-token ^ --region=your-cluster-region ^ --expires-in=3600 ^ --hostname=your-cluster-endpoint
  2. Tetapkan variabel lingkungan kata sandi:

    set "PGPASSWORD=token-from-above"
  3. Setel konfigurasi SSL:

    set PGSSLROOTCERT=C:\full\path\to\root.pem set PGSSLMODE=verify-full
  4. Hubungkan ke database:

    "C:\Program Files\PostgreSQL\17\bin\psql.exe" --dbname postgres ^ --username admin ^ --host your-cluster-endpoint

Menggunakan PowerShell

  1. Buat dan atur token otentikasi:

    $env:PGPASSWORD = (aws dsql generate-db-connect-admin-auth-token --region=your-cluster-region --expires-in=3600 --hostname=your-cluster-endpoint)
  2. Setel konfigurasi SSL:

    $env:PGSSLROOTCERT='C:\full\path\to\root.pem' $env:PGSSLMODE='verify-full'
  3. Hubungkan ke database:

    "C:\Program Files\PostgreSQL\17\bin\psql.exe" --dbname postgres ` --username admin ` --host your-cluster-endpoint

Sumber daya tambahan