密碼檢查掛鉤 (passcheck)

passcheck 掛鉤用來針對下列 SQL 命令和 psql 中繼命令自訂密碼檢查過程中的 PostgreSQL 行為。

• CREATE ROLE username ...PASSWORD – 如需詳細資訊，請參閱 PostgreSQL 文件中的 CREATE ROLE。

• ALTER ROLE username...PASSWORD – 如需詳細資訊，請參閱 PostgreSQL 文件中的 ALTER ROLE。

• \password username – 此互動式 psql 中繼命令透過在透明地使用 ALTER ROLE ... PASSWORD 語法之前對密碼進行雜湊處理，來安全地變更所指定使用者的密碼。中繼命令是 ALTER ROLE ... PASSWORD 命令的安全包裝函式，因此掛鉤適用於 psql 中繼命令的行為。

如需範例，請參閱 密碼檢查掛鉤程式碼清單。

函數原型

passcheck_hook(username text, password text, password_type pgtle.password_types, valid_until timestamptz, valid_null boolean)

引數

passcheck 掛鉤函數採用下列引數：

• username – 設定密碼之角色 (使用者名稱) 的名稱 (以文字形式表示)。

• password – 純文字或雜湊密碼。輸入的密碼應符合 password_type 中指定的類型。

• password_type – 指定密碼的 pgtle.password_type 格式。此 格式可以是下列其中一個選項：

  • PASSWORD_TYPE_PLAINTEXT – 純文字密碼。

  • PASSWORD_TYPE_MD5 – 使用 MD5 (訊息摘要 5) 演算法進行雜湊處理的密碼。

  • PASSWORD_TYPE_SCRAM_SHA_256 – 使用 SCRAM-SHA-256 演算法進行雜湊處理的密碼。

• valid_until – 指定密碼變成無效的時間。此為選用引數。如果使用此引數，請將時間指定為 timestamptz 值。

• valid_null – 如果將此布林值設為 true，則 valid_until 選項會設為 NULL。

組態

此函數 pgtle.enable_password_check 可控制 passcheck 掛鉤是否作用中。passcheck 掛鉤有三種可能的設定。

• off – 關閉 passcheck 密碼檢查掛鉤。這是預設值。

• on – 開啟 passcode 密碼檢查掛鉤，以便針對資料表檢查密碼。

• require – 需要定義密碼檢查掛鉤。

使用須知

若要開啟或關閉 passcheck 掛鉤，您需要針對 Aurora PostgreSQL 資料庫叢集的寫入器執行個體修改自訂資料庫參數群組。

對於LinuxmacOS、或Unix：

aws rds modify-db-parameter-group \
    --region aws-region \
    --db-parameter-group-name your-custom-parameter-group \
    --parameters "ParameterName=pgtle.enable_password_check,ParameterValue=on,ApplyMethod=immediate"

在Windows中：

aws rds modify-db-parameter-group ^
    --region aws-region ^
    --db-parameter-group-name your-custom-parameter-group ^
    --parameters "ParameterName=pgtle.enable_password_check,ParameterValue=on,ApplyMethod=immediate"