Postgres credentials#
You can use these credentials to authenticate the following nodes:
Agent node users
The Agent node doesn't support SSH tunnels.
Prerequisites#
Create a user account on a Postgres server.
Supported authentication methods#
- Database connection
Related resources#
Refer to Postgres's documentation for more information about the service.
Using database connection#
To configure this credential, you'll need:
- The Host: Enter the host or domain name for the server.
- The Database: Enter the database name.
- A User name: Enter the username for the user account.
- A user Password: Enter the password for the user account.
- Ignore SSL Issues: When turned on, the credential will connect even if SSL validation fails.
- SSL: Choose whether to use SSL in your connection. Refer to Postgres SSL Support for more information. Options include:
- Allow: Sets the
ssl-mode
parameter toallow
. First try a non-SSL connection; if that fails, try an SSL connection. - Disable: Sets the
ssl-mode
parameter todisable
. Only try a non-SSL connection. - Require: Sets the
ssl-mode
parameter torequire
. Only try an SSL connection. If a root CA file is present, verify that a trusted certificate authority (CA) issued the server certificate. - Verify: Sets the
ssl-mode
parameter toverify-ca
. Only try an SSL connection and verify that a trusted certificate authority (CA) issued the server certificate. - Verify-Full: Sets the
ssl-mode
parameter toverify-full
. Only try an SSL connection, verify that a trusted certificate authority (CA) issued the server certificate and that the requested server host name matches that in the certificate.
- Allow: Sets the
- The Port: Enter the port number to use for the connection.
- SSH Tunnel: If turned on, the credential uses SSH to encrypt the network connection with the Postgres server. Refer to Using SSH tunnel for more information.
Refer to Connection Strings for more information on finding and formatting these fields.
SSH tunnel#
Only turn on the SSH Tunnel if:
- You're using the credential with the Postgres node (Agent node doesn't support SSH tunnels).
- You have an SSH server running on the same machine as the Postgres server.
- You have a user account that can log in using
ssh
.
Once turned on, you'll need:
- SSH Authenticate with: Select whether to authenticate SSH with a Password or Private Key.
- SSH Host: Enter the remote bind address you're connecting to.
- SSH Port: Enter the local port number for the SSH tunnel.
- SSH Postgres Port: Enter the remote end of the tunnel, the port number the database server is using.
- SSH User: Enter the username to log in as.
- SSH Password: Only required if you selected Password as the SSH Authenticate with type. Enter the user's SSH password.
- Private Key: Only required if you selected Private Key as the SSH Authenticate with type.
- Passphrase: Only required if you selected Private Key as the SSH Authenticate with type.
Refer to Secure TCP/IP Connections with SSH Tunnels for more information.