Menghubungkan ke instans DB Anda menggunakan autentikasi IAM dari baris perintah: AWS CLI dan klien psql - Layanan Basis Data Relasional Amazon
Membuat token autentikasi IAMMenghubungkan ke instans Amazon RDS PostgreSQL

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

Menghubungkan ke instans DB Anda menggunakan autentikasi IAM dari baris perintah: AWS CLI dan klien psql

Anda dapat terhubung dari baris perintah ke instans DB Amazon RDS for PostgreSQL dengan AWS CLI dan alat baris perintah psql seperti yang dijelaskan berikut.

Prasyarat

Berikut adalah prasyarat untuk menghubungkan ke instans DB menggunakan autentikasi IAM:

catatan

Untuk informasi tentang menghubungkan ke basis data Anda menggunakan pgAdmin dengan autentikasi IAM, lihat postingan blog Menggunakan autentikasi IAM untuk terhubung dengan pgAdmin Amazon Aurora PostgreSQL atau Amazon RDS for PostgreSQL.

Membuat token autentikasi IAM

Token autentikasi terdiri dari ratusan karakter sehingga kemungkinan menjadi sulit ditangani di baris perintah. Salah satu cara untuk mengatasinya adalah dengan menyimpan token ke variabel lingkungan, lalu menggunakan variabel tersebut saat Anda terhubung. Contoh berikut menunjukkan cara menggunakan AWS CLI untuk mendapatkan token autentikasi yang ditandatangani menggunakan perintah generate-db-auth-token dan menyimpannya di variabel lingkungan PGPASSWORD.

export RDSHOST="rdspostgres.123456789012.us-west-2.rds.amazonaws.com"
export PGPASSWORD="$(aws rds generate-db-auth-token --hostname $RDSHOST --port 5432 --region us-west-2 --username jane_doe )"

Dalam contoh, parameter untuk perintah generate-db-auth-token adalah sebagai berikut:

  • --hostname – Nama host instans DB yang ingin Anda akses

  • --port – Nomor port yang digunakan untuk menghubungkan ke instans DB Anda

  • --region – Wilayah AWS tempat instans DB berjalan

  • --username – Akun basis data yang ingin Anda akses

Beberapa karakter pertama dari token yang dihasilkan terlihat seperti berikut.

rdspostgres.123456789012.us-west-2.rds.amazonaws.com:5432/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900...
catatan

Anda tidak dapat menggunakan catatan DNS Route 53 kustom sebagai pengganti titik akhir instans DB untuk menghasilkan token autentikasi.

Menghubungkan ke instans Amazon RDS PostgreSQL

Format umum untuk menggunakan psql untuk terhubung ditampilkan sebagai berikut.

psql "host=hostName port=portNumber sslmode=verify-full sslrootcert=full_path_to_ssl_certificate dbname=DBName user=userName password=authToken"

Parameternya adalah sebagai berikut:

  • host – Nama host instans DB yang ingin Anda akses

  • port – Nomor port yang digunakan untuk menghubungkan ke instans DB Anda

  • sslmode – Mode SSL yang akan digunakan

    Saat Anda menggunakan sslmode=verify-full, koneksi SSL memverifikasi titik akhir instans DB di sertifikat SSL.

  • sslrootcert – Jalur lengkap ke file sertifikat SSL yang berisi kunci publik

    Untuk informasi selengkapnya, lihat Menggunakan SSL dengan instance Postgre DB SQL.

    Untuk mengunduh sertifikat SSL, lihat .

  • dbname – Basis data yang ingin Anda akses

  • user – Akun basis data yang ingin Anda akses

  • password – Token autentikasi IAM yang ditandatangani

catatan

Anda tidak dapat menggunakan catatan DNS Route 53 kustom sebagai pengganti titik akhir instans DB untuk menghasilkan token autentikasi.

Contoh berikut menunjukkan penggunaan psql untuk terhubung. Dalam contoh, psql menggunakan variabel lingkungan RDSHOST untuk host dan variabel lingkungan PGPASSWORD untuk token yang dihasilkan. Selain itu, /sample_dir/ adalah jalur lengkap ke file sertifikat SSL yang berisi kunci publik.

export RDSHOST="rdspostgres.123456789012.us-west-2.rds.amazonaws.com"
export PGPASSWORD="$(aws rds generate-db-auth-token --hostname $RDSHOST --port 5432 --region us-west-2 --username jane_doe )"
                    
psql "host=$RDSHOST port=5432 sslmode=verify-full sslrootcert=/sample_dir/global-bundle.pem dbname=DBName user=jane_doe password=$PGPASSWORD"

Jika Anda ingin terhubung ke instans DB melalui proksi, lihat Terhubung ke sebuah proksi menggunakan autentikasi IAM.