Skip to content

Commit 2c881df

Browse files
authored
Merge pull request #287832 from MicrosoftDocs/main
10/3/2024 AM Publish
2 parents 232546d + 1b75b26 commit 2c881df

File tree

191 files changed

+9661
-6198
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

191 files changed

+9661
-6198
lines changed

articles/app-service/configure-common.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn to configure common settings for an App Service app. App sett
44
keywords: azure app service, web app, app settings, environment variables
55
ms.assetid: 9af8a367-7d39-4399-9941-b80cbc5f39a0
66
ms.topic: article
7-
ms.date: 06/04/2024
7+
ms.date: 10/03/2024
88
ms.custom: devx-track-csharp, devx-track-azurecli, devx-track-azurepowershell, AppServiceConnectivity
99
ms.devlang: azurecli
1010
author: cephalin
@@ -446,7 +446,8 @@ Here, you can configure some common settings for the app. Some settings require
446446
- **Always On**: Keeps the app loaded even when there's no traffic. When **Always On** isn't turned on (default), the app is unloaded after 20 minutes without any incoming requests. The unloaded app can cause high latency for new requests because of its warm-up time. When **Always On** is turned on, the front-end load balancer sends a GET request to the application root every five minutes. The continuous ping prevents the app from being unloaded.
447447

448448
Always On is required for continuous WebJobs or for WebJobs that are triggered using a CRON expression.
449-
- **ARR affinity**: In a multi-instance deployment, ensure that the client is routed to the same instance for the life of the session. You can set this option to **Off** for stateless applications.
449+
- **Session affinity**: In a multi-instance deployment, ensure that the client is routed to the same instance for the life of the session. You can set this option to **Off** for stateless applications.
450+
- **Session affinity proxy**: Session affinity proxy can be turned on if your app is behind a reverse proxy (like Azure Application Gateway or Azure Front Door) and you are using the default host name. The domain for the session affinity cookie will align with the forwarded host name from the reverse proxy.
450451
- **HTTPS Only**: When enabled, all HTTP traffic is redirected to HTTPS.
451452
- **Minimum TLS version**: Select the minimum TLS encryption version required by your app.
452453
- **Debugging**: Enable remote debugging for [ASP.NET](troubleshoot-dotnet-visual-studio.md#remotedebug), [ASP.NET Core](/visualstudio/debugger/remote-debugging-azure), or [Node.js](configure-language-nodejs.md#debug-remotely) apps. This option turns off automatically after 48 hours.

articles/app-service/overview-tls.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,17 @@ Transport Layer Security (TLS) is a widely adopted security protocol designed to
2929

3030
For incoming requests to your web app, App Service supports TLS versions 1.0, 1.1, 1.2, and 1.3.
3131

32+
### Set Minimum TLS Version
33+
Follow these steps to change the Minimum TLS version of your App Service resource:
34+
1. Browse to your app in the [Azure portal](https://portal.azure.com/)
35+
1. In the left menu, select **configuration** and then select the **General settings** tab.
36+
1. On __Minimum Inbound TLS Version__, using the dropdown, select your desired version.
37+
1. Select **Save** to save the changes.
38+
39+
### Minimum TLS Version with Azure Policy
40+
41+
You can use Azure Policy to help audit your resources when it comes to minimum TLS version. You can refer to [App Service apps should use the latest TLS version policy definition](https://ms.portal.azure.com/#view/Microsoft_Azure_Policy/PolicyDetailBlade/definitionId/%2Fproviders%2FMicrosoft.Authorization%2FpolicyDefinitions%2Ff0e6e85b-9b9f-4a4b-b67b-f730d42f1b0b) and change the values to your desired minimum TLS version. For similar policy definitions for other App Service resources, refer to [List of built-in policy definitions - Azure Policy for App Service](../governance/policy/samples/built-in-policies.md#app-service).
42+
3243
### Minimum TLS Version and SCM Minimum TLS Version
3344

3445
App Service also allows you to set minimum TLS version for incoming requests to your web app and to SCM site. By default, the minimum TLS version for incoming requests to your web app and to SCM would be set to 1.2 on both portal and API.

articles/communication-services/how-tos/calling-sdk/includes/spotlight/spotlight-android.md

Lines changed: 36 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -5,46 +5,30 @@ ms.topic: include
55
ms.date: 06/20/2023
66
ms.author: cnwankwo
77
---
8-
[!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
9-
10-
Communication Services or Microsoft 365 users can call the spotlight APIs based on role type and conversation type
11-
12-
**In a one to one call or group call scenario, the following APIs are supported for both Communication Services and Microsoft 365 users**
138

14-
|APIs| Organizer | Presenter | Attendee |
15-
|----------------------------------------------|--------|--------|--------|
16-
| startSpotlight | ✔️ | ✔️ | ✔️ |
17-
| stopSpotlight | ✔️ | ✔️ | ✔️ |
18-
| stopAllSpotlight | ✔️ | ✔️ | ✔️ |
19-
| getSpotlightedParticipants | ✔️ | ✔️ | ✔️ |
20-
| maxSupported | ✔️ | ✔️ | ✔️ |
21-
22-
**For meeting scenario the following APIs are supported for both Communication Services and Microsoft 365 users**
9+
[!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
2310

24-
|APIs| Organizer | Presenter | Attendee |
25-
|----------------------------------------------|--------|--------|--------|
26-
| startSpotlight | ✔️ | ✔️ | |
27-
| stopSpotlight | ✔️ | ✔️ | ✔️ |
28-
| stopAllSpotlight | ✔️ | ✔️ | |
29-
| getSpotlightedParticipants | ✔️ | ✔️ | ✔️ |
30-
| maxSupported | ✔️ | ✔️ | ✔️ |
11+
## Implement spotlight
3112

32-
Spotlight is an extended feature of the core `Call` API. You first need to import calling Features from the Calling SDK:
13+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
3314

3415
```java
3516
import com.azure.android.communication.calling.SpotlightFeature;
3617
```
3718

38-
Then you can get the feature API object from the call instance:
19+
Then you can get the feature API object from the call instance.
3920

4021
```java
4122
SpotlightCallFeature spotlightCallFeature;
4223
spotlightCallFeature = call.feature(Features.SPOTLIGHT);
4324
```
44-
### Start spotlight for participants:
45-
Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
4625

47-
To use this feature, a list of participants identifiers is required
26+
### Start spotlight for participants
27+
28+
Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
29+
30+
You need a list of participant identifiers to use this feature.
31+
4832
```java
4933
List<CommunicationIdentifier> spotlightIdentifiers = new ArrayList<>();
5034
CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
@@ -53,17 +37,21 @@ spotlightIdentifiers.add(new CommunicationUserIdentifier("<USER_ID>"));
5337
spotlightIdentifiers.add(new MicrosoftTeamsUserIdentifier("<USER_ID>"));
5438
spotlightCallFeature.StartSpotlight(spotlightIdentifiers);
5539
```
56-
The following API can also be used to start the spotlight of participants
40+
41+
You can also use the following code to start a participant spotlight.
42+
5743
```java
5844
CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
5945
MicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier(<USER_ID>);
6046
spotlightCallFeature.StartSpotlight(acsUser, teamsUser);
6147
```
6248

6349
### Remove spotlight from participants
64-
Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing
6550

66-
To use this feature, a list of participants identifiers is required
51+
Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing.
52+
53+
You need a list of participants identifiers to use this feature.
54+
6755
```java
6856
List<CommunicationIdentifier> spotlightIdentifiers = new ArrayList<>();
6957
CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
@@ -72,20 +60,29 @@ spotlightIdentifiers.add(new CommunicationUserIdentifier("<USER_ID>"));
7260
spotlightIdentifiers.add(new MicrosoftTeamsUserIdentifier("<USER_ID>"));
7361
spotlightCallFeature.StopSpotlight(spotlightIdentifiers);
7462
```
75-
The following API can also be used to remove the spotlight of participants
63+
64+
You can also use the following code to remove a participant spotlight.
65+
7666
```java
7767
CommunicationUserIdentifier acsUser = new CommunicationUserIdentifier(<USER_ID>);
7868
MicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier(<USER_ID>);
7969
spotlightCallFeature.StopSpotlight(acsUser, teamsUser);
8070
```
71+
8172
### Remove all spotlights
82-
All pinned participants can be unpinned using this API. Only MicrosoftTeamsUserIdentifier users who have an organizer, co-organizer or presenter role can unpin all participants.
73+
74+
All pinned participants can be unpinned using this operation. Only `MicrosoftTeamsUserIdentifier` users who have an organizer, co-organizer, or presenter role can unpin all participants.
75+
8376
```java
8477
spotlightCallFeature.stopAllSpotlight();
8578
```
8679

8780
### Handle changed states
88-
The `Spotlight` API allows you to subscribe to `SpotlightChanged` events. A `SpotlightChanged` event comes from a `call` instance and contains information about newly spotlighted participants and participants whose spotlight were stopped
81+
82+
Spotlight mode enables you to subscribe to `SpotlightChanged` events. A `SpotlightChanged` event comes from a call instance and contains information about newly spotlighted participants and participants whose spotlight stopped. The returned array `SpotlightedParticipant` is sorted by the order the participants were spotlighted.
83+
84+
To get information about all participants with spotlight state changes on the current call, use the following code.
85+
8986
```java
9087
import com.azure.android.communication.calling.SpotlightedParticipant;
9188

@@ -106,8 +103,9 @@ void onSpotlightChanged(SpotlightChangedEvent args) {
106103
spotlightCallFeature.addOnSpotlightChangedListener(onSpotlightChanged);
107104
```
108105

109-
### Get all spotlighted participants:
110-
To get information about all participants that have spotlight state on current call, you can use the following API. The returned array is sorted by the order the participants were spotlighted.
106+
### Get all spotlighted participants
107+
108+
To get information about all participants that have spotlight state on current call, use the following operation. The returned array is sorted by the order the participants were spotlighted.
111109

112110
``` java
113111
List<SpotlightedParticipant> currentSpotlightedParticipants = spotlightCallFeature.getSpotlightedParticipants();
@@ -117,8 +115,10 @@ foreach (SpotlightedParticipant participant in currentSpotlightedParticipants)
117115
}
118116
```
119117

120-
### Get the maximum supported spotlight:
121-
The following API can be used to get the maximum number of participants that can be spotlighted using the Calling SDK
118+
### Get the maximum supported spotlight participants
119+
120+
Use the following operation to get the maximum number of participants that can be spotlighted using the Calling SDK.
121+
122122
``` java
123123
spotlightCallFeature.maxSupported();
124124
```

articles/communication-services/how-tos/calling-sdk/includes/spotlight/spotlight-ios.md

Lines changed: 25 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,9 @@ ms.author: cnwankwo
77
---
88
[!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
99

10-
Communication Services or Microsoft 365 users can call the spotlight APIs based on role type and conversation type
10+
## Implement spotlight
1111

12-
**In a one to one call or group call scenario, the following APIs are supported for both Communication Services and Microsoft 365 users**
13-
14-
|APIs| Organizer | Presenter | Attendee |
15-
|----------------------------------------------|--------|--------|--------|
16-
| startSpotlight | ✔️ | ✔️ | ✔️ |
17-
| stopSpotlight | ✔️ | ✔️ | ✔️ |
18-
| stopAllSpotlight | ✔️ | ✔️ | ✔️ |
19-
| spotlightedParticipants | ✔️ | ✔️ | ✔️ |
20-
| maxSupported | ✔️ | ✔️ | ✔️ |
21-
22-
**For meeting scenario the following APIs are supported for both Communication Services and Microsoft 365 users**
23-
24-
|APIs| Organizer | Presenter | Attendee |
25-
|----------------------------------------------|--------|--------|--------|
26-
| startSpotlight | ✔️ | ✔️ | |
27-
| stopSpotlight | ✔️ | ✔️ | ✔️ |
28-
| stopAllSpotlight | ✔️ | ✔️ | |
29-
| spotlightedParticipants | ✔️ | ✔️ | ✔️ |
30-
| maxSupported | ✔️ | ✔️ | ✔️ |
31-
32-
Spotlight is an extended feature of the core `Call` API. You first need to import calling Features from the Calling SDK:
12+
Spotlight is an extended feature of the core `Call` API. You first need to import calling features from the Calling SDK.
3313

3414
```swift
3515
import AzureCommunicationCalling
@@ -43,10 +23,11 @@ Then you can get the feature API object from the call instance:
4323
spotlightFeature = self.call!.feature(Features.spotlight)
4424
```
4525

46-
### Start spotlight for participants:
47-
Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
26+
### Start spotlight for participants
4827

49-
To use this feature, a list of participants identifiers is required
28+
Any participant in the call or meeting can be pinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can start spotlight for other participants. This action is idempotent, trying to start spotlight on a pinned participant does nothing
29+
30+
You need a list of participant identifiers to use this feature.
5031

5132
```swift
5233
var identifiers : [CommunicationIdentifier] = []
@@ -60,9 +41,11 @@ spotlightFeature.startSpotlight(participants: identifiers, completionHandler: {
6041
```
6142

6243
### Remove spotlight from participants
63-
Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing
6444

65-
To use this feature, a list of participants identifiers is required
45+
Any pinned participant in the call or meeting can be unpinned. Only Microsoft 365 users who have an organizer, co-organizer, or presenter role can unpin other participants. This action is idempotent, trying to stop spotlight on an unpinned participant does nothing.
46+
47+
You need a list of participants identifiers to use this feature.
48+
6649
```swift
6750
var identifiers : [CommunicationIdentifier] = []
6851
identifiers.append(CommunicationUserIdentifier("<USER_ID>"))
@@ -75,7 +58,9 @@ spotlightFeature.stopSpotlight(participants: identifiers, completionHandler: { (
7558
```
7659

7760
### Remove all spotlights
78-
All pinned participants can be unpinned using this API. Only MicrosoftTeamsUserIdentifier users who have an organizer, co-organizer or presenter role can unpin all participants.
61+
62+
All pinned participants can be unpinned using this operation. Only `MicrosoftTeamsUserIdentifier` users who have an organizer, co-organizer, or presenter role can unpin all participants.
63+
7964
```swift
8065
spotlightFeature.stopAllSpotlight(completionHandler: { (error) in
8166
if let error = error {
@@ -85,7 +70,11 @@ spotlightFeature.stopAllSpotlight(completionHandler: { (error) in
8570
```
8671

8772
### Handle changed states
88-
The `Spotlight` API allows you to subscribe to `SpotlightChanged` events. A `SpotlightChanged` event comes from a `call` instance and contains information about newly spotlighted participants and participants whose spotlight were stopped
73+
74+
Spotlight mode enables you to subscribe to `SpotlightChanged` events. A `SpotlightChanged` event comes from a call instance and contains information about newly spotlighted participants and participants whose spotlight stopped. The returned array `SpotlightedParticipant` is sorted by the order the participants were spotlighted.
75+
76+
To get information about all participants with spotlight state changes on the current call, use the following code.
77+
8978
```swift
9079
// event : { added: SpotlightedParticipant[]; removed: SpotlightedParticipant[] }
9180
// SpotlightedParticipant = { identifier: CommunicationIdentifier }
@@ -107,17 +96,20 @@ public class SpotlightDelegate: SpotlightCallFeatureDelegate {
10796
}
10897
```
10998

110-
### Get all spotlighted participants:
111-
To get information about all participants that have spotlight state on current call, you can use the following API. The returned array is sorted by the order the participants were spotlighted.
99+
### Get all spotlighted participants
100+
101+
To get information about all participants that have spotlight state on the current call, use the following operation. The returned array is sorted by the order the participants were spotlighted.
112102

113103
``` swift
114104
spotlightCallFeature.spotlightedParticipants.forEach { participant in
115105
print("Spotlight active for participant: " + Utilities.toMri(participant.identifier))
116106
}
117107
```
118108

119-
### Get the maximum supported spotlight:
120-
The following API can be used to get the maximum number of participants that can be spotlighted using the Calling SDK
109+
### Get the maximum supported spotlight participants
110+
111+
Use the following operation to get the maximum number of participants that can be spotlighted using the Calling SDK.
112+
121113
``` swift
122114
spotlightCallFeature.maxSupported();
123115
```

0 commit comments

Comments
 (0)