Skip to content

Commit cbbaa03

Browse files
committed
fixed acrolinx issues
1 parent d6707ec commit cbbaa03

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/active-directory/authentication/concept-certificate-based-authentication-mobile-ios.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,15 @@ This topic covers Azure Active Directory (Azure AD) certificate-based authentica
2424

2525
Devices that run macOS can use CBA to authenticate against Azure AD by using their X.509 client certificate. Azure AD CBA is supported with certificates on-device and external hardware protected security keys. On macOS, Azure AD CBA is supported on all browsers and on Microsoft first-party applications.
2626

27-
**Browsers supported on macOS**
27+
### Browsers supported on macOS
2828

2929
|Edge | Chrome | Safari | Firefox |
3030
|--------|---------|------|-------|
3131
|✅ |✅ | ✅ |✅ |
3232

33-
**macOS device sign in with Azure AD CBA**
33+
### macOS device sign-in with Azure AD CBA
3434

35-
Azure AD CBA today is not supported for device based sign into macOS machines. While the certificate used to sign-into the device may be the same certificate used to subsequently authenticate to Azure AD from a browser/desktop application, the device sign-in itself is not supported against Azure AD yet. 
35+
Azure AD CBA today isn't supported for device-based sign-in to macOS machines. The certificate used to sign in to the device can be the same certificate used to authenticate to Azure AD from a browser or desktop application, but the device sign-in itself isn't supported against Azure AD yet. 
3636

3737
## Azure Active Directory certificate-based authentication on iOS devices
3838
Devices that run iOS can use certificate-based authentication (CBA) to authenticate to Azure Active Directory (Azure AD) using a client certificate on their device when connecting to:
@@ -55,7 +55,7 @@ On-device certificates are provisioned on the device. Customers can use Mobile D
5555

5656
- Only native browsers are supported
5757
- Applications using latest MSAL libraries or Microsoft Authenticator can do CBA
58-
- Edge with profile, when users add account and logged in a profile will support CBA
58+
- Edge with profile, when users add account and logged in a profile support CBA
5959
- Microsoft first party apps with latest MSAL libraries or Microsoft Authenticator can do CBA
6060

6161
### Browsers
@@ -91,7 +91,7 @@ To determine if your email application supports Azure AD CBA, contact your appli
9191
Certificates can be provisioned in external devices like hardware security keys along with a PIN to protect private key access.
9292
Microsoft's mobile certificate-based solution coupled with the hardware security keys is a simple, convenient, FIPS (Federal Information Processing Standards) certified phishing-resistant MFA method.
9393

94-
As for iOS 16/iPadOS 16.1, Apple devices provide native driver support for USB-C or Lightning connected CCID-compliant smart cards. This means Apple devices on iOS 16/iPadOS 16.1 will see a USB-C or Lightning connected CCID-compliant device as a smart card without the use of additional drivers or third-party apps. Azure AD CBA will work on these USB-A or USB-C, or Lightning connected CCID-compliant smart cards.
94+
As for iOS 16/iPadOS 16.1, Apple devices provide native driver support for USB-C or Lightning connected CCID-compliant smart cards. This means Apple devices on iOS 16/iPadOS 16.1 see a USB-C or Lightning connected CCID-compliant device as a smart card without the use of additional drivers or third-party apps. Azure AD CBA works on these USB-A, USB-C, or Lightning connected CCID-compliant smart cards.
9595

9696

9797
### Advantages of certificates on hardware security key
@@ -106,7 +106,7 @@ Security keys with certificates:
106106

107107
### Azure AD CBA on iOS mobile with YubiKey
108108

109-
Even though the native Smartcard/CCID driver is available on iOS/iPadOS for Lightning connected CCID-compliant smart cards, the YubiKey 5Ci Lightning connector is not seen as a connected smart card on these devices without the use of PIV (Personal Identity Verification) middleware like the Yubico Authenticator.
109+
Even though the native Smartcard/CCID driver is available on iOS/iPadOS for Lightning connected CCID-compliant smart cards, the YubiKey 5Ci Lightning connector isn't seen as a connected smart card on these devices without the use of PIV (Personal Identity Verification) middleware like the Yubico Authenticator.
110110

111111
### One-time registration prerequisite
112112

@@ -119,7 +119,7 @@ Even though the native Smartcard/CCID driver is available on iOS/iPadOS for Ligh
119119
1. Install the latest Microsoft Authenticator app.
120120
1. Open Outlook and plug in your YubiKey.
121121
1. Select **Add account** and enter your user principal name (UPN).
122-
1. Click **Continue** and the iOS certificate picker will appear.
122+
1. Click **Continue** and the iOS certificate picker appears.
123123
1. Select the public certificate copied from YubiKey that is associated with the user’s account.
124124
1. Click **YubiKey required** to open the YubiKey authenticator app.
125125
1. Enter the PIN to access YubiKey and select the back button at the top left corner.
@@ -128,18 +128,18 @@ The user should be successfully logged in and redirected to the Outlook homepage
128128

129129
### Troubleshoot certificates on hardware security key
130130

131-
#### What will happen if the user has certificates both on the iOS device and YubiKey?
131+
#### What happens if the user has certificates both on the iOS device and YubiKey?
132132

133-
The iOS certificate picker will show all the certificates on both iOS device and the ones copied from YubiKey into iOS device. Depending on the certificate user picks they will be either taken to YubiKey authenticator to enter PIN or directly authenticated.
133+
The iOS certificate picker shows all the certificates on both iOS device and the ones copied from YubiKey into iOS device. Depending on the certificate user picks, they may be taken to YubiKey authenticator to enter a PIN, or directly authenticated.
134134

135135
#### My YubiKey is locked after incorrectly typing PIN 3 times. How do I fix it?
136136

137137
- Users should see a dialog informing you that too many PIN attempts have been made. This dialog also pops up during subsequent attempts to select **Use Certificate or smart card**.
138138
- [YubiKey Manager](https://www.yubico.com/support/download/yubikey-manager/) can reset a YubiKey’s PIN.
139139

140-
#### Once CBA fails, clicking on the CBA option again in the ‘Other ways to signin’ link on the error page fails.
140+
#### After CBA fails, the CBA option in the ‘Other ways to sign in’ link also fails. Is there a workaround?
141141

142-
This issue happens because of certificate caching. We are working to add a fix to clear the cache. As a workaround, clicking cancel and restarting the login flow will let the user choose a new certificate and successfully login.
142+
This issue happens because of certificate caching. We're working on an update to clear the cache. As a workaround, click **Cancel**, retry sign-in, and choose a new certificate.
143143

144144
#### Azure AD CBA with YubiKey is failing. What information would help debug the issue?
145145

@@ -151,9 +151,9 @@ This issue happens because of certificate caching. We are working to add a fix t
151151

152152
#### How can I enforce phishing-resistant MFA using a hardware security key on browser-based applications on mobile?
153153

154-
Certificate based authentication and Conditional Access authentication strength capability makes it powerful for customers to enforce authentication needs. Edge as a profile (add an account) will work with a hardware security key like YubiKey and conditional access policy with authentication strength capability can enforce phishing-resistant authentication with CBA.
154+
Certificate-based authentication and Conditional Access authentication strength capability makes it powerful for customers to enforce authentication needs. Edge as a profile (add an account) works with a hardware security key like YubiKey and a Conditional Access policy with authentication strength capability can enforce phishing-resistant authentication with CBA.
155155

156-
CBA support for YubiKey is available in the latest Microsoft Authentication Library (MSAL) libraries, any third-party application that integrates the latest MSAL, and all Microsoft first party applications can leverage CBA and Conditional Access authentication strength.
156+
CBA support for YubiKey is available in the latest Microsoft Authentication Library (MSAL) libraries, and any third-party application that integrates the latest MSAL. All Microsoft first-party applications can use CBA and Conditional Access authentication strength.
157157

158158
### Supported operating systems
159159

@@ -175,7 +175,7 @@ CBA support for YubiKey is available in the latest Microsoft Authentication Libr
175175

176176
## Known issue
177177

178-
On iOS, users will see a "double prompt", where they must click the option to use certificate-based authentication twice. We're working to create a seamless user experience.
178+
On iOS, users see a "double prompt", where they must click the option to use certificate-based authentication twice. We're working to create a seamless user experience.
179179

180180
## Next steps
181181

0 commit comments

Comments
 (0)