Skip to content

Commit 82a56c8

Browse files
authored
Merge pull request #108024 from TimShererWithAquent/us1679050c
Change SSL to TLS per 1679050
2 parents b2d3843 + 55c5113 commit 82a56c8

File tree

5 files changed

+27
-27
lines changed

5 files changed

+27
-27
lines changed

articles/machine-learning/concept-enterprise-security.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -190,9 +190,9 @@ Azure Databricks can be used in Azure Machine Learning pipelines. By default, th
190190

191191
### Encryption in transit
192192

193-
You can use SSL to secure internal communication between Azure Machine Learning microservices and to secure external calls to the scoring endpoint. All Azure Storage access also occurs over a secure channel.
193+
You can use TLS to secure internal communication between Azure Machine Learning microservices and to secure external calls to the scoring endpoint. All Azure Storage access also occurs over a secure channel.
194194

195-
For more information, see [Use SSL to secure a web service through Azure Machine Learning](https://docs.microsoft.com/azure/machine-learning/how-to-secure-web-service).
195+
For more information, see [Use TLS to secure a web service through Azure Machine Learning](https://docs.microsoft.com/azure/machine-learning/how-to-secure-web-service).
196196

197197
### Using Azure Key Vault
198198

@@ -330,7 +330,7 @@ Here are the details:
330330

331331
## Next steps
332332

333-
* [Secure Azure Machine Learning web services with SSL](how-to-secure-web-service.md)
333+
* [Secure Azure Machine Learning web services with TLS](how-to-secure-web-service.md)
334334
* [Consume a Machine Learning model deployed as a web service](how-to-consume-web-service.md)
335335
* [How to run batch predictions](how-to-use-parallel-run-step.md)
336336
* [Monitor your Azure Machine Learning models with Application Insights](how-to-enable-app-insights.md)

articles/machine-learning/how-to-consume-web-service.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,12 +73,12 @@ There are a three ways to retrieve this information for deployed web services:
7373

7474
### Secured web service
7575

76-
If you secured the deployed web service using an SSL certificate, you can use [HTTPS](https://en.wikipedia.org/wiki/HTTPS) to connect to the service using the scoring or swagger URI. HTTPS helps secure communications between a client and a web service by encrypting communications between the two. Encryption uses [Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security). TLS is sometimes still referred to as *Secure Sockets Layer* (SSL), which was the predecessor of TLS.
76+
If you secured the deployed web service using a TLS/SSL certificate, you can use [HTTPS](https://en.wikipedia.org/wiki/HTTPS) to connect to the service using the scoring or swagger URI. HTTPS helps secure communications between a client and a web service by encrypting communications between the two. Encryption uses [Transport Layer Security (TLS)](https://en.wikipedia.org/wiki/Transport_Layer_Security). TLS is sometimes still referred to as *Secure Sockets Layer* (SSL), which was the predecessor of TLS.
7777

7878
> [!IMPORTANT]
7979
> Web services deployed by Azure Machine Learning only support TLS version 1.2. When creating a client application, make sure that it supports this version.
8080

81-
For more information, see [Use SSL to secure a web service through Azure Machine Learning](how-to-secure-web-service.md).
81+
For more information, see [Use TLS to secure a web service through Azure Machine Learning](how-to-secure-web-service.md).
8282

8383
### Authentication for services
8484

articles/machine-learning/how-to-deploy-app-service.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ With Azure Machine Learning, you can create Docker images from trained machine l
2626

2727
* Advanced [authentication](/azure/app-service/configure-authentication-provider-aad) for enhanced security. Authentication methods include both Azure Active Directory and multi-factor auth.
2828
* [Autoscale](/azure/azure-monitor/platform/autoscale-get-started?toc=%2fazure%2fapp-service%2ftoc.json) without having to redeploy.
29-
* [SSL support](/azure/app-service/configure-ssl-certificate-in-code) for secure communications between clients and the service.
29+
* [TLS support](/azure/app-service/configure-ssl-certificate-in-code) for secure communications between clients and the service.
3030

3131
For more information on features provided by Azure App Service, see the [App Service overview](/azure/app-service/overview).
3232

@@ -268,6 +268,6 @@ print(response.json())
268268
269269
* Learn to configure your Web App in the [App Service on Linux](/azure/app-service/containers/) documentation.
270270
* Learn more about scaling in [Get started with Autoscale in Azure](/azure/azure-monitor/platform/autoscale-get-started?toc=%2fazure%2fapp-service%2ftoc.json).
271-
* [Use an SSL certificate in your Azure App Service](/azure/app-service/configure-ssl-certificate-in-code).
271+
* [Use a TLS/SSL certificate in your Azure App Service](/azure/app-service/configure-ssl-certificate-in-code).
272272
* [Configure your App Service app to use Azure Active Directory sign-in](/azure/app-service/configure-authentication-provider-aad).
273273
* [Consume a ML Model deployed as a web service](how-to-consume-web-service.md)

articles/machine-learning/how-to-enable-virtual-network.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -507,4 +507,4 @@ When using a virtual network with Azure Machine Learning, __do not__ put the Azu
507507
508508
* [Set up training environments](how-to-set-up-training-targets.md)
509509
* [Where to deploy models](how-to-deploy-and-where.md)
510-
* [Securely deploy models with SSL](how-to-secure-web-service.md)
510+
* [Use TLS to secure a web service through Azure Machine Learning](how-to-secure-web-service.md)

articles/machine-learning/how-to-secure-web-service.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -39,22 +39,22 @@ This is the general process to secure a web service:
3939

4040
2. Get a digital certificate.
4141

42-
3. Deploy or update the web service with SSL enabled.
42+
3. Deploy or update the web service with TLS enabled.
4343

4444
4. Update your DNS to point to the web service.
4545

4646
> [!IMPORTANT]
47-
> If you're deploying to Azure Kubernetes Service (AKS), you can purchase your own certificate or use a certificate that's provided by Microsoft. If you use a certificate from Microsoft, you don't need to get a domain name or SSL certificate. For more information, see the [Enable SSL and deploy](#enable) section of this article.
47+
> If you're deploying to Azure Kubernetes Service (AKS), you can purchase your own certificate or use a certificate that's provided by Microsoft. If you use a certificate from Microsoft, you don't need to get a domain name or TLS/SSL certificate. For more information, see the [Enable TLS and deploy](#enable) section of this article.
4848
4949
There are slight differences when you secure s across [deployment targets](how-to-deploy-and-where.md).
5050

5151
## Get a domain name
5252

5353
If you don't already own a domain name, purchase one from a *domain name registrar*. The process and price differ among registrars. The registrar provides tools to manage the domain name. You use these tools to map a fully qualified domain name (FQDN) (such as www\.contoso.com) to the IP address that hosts your web service.
5454

55-
## Get an SSL certificate
55+
## Get a TLS/SSL certificate
5656

57-
There are many ways to get an SSL certificate (digital certificate). The most common is to purchase one from a *certificate authority* (CA). Regardless of where you get the certificate, you need the following files:
57+
There are many ways to get an TLS/SSL certificate (digital certificate). The most common is to purchase one from a *certificate authority* (CA). Regardless of where you get the certificate, you need the following files:
5858

5959
* A **certificate**. The certificate must contain the full certificate chain, and it must be "PEM-encoded."
6060
* A **key**. The key must also be PEM-encoded.
@@ -67,9 +67,9 @@ When you request a certificate, you must provide the FQDN of the address that yo
6767
> [!WARNING]
6868
> Use *self-signed* certificates only for development. Don't use them in production environments. Self-signed certificates can cause problems in your client applications. For more information, see the documentation for the network libraries that your client application uses.
6969
70-
## <a id="enable"></a> Enable SSL and deploy
70+
## <a id="enable"></a> Enable TLS and deploy
7171

72-
To deploy (or redeploy) the service with SSL enabled, set the *ssl_enabled* parameter to "True" wherever it's applicable. Set the *ssl_certificate* parameter to the value of the *certificate* file. Set the *ssl_key* to the value of the *key* file.
72+
To deploy (or redeploy) the service with TLS enabled, set the *ssl_enabled* parameter to "True" wherever it's applicable. Set the *ssl_certificate* parameter to the value of the *certificate* file. Set the *ssl_key* to the value of the *key* file.
7373

7474
### Deploy on AKS and field-programmable gate array (FPGA)
7575

@@ -85,24 +85,24 @@ The **enable_ssl** method can use a certificate that's provided by Microsoft or
8585

8686
* When you use a certificate from Microsoft, you must use the *leaf_domain_label* parameter. This parameter generates the DNS name for the service. For example, a value of "contoso" creates a domain name of "contoso\<six-random-characters>.\<azureregion>.cloudapp.azure.com", where \<azureregion> is the region that contains the service. Optionally, you can use the *overwrite_existing_domain* parameter to overwrite the existing *leaf_domain_label*.
8787

88-
To deploy (or redeploy) the service with SSL enabled, set the *ssl_enabled* parameter to "True" wherever it's applicable. Set the *ssl_certificate* parameter to the value of the *certificate* file. Set the *ssl_key* to the value of the *key* file.
88+
To deploy (or redeploy) the service with TLS enabled, set the *ssl_enabled* parameter to "True" wherever it's applicable. Set the *ssl_certificate* parameter to the value of the *certificate* file. Set the *ssl_key* to the value of the *key* file.
8989

9090
> [!IMPORTANT]
9191
> When you use a certificate from Microsoft, you don't need to purchase your own certificate or domain name.
9292
93-
The following example demonstrates how to create a configuration that enables an SSL certificate from Microsoft:
93+
The following example demonstrates how to create a configuration that enables an TLS/SSL certificate from Microsoft:
9494

9595
```python
9696
from azureml.core.compute import AksCompute
97-
# Config used to create a new AKS cluster and enable SSL
97+
# Config used to create a new AKS cluster and enable TLS
9898
provisioning_config = AksCompute.provisioning_configuration()
9999
# Leaf domain label generates a name using the formula
100100
# "<leaf-domain-label>######.<azure-region>.cloudapp.azure.net"
101101
# where "######" is a random series of characters
102102
provisioning_config.enable_ssl(leaf_domain_label = "contoso")
103103

104104

105-
# Config used to attach an existing AKS cluster to your workspace and enable SSL
105+
# Config used to attach an existing AKS cluster to your workspace and enable TLS
106106
attach_config = AksCompute.attach_configuration(resource_group = resource_group,
107107
cluster_name = cluster_name)
108108
# Leaf domain label generates a name using the formula
@@ -111,11 +111,11 @@ The **enable_ssl** method can use a certificate that's provided by Microsoft or
111111
attach_config.enable_ssl(leaf_domain_label = "contoso")
112112
```
113113

114-
* When you use *a certificate that you purchased*, you use the *ssl_cert_pem_file*, *ssl_key_pem_file*, and *ssl_cname* parameters. The following example demonstrates how to use *.pem* files to create a configuration that uses an SSL certificate that you purchased:
114+
* When you use *a certificate that you purchased*, you use the *ssl_cert_pem_file*, *ssl_key_pem_file*, and *ssl_cname* parameters. The following example demonstrates how to use *.pem* files to create a configuration that uses a TLS/SSL certificate that you purchased:
115115

116116
```python
117117
from azureml.core.compute import AksCompute
118-
# Config used to create a new AKS cluster and enable SSL
118+
# Config used to create a new AKS cluster and enable TLS
119119
provisioning_config = AksCompute.provisioning_configuration()
120120
provisioning_config.enable_ssl(ssl_cert_pem_file="cert.pem",
121121
ssl_key_pem_file="key.pem", ssl_cname="www.contoso.com")
@@ -130,7 +130,7 @@ For more information about *enable_ssl*, see [AksProvisioningConfiguration.enabl
130130

131131
### Deploy on Azure Container Instances
132132

133-
When you deploy to Azure Container Instances, you provide values for SSL-related parameters, as the following code snippet shows:
133+
When you deploy to Azure Container Instances, you provide values for TLS-related parameters, as the following code snippet shows:
134134

135135
```python
136136
from azureml.core.webservice import AciWebservice
@@ -158,11 +158,11 @@ Next, you must update your DNS to point to the web service.
158158

159159
Update the DNS of the Public IP Address of the AKS cluster on the **Configuration** tab under **Settings** in the left pane. (See the following image.) The Public IP Address is a resource type that's created under the resource group that contains the AKS agent nodes and other networking resources.
160160

161-
[![Azure Machine Learning: Securing web services with SSL](./media/how-to-secure-web-service/aks-public-ip-address.png)](./media/how-to-secure-web-service/aks-public-ip-address-expanded.png)
161+
[![Azure Machine Learning: Securing web services with TLS](./media/how-to-secure-web-service/aks-public-ip-address.png)](./media/how-to-secure-web-service/aks-public-ip-address-expanded.png)
162162

163-
## Update the SSL certificate
163+
## Update the TLS/SSL certificate
164164

165-
SSL certificates expire and must be renewed. Typically this happens every year. Use the information in the following sections to update and renew your certificate for models deployed to Azure Kubernetes Service:
165+
TLS/SSL certificates expire and must be renewed. Typically this happens every year. Use the information in the following sections to update and renew your certificate for models deployed to Azure Kubernetes Service:
166166

167167
### Update a Microsoft generated certificate
168168

@@ -235,9 +235,9 @@ For more information, see the following reference docs:
235235
* [SslConfiguration](https://docs.microsoft.com/python/api/azureml-core/azureml.core.compute.aks.sslconfiguration?view=azure-ml-py)
236236
* [AksUpdateConfiguration](https://docs.microsoft.com/python/api/azureml-core/azureml.core.compute.aks.aksupdateconfiguration?view=azure-ml-py)
237237

238-
## Disable SSL
238+
## Disable TLS
239239

240-
To disable SSL for a model deployed to Azure Kubernetes Service, create an `SslConfiguration` with `status="Disabled"`, then perform an update:
240+
To disable TLS for a model deployed to Azure Kubernetes Service, create an `SslConfiguration` with `status="Disabled"`, then perform an update:
241241

242242
```python
243243
from azureml.core.compute import AksCompute
@@ -247,7 +247,7 @@ from azureml.core.compute.aks import SslConfiguration
247247
# Get the existing cluster
248248
aks_target = AksCompute(ws, clustername)
249249

250-
# Disable SSL
250+
# Disable TLS
251251
ssl_configuration = SslConfiguration(status="Disabled")
252252
update_config = AksUpdateConfiguration(ssl_configuration)
253253
aks_target.update(update_config)

0 commit comments

Comments
 (0)