Skip to content

Commit 92bc242

Browse files
authored
Merge pull request #109663 from TimShererWithAquent/us1679050ce
Change SSL to TLS per 1679050
2 parents 9571532 + 4570f05 commit 92bc242

6 files changed

+21
-21
lines changed

articles/postgresql/concepts-hyperscale-extensions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ The following tables list the standard PostgreSQL extensions that are currently
110110
> | [pgrowlocks](https://www.postgresql.org/docs/current/static/pgrowlocks.html) | Provides a means for showing row-level locking information. |
111111
> | [pgstattuple](https://www.postgresql.org/docs/current/static/pgstattuple.html) | Provides a means for showing tuple-level statistics. |
112112
> | [postgres\_fdw](https://www.postgresql.org/docs/current/static/postgres-fdw.html) | Foreign-data wrapper used to access data stored in external PostgreSQL servers. See the "dblink and postgres_fdw" section for information about this extension.|
113-
> | [sslinfo](https://www.postgresql.org/docs/current/sslinfo.html) | Information about SSL certificates. |
113+
> | [sslinfo](https://www.postgresql.org/docs/current/sslinfo.html) | Information about TLS/SSL certificates. |
114114
> | [tsm\_system\_rows](https://www.postgresql.org/docs/current/tsm-system-rows.html) | TABLESAMPLE method, which accepts number of rows as a limit. |
115115
> | [tsm\_system\_time](https://www.postgresql.org/docs/current/tsm-system-time.html) | TABLESAMPLE method, which accepts time in milliseconds as a limit. |
116116
> | [hypopg](https://hypopg.readthedocs.io/en/latest/) | Provides a means of creating hypothetical indexes that don't cost CPU or disk. |

articles/postgresql/concepts-ssl-connection-security.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
11
---
2-
title: SSL - Azure Database for PostgreSQL - Single Server
3-
description: Instructions and information on how to configure SSL connectivity for Azure Database for PostgreSQL - Single Server.
2+
title: TLS - Azure Database for PostgreSQL - Single Server
3+
description: Instructions and information on how to configure TLS connectivity for Azure Database for PostgreSQL - Single Server.
44
author: rachel-msft
55
ms.author: raagyema
66
ms.service: postgresql
77
ms.topic: conceptual
88
ms.date: 03/10/2020
99
---
10-
# Configure SSL connectivity in Azure Database for PostgreSQL - Single Server
10+
# Configure TLS connectivity in Azure Database for PostgreSQL - Single Server
1111

12-
Azure Database for PostgreSQL prefers connecting your client applications to the PostgreSQL service using Secure Sockets Layer (SSL). Enforcing SSL connections between your database server and your client applications helps protect against "man-in-the-middle" attacks by encrypting the data stream between the server and your application.
12+
Azure Database for PostgreSQL prefers connecting your client applications to the PostgreSQL service using Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL). Enforcing TLS connections between your database server and your client applications helps protect against "man-in-the-middle" attacks by encrypting the data stream between the server and your application.
1313

14-
By default, the PostgreSQL database service is configured to require SSL connection. You can choose to disable requiring SSL if your client application does not support SSL connectivity.
14+
By default, the PostgreSQL database service is configured to require TLS connection. You can choose to disable requiring TLS if your client application does not support TLS connectivity.
1515

16-
## Enforcing SSL connections
16+
## Enforcing TLS connections
1717

18-
For all Azure Database for PostgreSQL servers provisioned through the Azure portal and CLI, enforcement of SSL connections is enabled by default.
18+
For all Azure Database for PostgreSQL servers provisioned through the Azure portal and CLI, enforcement of TLS connections is enabled by default.
1919

20-
Likewise, connection strings that are pre-defined in the "Connection Strings" settings under your server in the Azure portal include the required parameters for common languages to connect to your database server using SSL. The SSL parameter varies based on the connector, for example "ssl=true" or "sslmode=require" or "sslmode=required" and other variations.
20+
Likewise, connection strings that are pre-defined in the "Connection Strings" settings under your server in the Azure portal include the required parameters for common languages to connect to your database server using TLS. The TLS parameter varies based on the connector, for example "ssl=true" or "sslmode=require" or "sslmode=required" and other variations.
2121

22-
## Configure Enforcement of SSL
22+
## Configure Enforcement of TLS
2323

24-
You can optionally disable enforcing SSL connectivity. Microsoft Azure recommends to always enable **Enforce SSL connection** setting for enhanced security.
24+
You can optionally disable enforcing TLS connectivity. Microsoft Azure recommends to always enable **Enforce SSL connection** setting for enhanced security.
2525

2626
### Using the Azure portal
2727

2828
Visit your Azure Database for PostgreSQL server and click **Connection security**. Use the toggle button to enable or disable the **Enforce SSL connection** setting. Then, click **Save**.
2929

30-
![Connection Security - Disable Enforce SSL](./media/concepts-ssl-connection-security/1-disable-ssl.png)
30+
![Connection Security - Disable Enforce TLS/SSL](./media/concepts-ssl-connection-security/1-disable-ssl.png)
3131

3232
You can confirm the setting by viewing the **Overview** page to see the **SSL enforce status** indicator.
3333

@@ -39,17 +39,17 @@ You can enable or disable the **ssl-enforcement** parameter using `Enabled` or `
3939
az postgres server update --resource-group myresourcegroup --name mydemoserver --ssl-enforcement Enabled
4040
```
4141

42-
## Ensure your application or framework supports SSL connections
42+
## Ensure your application or framework supports TLS connections
4343

44-
Some application frameworks that use PostgreSQL for their database services do not enable SSL by default during installation. If your PostgreSQL server enforces SSL connections but the application is not configured for SSL, the application may fail to connect to your database server. Consult your application's documentation to learn how to enable SSL connections.
44+
Some application frameworks that use PostgreSQL for their database services do not enable TLS by default during installation. If your PostgreSQL server enforces TLS connections but the application is not configured for TLS, the application may fail to connect to your database server. Consult your application's documentation to learn how to enable TLS connections.
4545

46-
## Applications that require certificate verification for SSL connectivity
46+
## Applications that require certificate verification for TLS connectivity
4747

4848
In some cases, applications require a local certificate file generated from a trusted Certificate Authority (CA) certificate file (.cer) to connect securely. The certificate to connect to an Azure Database for PostgreSQL server is located at https://www.digicert.com/CACerts/BaltimoreCyberTrustRoot.crt.pem. Download the certificate file and save it to your preferred location.
4949

5050
### Connect using psql
5151

52-
The following example shows how to connect to your PostgreSQL server using the psql command-line utility. Use the `sslmode=verify-full` connection string setting to enforce SSL certificate verification. Pass the local certificate file path to the `sslrootcert` parameter.
52+
The following example shows how to connect to your PostgreSQL server using the psql command-line utility. Use the `sslmode=verify-full` connection string setting to enforce TLS/SSL certificate verification. Pass the local certificate file path to the `sslrootcert` parameter.
5353

5454
The following command is an example of the psql connection string:
5555

articles/postgresql/howto-migrate-using-dump-and-restore.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ pg_restore -v --no-owner --host=<server name> --port=<port> --username=<user@ser
3737
Including the --no-owner parameter causes all objects created during the restore to be owned by the user specified with --username. For more information, see the official PostgreSQL documentation on [pg_restore](https://www.postgresql.org/docs/9.6/static/app-pgrestore.html).
3838

3939
> [!NOTE]
40-
> If your PostgreSQL server requires SSL connections (on by default in Azure Database for PostgreSQL servers), set an environment variable `PGSSLMODE=require` so that the pg_restore tool connects with SSL. Without SSL, the error may read `FATAL: SSL connection is required. Please specify SSL options and retry.`
40+
> If your PostgreSQL server requires TLS/SSL connections (on by default in Azure Database for PostgreSQL servers), set an environment variable `PGSSLMODE=require` so that the pg_restore tool connects with TLS. Without TLS, the error may read `FATAL: SSL connection is required. Please specify SSL options and retry.`
4141
>
4242
> In the Windows command line, run the command `SET PGSSLMODE=require` before running the pg_restore command. In Linux or Bash run the command `export PGSSLMODE=require` before running the pg_restore command.
4343
>

articles/postgresql/quickstart-create-server-database-azure-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ sku-name | GP_Gen5_2 | The name of the sku. Follows the convention {pricing tier
5252
backup-retention | 7 | How long a backup should be retained. Unit is days. Range is 7-35.
5353
geo-redundant-backup | Disabled | Whether geo-redundant backups should be enabled for this server or not. Allowed values: Enabled, Disabled.
5454
location | westus | The Azure location for the server.
55-
ssl-enforcement | Enabled | Whether ssl should be enabled or not for this server. Allowed values: Enabled, Disabled.
55+
ssl-enforcement | Enabled | Whether TLS/SSL should be enabled or not for this server. Allowed values: Enabled, Disabled.
5656
storage-size | 51200 | The storage capacity of the server (unit is megabytes). Valid storage-size is minimum 5120MB and increases in 1024MB increments. See the [pricing tiers](./concepts-pricing-tiers.md) document for more information about storage size limits.
5757
version | 9.6 | The PostgreSQL major version.
5858
admin-user | myadmin | The username for the administrator login. It cannot be **azure_superuser**, **admin**, **administrator**, **root**, **guest**, or **public**.
@@ -180,7 +180,7 @@ pgAdmin is an open-source tool used with PostgreSQL. You can install pgAdmin fro
180180
Username | Server admin login name | The server admin login username that you supplied when you created the Azure Database for PostgreSQL server earlier. If you don't remember the username, follow the steps in the previous section to get the connection information. The format is *username\@servername*.
181181
Password | Your admin password | The password you chose when you created the server earlier in this Quickstart.
182182
Role | Leave blank | There's no need to provide a role name at this point. Leave the field blank.
183-
SSL mode | *Require* | You can set the SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with SSL enforcing turned on. To turn off SSL enforcing, see [SSL Enforcing](./concepts-ssl-connection-security.md).
183+
SSL mode | *Require* | You can set the TLS/SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with TLS enforcing turned on. To turn off TLS enforcing, see [Configure Enforcement of TLS](./concepts-ssl-connection-security.md#configure-enforcement-of-tls).
184184

185185
5. Select **Save**.
186186

articles/postgresql/quickstart-create-server-database-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ pgAdmin is an open-source tool used with PostgreSQL. You can install pgAdmin fro
173173
Username | Server admin login name | The server admin login username that you supplied when you created the Azure Database for PostgreSQL server earlier. If you don't remember the username, follow the steps in the previous section to get the connection information. The format is *username\@servername*.
174174
Password | Your admin password | The password you chose when you created the server earlier in this Quickstart.
175175
Role | Leave blank | There's no need to provide a role name at this point. Leave the field blank.
176-
SSL mode | *Require* | You can set the SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with SSL enforcing turned on. To turn off SSL enforcing, see [SSL Enforcing](./concepts-ssl-connection-security.md).
176+
SSL mode | *Require* | You can set the TLS/SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with TLS enforcing turned on. To turn off TLS enforcing, see [Configure Enforcement of TLS](./concepts-ssl-connection-security.md#configure-enforcement-of-tls).
177177

178178
5. Select **Save**.
179179

articles/postgresql/quickstart-create-server-up-azure-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ sku-name | GP_Gen5_2 | The name of the sku. Follows the convention {pricing tier
5757
backup-retention | 7 | How long a backup is retained. Unit is days.
5858
geo-redundant-backup | Disabled | Whether geo-redundant backups should be enabled for this server or not.
5959
location | westus2 | The Azure location for the server.
60-
ssl-enforcement | Disabled | Whether ssl should be enabled or not for this server.
60+
ssl-enforcement | Disabled | Whether TLS/SSL should be enabled or not for this server.
6161
storage-size | 5120 | The storage capacity of the server (unit is megabytes).
6262
version | 10 | The PostgreSQL major version.
6363
admin-user | System generated | The username for the administrator.

0 commit comments

Comments
 (0)