begriffs open source - ai-pg/blob - full-docs/src/sgml/html/auth-cert.html

   1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>20.12. Certificate Authentication</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="prev" href="auth-radius.html" title="20.11. RADIUS Authentication" /><link rel="next" href="auth-pam.html" title="20.13. PAM Authentication" /></head><body id="docContent" class="container-fluid col-10"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">20.12. Certificate Authentication</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="auth-radius.html" title="20.11. RADIUS Authentication">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="client-authentication.html" title="Chapter 20. Client Authentication">Up</a></td><th width="60%" align="center">Chapter 20. Client Authentication</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 18.0 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="auth-pam.html" title="20.13. PAM Authentication">Next</a></td></tr></table><hr /></div><div class="sect1" id="AUTH-CERT"><div class="titlepage"><div><div><h2 class="title" style="clear: both">20.12. Certificate Authentication <a href="#AUTH-CERT" class="id_link">#</a></h2></div></div></div><a id="id-1.6.7.19.2" class="indexterm"></a><p>
   3     This authentication method uses SSL client certificates to perform
   4     authentication. It is therefore only available for SSL connections;
   5     see <a class="xref" href="ssl-tcp.html#SSL-OPENSSL-CONFIG" title="18.9.2. OpenSSL Configuration">Section 18.9.2</a> for SSL configuration instructions.
   6     When using this authentication method, the server will require that
   7     the client provide a valid, trusted certificate.  No password prompt
   8     will be sent to the client.  The <code class="literal">cn</code> (Common Name)
   9     attribute of the certificate
  10     will be compared to the requested database user name, and if they match
  11     the login will be allowed.  User name mapping can be used to allow
  12     <code class="literal">cn</code> to be different from the database user name.
  13    </p><p>
  14     The following configuration options are supported for SSL certificate
  15     authentication:
  16     </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">map</code></span></dt><dd><p>
  17         Allows for mapping between system and database user names. See
  18         <a class="xref" href="auth-username-maps.html" title="20.2. User Name Maps">Section 20.2</a> for details.
  19        </p></dd></dl></div><p>
  20    </p><p>
  21     It is redundant to use the <code class="literal">clientcert</code> option with
  22     <code class="literal">cert</code> authentication because <code class="literal">cert</code>
  23     authentication is effectively <code class="literal">trust</code> authentication
  24     with <code class="literal">clientcert=verify-full</code>.
  25    </p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="auth-radius.html" title="20.11. RADIUS Authentication">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="client-authentication.html" title="Chapter 20. Client Authentication">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="auth-pam.html" title="20.13. PAM Authentication">Next</a></td></tr><tr><td width="40%" align="left" valign="top">20.11. RADIUS Authentication </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 18.0 Documentation">Home</a></td><td width="40%" align="right" valign="top"> 20.13. PAM Authentication</td></tr></table></div></body></html>