Skip to content

Commit b7043f6

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents ad1a994 + 980c3d8 commit b7043f6

File tree

192 files changed

+3117
-2332
lines changed

Some content is hidden

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

192 files changed

+3117
-2332
lines changed

.openpublishing.redirection.json

Lines changed: 46 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1995,6 +1995,26 @@
19951995
"redirect_url": "/azure/cognitive-services/bing-video-search/quickstarts/client-libraries?pivots=programming-language-python",
19961996
"redirect_document_id": false
19971997
},
1998+
{
1999+
"source_path": "articles/cognitive-services/bing-visual-search/visual-search-sdk-c-sharp.md",
2000+
"redirect_url": "/azure/cognitive-services/bing-visual-search/quickstarts/client-libraries?pivots=programming-language-csharp",
2001+
"redirect_document_id": false
2002+
},
2003+
{
2004+
"source_path": "articles/cognitive-services/bing-visual-search/visual-search-sdk-java.md",
2005+
"redirect_url": "/azure/cognitive-services/bing-visual-search/quickstarts/client-libraries?pivots=programming-language-java",
2006+
"redirect_document_id": false
2007+
},
2008+
{
2009+
"source_path": "articles/cognitive-services/bing-visual-search/visual-search-sdk-node.md",
2010+
"redirect_url": "/azure/cognitive-services/bing-visual-search/quickstarts/client-libraries?pivots=programming-language-javascript",
2011+
"redirect_document_id": false
2012+
},
2013+
{
2014+
"source_path": "articles/cognitive-services/bing-visual-search/visual-search-sdk-python.md",
2015+
"redirect_url": "/azure/cognitive-services/bing-visual-search/quickstarts/client-libraries?pivots=programming-language-python",
2016+
"redirect_document_id": false
2017+
},
19982018
{
19992019
"source_path": "articles/virtual-machines/linux/classic/rdma-cluster.md",
20002020
"redirect_url": "/azure/virtual-machines/linux/sizes-hpc#rdma-capable-instances",
@@ -2902,7 +2922,7 @@
29022922
},
29032923
{
29042924
"source_path": "articles/machine-learning/service/overview-more-machine-learning.md",
2905-
"redirect_url": "/azure/architecture/data-guide/technology-choices/data-science-and-machine-learning",
2925+
"redirect_url": "https://docs.microsoft.com/azure/architecture/data-guide/technology-choices/data-science-and-machine-learning",
29062926
"redirect_document_id": false
29072927
},
29082928
{
@@ -2982,7 +3002,7 @@
29823002
},
29833003
{
29843004
"source_path": "articles/machine-learning/service/support-for-aml-services.md",
2985-
"redirect_url": "https://aka.ms/aml-forum-service",
3005+
"redirect_url": "https://social.msdn.microsoft.com/Forums/home?forum=AzureMachineLearningService",
29863006
"redirect_document_id": false
29873007
},
29883008
{
@@ -3072,17 +3092,17 @@
30723092
},
30733093
{
30743094
"source_path": "articles/machine-learning/studio/live-chat.md",
3075-
"redirect_url": "https://social.msdn.microsoft.com/Forums/en-US/home?forum=MachineLearning",
3095+
"redirect_url": "https://social.msdn.microsoft.com/Forums/home?forum=MachineLearning",
30763096
"redirect_document_id": false
30773097
},
30783098
{
30793099
"source_path": "articles/machine-learning/studio/datamarket-deprecation.md",
3080-
"redirect_url": "https://microsoft.com/cognitive",
3100+
"redirect_url": "https://azure.microsoft.com/services/cognitive-services/",
30813101
"redirect_document_id": false
30823102
},
30833103
{
30843104
"source_path": "articles/machine-learning/r-developers-guide.md",
3085-
"redirect_url": "/azure/architecture/data-guide/technology-choices/r-developers-guide",
3105+
"redirect_url": "https://docs.microsoft.com/azure/architecture/data-guide/technology-choices/r-developers-guide",
30863106
"redirect_document_id": false
30873107
},
30883108
{
@@ -5110,6 +5130,11 @@
51105130
"redirect_url": "/azure/active-directory/develop/msal-overview",
51115131
"redirect_document_id": true
51125132
},
5133+
{
5134+
"source_path": "articles/active-directory/develop/shared-device-mode.md",
5135+
"redirect_url": "/azure/active-directory/develop/msal-android-shared-devices",
5136+
"redirect_document_id": true
5137+
},
51135138
{
51145139
"source_path": "articles/azure-resource-manager/resource-group-authenticate-service-principal.md",
51155140
"redirect_url": "/azure/active-directory/develop/howto-authenticate-service-principal-powershell",
@@ -15156,7 +15181,7 @@
1515615181
},
1515715182
{
1515815183
"source_path": "articles/machine-learning/service/how-to-create-portal-experiments.md",
15159-
"redirect_url": "/azure/machine-learning/how-to-create-portal-experiments",
15184+
"redirect_url": "/azure/machine-learning/tutorial-first-experiment-automated-ml",
1516015185
"redirect_document_id": false
1516115186
},
1516215187
{
@@ -47324,6 +47349,11 @@
4732447349
"redirect_url": "https://feedback.azure.com/forums/169401-azure-active-directory?category_id=160593",
4732547350
"redirect_document_id": false
4732647351
},
47352+
{
47353+
"source_path": "articles/active-directory-domain-services/compatible-software.md",
47354+
"redirect_url": "/azure/active-directory-domain-services/overview",
47355+
"redirect_document_id": false
47356+
},
4732747357
{
4732847358
"source_path": "articles/active-directory-domain-services/active-directory-ds-troubleshooting.md",
4732947359
"redirect_url": "/azure/active-directory-domain-services/troubleshoot",
@@ -50498,6 +50528,16 @@
5049850528
{
5049950529
"source_path": "articles/sql-database/sql-database-managed-instance-index.yml",
5050050530
"redirect_url": "/azure/sql-database/sql-database-managed-instance"
50531+
},
50532+
{
50533+
"source_path": "articles/aks/integrate-azure.md",
50534+
"redirect_url": "/azure/aks/",
50535+
"redirect_document_id": false
50536+
},
50537+
{
50538+
"source_path": "articles/aks/use-cosmosdb-osba-mongo-app.md",
50539+
"redirect_url": "/azure/aks/",
50540+
"redirect_document_id": false
5050150541
}
5050250542
]
5050350543
}

articles/active-directory-domain-services/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,8 +145,6 @@
145145
href: faqs.md
146146
- name: Service updates
147147
href: https://azure.microsoft.com/updates/?product=active-directory-ds
148-
- name: Compatible third-party software
149-
href: compatible-software.md
150148
- name: Pricing
151149
href: https://azure.microsoft.com/pricing/details/active-directory-ds/
152150
- name: Azure AD feedback forum

articles/active-directory-domain-services/compatible-software.md

Lines changed: 0 additions & 41 deletions
This file was deleted.

articles/active-directory/develop/TOC.yml

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -223,8 +223,12 @@
223223
href: scenario-mobile-app-configuration.md
224224
- name: Mobile platforms specific config
225225
items:
226+
- name: Microsoft Enterprise SSO plug-in for Apple devices
227+
href: apple-sso-plugin.md
226228
- name: Shared device mode for Android devices
227-
href: shared-device-mode.md
229+
href: msal-android-shared-devices.md
230+
- name: Shared device mode for iOS devices
231+
href: msal-ios-shared-devices.md
228232
- name: Xamarin Android
229233
href: msal-net-xamarin-android-considerations.md
230234
- name: System browser on Android
@@ -312,6 +316,17 @@
312316
href: msal-handling-exceptions.md
313317
- name: Logging
314318
href: msal-logging.md
319+
- name: Shared devices
320+
items:
321+
- name: Overview - shared devices
322+
href: msal-shared-devices.md
323+
displayName: shared device mode, firstline worker, frontline worker
324+
- name: Shared device mode for iOS devices
325+
href: msal-ios-shared-devices.md
326+
displayName: firstline worker, frontline worker
327+
- name: Shared device mode for Android devices
328+
href: msal-android-shared-devices.md
329+
displayName: firstline worker, frontline worker
315330
- name: Single sign-on
316331
displayName: SSO
317332
items:
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: Microsoft Enterprise SSO plug-in for Apple devices
3+
titleSuffix: Microsoft identity platform | Azure
4+
description: Learn about Microsoft's Azure Active Directory SSO plug-in for iOS and macOS devices.
5+
services: active-directory
6+
author: brandwe
7+
manager: CelesteDG
8+
9+
ms.service: active-directory
10+
ms.subservice: develop
11+
ms.topic: conceptual
12+
ms.workload: identity
13+
ms.date: 03/31/2020
14+
ms.author: brandwe
15+
ms.reviewer: brandwe
16+
ms.custom: aaddev
17+
---
18+
19+
# Microsoft Enterprise SSO plug-in for Apple devices (Preview)
20+
21+
> [!NOTE]
22+
> This feature is in public preview.
23+
> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
24+
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
25+
26+
The *Microsoft Enterprise SSO plug-in for Apple devices* provides single sign-on (SSO) for Active Directory accounts across all applications that support Apple's [Enterprise Single Sign-On](https://developer.apple.com/documentation/authenticationservices) feature. Microsoft worked closely with Apple to develop this plug-in to increase your application's usability while providing the best protection that Apple and Microsoft can provide.
27+
28+
In this Public Preview release, the Enterprise SSO plug-in is available only for iOS devices and is distributed in certain Microsoft applications.
29+
30+
Our first use of the Enterprise SSO plug-in is with our new [shared device mode](msal-ios-shared-devices.md) feature.
31+
32+
## Features
33+
34+
The Microsoft Enterprise SSO plug-in for Apple devices offers the following benefits:
35+
36+
- Provides SSO for Active Directory accounts across all applications that support Apple's Enterprise Single Sign-On feature.
37+
- Delivered automatically in the Microsoft Authenticator and can be enabled by any mobile device management (MDM) solution.
38+
39+
## Requirements
40+
41+
To use Microsoft Enterprise SSO plug-in for Apple devices:
42+
43+
- iOS 13.0 or higher must be installed on the device.
44+
- A Microsoft application that provides the Microsoft Enterprise SSO plug-in for Apple devices must be installed on the device. For Public Preview, these applications include the [Microsoft Authenticator app](../user-help/user-help-auth-app-overview.md).
45+
- Device must be MDM-enrolled (for example, with Microsoft Intune).
46+
- Configuration must be pushed to the device to enable the Microsoft Enterprise SSO plug-in for Apple devices on the device. This security constraint is required by Apple.
47+
48+
## Enable the SSO extension with mobile device management (MDM)
49+
50+
To enable the Microsoft Enterprise SSO plug-in for Apple devices, your devices need to be sent a signal through an MDM service. Since Microsoft includes the Enterprise SSO plug-in in the [Microsoft Authenticator app](..//user-help/user-help-auth-app-overview.md), use your MDM to configure the app to enable the Microsoft Enterprise SSO plug-in.
51+
52+
Use the following parameters to configure the Microsoft Enterprise SSO plug-in for Apple devices:
53+
54+
- **Type**: Redirect
55+
- **Extension ID**: `com.microsoft.azureauthenticator.ssoextension`
56+
- **Team ID**: `SGGM6D27TK`
57+
- **URLs**:
58+
- `https://login.microsoftonline.com`
59+
- `https://login.windows.net`
60+
- `https://login.microsoft.com`
61+
- `https://sts.windows.net`
62+
- `https://login.partner.microsoftonline.cn`
63+
- `https://login.chinacloudapi.cn`
64+
- `https://login.microsoftonline.de`
65+
- `https://login.microsoftonline.us`
66+
- `https://login.usgovcloudapi.net`
67+
- `https://login-us.microsoftonline.com`
68+
69+
You can use Microsoft Intune as your MDM service to ease configuration of the Microsoft Enterprise SSO plug-in. For more information, see the [Intune configuration documentation](https://docs.microsoft.com/intune/configuration/ios-device-features-settings).
70+
71+
## Using the SSO extension in your application
72+
73+
The [Microsoft Authentication Library (MSAL) for Apple devices](https://github.com/AzureAD/microsoft-authentication-library-for-objc) version 1.1.0 and higher supports the Microsoft Enterprise SSO plug-in for Apple devices.
74+
75+
If you'd like to support shared device mode provided by the Microsoft Enterprise SSO plug-in for Apple devices, ensure your applications use the specified minimum required version of MSAL.
76+
77+
## Next steps
78+
79+
For more information about shared device mode on iOS, see [Shared device mode for iOS devices](msal-ios-shared-devices.md).

articles/active-directory/develop/customize-webviews.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -18,34 +18,43 @@ ms.custom: aaddev
1818

1919
# How to: Customize browsers and WebViews for iOS/macOS
2020

21-
A web browser is required for interactive authentication. On iOS, the Microsoft Authentication Library (MSAL) uses the system web browser by default (which might appear on top of your app) to do interactive authentication to sign in users. Using the system browser has the advantage of sharing the Single Sign On (SSO) state with other applications and with web applications.
21+
A web browser is required for interactive authentication. On iOS and macOS 10.15+, the Microsoft Authentication Library (MSAL) uses the system web browser by default (which might appear on top of your app) to do interactive authentication to sign in users. Using the system browser has the advantage of sharing the Single Sign On (SSO) state with other applications and with web applications.
2222

2323
You can change the experience by customizing the configuration to other options for displaying web content, such as:
2424

2525
For iOS only:
2626

27-
- [ASWebAuthenticationSession](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession?language=objc)
2827
- [SFAuthenticationSession](https://developer.apple.com/documentation/safariservices/sfauthenticationsession?language=objc)
2928
- [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller?language=objc)
3029

3130
For iOS and macOS:
3231

32+
- [ASWebAuthenticationSession](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession?language=objc)
3333
- [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview?language=objc).
3434

35-
MSAL for macOS only supports `WKWebView`.
35+
MSAL for macOS only supports `WKWebView` on older OS versions. `ASWebAuthenticationSession` is only supported on macOS 10.15 and above.
3636

3737
## System browsers
3838

39-
For iOS, `ASWebAuthenticationSession`, `SFAuthenticationSession`, and `SFSafariViewController` are considered system browsers. In general, system browsers share cookies and other website data with the Safari browser application.
39+
For iOS, `ASWebAuthenticationSession`, `SFAuthenticationSession`, and `SFSafariViewController` are considered system browsers. For macOS, only `ASWebAuthenticationSession` is available. In general, system browsers share cookies and other website data with the Safari browser application.
4040

4141
By default, MSAL will dynamically detect iOS version and select the recommended system browser available on that version. On iOS 12+ it will be `ASWebAuthenticationSession`.
4242

43+
### Default configuration for iOS
44+
4345
| Version | Web browser |
4446
|:-------------:|:-------------:|
4547
| iOS 12+ | ASWebAuthenticationSession |
4648
| iOS 11 | SFAuthenticationSession |
4749
| iOS 10 | SFSafariViewController |
4850

51+
### Default configuration for macOS
52+
53+
| Version | Web browser |
54+
|:-------------:|:-------------:|
55+
| macOS 10.15+ | ASWebAuthenticationSession |
56+
| other versions | WKWebView |
57+
4958
Developers can also select a different system browser for MSAL apps:
5059

5160
- `SFAuthenticationSession` is the iOS 11 version of `ASWebAuthenticationSession`.
@@ -61,7 +70,7 @@ The browser you use impacts the SSO experience because of how they share cookies
6170

6271
| Technology | Browser Type | iOS availability | macOS availability | Shares cookies and other data | MSAL availability | SSO |
6372
|:-------------:|:-------------:|:-------------:|:-------------:|:-------------:|:-------------:|-------------:|
64-
| [ASWebAuthenticationSession](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession) | System | iOS12 and up | macOS 10.15 and up | Yes | iOS only | w/ Safari instances
73+
| [ASWebAuthenticationSession](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession) | System | iOS12 and up | macOS 10.15 and up | Yes | iOS and macOS 10.15+ | w/ Safari instances
6574
| [SFAuthenticationSession](https://developer.apple.com/documentation/safariservices/sfauthenticationsession) | System | iOS11 and up | N/A | Yes | iOS only | w/ Safari instances
6675
| [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) | System | iOS11 and up | N/A | No | iOS only | No**
6776
| **SFSafariViewController** | System | iOS10 | N/A | Yes | iOS only | w/ Safari instances
@@ -134,21 +143,26 @@ All MSAL supported web browser types are declared in the [MSALWebviewType enum](
134143
```objc
135144
typedef NS_ENUM(NSInteger, MSALWebviewType)
136145
{
137-
#if TARGET_OS_IPHONE
138-
// For iOS 11 and up, uses AuthenticationSession (ASWebAuthenticationSession
139-
// or SFAuthenticationSession).
140-
// For older versions, with AuthenticationSession not being available, uses
141-
// SafariViewController.
146+
/**
147+
For iOS 11 and up, uses AuthenticationSession (ASWebAuthenticationSession or SFAuthenticationSession).
148+
For older versions, with AuthenticationSession not being available, uses SafariViewController.
149+
For macOS 10.15 and above uses ASWebAuthenticationSession
150+
For older macOS versions uses WKWebView
151+
*/
142152
MSALWebviewTypeDefault,
143153

144-
// Use SFAuthenticationSession/ASWebAuthenticationSession
154+
/** Use ASWebAuthenticationSession where available.
155+
On older iOS versions uses SFAuthenticationSession
156+
Doesn't allow any other webview type, so if either of these are not present, fails the request*/
145157
MSALWebviewTypeAuthenticationSession,
146158

147-
// Use SFSafariViewController for all versions.
159+
#if TARGET_OS_IPHONE
160+
161+
/** Use SFSafariViewController for all versions. */
148162
MSALWebviewTypeSafariViewController,
149163

150164
#endif
151-
// Use WKWebView
165+
/** Use WKWebView */
152166
MSALWebviewTypeWKWebView,
153167
};
154168
```

articles/active-directory/develop/howto-create-service-principal-portal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: CelesteDG
99
ms.service: active-directory
1010
ms.subservice: develop
1111
ms.topic: conceptual
12-
ms.date: 02/26/2020
12+
ms.date: 04/01/2020
1313
ms.author: ryanwi
1414
ms.reviewer: tomfitz
1515
ms.custom: aaddev, seoapril2019, identityplatformtop40
@@ -95,7 +95,7 @@ Export this certificate to a file using the [Manage User Certificate](/dotnet/fr
9595

9696
1. To view your certificates, under **Certificates - Current User** in the left pane, expand the **Personal** directory.
9797
1. Right-click on the cert you created, select **All tasks->Export**.
98-
1. Follow the Certificate Export wizard. Export the private key, specify a password for the cert file, and export to a file.
98+
1. Follow the Certificate Export wizard. Do not export the private key, and export to a .CER file.
9999

100100
To upload the certificate:
101101

0 commit comments

Comments
 (0)