{"kind": "conn", "major": "18", "item": {"slug": "require-auth", "name": "require_auth", "name_zh": "", "category": "\u8eab\u4efd\u8ba4\u8bc1", "summary": "\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002", "aliases": ["PGREQUIREAUTH", "require_auth"], "content_hash": "5c84ef1f7371d7ba70ec0ae1bc55e03b3499ecaa6918b4988c18d79221328818", "versions": {"16": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 16.15"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/16/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/16/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/16/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/16/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "label": "16.15", "major": "16", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/16/postgresql-16-A4.pdf", "bytes": 15282337, "pages": 3055, "sha256": "4bb6c1f63deedac98736d8c4c7bc0fad0ac24e85b07e21ee10411872f06afd06", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/16/postgresql-16-US.pdf", "bytes": 15164148, "pages": 3220, "sha256": "5b6b6166c89991199e144bb0ae34c17a5f29826251dbf19db1abc0df3a3e771b", "built_at": "2026-09-26"}}, "tree": "16", "index": "index.html", "major": "16", "pages": 1169, "release": "16.15", "source_url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "svg_assets": 3, "source_mode": "en HTML verified against the pinned official archive", "source_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, "revision": "3c21e58b35318021716440e67bb8bafd392b6a2b965a244d90e9e33c99e0bdef", "evidence_kind": "English manual and source declarations", "source_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, "sources": [{"url": "https://pg.center/docs/16/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "16.15 English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "a88a6c8f0e2229b1e469ca3fcf95d6cba163af369f2c232c04c07ba0a5b64242", "language": "en", "original_url": "/docs/16/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "16.15 libpq connection option declarations", "sha256": "ccc43473f7a01820f1ef625a8704548db03499bdee02ef943adbd1329f17f9e7", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, {"url": "https://pg.center/docs/16/libpq-envars.html", "file": "libpq-envars.html", "label": "16.15 English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "2dd3190c2f6b9e0d3051b7cc325bb30dad84b29e53035680aa622409ad00fe28", "language": "en", "original_url": "/docs/16/libpq-envars.html"}, {"url": "https://pg.center/docs/16/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "16.15 English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "d636639599c1db7c0eb9da6c188abfbf7c590bb2ae9367e7fff05863bb9bd0db", "language": "en", "original_url": "/docs/16/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/16/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/16/libpq-connect.html", "method": "same-major semantic node", "sha256": "056cef980842e121e2f0cbba07595647bf705e362148232859ecd453cb7446b5", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/16/libpq-envars.html", "method": "same-major semantic node", "sha256": "841a7b2a5d33a812cca40c163dcc0a97350d036c7a31d73230803a40d5c8e917", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[7]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/16/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "6facaad2a42331e2d577d3abc10e1cd4a7af12acb08715071c1996e2caa39239", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/versions/16/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/16/facts/0/label": "Client library", "/versions/16/facts/1/label": "Manual definition", "/versions/16/facts/1/value": "Documented", "/versions/16/facts/2/label": "Source environment fallback", "/versions/16/facts/3/label": "Compiled fallback expression", "/versions/16/tables/0/title": "Environment fallback", "/versions/16/related/0/label": "Connection service file", "/versions/16/related/1/label": "Password file", "/versions/16/related/2/label": "All libpq environment variables", "/versions/16/sections/0/title": "Default resolution and service-file precedence", "/versions/16/sections/1/title": "Environment variable evidence", "/versions/16/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/16/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/16/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/16/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/16/tables/0/columns/0/label": "Variable", "/versions/16/tables/0/columns/1/label": "Documented behavior", "/versions/16/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "d36cf0262a97fa6f44e32591d4e1ded7edebfb4d29f467c9312013008e0410bb"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "2ec2ff10416c65dc62d953dddc49c8c459a8e768d574784d006210ea80b59c65", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}, "17": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 17.11"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/17/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/17/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/17/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/17/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "label": "17.11", "major": "17", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/17/postgresql-17-A4.pdf", "bytes": 15521293, "pages": 3099, "sha256": "1991354df0dc89e70ec39328c28988ef8b19c6a93671dab3893650b63e9f4e36", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/17/postgresql-17-US.pdf", "bytes": 15398150, "pages": 3270, "sha256": "07696c8f38abf31babf22d2db337093936e7c472d2af36d050b000c49bbcf52c", "built_at": "2026-09-26"}}, "tree": "17", "index": "index.html", "major": "17", "pages": 1143, "release": "17.11", "source_url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, "revision": "58419c9b0dd42cb34c8d53695bb025a7e582edf55ccd4c5bcb1c2c7c71a37487", "evidence_kind": "English manual and source declarations", "source_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, "sources": [{"url": "https://pg.center/docs/17/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "17.11 English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "7f15cf88e7854d7e92b57bdcb85ce566543eee5783ebc8eb2972cd6aaca8e7a1", "language": "en", "original_url": "/docs/17/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "17.11 libpq connection option declarations", "sha256": "9c189446b1b18faf81823636067c9cf9fb01215bdae5b036cc3bb0ebc84971a2", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, {"url": "https://pg.center/docs/17/libpq-envars.html", "file": "libpq-envars.html", "label": "17.11 English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "48fb76414267a67473ccb901e64320de2e73fb0dc8ade8fcea38edf3628d2c21", "language": "en", "original_url": "/docs/17/libpq-envars.html"}, {"url": "https://pg.center/docs/17/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "17.11 English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "1447c3836f348d6d0ea59ab68fe17ef604eb913938eed81c1e2cb081a36e2d8d", "language": "en", "original_url": "/docs/17/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/17/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/17/libpq-connect.html", "method": "same-major semantic node", "sha256": "41bb236b80f7c23464be2555c7d20d19551e13f7107cb1d36d58821cbb2f41f1", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/17/libpq-envars.html", "method": "same-major semantic node", "sha256": "5f1014f4afd40210bc05e52c10a62fe34fcaf5cc4445cb809ec8cdacb003cf1c", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[8]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/17/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "0544512734d86673b69ac05be91d417df85476fe6048c6d4b197c65a7d566bbe", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/versions/17/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/17/facts/0/label": "Client library", "/versions/17/facts/1/label": "Manual definition", "/versions/17/facts/1/value": "Documented", "/versions/17/facts/2/label": "Source environment fallback", "/versions/17/facts/3/label": "Compiled fallback expression", "/versions/17/tables/0/title": "Environment fallback", "/versions/17/related/0/label": "Connection service file", "/versions/17/related/1/label": "Password file", "/versions/17/related/2/label": "All libpq environment variables", "/versions/17/sections/0/title": "Default resolution and service-file precedence", "/versions/17/sections/1/title": "Environment variable evidence", "/versions/17/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/17/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/17/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/17/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/17/tables/0/columns/0/label": "Variable", "/versions/17/tables/0/columns/1/label": "Documented behavior", "/versions/17/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "1ce4aaff5173b188974058de7888aecb1e25a0e1c2bc17d0bb4baff87e1035ba"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "2ec2ff10416c65dc62d953dddc49c8c459a8e768d574784d006210ea80b59c65", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}, "18": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 18.6"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/18/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/18/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/18/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/18/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/18/postgresql-18-A4.pdf", "bytes": 15865106, "pages": 3154, "sha256": "19512c405da53f9f7fcf0abba359223aa65f021be025bf3411381918f92e3190", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/18/postgresql-18-US.pdf", "bytes": 15748059, "pages": 3328, "sha256": "facbe6c229e598b872d3d98bef53308f46e06746006fa4590de9a7de9dd46319", "built_at": "2026-09-26"}}, "tree": "18", "index": "index.html", "major": "18", "pages": 1148, "release": "18.6", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "revision": "ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8", "evidence_kind": "English manual and source declarations", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "https://pg.center/docs/18/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "18.6 English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "c26a7fc3dcda6066cfe540641ae2690faf3d3c03277f30b4dfc2328ab45c212f", "language": "en", "original_url": "/docs/18/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "18.6 libpq connection option declarations", "sha256": "44a6e386cbfd67ebe768d6ef5493098119c2e6b4796239d53e5ed7b122b206a5", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://pg.center/docs/18/libpq-envars.html", "file": "libpq-envars.html", "label": "18.6 English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "d64db73f3d48127bb984a5f775e77b7bcca2ba4bd218333cf24a45fcdd7c4363", "language": "en", "original_url": "/docs/18/libpq-envars.html"}, {"url": "https://pg.center/docs/18/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "18.6 English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "6035a3f0ee1d0fd80db5bf58834390b884eecd23206659bdf6f07560deea5aa7", "language": "en", "original_url": "/docs/18/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/18/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n<div class=\"warning\">\n<h3 class=\"title\" lang=\"zh\">\u8b66\u544a</h3>\n<p lang=\"zh\">\u5bf9 MD5 \u52a0\u5bc6\u5bc6\u7801\u7684\u652f\u6301\u5df2\u5f03\u7528\uff0c\u5e76\u5c06\u5728<span class=\"productname\">PostgreSQL</span>\u7684\u672a\u6765\u7248\u672c\u4e2d\u79fb\u9664\u3002\u8fc1\u79fb\u5230\u5176\u4ed6\u5bc6\u7801\u7c7b\u578b\u7684\u8be6\u7ec6\u4fe1\u606f\u89c1<a class=\"xref\" href=\"/docs/18/auth-password.html\" title=\"20.5.\u00a0\u5bc6\u7801\u8ba4\u8bc1\">\u7b2c\u00a020.5\u00a0\u8282</a>\u3002</p>\n</div>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">oauth</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u5411\u5ba2\u6237\u7aef\u8bf7\u6c42 OAuth Bearer \u4ee4\u724c\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/18/libpq-connect.html", "method": "same-major semantic node", "sha256": "bae58c13a65be235aa0408ef12f8bcc7e48f2908cd71080a7dedec225a74c083", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[3]/h3[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[13]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/div[1]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/18/libpq-envars.html", "method": "same-major semantic node", "sha256": "8423affb67ef7d4f700d7ccc8c0ef66629341568c8d72530a0c765f3d155da2f", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[8]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/18/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "a06dfcdffbbdf6bd55987cade2d9ff1db6cbfd9f75eb80c7866e8792cd70463e", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/versions/18/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/18/facts/0/label": "Client library", "/versions/18/facts/1/label": "Manual definition", "/versions/18/facts/1/value": "Documented", "/versions/18/facts/2/label": "Source environment fallback", "/versions/18/facts/3/label": "Compiled fallback expression", "/versions/18/tables/0/title": "Environment fallback", "/versions/18/related/0/label": "Connection service file", "/versions/18/related/1/label": "Password file", "/versions/18/related/2/label": "All libpq environment variables", "/versions/18/sections/0/title": "Default resolution and service-file precedence", "/versions/18/sections/1/title": "Environment variable evidence", "/versions/18/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/18/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/18/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/18/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/18/tables/0/columns/0/label": "Variable", "/versions/18/tables/0/columns/1/label": "Documented behavior", "/versions/18/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "ad3e32b700eb69bf6a2e25d1eab9739ab314c26c2a6f7116ca19f85b7a0ef73c"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. Warning Support for MD5-encrypted passwords is deprecated and will be removed in a future release of PostgreSQL . Refer to Section 20.5 for details about migrating to another password type. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. oauth The server must request an OAuth bearer token from the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "b90f10c3c2ccff2990774577cab21e0392f308768058f40109dd55f7e52ca3c5", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}, "19": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 19beta4"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/19/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/19/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/19/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/19/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "label": "19beta4", "major": "19", "channel": "preview", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/19/postgresql-19-A4.pdf", "bytes": 16064841, "pages": 3052, "sha256": "4dd099e4125c591128fc5f3ebd02178dc24781f9e5ae629f96d67c4c8547427b", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/19/postgresql-19-US.pdf", "bytes": 15974616, "pages": 3225, "sha256": "61971fa857f0956d47341a0388fa6af9ae10acf691d4b2fc009007d384b0342b", "built_at": "2026-09-26"}}, "tree": "19", "index": "index.html", "major": "19", "pages": 1155, "release": "19beta4", "source_url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "svg_assets": 5, "source_mode": "en SGML built with pinned official archive", "source_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, "revision": "1bbbbf4133d426f0e4304010688d2984c30fb67df0cc3a61b3e37eb3f6f37833", "evidence_kind": "English manual and source declarations", "source_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, "sources": [{"url": "https://pg.center/docs/19/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "19beta4 English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "14917417235a95d969bf3642c347dea7ae548c5f73b0dd00991a580ebcfbb47e", "language": "en", "original_url": "/docs/19/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "19beta4 libpq connection option declarations", "sha256": "ae8005372c570ff47a4922c942238653a034f01f9db40c9e0f57cb48915ffd98", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, {"url": "https://pg.center/docs/19/libpq-envars.html", "file": "libpq-envars.html", "label": "19beta4 English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "d8f0afee19bae6323942ea5415649fbd66e3880fe8c8415350fcf3915f7c7047", "language": "en", "original_url": "/docs/19/libpq-envars.html"}, {"url": "https://pg.center/docs/19/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "19beta4 English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "4c858fe55701d703cc00e7adf55eeac09cafcfdc37929b8e23ccf8ba42af9f98", "language": "en", "original_url": "/docs/19/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u5728 libpq \u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u4f7f\u7528 servicefile \u5173\u952e\u5b57\uff0c\u6216\u8005\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/19/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n<div class=\"warning\">\n<h3 class=\"title\" lang=\"zh\">\u8b66\u544a</h3>\n<p lang=\"zh\">\u5bf9 MD5 \u52a0\u5bc6\u5bc6\u7801\u7684\u652f\u6301\u5df2\u5f03\u7528\uff0c\u5e76\u5c06\u5728<span class=\"productname\">PostgreSQL</span>\u7684\u672a\u6765\u7248\u672c\u4e2d\u79fb\u9664\u3002\u8fc1\u79fb\u5230\u5176\u4ed6\u5bc6\u7801\u7c7b\u578b\u7684\u8be6\u7ec6\u4fe1\u606f\u89c1<a class=\"xref\" href=\"/docs/19/auth-password.html\" title=\"20.5.\u00a0\u5bc6\u7801\u8ba4\u8bc1\">\u7b2c\u00a020.5\u00a0\u8282</a>\u3002</p>\n</div>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">oauth</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u5411\u5ba2\u6237\u7aef\u8bf7\u6c42 OAuth Bearer \u4ee4\u724c\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/19/libpq-connect.html", "method": "same-major semantic node", "sha256": "8a146554e35097ee5bd56228b90d2a83442c7bd6ca303bdd01de148d06928cd3", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[3]/h3[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[13]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/div[1]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/19/libpq-envars.html", "method": "same-major semantic node", "sha256": "1c8f71428ae8cd8acf564cb581b51a0bce2bf0102680e44c1ced261aa3ec55f7", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[8]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/19/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "ed80600a221e79a10c683341a2d8b9fa12c84e00c638b7969a72feb8b3c467d3", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/versions/19/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/19/facts/0/label": "Client library", "/versions/19/facts/1/label": "Manual definition", "/versions/19/facts/1/value": "Documented", "/versions/19/facts/2/label": "Source environment fallback", "/versions/19/facts/3/label": "Compiled fallback expression", "/versions/19/tables/0/title": "Environment fallback", "/versions/19/related/0/label": "Connection service file", "/versions/19/related/1/label": "Password file", "/versions/19/related/2/label": "All libpq environment variables", "/versions/19/sections/0/title": "Default resolution and service-file precedence", "/versions/19/sections/1/title": "Environment variable evidence", "/versions/19/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/19/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified using the servicefile key word in a libpq connection string or by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/19/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/19/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/19/tables/0/columns/0/label": "Variable", "/versions/19/tables/0/columns/1/label": "Documented behavior", "/versions/19/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "03c41ef6f66954ee5ed8eb12541d2040a2e9ad4a8cbb35e6a10f70d099cba58f"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. Warning Support for MD5-encrypted passwords is deprecated and will be removed in a future release of PostgreSQL . Refer to Section 20.5 for details about migrating to another password type. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. oauth The server must request an OAuth bearer token from the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "b90f10c3c2ccff2990774577cab21e0392f308768058f40109dd55f7e52ca3c5", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified using the servicefile key word in a libpq connection string or by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}, "20": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 20devel"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/devel/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/devel/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/devel/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/devel/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "label": "20devel", "major": "20", "channel": "devel", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/20/postgresql-20-A4.pdf", "bytes": 16030631, "pages": 3052, "sha256": "bd5d82c0ce38fc18f92a0447818a91a193a261776bca1c37564bf9a683e177d0", "built_at": "2026-09-28"}, "US": {"url": "/files/documentation/pdf/20/postgresql-20-US.pdf", "bytes": 15936613, "pages": 3223, "sha256": "d97d9e0db479a02f4234b175f50fcad70c3661619afc8d6df9b9437882e3c299", "built_at": "2026-09-28"}}, "tree": "0", "index": "index.html", "major": "20", "pages": 1156, "release": "20devel", "source_url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "svg_assets": 6, "source_mode": "en SGML built with pinned official archive", "source_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41", "source_snapshot_utc": "26-Sep-2026 20:22"}, "revision": "2eba5e0fd4c3bffb2803247b6cd537878e9d6ee5a6dfbe3c50ece8b421b80918", "evidence_kind": "English manual and source declarations", "source_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, "sources": [{"url": "https://pg.center/docs/devel/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "20devel English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "eeb28ce798c0f99c3581400b4baaae7687ee5d4176fcb9f5d2fd28809282d48f", "language": "en", "original_url": "/docs/devel/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "20devel libpq connection option declarations", "sha256": "d6eab6e2f37054b32a7ee7039b53beae603316f8ec3f0a14716061e042fc4aa1", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, {"url": "https://pg.center/docs/devel/libpq-envars.html", "file": "libpq-envars.html", "label": "20devel English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "7c49cf204e26ea86654491db5ea06c4f558c670e2e60a60b1dbf708ce682accc", "language": "en", "original_url": "/docs/devel/libpq-envars.html"}, {"url": "https://pg.center/docs/devel/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "20devel English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "a1ccd63a6e307a5541d58eabd57be5b467dff2480770838ec9b6a59a3ef110dc", "language": "en", "original_url": "/docs/devel/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u5728 libpq \u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u4f7f\u7528 servicefile \u5173\u952e\u5b57\uff0c\u6216\u8005\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/devel/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n<div class=\"warning\">\n<h3 class=\"title\" lang=\"zh\">\u8b66\u544a</h3>\n<p lang=\"zh\">\u5bf9 MD5 \u52a0\u5bc6\u5bc6\u7801\u7684\u652f\u6301\u5df2\u5f03\u7528\uff0c\u5e76\u5c06\u5728<span class=\"productname\">PostgreSQL</span>\u7684\u672a\u6765\u7248\u672c\u4e2d\u79fb\u9664\u3002\u8fc1\u79fb\u5230\u5176\u4ed6\u5bc6\u7801\u7c7b\u578b\u7684\u8be6\u7ec6\u4fe1\u606f\u89c1<a class=\"xref\" href=\"/docs/devel/auth-password.html\" title=\"20.5.\u00a0\u5bc6\u7801\u8ba4\u8bc1\">\u7b2c\u00a020.5\u00a0\u8282</a>\u3002</p>\n</div>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">oauth</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u5411\u5ba2\u6237\u7aef\u8bf7\u6c42 OAuth Bearer \u4ee4\u724c\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/devel/libpq-connect.html", "method": "same-major semantic node", "sha256": "80a1ddba976c7228bb9d179e08545f0a6328ffc9b880481df17a53fdebf42bb5", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[3]/h3[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[13]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/div[1]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/devel/libpq-envars.html", "method": "same-major semantic node", "sha256": "b4afd6d100d2be289d48e1a6f6fb9804dd0b684798b7dabf8bae7d3db074117f", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[8]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/devel/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "acea589bbba517979fe815bd3bff32cd6d5e6323e1d5b4f395d7864338868b26", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/summary": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/category": "Authentication", "/versions/20/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/20/facts/0/label": "Client library", "/versions/20/facts/1/label": "Manual definition", "/versions/20/facts/1/value": "Documented", "/versions/20/facts/2/label": "Source environment fallback", "/versions/20/facts/3/label": "Compiled fallback expression", "/versions/20/tables/0/title": "Environment fallback", "/versions/20/related/0/label": "Connection service file", "/versions/20/related/1/label": "Password file", "/versions/20/related/2/label": "All libpq environment variables", "/versions/20/sections/0/title": "Default resolution and service-file precedence", "/versions/20/sections/1/title": "Environment variable evidence", "/versions/20/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/20/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified using the servicefile key word in a libpq connection string or by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/20/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/20/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/20/tables/0/columns/0/label": "Variable", "/versions/20/tables/0/columns/1/label": "Documented behavior", "/versions/20/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "e2528ed89401fad0071cef23f2ddef8c24e91ec478df62aa68d23b64c622865c"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. Warning Support for MD5-encrypted passwords is deprecated and will be removed in a future release of PostgreSQL . Refer to Section 20.5 for details about migrating to another password type. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. oauth The server must request an OAuth bearer token from the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "b90f10c3c2ccff2990774577cab21e0392f308768058f40109dd55f7e52ca3c5", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified using the servicefile key word in a libpq connection string or by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}}}, "snapshot": {"facts": [{"label": "\u5ba2\u6237\u7aef\u5e93", "value": "libpq 18.6"}, {"label": "\u624b\u518c\u5b9a\u4e49", "value": "\u624b\u518c\u5df2\u8bb0\u8f7d"}, {"label": "\u6e90\u7801\u4e2d\u7684\u73af\u5883\u53d8\u91cf\u56de\u9000", "value": "PGREQUIREAUTH"}, {"label": "\u7f16\u8bd1\u65f6\u56de\u9000\u8868\u8fbe\u5f0f", "value": "NULL"}], "tables": [{"key": "environment", "rows": [{"name": {"url": "/docs/18/libpq-envars.html", "text": "PGREQUIREAUTH"}, "description": "PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"}], "title": "\u73af\u5883\u53d8\u91cf\u56de\u9000", "columns": [{"key": "name", "label": "\u53d8\u91cf"}, {"key": "description", "label": "\u624b\u518c\u8bb0\u8f7d\u7684\u884c\u4e3a"}]}], "keyword": "require_auth", "related": [{"url": "/docs/18/libpq-pgservice.html", "label": "\u8fde\u63a5\u670d\u52a1\u6587\u4ef6"}, {"url": "/docs/18/libpq-pgpass.html", "label": "\u53e3\u4ee4\u6587\u4ef6"}, {"url": "/docs/18/libpq-envars.html", "label": "\u6240\u6709 libpq \u73af\u5883\u53d8\u91cf"}], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/18/postgresql-18-A4.pdf", "bytes": 15865106, "pages": 3154, "sha256": "19512c405da53f9f7fcf0abba359223aa65f021be025bf3411381918f92e3190", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/18/postgresql-18-US.pdf", "bytes": 15748059, "pages": 3328, "sha256": "facbe6c229e598b872d3d98bef53308f46e06746006fa4590de9a7de9dd46319", "built_at": "2026-09-26"}}, "tree": "18", "index": "index.html", "major": "18", "pages": 1148, "release": "18.6", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "revision": "ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8", "evidence_kind": "English manual and source declarations", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "https://pg.center/docs/18/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "file": "libpq-connect.html", "label": "18.6 English manual \u00b7 libpq-connect.html", "anchor": "LIBPQ-CONNECT-REQUIRE-AUTH", "sha256": "c26a7fc3dcda6066cfe540641ae2690faf3d3c03277f30b4dfc2328ab45c212f", "language": "en", "original_url": "/docs/18/libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "file": "src/interfaces/libpq/fe-connect.c", "label": "18.6 libpq connection option declarations", "sha256": "44a6e386cbfd67ebe768d6ef5493098119c2e6b4796239d53e5ed7b122b206a5", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://pg.center/docs/18/libpq-envars.html", "file": "libpq-envars.html", "label": "18.6 English manual \u00b7 libpq-envars.html", "anchor": "", "sha256": "d64db73f3d48127bb984a5f775e77b7bcca2ba4bd218333cf24a45fcdd7c4363", "language": "en", "original_url": "/docs/18/libpq-envars.html"}, {"url": "https://pg.center/docs/18/libpq-pgservice.html", "file": "libpq-pgservice.html", "label": "18.6 English manual \u00b7 libpq-pgservice.html", "anchor": "", "sha256": "6035a3f0ee1d0fd80db5bf58834390b884eecd23206659bdf6f07560deea5aa7", "language": "en", "original_url": "/docs/18/libpq-pgservice.html"}], "sections": [{"title": "\u9ed8\u8ba4\u503c\u89e3\u6790\u4e0e\u670d\u52a1\u6587\u4ef6\u4f18\u5148\u7ea7", "paragraphs": ["\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\u53ef\u7528\u4e8e\u9009\u62e9\u8fde\u63a5\u53c2\u6570\u7684\u9ed8\u8ba4\u503c\uff0c\u4f9b PQconnectdb \u3001 PQsetdbLogin \u548c PQsetdb \u5728\u8c03\u7528\u4ee3\u7801\u672a\u76f4\u63a5\u6307\u5b9a\u53c2\u6570\u503c\u65f6\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u5728\u7b80\u5355\u7684\u5ba2\u6237\u7aef\u5e94\u7528\u7a0b\u5e8f\u4e2d\u786c\u7f16\u7801\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\u3002", "\u670d\u52a1\u540d\u79f0\u53ef\u4ee5\u5728\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u6216\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u4e2d\u5b9a\u4e49\u3002\u5982\u679c\u540c\u4e00\u4e2a\u670d\u52a1\u540d\u79f0\u5b58\u5728\u4e8e\u7528\u6237\u6587\u4ef6\u548c\u7cfb\u7edf\u6587\u4ef6\u4e2d\uff0c\u5219\u7528\u6237\u6587\u4ef6\u4f18\u5148\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a\u7528\u6237\u7684\u670d\u52a1\u6587\u4ef6\u540d\u4e3a ~/.pg_service.conf \u3002\u5728Microsoft Windows\u4e0a\uff0c\u5b83\u7684\u540d\u79f0\u4e3a %APPDATA%\\postgresql\\.pg_service.conf \uff08\u5176\u4e2d %APPDATA% \u6307\u7528\u6237\u914d\u7f6e\u6587\u4ef6\u5939\u4e2d\u7684\u5e94\u7528\u6570\u636e\u5b50\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSERVICEFILE \u6765\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002\u7cfb\u7edf\u8303\u56f4\u7684\u6587\u4ef6\u540d\u4e3a pg_service.conf \u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728 PostgreSQL \u5b89\u88c5\u7684 etc \u76ee\u5f55\u4e2d\u5bfb\u627e\uff08\u4f7f\u7528 pg_config --sysconfdir \u6765\u51c6\u786e\u8bc6\u522b\u6b64\u76ee\u5f55\uff09\u3002\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf PGSYSCONFDIR \u6765\u6307\u5b9a\u53e6\u4e00\u4e2a\u76ee\u5f55\uff0c\u4f46\u4e0d\u80fd\u6307\u5b9a\u4e0d\u540c\u7684\u6587\u4ef6\u540d\u3002", "\u4ece\u670d\u52a1\u6587\u4ef6\u4e2d\u83b7\u53d6\u7684\u8fde\u63a5\u53c2\u6570\u4f1a\u4e0e\u5176\u4ed6\u6765\u6e90\u7684\u53c2\u6570\u5408\u5e76\u3002\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u4f1a\u8986\u76d6\u76f8\u5e94\u7684\u73af\u5883\u53d8\u91cf\uff0c\u800c\u8fde\u63a5\u5b57\u7b26\u4e32\u4e2d\u76f4\u63a5\u7ed9\u51fa\u7684\u503c\u53c8\u4f1a\u8986\u76d6\u670d\u52a1\u6587\u4ef6\u4e2d\u7684\u8bbe\u7f6e\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u4e0a\u8ff0\u670d\u52a1\u6587\u4ef6\u65f6\uff0c\u8fde\u63a5\u5b57\u7b26\u4e32 service=mydb port=5434 \u5c06\u4f7f\u7528\u4e3b\u673a somehost \u3001\u7aef\u53e3 5434 \u3001\u7528\u6237 admin \uff0c\u4ee5\u53ca\u7531\u73af\u5883\u53d8\u91cf\u6216\u5185\u7f6e\u9ed8\u8ba4\u503c\u8bbe\u7f6e\u7684\u5176\u4ed6\u53c2\u6570\u3002"]}, {"title": "\u73af\u5883\u53d8\u91cf\u8bc1\u636e", "paragraphs": ["PGREQUIREAUTH \u7684\u884c\u4e3a\u4e0e require_auth \u8fde\u63a5\u53c2\u6570\u76f8\u540c\u3002"]}], "signature": "require_auth", "documented": true, "description": ["\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002"], "environment": [{"name": "PGREQUIREAUTH", "source_url": "/docs/18/libpq-envars.html", "description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}], "manual_html": "<div><dl class=\"variablelist\"><dt id=\"LIBPQ-CONNECT-REQUIRE-AUTH\"><span class=\"term\"><code class=\"literal\">require_auth</code></span> </dt><dd>\n<p lang=\"zh\">\u6307\u5b9a\u5ba2\u6237\u7aef\u8981\u6c42\u670d\u52a1\u5668\u91c7\u7528\u7684\u8ba4\u8bc1\u65b9\u6cd5\u3002\u5982\u679c\u670d\u52a1\u5668\u6ca1\u6709\u4f7f\u7528\u6240\u8981\u6c42\u7684\u65b9\u6cd5\u6765\u8ba4\u8bc1\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u670d\u52a1\u5668\u6ca1\u6709\u5b8c\u6574\u5b8c\u6210\u8ba4\u8bc1\u63e1\u624b\uff0c\u5219\u8fde\u63a5\u5c06\u5931\u8d25\u3002\u4e5f\u53ef\u4ee5\u63d0\u4f9b\u4e00\u4e2a\u4ee5\u9017\u53f7\u5206\u9694\u7684\u65b9\u6cd5\u5217\u8868\uff0c\u6b64\u65f6\u670d\u52a1\u5668\u5fc5\u987b\u6070\u597d\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd\u65b9\u6cd5\uff0c\u8fde\u63a5\u624d\u4f1a\u6210\u529f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u63a5\u53d7\u4efb\u610f\u8ba4\u8bc1\u65b9\u6cd5\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u8df3\u8fc7\u8ba4\u8bc1\u3002</p>\n<p lang=\"zh\">\u53ef\u4ee5\u5728\u65b9\u6cd5\u540d\u524d\u52a0\u4e0a<code class=\"literal\">!</code>\u524d\u7f00\u4ee5\u8868\u793a\u5426\u5b9a\uff0c\u6b64\u65f6\u670d\u52a1\u5668<span class=\"emphasis\"><em>\u4e0d\u5f97</em></span>\u5c1d\u8bd5\u6240\u5217\u65b9\u6cd5\uff1b\u9664\u6b64\u4e4b\u5916\uff0c\u4efb\u4f55\u5176\u4ed6\u65b9\u6cd5\u90fd\u53ef\u63a5\u53d7\uff0c\u5e76\u4e14\u670d\u52a1\u5668\u4e5f\u53ef\u4ee5\u5b8c\u5168\u4e0d\u8ba4\u8bc1\u5ba2\u6237\u7aef\u3002\u5982\u679c\u63d0\u4f9b\u7684\u662f\u9017\u53f7\u5206\u9694\u5217\u8868\uff0c\u670d\u52a1\u5668\u4e0d\u5f97\u5c1d\u8bd5\u5176\u4e2d<span class=\"emphasis\"><em>\u4efb\u4f55\u4e00\u4e2a</em></span>\u88ab\u5426\u5b9a\u7684\u65b9\u6cd5\u3002\u5426\u5b9a\u5f62\u5f0f\u548c\u975e\u5426\u5b9a\u5f62\u5f0f\u4e0d\u80fd\u5728\u540c\u4e00\u8bbe\u7f6e\u4e2d\u6df7\u7528\u3002</p>\n<p lang=\"zh\">\u6700\u540e\u8fd8\u6709\u4e00\u79cd\u7279\u6b8a\u60c5\u51b5\uff1a<code class=\"literal\">none</code>\u65b9\u6cd5\u8981\u6c42\u670d\u52a1\u5668\u4e0d\u4f7f\u7528\u8ba4\u8bc1\u8d28\u8be2\u3002\uff08\u5b83\u4e5f\u53ef\u4ee5\u88ab\u5426\u5b9a\uff0c\u7528\u6765\u8981\u6c42\u5fc5\u987b\u8fdb\u884c\u67d0\u79cd\u8ba4\u8bc1\u3002\uff09</p>\n<p lang=\"zh\">\u53ef\u6307\u5b9a\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a</p>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"literal\">password</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42\u660e\u6587\u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">md5</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 MD5 hash \u5bc6\u7801\u8ba4\u8bc1\u3002</p>\n<div class=\"warning\">\n<h3 class=\"title\" lang=\"zh\">\u8b66\u544a</h3>\n<p lang=\"zh\">\u5bf9 MD5 \u52a0\u5bc6\u5bc6\u7801\u7684\u652f\u6301\u5df2\u5f03\u7528\uff0c\u5e76\u5c06\u5728<span class=\"productname\">PostgreSQL</span>\u7684\u672a\u6765\u7248\u672c\u4e2d\u79fb\u9664\u3002\u8fc1\u79fb\u5230\u5176\u4ed6\u5bc6\u7801\u7c7b\u578b\u7684\u8be6\u7ec6\u4fe1\u606f\u89c1<a class=\"xref\" href=\"/docs/18/auth-password.html\" title=\"20.5.\u00a0\u5bc6\u7801\u8ba4\u8bc1\">\u7b2c\u00a020.5\u00a0\u8282</a>\u3002</p>\n</div>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">gss</code></span></dt>\n<dd>\n<p lang=\"zh\">\u670d\u52a1\u5668\u5fc5\u987b\u901a\u8fc7 GSSAPI \u8bf7\u6c42 Kerberos \u63e1\u624b\uff0c\u6216\u5efa\u7acb GSS \u52a0\u5bc6\u901a\u9053\uff0c\u53e6\u89c1 gssencmode\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">sspi</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u8bf7\u6c42 Windows <acronym class=\"acronym\">SSPI</acronym> \u8ba4\u8bc1\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">scram-sha-256</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u4e0e\u5ba2\u6237\u7aef\u6210\u529f\u5b8c\u6210\u4e00\u6b21 SCRAM-SHA-256 \u8ba4\u8bc1\u4ea4\u6362\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">oauth</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u5fc5\u987b\u5411\u5ba2\u6237\u7aef\u8bf7\u6c42 OAuth Bearer \u4ee4\u724c\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"literal\">none</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u670d\u52a1\u5668\u4e0d\u5f97\u63d0\u793a\u5ba2\u6237\u7aef\u6267\u884c\u8ba4\u8bc1\u4ea4\u6362\u3002\uff08\u8fd9\u5e76\u4e0d\u7981\u6b62\u901a\u8fc7 TLS \u8fdb\u884c\u5ba2\u6237\u7aef\u8bc1\u4e66\u8ba4\u8bc1\uff0c\u4e5f\u4e0d\u7981\u6b62\u901a\u8fc7 GSS \u81ea\u8eab\u7684\u52a0\u5bc6\u4f20\u8f93\u8fdb\u884c GSS \u8ba4\u8bc1\u3002\uff09</p>\n</p>\n</dd>\n</dl>\n</div>\n</dd></dl></div>", "manual_path": "libpq-connect.html#LIBPQ-CONNECT-REQUIRE-AUTH", "localization": {"status": "complete", "sources": [{"url": "/docs/18/libpq-connect.html", "method": "same-major semantic node", "sha256": "bae58c13a65be235aa0408ef12f8bcc7e48f2908cd71080a7dedec225a74c083", "language": "zh", "matched_nodes": ["#LIBPQ-CONNECT/div[3]/h3[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[11]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[13]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/div[1]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[3]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[7]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/div[4]/dl[0]/dd[9]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[0]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[1]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[2]", "#LIBPQ-CONNECT/div[7]/div[2]/dl[0]/dd[15]/p[3]"]}, {"url": "/docs/18/libpq-envars.html", "method": "same-major semantic node", "sha256": "8423affb67ef7d4f700d7ccc8c0ef66629341568c8d72530a0c765f3d155da2f", "language": "zh", "matched_nodes": ["#LIBPQ-ENVARS/div[3]/ul[0]/li[8]", "#LIBPQ-ENVARS/p[2]"]}, {"url": "/docs/18/libpq-pgservice.html", "method": "same-major semantic node", "sha256": "a06dfcdffbbdf6bd55987cade2d9ff1db6cbfd9f75eb80c7866e8792cd70463e", "language": "zh", "matched_nodes": ["#LIBPQ-PGSERVICE/p[5]", "#LIBPQ-PGSERVICE/p[9]"]}], "language": "zh", "original_text": {"/versions/18/description/0": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.", "/versions/18/facts/0/label": "Client library", "/versions/18/facts/1/label": "Manual definition", "/versions/18/facts/1/value": "Documented", "/versions/18/facts/2/label": "Source environment fallback", "/versions/18/facts/3/label": "Compiled fallback expression", "/versions/18/tables/0/title": "Environment fallback", "/versions/18/related/0/label": "Connection service file", "/versions/18/related/1/label": "Password file", "/versions/18/related/2/label": "All libpq environment variables", "/versions/18/sections/0/title": "Default resolution and service-file precedence", "/versions/18/sections/1/title": "Environment variable evidence", "/versions/18/sections/0/paragraphs/0": "The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "/versions/18/sections/0/paragraphs/1": "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "/versions/18/sections/0/paragraphs/2": "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults.", "/versions/18/sections/1/paragraphs/0": "PGREQUIREAUTH behaves the same as the require_auth connection parameter.", "/versions/18/tables/0/columns/0/label": "Variable", "/versions/18/tables/0/columns/1/label": "Documented behavior", "/versions/18/tables/0/rows/0/description": "PGREQUIREAUTH behaves the same as the require_auth connection parameter."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "ad3e32b700eb69bf6a2e25d1eab9739ab314c26c2a6f7116ca19f85b7a0ef73c"}, "source_option": {"keyword": "require_auth", "declaration": "\"require_auth\", \"PGREQUIREAUTH\", NULL, NULL, \"Require-Auth\", \"\", 14, offsetof(struct pg_conn, require_auth)", "environment": "PGREQUIREAUTH", "source_notes": [], "compiled_default_expression": "NULL"}, "comparison_data": {"keyword": "require_auth", "definition": "Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. Warning Support for MD5-encrypted passwords is deprecated and will be removed in a future release of PostgreSQL . Refer to Section 20.5 for details about migrating to another password type. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. oauth The server must request an OAuth bearer token from the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)", "documented": true, "environment": "PGREQUIREAUTH", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "compiled_default_expression": "NULL"}, "comparison_hash": "b90f10c3c2ccff2990774577cab21e0392f308768058f40109dd55f7e52ca3c5", "manual_language": "zh", "default_evidence": ["Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether."], "precedence_evidence": ["The following environment variables can be used to select default connection parameter values, which will be used by PQconnectdb , PQsetdbLogin and PQsetdb if no value is directly specified by the calling code. These are useful to avoid hard-coding database connection information into simple client applications, for example.", "Service names can be defined in either a per-user service file or a system-wide file. If the same service name exists in both the user and the system file, the user file takes precedence. By default, the per-user service file is named ~/.pg_service.conf . On Microsoft Windows, it is named %APPDATA%\\postgresql\\.pg_service.conf (where %APPDATA% refers to the Application Data subdirectory in the user's profile). A different file name can be specified by setting the environment variable PGSERVICEFILE . The system-wide file is named pg_service.conf . By default it is sought in the etc directory of the PostgreSQL installation (use pg_config --sysconfdir to identify this directory precisely). Another directory, but not a different file name, can be specified by setting the environment variable PGSYSCONFDIR .", "Connection parameters obtained from a service file are combined with parameters obtained from other sources. A service file setting overrides the corresponding environment variable, and in turn can be overridden by a value given directly in the connection string. For example, using the above service file, a connection string service=mydb port=5434 will use host somehost , port 5434 , user admin , and other parameters as set by environment variables or built-in defaults."]}, "comparison": {"left": "15", "right": "16", "status": "added", "diff": "--- PostgreSQL 15\n+++ PostgreSQL 16\n@@ -1 +1,10 @@\n-\u8be5\u7248\u672a\u6536\u5f55\n+{\n+  \"compiled_default_expression\": \"NULL\",\n+  \"default_evidence\": [\n+    \"Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether.\"\n+  ],\n+  \"definition\": \"Specifies the authentication method that the client requires from the server. If the server does not use the required method to authenticate the client, or if the authentication handshake is not fully completed by the server, the connection will fail. A comma-separated list of methods may also be provided, of which the server must use exactly one in order for the connection to succeed. By default, any authentication method is accepted, and the server is free to skip authentication altogether. Methods may be negated with the addition of a ! prefix, in which case the server must not attempt the listed method; any other method is accepted, and the server is free not to authenticate the client at all. If a comma-separated list is provided, the server may not attempt any of the listed negated methods. Negated and non-negated forms may not be combined in the same setting. As a final special case, the none method requires the server not to use an authentication challenge. (It may also be negated, to require some form of authentication.) The following methods may be specified: password The server must request plaintext password authentication. md5 The server must request MD5 hashed password authentication. gss The server must either request a Kerberos handshake via GSSAPI or establish a GSS -encrypted channel (see also gssencmode ). sspi The server must request Windows SSPI authentication. scram-sha-256 The server must successfully complete a SCRAM-SHA-256 authentication exchange with the client. none The server must not prompt the client for an authentication exchange. (This does not prohibit client certificate authentication via TLS, nor GSS authentication via its encrypted transport.)\",\n+  \"documented\": true,\n+  \"environment\": \"PGREQUIREAUTH\",\n+  \"keyword\": \"require_auth\"\n+}"}}