peer
Obtain the client's operating system user name from the operating system and check if it matches the requested database user name. This is only available for local connections. See Section 20.9 for details.
Reading PG 18·Select a recorded version
- Method
- peer
- Configuration
- pg_hba.conf
- Inventory
- User-visible source authentication method
- aliases
- Unknown
- manual path
- /docs/18/auth-peer.html
- signature
- Unknown
Definition PG 18
20.9. Peer Authentication
The peer authentication method works by obtaining the client's operating system user name from the kernel and using it as the allowed database user name (with optional user name mapping). This method is only supported on local connections.
The following configuration options are supported for peer:
map-
Allows for mapping between system and database user names. See Section 20.2 for details.
Peer authentication is only available on operating systems providing the getpeereid() function, the SO_PEERCRED socket parameter, or similar mechanisms. Currently that includes Linux, most flavors of BSD including macOS, and Solaris.
Documented method options and alternatives
| Option or term | Meaning |
|---|---|
| map | Allows for mapping between system and database user names. See Section 20.2 for details. |
Compare versions
Complete source facts
attributes
{"configuration":"pg_hba.conf","inventory":"User-visible source authentication method","method":"peer"}Source references
- Matching PostgreSQL source archive
- PostgreSQL 18 English manual
- PostgreSQL 18 English manual
- Pinned PostgreSQL source archive
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
Text language: en · 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f