mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-14 06:17:22 +00:00
Merge branch 'master' into autoir-converged
This commit is contained in:
commit
354f33eb49
@ -49,8 +49,8 @@ You install VAMT as part of the Windows Assessment and Deployment Kit (ADK) for
|
|||||||
|
|
||||||
### Install VAMT using the ADK
|
### Install VAMT using the ADK
|
||||||
|
|
||||||
1. Download and open the [Windows 10, version 1903 ADK](https://go.microsoft.com/fwlink/?linkid=2086042) package.
|
1. Download the latest version of [Windows 10 ADK](https://docs.microsoft.com/windows-hardware/get-started/adk-install).
|
||||||
Reminder: There won't be new ADK release for 1909.
|
If an older version is already installed, it is recommended to uninstall the older ADK and install the latest version. Existing VAMT data is maintained in the VAMT database.
|
||||||
2. Enter an install location or use the default path, and then select **Next**.
|
2. Enter an install location or use the default path, and then select **Next**.
|
||||||
3. Select a privacy setting, and then select **Next**.
|
3. Select a privacy setting, and then select **Next**.
|
||||||
4. Accept the license terms.
|
4. Accept the license terms.
|
||||||
|
@ -113,6 +113,7 @@ The following methodology was used to derive these network endpoints:
|
|||||||
|||HTTP|*.windowsupdate.com|
|
|||HTTP|*.windowsupdate.com|
|
||||||
||The following endpoints enable connections to Windows Update, Microsoft Update, and the online services of the Store. If you turn off traffic for these endpoints, the device will not be able to connect to Windows Update and Microsoft Update to help keep the device secure. Also, the device will not be able to acquire and update apps from the Store. These are dependent on also enabling "Device authentication" and "Microsoft Account" endpoints.|HTTPS|*.delivery.mp.microsoft.com|
|
||The following endpoints enable connections to Windows Update, Microsoft Update, and the online services of the Store. If you turn off traffic for these endpoints, the device will not be able to connect to Windows Update and Microsoft Update to help keep the device secure. Also, the device will not be able to acquire and update apps from the Store. These are dependent on also enabling "Device authentication" and "Microsoft Account" endpoints.|HTTPS|*.delivery.mp.microsoft.com|
|
||||||
|||TLSv1.2|*.update.microsoft.com|
|
|||TLSv1.2|*.update.microsoft.com|
|
||||||
|
||The following endpoint is used for compatibility database updates for Windows.|HTTP|adl.windows.com|
|
||||||
||The following endpoint is used for content regulation. If you turn off traffic for this endpoint, the Windows Update Agent will be unable to contact the endpoint and fallback behavior will be used. This may result in content being either incorrectly.|TLSv1.2|tsfe.trafficshaping.dsp.mp.microsoft.com|
|
||The following endpoint is used for content regulation. If you turn off traffic for this endpoint, the Windows Update Agent will be unable to contact the endpoint and fallback behavior will be used. This may result in content being either incorrectly.|TLSv1.2|tsfe.trafficshaping.dsp.mp.microsoft.com|
|
||||||
|Xbox Live|The following endpoint is used for Xbox Live.||[Learn how to turn off traffic to all of the following endpoint(s).]( manage-connections-from-windows-operating-system-components-to-microsoft-services.md#26-microsoft-store)|
|
|Xbox Live|The following endpoint is used for Xbox Live.||[Learn how to turn off traffic to all of the following endpoint(s).]( manage-connections-from-windows-operating-system-components-to-microsoft-services.md#26-microsoft-store)|
|
||||||
|||TLSv1.2|dlassets-ssl.xboxlive.com|
|
|||TLSv1.2|dlassets-ssl.xboxlive.com|
|
||||||
|
@ -25,13 +25,13 @@ ms.reviewer:
|
|||||||
- Hybrid Deployment
|
- Hybrid Deployment
|
||||||
- Certificate Trust
|
- Certificate Trust
|
||||||
|
|
||||||
Windows Hello for Business deployments rely on certificates. Hybrid deployments uses publicly issued server authentication certificates to validate the name of the server to which they are connecting and to encrypt the data that flows them and the client computer.
|
Windows Hello for Business deployments rely on certificates. Hybrid deployments use publicly-issued server authentication certificates to validate the name of the server to which they are connecting and to encrypt the data that flows between them and the client computer.
|
||||||
|
|
||||||
All deployments use enterprise issued certificates for domain controllers as a root of trust. Hybrid certificate trust deployments issue users sign-in certificate that enables them to authenticate using Windows Hello for Business credentials to non-Windows Server 2016 domain controllers. Additionally, hybrid certificate trust deployments issue certificate to registration authorities to provide defense-in-depth security for issuing user authentication certificates.
|
All deployments use enterprise issued certificates for domain controllers as a root of trust. Hybrid certificate trust deployments issue users with a sign-in certificate that enables them to authenticate using Windows Hello for Business credentials to non-Windows Server 2016 domain controllers. Additionally, hybrid certificate trust deployments issue certificates to registration authorities to provide defense-in-depth security when issuing user authentication certificates.
|
||||||
|
|
||||||
## Certificate Templates
|
## Certificate Templates
|
||||||
|
|
||||||
This section has you configure certificate templates on your Windows Server 2012 or later issuing certificate authority.
|
This section has you configure certificate templates on your Windows Server 2012 (or later) Active Directory Certificate Services issuing certificate authority.
|
||||||
|
|
||||||
### Domain Controller certificate template
|
### Domain Controller certificate template
|
||||||
|
|
||||||
@ -45,7 +45,7 @@ By default, the Active Directory Certificate Authority provides and publishes th
|
|||||||
|
|
||||||
Sign-in a certificate authority or management workstations with _Domain Admin_ equivalent credentials.
|
Sign-in a certificate authority or management workstations with _Domain Admin_ equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Right-click **Certificate Templates** and click **Manage**.
|
2. Right-click **Certificate Templates** and click **Manage**.
|
||||||
|
|
||||||
@ -66,15 +66,15 @@ Sign-in a certificate authority or management workstations with _Domain Admin_ e
|
|||||||
|
|
||||||
#### Configure Certificate Superseding for the Domain Controller Authentication (Kerberos) Certificate Template
|
#### Configure Certificate Superseding for the Domain Controller Authentication (Kerberos) Certificate Template
|
||||||
|
|
||||||
Many domain controllers may have an existing domain controller certificate. The Active Directory Certificate Services provides a default certificate template for domain controllers--the domain controller certificate template. Later releases provided a new certificate template--the domain controller authentication certificate template. These certificate templates were provided prior to update of the Kerberos specification that stated Key Distribution Centers (KDCs) performing certificate authentication needed to include the **KDC Authentication** extension.
|
Many domain controllers may have an existing domain controller certificate. Active Directory Certificate Services provides a default certificate template for domain controllers--the Domain Controller certificate template. Later releases provided a new certificate template--the Domain Controller Authentication certificate template. These certificate templates were provided prior to update of the Kerberos specification that stated Key Distribution Centers (KDCs) performing certificate authentication needed to include the **KDC Authentication** extension.
|
||||||
|
|
||||||
The Kerberos Authentication certificate template is the most current certificate template designated for domain controllers and should be the one you deploy to all your domain controllers (2008 or later).
|
The Kerberos Authentication certificate template is the most current certificate template designated for domain controllers, and should be the one you deploy to all your domain controllers (2008 or later).
|
||||||
|
|
||||||
The auto-enrollment feature in Windows enables you to effortlessly replace these domain controller certificates. You can use the following configuration to replace older domain controller certificates with a new certificate using the Kerberos Authentication certificate template.
|
The auto-enrollment feature in Windows enables you to effortlessly replace these domain controller certificates. You can use the following configuration to replace older domain controller certificates with a new certificate based on the Kerberos Authentication certificate template.
|
||||||
|
|
||||||
Sign-in a certificate authority or management workstations with _Enterprise Admin_ equivalent credentials.
|
Sign-in a certificate authority or management workstations with _Enterprise Admin_ equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Right-click **Certificate Templates** and click **Manage**.
|
2. Right-click **Certificate Templates** and click **Manage**.
|
||||||
|
|
||||||
@ -86,31 +86,32 @@ Sign-in a certificate authority or management workstations with _Enterprise Admi
|
|||||||
|
|
||||||
6. From the **Add Superseded Template** dialog, select the **Domain Controller Authentication** certificate template and click **OK**.
|
6. From the **Add Superseded Template** dialog, select the **Domain Controller Authentication** certificate template and click **OK**.
|
||||||
|
|
||||||
7. From the **Add Superseded Template dialog**, select the **Kerberos Authentication** certificate template and click **OK**.
|
7. From the **Add Superseded Template dialog**, select the **Kerberos Authentication** certificate template, and click **OK**.
|
||||||
|
|
||||||
8. Add any other enterprise certificate templates that were previously configured for domain controllers to the **Superseded Templates** tab.
|
8. Add any other enterprise certificate templates that were previously configured for domain controllers to the **Superseded Templates** tab.
|
||||||
|
|
||||||
9. Click **OK** and close the **Certificate Templates** console.
|
9. Click **OK** and close the **Certificate Templates** console.
|
||||||
|
|
||||||
The certificate template is configured to supersede all the certificate templates provided in the certificate templates superseded templates list. However, the certificate template and the superseding of certificate templates is not active until you publish the certificate template to one or more certificate authorities.
|
The certificate template is configured to supersede all the certificate templates listed in the superseded templates list. However, the certificate template and the superseding of certificate templates is not active until you publish the certificate template to one or more certificate authorities.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> The domain controller's certificate must chain to a root in the NTAuth store. By default, the Active Directory Certificate Authority's root certificate is added to the NTAuth store. If you are using a third-party CA, this may not be done by default. If the domain controller certificate does not chain to a root in the NTAuth store, user authentication will fail.
|
> A domain controller's certificate must chain to a certificate in the NTAuth store in Active Directory. By default, online "Enterprise" Active Directory Certificate Authority certificates are added to the NTAuth store at installation time. If you are using a third-party CA, this is not done by default. If the domain controller certificate does not chain to a trusted CA in the NTAuth store, user authentication will fail.
|
||||||
|
> You can view an AD forest's NTAuth store (NTAuthCertificates) using PKIVIEW.MSC from an ADCS CA. Open PKIView.msc, then click the Action menu -> Manage AD Containers.
|
||||||
|
|
||||||
### Enrollment Agent certificate template
|
### Enrollment Agent certificate template
|
||||||
|
|
||||||
Active Directory Federation Server used for Windows Hello for Business certificate enrollment performs its own certificate life-cycle management. Once the registration authority is configured with the proper certificate template, the AD FS server attempts to enroll the certificate on the first certificate request or when the service first starts.
|
Active Directory Federation Server used for Windows Hello for Business certificate enrollment performs its own certificate lifecycle management. Once the registration authority is configured with the proper certificate template, the AD FS server attempts to enroll the certificate on the first certificate request, or when the service first starts.
|
||||||
|
|
||||||
Approximately 60 days prior to enrollment agent certificate's expiration, the AD FS service attempts to renew the certificate until it is successful. If the certificate fails to renew, and the certificate expires, the AD FS server will request a new enrollment agent certificate. You can view the AD FS event logs to determine the status of the enrollment agent certificate.
|
Approximately 60 days prior to the enrollment agent certificate's expiration, the AD FS service attempts to renew the certificate until it is successful. If the certificate fails to renew and expires, the AD FS server will request a new enrollment agent certificate. You can view the AD FS event logs to determine the status of the enrollment agent certificate.
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> Follow the procedures below based on the AD FS service account used in your environment.
|
> Follow the procedures below based on the AD FS service account used in your environment.
|
||||||
|
|
||||||
#### Creating an Enrollment Agent certificate for Group Managed Service Accounts
|
#### Creating an Enrollment Agent certificate for Group Managed Service Accounts
|
||||||
|
|
||||||
Sign-in a certificate authority or management workstations with _Domain Admin_ equivalent credentials.
|
Sign-in to a certificate authority or management workstation with _Domain Admin_ equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority Management** console.
|
1. Open the **Certification Authority Management** console.
|
||||||
|
|
||||||
2. Right-click **Certificate Templates** and click **Manage**.
|
2. Right-click **Certificate Templates** and click **Manage**.
|
||||||
|
|
||||||
@ -123,7 +124,7 @@ Sign-in a certificate authority or management workstations with _Domain Admin_ e
|
|||||||
6. On the **Subject** tab, select the **Supply in the request** button if it is not already selected.
|
6. On the **Subject** tab, select the **Supply in the request** button if it is not already selected.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> The preceding step is very important. Group Managed Service Accounts (GMSA) do not support the Build from this Active Directory information option and will result in the AD FS server failing to enroll the enrollment agent certificate. You must configure the certificate template with Supply in the request to ensure that AD FS servers can perform the automatic enrollment and renewal of the enrollment agent certificate.
|
> The preceding step is very important. Group Managed Service Accounts (GMSA) do not support the _Build from this Active Directory information_ option, which will result in the AD FS server failing to enroll the enrollment agent certificate. You must configure the certificate template with _Supply in the request_ to ensure that AD FS servers can perform the automatic enrollment and renewal of the enrollment agent certificate.
|
||||||
|
|
||||||
7. On the **Cryptography** tab, select **Key Storage Provider** from the **Provider Category** list. Select **RSA** from the **Algorithm name** list. Type **2048** in the **Minimum key size** text box. Select **SHA256** from the **Request hash** list.
|
7. On the **Cryptography** tab, select **Key Storage Provider** from the **Provider Category** list. Select **RSA** from the **Algorithm name** list. Type **2048** in the **Minimum key size** text box. Select **SHA256** from the **Request hash** list.
|
||||||
|
|
||||||
@ -139,9 +140,9 @@ Sign-in a certificate authority or management workstations with _Domain Admin_ e
|
|||||||
|
|
||||||
#### Creating an Enrollment Agent certificate for typical Service Accounts
|
#### Creating an Enrollment Agent certificate for typical Service Accounts
|
||||||
|
|
||||||
Sign-in a certificate authority or management workstations with *Domain Admin* equivalent credentials.
|
Sign-in to a certificate authority or management workstation with *Domain Admin* equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Right-click **Certificate Templates** and click **Manage**.
|
2. Right-click **Certificate Templates** and click **Manage**.
|
||||||
|
|
||||||
@ -163,11 +164,11 @@ Sign-in a certificate authority or management workstations with *Domain Admin* e
|
|||||||
|
|
||||||
### Creating Windows Hello for Business authentication certificate template
|
### Creating Windows Hello for Business authentication certificate template
|
||||||
|
|
||||||
During Windows Hello for Business provisioning, the Windows 10, version 1703 client requests an authentication certificate from the Active Directory Federation Service, which requests the authentication certificate on behalf of the user. This task configures the Windows Hello for Business authentication certificate template. You use the name of the certificate template when configuring.
|
During Windows Hello for Business provisioning, a Windows 10 client requests an authentication certificate from the Active Directory Federation Service, which requests an authentication certificate on behalf of the user. This task configures the Windows Hello for Business authentication certificate template. You set the name of the certificate template when configuring it.
|
||||||
|
|
||||||
Sign-in a certificate authority or management workstations with _Domain Admin equivalent_ credentials.
|
Sign-in to a certificate authority or management workstation with _Domain Admin equivalent_ credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Right-click **Certificate Templates** and click **Manage**.
|
2. Right-click **Certificate Templates** and click **Manage**.
|
||||||
|
|
||||||
@ -175,10 +176,10 @@ Sign-in a certificate authority or management workstations with _Domain Admin eq
|
|||||||
|
|
||||||
4. On the **Compatibility** tab, clear the **Show resulting changes** check box. Select **Windows Server 2012** or **Windows Server 2012 R2** from the **Certification Authority** list. Select **Windows Server 2012** or **Windows Server 2012 R2** from the **Certification Recipient** list.
|
4. On the **Compatibility** tab, clear the **Show resulting changes** check box. Select **Windows Server 2012** or **Windows Server 2012 R2** from the **Certification Authority** list. Select **Windows Server 2012** or **Windows Server 2012 R2** from the **Certification Recipient** list.
|
||||||
|
|
||||||
5. On the **General** tab, type **WHFB Authentication** in **Template display name**. Adjust the validity and renewal period to meet your enterprise's needs.
|
5. On the **General** tab, type **WHFB Authentication** or your choice of template name in **Template display name**. Note the short template name for later use with CertUtil. Adjust the validity and renewal period to meet your enterprise's needs.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> If you use different template names, you'll need to remember and substitute these names in different portions of the deployment.
|
> If you use different template names, you'll need to remember and substitute these names in the relevant portions of the deployment.
|
||||||
|
|
||||||
6. On the **Cryptography** tab, select **Key Storage Provider** from the **Provider Category** list. Select **RSA** from the **Algorithm name** list. Type **2048** in the **Minimum key size** text box. Select **SHA256** from the **Request hash** list.
|
6. On the **Cryptography** tab, select **Key Storage Provider** from the **Provider Category** list. Select **RSA** from the **Algorithm name** list. Type **2048** in the **Minimum key size** text box. Select **SHA256** from the **Request hash** list.
|
||||||
|
|
||||||
@ -231,39 +232,39 @@ CertUtil: -dsTemplate command completed successfully."
|
|||||||
```
|
```
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> If you gave your Windows Hello for Business Authentication certificate template a different name, then replace **WHFBAuthentication** in the above command with the name of your certificate template. It's important that you use the template name rather than the template display name. You can view the template name on the **General** tab of the certificate template using the Certificate Template management console (certtmpl.msc). Or, you can view the template name using the **Get-CATemplate** ADCS Administration Windows PowerShell cmdlet on our Windows Server 2012 or later certificate authority.
|
> If you gave your Windows Hello for Business Authentication certificate template a different name, then replace **WHFBAuthentication** in the above command with the name of your certificate template. It's important that you use the template name rather than the template display name. You can view the template name on the **General** tab of the certificate template using the Certificate Template management console (certtmpl.msc). Or, you can view the template name using the **Get-CATemplate** ADCS Administration Windows PowerShell cmdlet on a Windows Server 2012 or later certificate authority.
|
||||||
|
|
||||||
## Publish Templates
|
## Publish Templates
|
||||||
|
|
||||||
### Publish Certificate Templates to a Certificate Authority
|
### Publish Certificate Templates to a Certificate Authority
|
||||||
|
|
||||||
The certificate authority may only issue certificates for certificate templates that are published to that certificate authority. If you have more than one certificate authority and you want that certificate authority to issue certificates based on a specific certificate template, then you must publish the certificate template to all certificate authorities that are expected to issue the certificate.
|
The certificate authority only issues certificates for certificate templates which are published by that certificate authority. If you have more than one certificate authority and you want that certificate authority to issue certificates based on a specific certificate template, then you must publish the certificate template to all certificate authorities that are expected to issue the certificate.
|
||||||
|
|
||||||
#### Publish Certificate Templates to the Certificate Authority
|
#### Publish Certificate Templates to the Certificate Authority
|
||||||
|
|
||||||
Sign-in to the certificate authority or management workstations with an _Enterprise Admin_ equivalent credentials.
|
Sign-in to the certificate authority or management workstations with an _Enterprise Admin_ equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Expand the parent node from the navigation pane.
|
2. Expand the parent node from the navigation pane.
|
||||||
|
|
||||||
3. Click **Certificate Templates** in the navigation pane.
|
3. Click **Certificate Templates** in the navigation pane.
|
||||||
|
|
||||||
4. Right-click the **Certificate Templates** node. Click **New**, and click **Certificate Template** to issue.
|
4. Right-click the **Certificate Templates** node. Click **New**, and click **Certificate Template to issue**.
|
||||||
|
|
||||||
5. In the **Enable Certificates Templates** window, select the **Domain Controller Authentication (Kerberos)**, **WHFB Enrollment Agent** and **WHFB Authentication** templates you created in the previous steps. Click **OK** to publish the selected certificate templates to the certificate authority.
|
5. In the **Enable Certificates Templates** window, Ctrl-select the **Domain Controller Authentication (Kerberos)**, **WHFB Enrollment Agent** and **WHFB Authentication** templates you created in the previous steps. Click **OK** to publish the selected certificate templates to the certificate authority.
|
||||||
|
|
||||||
6. Close the console.
|
6. Close the console.
|
||||||
|
|
||||||
#### Unpublish Superseded Certificate Templates
|
#### Unpublish Superseded Certificate Templates
|
||||||
|
|
||||||
The certificate authority only issues certificates based on published certificate templates. For defense in depth security, it is a good practice to unpublish certificate templates that the certificate authority is not configured to issue. This includes the pre-published certificate template from the role installation and any superseded certificate templates.
|
The certificate authority only issues certificates based on published certificate templates. For defense-in-depth security, it is a good practice to unpublish certificate templates that the certificate authority is not configured to issue. This includes any pre-published certificate templates from the role installation and any superseded certificate templates.
|
||||||
|
|
||||||
The newly created domain controller authentication certificate template supersedes previous domain controller certificate templates. Therefore, you need to unpublish these certificate templates from all issuing certificate authorities.
|
The newly-created Kerberos authentication-based Domain Controller certificate template supersedes any previous domain controller certificate templates. Therefore, you should unpublish these certificate templates from all issuing certificate authorities.
|
||||||
|
|
||||||
Sign-in to the certificate authority or management workstation with _Enterprise Admin_ equivalent credentials.
|
Sign-in to each certificate authority, or a management workstation with _Enterprise Admin_ equivalent credentials.
|
||||||
|
|
||||||
1. Open the **Certificate Authority** management console.
|
1. Open the **Certification Authority** management console.
|
||||||
|
|
||||||
2. Expand the parent node from the navigation pane.
|
2. Expand the parent node from the navigation pane.
|
||||||
|
|
||||||
|
@ -74,8 +74,7 @@ The minimum required Enterprise certificate authority that can be used with Wind
|
|||||||
* The certificate Enhanced Key Usage section must contain Client Authentication (1.3.6.1.5.5.7.3.2), Server Authentication (1.3.6.1.5.5.7.3.1), and KDC Authentication (1.3.6.1.5.2.3.5).
|
* The certificate Enhanced Key Usage section must contain Client Authentication (1.3.6.1.5.5.7.3.2), Server Authentication (1.3.6.1.5.5.7.3.1), and KDC Authentication (1.3.6.1.5.2.3.5).
|
||||||
* The certificate Subject Alternative Name section must contain the Domain Name System (DNS) name.
|
* The certificate Subject Alternative Name section must contain the Domain Name System (DNS) name.
|
||||||
* The certificate template must have an extension that has the value "DomainController", encoded as a [BMPstring](https://docs.microsoft.com/windows/win32/seccertenroll/about-bmpstring). If you are using Windows Server Enterprise Certificate Authority, this extension is already included in the domain controller certificate template.
|
* The certificate template must have an extension that has the value "DomainController", encoded as a [BMPstring](https://docs.microsoft.com/windows/win32/seccertenroll/about-bmpstring). If you are using Windows Server Enterprise Certificate Authority, this extension is already included in the domain controller certificate template.
|
||||||
* The domain controller certificate must be installed in the local computer's certificate store.
|
* The domain controller certificate must be installed in the local computer's certificate store. See [Configure Hybrid Windows Hello for Business: Public Key Infrastructure](https://docs.microsoft.com/windows/security/identity-protection/hello-for-business/hello-hybrid-cert-whfb-settings-pki) for details.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
|
@ -216,7 +216,7 @@ The policy name for these operating systems is **Interactive logon: Require Wind
|
|||||||
When you enable this security policy setting, Windows prevents users from signing in or unlocking with a password. The password credential provider remains visible to the user. If a user tries to use a password, Windows informs the user they must use Windows Hello for Business or a smart card.
|
When you enable this security policy setting, Windows prevents users from signing in or unlocking with a password. The password credential provider remains visible to the user. If a user tries to use a password, Windows informs the user they must use Windows Hello for Business or a smart card.
|
||||||
|
|
||||||
#### Excluding the password credential provider
|
#### Excluding the password credential provider
|
||||||
You can use Group Policy to deploy an administrative template policy setting to the computer. This policy setting is found under **Computer Configuration > Policies > Administrative Templates > Logon**
|
You can use Group Policy to deploy an administrative template policy setting to the computer. This policy setting is found under **Computer Configuration > Policies > Administrative Templates > System > Logon**
|
||||||

|

|
||||||
|
|
||||||
The name of the policy setting is **Exclude credential providers**. The value to enter in the policy to hide the password credential provider is **60b78e88-ead8-445c-9cfd-0b87f74ea6cd**.
|
The name of the policy setting is **Exclude credential providers**. The value to enter in the policy to hide the password credential provider is **60b78e88-ead8-445c-9cfd-0b87f74ea6cd**.
|
||||||
|
@ -50,7 +50,7 @@ You can also download the whitepaper [Microsoft Defender Antivirus on Virtual De
|
|||||||
|
|
||||||
## Set up a dedicated VDI file share
|
## Set up a dedicated VDI file share
|
||||||
|
|
||||||
In Windows 10, version 1903, we introduced the shared security intelligence feature, which offloads the unpackaging of downloaded security intelligence updates onto a host machine—thus saving previous CPU, disk, and memory resources on individual machines. You can set this feature with a Group Policy, or PowerShell.
|
In Windows 10, version 1903, we introduced the shared security intelligence feature, which offloads the unpackaging of downloaded security intelligence updates onto a host machine—thus saving previous CPU, disk, and memory resources on individual machines. This feature has been backported and now works in Windows 10 version 1703 and above. You can set this feature with a Group Policy, or PowerShell.
|
||||||
|
|
||||||
### Use Group Policy to enable the shared security intelligence feature:
|
### Use Group Policy to enable the shared security intelligence feature:
|
||||||
|
|
||||||
|
@ -13,7 +13,7 @@ ms.author: deniseb
|
|||||||
ms.custom: nextgen
|
ms.custom: nextgen
|
||||||
ms.reviewer: pahuijbr
|
ms.reviewer: pahuijbr
|
||||||
manager: dansimp
|
manager: dansimp
|
||||||
ms.date: 01/07/2021
|
ms.date: 02/04/2021
|
||||||
ms.technology: mde
|
ms.technology: mde
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -90,7 +90,6 @@ All our updates contain
|
|||||||
### What's new
|
### What's new
|
||||||
|
|
||||||
- Improved SmartScreen status support logging
|
- Improved SmartScreen status support logging
|
||||||
- Apply CPU throttling policy to manually initiated scans
|
|
||||||
|
|
||||||
### Known Issues
|
### Known Issues
|
||||||
No known issues
|
No known issues
|
||||||
@ -387,6 +386,20 @@ We recommend updating your Windows 10 (Enterprise, Pro, and Home editions), Wind
|
|||||||
For more information, see [Microsoft Defender update for Windows operating system installation images](https://support.microsoft.com/help/4568292/defender-update-for-windows-operating-system-installation-images).
|
For more information, see [Microsoft Defender update for Windows operating system installation images](https://support.microsoft.com/help/4568292/defender-update-for-windows-operating-system-installation-images).
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
|
<summary>1.1.2102.03</summary>
|
||||||
|
|
||||||
|
 Package version: **1.1.2102.03**
|
||||||
|
 Platform version: **4.18.2011.6**
|
||||||
|
 Engine version: **1.17800.5**
|
||||||
|
 Signature version: **1.331.174.0**
|
||||||
|
|
||||||
|
### Fixes
|
||||||
|
- None
|
||||||
|
|
||||||
|
### Additional information
|
||||||
|
- None
|
||||||
|
<br/>
|
||||||
|
</details><details>
|
||||||
<summary>1.1.2101.02</summary>
|
<summary>1.1.2101.02</summary>
|
||||||
|
|
||||||
 Package version: **1.1.2101.02**
|
 Package version: **1.1.2101.02**
|
||||||
|
@ -13,55 +13,51 @@ ms.topic: article
|
|||||||
author: dansimp
|
author: dansimp
|
||||||
ms.author: dansimp
|
ms.author: dansimp
|
||||||
ms.custom: nextgen
|
ms.custom: nextgen
|
||||||
ms.date: 09/10/2020
|
ms.date: 02/04/2021
|
||||||
ms.reviewer:
|
ms.reviewer:
|
||||||
manager: dansimp
|
manager: dansimp
|
||||||
ms.technology: mde
|
ms.technology: mde
|
||||||
---
|
---
|
||||||
|
|
||||||
# Onboard Windows 10 multi-session devices in Windows Virtual Desktop
|
# Onboard Windows 10 multi-session devices in Windows Virtual Desktop
|
||||||
6 minutes to read
|
|
||||||
|
|
||||||
Applies to:
|
Applies to:
|
||||||
- Windows 10 multi-session running on Windows Virtual Desktop (WVD)
|
- Windows 10 multi-session running on Windows Virtual Desktop (WVD)
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> Microsoft Defender for Endpoint support for Windows Virtual Desktop multi-session scenarios is currently in Preview and limited up to 25 concurrent sessions per host/VM. However, single session scenarios on Windows Virtual Desktop are fully supported.
|
|
||||||
|
|
||||||
Microsoft Defender for Endpoint supports monitoring both VDI as well as Windows Virtual Desktop sessions. Depending on your organization's needs, you might need to implement VDI or Windows Virtual Desktop sessions to help your employees access corporate data and apps from an unmanaged device, remote location, or similar scenario. With Microsoft Defender for Endpoint, you can monitor these virtual machines for anomalous activity.
|
Microsoft Defender for Endpoint supports monitoring both VDI as well as Windows Virtual Desktop sessions. Depending on your organization's needs, you might need to implement VDI or Windows Virtual Desktop sessions to help your employees access corporate data and apps from an unmanaged device, remote location, or similar scenario. With Microsoft Defender for Endpoint, you can monitor these virtual machines for anomalous activity.
|
||||||
|
|
||||||
## Before you begin
|
## Before you begin
|
||||||
Familiarize yourself with the [considerations for non-persistent VDI](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-vdi#onboard-non-persistent-virtual-desktop-infrastructure-vdi-devices-1). While [Windows Virtual Desktop](https://docs.microsoft.com/azure/virtual-desktop/overview) does not provide non-persistence options, it does provide ways to use a golden Windows image that can be used to provision new hosts and redeploy machines. This increases volatility in the environment and thus impacts what entries are created and maintained in the Microsoft Defender for Endpoint portal, potentially reducing visibility for your security analysts.
|
Familiarize yourself with the [considerations for non-persistent VDI](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-vdi#onboard-non-persistent-virtual-desktop-infrastructure-vdi-devices-1). Although [Windows Virtual Desktop](https://docs.microsoft.com/azure/virtual-desktop/overview) does not provide non-persistence options, it does provide ways to use a Windows image that can be used to provision new hosts and redeploy machines. This increases volatility in the environment, and thus impacts what entries are created and maintained in the Microsoft Defender Security Center ([https://securitycenter.windows.com](https://securitycenter.windows.com)), potentially reducing visibility for your security analysts.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> Depending on your choice of onboarding method, devices can appear in Microsoft Defender for Endpoint portal as either:
|
> Depending on your choice of onboarding method, devices can appear in Microsoft Defender Security Center as either:
|
||||||
> - Single entry for each virtual desktop
|
> - Single entry for each virtual desktop
|
||||||
> - Multiple entries for each virtual desktop
|
> - Multiple entries for each virtual desktop
|
||||||
|
|
||||||
Microsoft recommends onboarding Windows Virtual Desktop as a single entry per virtual desktop. This ensures that the investigation experience in the Microsoft Defender Endpoint portal is in the context of one device based on the machine name. Organizations that frequently delete and re-deploy WVD hosts should strongly consider using this method as it prevents multiple objects for the same machine from being created in the Microsoft Defender for Endpoint portal. This can lead to confusion when investigating incidents. For test or non-volatile environments, you may opt to choose differently.
|
Microsoft recommends onboarding Windows Virtual Desktop as a single entry per virtual desktop. This ensures that the investigation experience in the Microsoft Defender Security Center is in the context of one device based on the machine name. Organizations that frequently delete and re-deploy WVD hosts should strongly consider using this method as it prevents multiple objects for the same machine from being created in the Microsoft Defender Security Center. This can lead to confusion when investigating incidents. For test or non-volatile environments, you may opt to choose differently.
|
||||||
|
|
||||||
Microsoft recommends adding the Microsoft Defender for Endpoint onboarding script to the WVD golden image. This way, you can be sure that this onboarding script runs immediately at first boot. It is executed as a startup script at first boot on all the WVD machines that are provisioned from the WVD golden image. However, if you are using one of the gallery images without modification, place the script in a shared location and call it from either local or domain group policy.
|
Microsoft recommends adding the Microsoft Defender for Endpoint onboarding script to the WVD image. This way, you can be sure that this onboarding script runs immediately at first boot. It is executed as a startup script at first boot on all the WVD machines that are provisioned from the WVD golden image. However, if you are using one of the gallery images without modification, place the script in a shared location and call it from either local or domain group policy.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> The placement and configuration of the VDI onboarding startup script on the WVD golden image configures it as a startup script that runs when the WVD starts. It is NOT recommended to onboard the actual WVD golden image. Another consideration is the method used to run the script. It should run as early in the startup/provisioning process as possible to reduce the time between the machine being available to receive sessions and the device onboarding to the service. Below scenarios 1 & 2 take this into account.
|
> The placement and configuration of the VDI onboarding startup script on the WVD golden image configures it as a startup script that runs when the WVD starts. It is NOT recommended to onboard the actual WVD golden image. Another consideration is the method used to run the script. It should run as early in the startup/provisioning process as possible to reduce the time between the machine being available to receive sessions and the device onboarding to the service. Below scenarios 1 & 2 take this into account.
|
||||||
|
|
||||||
### Scenarios
|
## Scenarios
|
||||||
There are several ways to onboard a WVD host machine:
|
There are several ways to onboard a WVD host machine:
|
||||||
|
|
||||||
- Run the script in the golden image (or from a shared location) during startup.
|
- Run the script in the golden image (or from a shared location) during startup.
|
||||||
- Use a management tool to run the script.
|
- Use a management tool to run the script.
|
||||||
|
|
||||||
#### *Scenario 1: Using local group policy*
|
### Scenario 1: Using local group policy
|
||||||
This scenario requires placing the script in a golden image and uses local group policy to run early in the boot process.
|
This scenario requires placing the script in a golden image and uses local group policy to run early in the boot process.
|
||||||
|
|
||||||
Use the instructions in [Onboard non-persistent virtual desktop infrastructure VDI devices](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-vdi#onboard-non-persistent-virtual-desktop-infrastructure-vdi-devices-1).
|
Use the instructions in [Onboard non-persistent virtual desktop infrastructure VDI devices](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-vdi#onboard-non-persistent-virtual-desktop-infrastructure-vdi-devices-1).
|
||||||
|
|
||||||
Follow the instructions for a single entry for each device.
|
Follow the instructions for a single entry for each device.
|
||||||
|
|
||||||
#### *Scenario 2: Using domain group policy*
|
### Scenario 2: Using domain group policy
|
||||||
This scenario uses a centrally located script and runs it using a domain-based group policy. You can also place the script in the golden image and run it in the same way.
|
This scenario uses a centrally located script and runs it using a domain-based group policy. You can also place the script in the golden image and run it in the same way.
|
||||||
|
|
||||||
**Download the WindowsDefenderATPOnboardingPackage.zip file from the Windows Defender Security Center**
|
#### Download the WindowsDefenderATPOnboardingPackage.zip file from the Windows Defender Security Center
|
||||||
1. Open the VDI configuration package .zip file (WindowsDefenderATPOnboardingPackage.zip)
|
1. Open the VDI configuration package .zip file (WindowsDefenderATPOnboardingPackage.zip)
|
||||||
- In the Microsoft Defender Security Center navigation pane, select **Settings** > **Onboarding**.
|
- In the Microsoft Defender Security Center navigation pane, select **Settings** > **Onboarding**.
|
||||||
- Select Windows 10 as the operating system.
|
- Select Windows 10 as the operating system.
|
||||||
@ -69,7 +65,7 @@ This scenario uses a centrally located script and runs it using a domain-based g
|
|||||||
- Click **Download package** and save the .zip file.
|
- Click **Download package** and save the .zip file.
|
||||||
2. Extract the contents of the .zip file to a shared, read-only location that can be accessed by the device. You should have a folder called **OptionalParamsPolicy** and the files **WindowsDefenderATPOnboardingScript.cmd** and **Onboard-NonPersistentMachine.ps1**.
|
2. Extract the contents of the .zip file to a shared, read-only location that can be accessed by the device. You should have a folder called **OptionalParamsPolicy** and the files **WindowsDefenderATPOnboardingScript.cmd** and **Onboard-NonPersistentMachine.ps1**.
|
||||||
|
|
||||||
**Use Group Policy management console to run the script when the virtual machine starts**
|
#### Use Group Policy management console to run the script when the virtual machine starts
|
||||||
1. Open the Group Policy Management Console (GPMC), right-click the Group Policy Object (GPO) you want to configure and click **Edit**.
|
1. Open the Group Policy Management Console (GPMC), right-click the Group Policy Object (GPO) you want to configure and click **Edit**.
|
||||||
1. In the Group Policy Management Editor, go to **Computer configuration** \> **Preferences** \> **Control panel settings**.
|
1. In the Group Policy Management Editor, go to **Computer configuration** \> **Preferences** \> **Control panel settings**.
|
||||||
1. Right-click **Scheduled tasks**, click **New**, and then click **Immediate Task** (At least Windows 7).
|
1. Right-click **Scheduled tasks**, click **New**, and then click **Immediate Task** (At least Windows 7).
|
||||||
@ -84,7 +80,7 @@ Enter the following:
|
|||||||
|
|
||||||
Click **OK** and close any open GPMC windows.
|
Click **OK** and close any open GPMC windows.
|
||||||
|
|
||||||
#### *Scenario 3: Onboarding using management tools*
|
### Scenario 3: Onboarding using management tools
|
||||||
|
|
||||||
If you plan to manage your machines using a management tool, you can onboard devices with Microsoft Endpoint Configuration Manager.
|
If you plan to manage your machines using a management tool, you can onboard devices with Microsoft Endpoint Configuration Manager.
|
||||||
|
|
||||||
@ -96,18 +92,18 @@ For more information, see: [Onboard Windows 10 devices using Configuration Manag
|
|||||||
> [!TIP]
|
> [!TIP]
|
||||||
> After onboarding the device, you can choose to run a detection test to verify that the device is properly onboarded to the service. For more information, see [Run a detection test on a newly onboarded Microsoft Defender for Endpoint device](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/run-detection-test).
|
> After onboarding the device, you can choose to run a detection test to verify that the device is properly onboarded to the service. For more information, see [Run a detection test on a newly onboarded Microsoft Defender for Endpoint device](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/run-detection-test).
|
||||||
|
|
||||||
#### Tagging your machines when building your golden image
|
## Tagging your machines when building your image
|
||||||
|
|
||||||
As part of your onboarding, you may want to consider setting a machine tag to be able to differentiate WVD machines more easily in the Microsoft Security Center. For more information, see
|
As part of your onboarding, you may want to consider setting a machine tag to be able to differentiate WVD machines more easily in the Microsoft Security Center. For more information, see
|
||||||
[Add device tags by setting a registry key value](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/machine-tags#add-device-tags-by-setting-a-registry-key-value).
|
[Add device tags by setting a registry key value](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/machine-tags#add-device-tags-by-setting-a-registry-key-value).
|
||||||
|
|
||||||
#### Other recommended configuration settings
|
## Other recommended configuration settings
|
||||||
|
|
||||||
When building your golden image, you may want to configure initial protection settings as well. For more information, see [Other recommended configuration settings](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-gp#other-recommended-configuration-settings).
|
When building your image, you may want to configure initial protection settings as well. For more information, see [Other recommended configuration settings](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/configure-endpoints-gp#other-recommended-configuration-settings).
|
||||||
|
|
||||||
In addition, if you are using FSlogix user profiles, we recommend you exclude the following files from always-on protection:
|
In addition, if you are using FSlogix user profiles, we recommend you exclude the following files from always-on protection:
|
||||||
|
|
||||||
**Exclude Files:**
|
### Exclude Files
|
||||||
|
|
||||||
> %ProgramFiles%\FSLogix\Apps\frxdrv.sys <br>
|
> %ProgramFiles%\FSLogix\Apps\frxdrv.sys <br>
|
||||||
> %ProgramFiles%\FSLogix\Apps\frxdrvvt.sys <br>
|
> %ProgramFiles%\FSLogix\Apps\frxdrvvt.sys <br>
|
||||||
@ -119,12 +115,12 @@ In addition, if you are using FSlogix user profiles, we recommend you exclude th
|
|||||||
> \\storageaccount.file.core.windows.net\share\*\*.VHD <br>
|
> \\storageaccount.file.core.windows.net\share\*\*.VHD <br>
|
||||||
> \\storageaccount.file.core.windows.net\share\*\*.VHDX <br>
|
> \\storageaccount.file.core.windows.net\share\*\*.VHDX <br>
|
||||||
|
|
||||||
**Exclude Processes:**
|
### Exclude Processes
|
||||||
|
|
||||||
> %ProgramFiles%\FSLogix\Apps\frxccd.exe <br>
|
> %ProgramFiles%\FSLogix\Apps\frxccd.exe <br>
|
||||||
> %ProgramFiles%\FSLogix\Apps\frxccds.exe <br>
|
> %ProgramFiles%\FSLogix\Apps\frxccds.exe <br>
|
||||||
> %ProgramFiles%\FSLogix\Apps\frxsvc.exe <br>
|
> %ProgramFiles%\FSLogix\Apps\frxsvc.exe <br>
|
||||||
|
|
||||||
#### Licensing requirements
|
## Licensing requirements
|
||||||
|
|
||||||
Windows 10 Multi-session is a client OS. Licensing requirements for Microsoft Defender for endpoint can be found at: [Licensing requirements](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/minimum-requirements#licensing-requirements).
|
Windows 10 Multi-session is a client OS. Licensing requirements for Microsoft Defender for endpoint can be found at: [Licensing requirements](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/minimum-requirements#licensing-requirements).
|
||||||
|
@ -114,6 +114,7 @@ These actions are applied to devices in the `DeviceId` column of the query resul
|
|||||||
- **Collect investigation package**—collects device information in a ZIP file. [Learn more about the investigation package](respond-machine-alerts.md#collect-investigation-package-from-devices)
|
- **Collect investigation package**—collects device information in a ZIP file. [Learn more about the investigation package](respond-machine-alerts.md#collect-investigation-package-from-devices)
|
||||||
- **Run antivirus scan**—performs a full Microsoft Defender Antivirus scan on the device
|
- **Run antivirus scan**—performs a full Microsoft Defender Antivirus scan on the device
|
||||||
- **Initiate investigation**—starts an [automated investigation](automated-investigations.md) on the device
|
- **Initiate investigation**—starts an [automated investigation](automated-investigations.md) on the device
|
||||||
|
- **Restrict app execution**—sets restrictions on the device to allow only files that are signed with a Microsoft-issued certificate to run. [Learn more about restricting app execution](respond-machine-alerts.md#restrict-app-execution)
|
||||||
|
|
||||||
### Actions on files
|
### Actions on files
|
||||||
|
|
||||||
@ -122,6 +123,10 @@ These actions are applied to files in the `SHA1` or the `InitiatingProcessSHA1`
|
|||||||
- **Allow/Block**—automatically adds the file to your [custom indicator list](manage-indicators.md) so that it is always allowed to run or blocked from running. You can set the scope of this action so that it is taken only on selected device groups. This scope is independent of the scope of the rule.
|
- **Allow/Block**—automatically adds the file to your [custom indicator list](manage-indicators.md) so that it is always allowed to run or blocked from running. You can set the scope of this action so that it is taken only on selected device groups. This scope is independent of the scope of the rule.
|
||||||
- **Quarantine file**—deletes the file from its current location and places a copy in quarantine
|
- **Quarantine file**—deletes the file from its current location and places a copy in quarantine
|
||||||
|
|
||||||
|
### Actions on users
|
||||||
|
|
||||||
|
- **Mark user as compromised**—sets the user's risk level to "high" in Azure Active Directory, triggering the corresponding [identity protection policies](https://docs.microsoft.com/azure/active-directory/identity-protection/overview-identity-protection#risk-levels).
|
||||||
|
|
||||||
## 5. Set the rule scope.
|
## 5. Set the rule scope.
|
||||||
|
|
||||||
Set the scope to specify which devices are covered by the rule:
|
Set the scope to specify which devices are covered by the rule:
|
||||||
|
@ -46,9 +46,10 @@ It's important to understand the following prerequisites prior to creating indic
|
|||||||
- The Antimalware client version must be 4.18.1906.x or later.
|
- The Antimalware client version must be 4.18.1906.x or later.
|
||||||
- Supported on machines on Windows 10, version 1709 or later.
|
- Supported on machines on Windows 10, version 1709 or later.
|
||||||
- Ensure that **Custom network indicators** is enabled in **Microsoft Defender Security Center > Settings > Advanced features**. For more information, see [Advanced features](advanced-features.md).
|
- Ensure that **Custom network indicators** is enabled in **Microsoft Defender Security Center > Settings > Advanced features**. For more information, see [Advanced features](advanced-features.md).
|
||||||
|
- For support of indicators on iOS, see [Configure custom indicators](https://docs.microsoft.com/windows/security/threat-protection/microsoft-defender-atp/ios-configure-features#configure-custom-indicators).
|
||||||
|
|
||||||
|
|
||||||
>[!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> Only external IPs can be added to the indicator list. Indicators cannot be created for internal IPs.
|
> Only external IPs can be added to the indicator list. Indicators cannot be created for internal IPs.
|
||||||
> For web protection scenarios, we recommend using the built-in capabilities in Microsoft Edge. Microsoft Edge leverages [Network Protection](network-protection.md) to inspect network traffic and allows blocks for TCP, HTTP, and HTTPS (TLS). For all other processes, web protection scenarios leverage Network Protection for inspection and enforcement: <br>
|
> For web protection scenarios, we recommend using the built-in capabilities in Microsoft Edge. Microsoft Edge leverages [Network Protection](network-protection.md) to inspect network traffic and allows blocks for TCP, HTTP, and HTTPS (TLS). For all other processes, web protection scenarios leverage Network Protection for inspection and enforcement: <br>
|
||||||
> NOTE:
|
> NOTE:
|
||||||
|
@ -32,10 +32,18 @@ ms.technology: mde
|
|||||||
|
|
||||||
This article describes how to deploy Microsoft Defender for Endpoint for Linux manually. A successful deployment requires the completion of all of the following tasks:
|
This article describes how to deploy Microsoft Defender for Endpoint for Linux manually. A successful deployment requires the completion of all of the following tasks:
|
||||||
|
|
||||||
- [Configure the Linux software repository](#configure-the-linux-software-repository)
|
- [Deploy Microsoft Defender for Endpoint for Linux manually](#deploy-microsoft-defender-for-endpoint-for-linux-manually)
|
||||||
- [Application installation](#application-installation)
|
- [Prerequisites and system requirements](#prerequisites-and-system-requirements)
|
||||||
- [Download the onboarding package](#download-the-onboarding-package)
|
- [Configure the Linux software repository](#configure-the-linux-software-repository)
|
||||||
- [Client configuration](#client-configuration)
|
- [RHEL and variants (CentOS and Oracle Linux)](#rhel-and-variants-centos-and-oracle-linux)
|
||||||
|
- [SLES and variants](#sles-and-variants)
|
||||||
|
- [Ubuntu and Debian systems](#ubuntu-and-debian-systems)
|
||||||
|
- [Application installation](#application-installation)
|
||||||
|
- [Download the onboarding package](#download-the-onboarding-package)
|
||||||
|
- [Client configuration](#client-configuration)
|
||||||
|
- [Log installation issues](#log-installation-issues)
|
||||||
|
- [Operating system upgrades](#operating-system-upgrades)
|
||||||
|
- [Uninstallation](#uninstallation)
|
||||||
|
|
||||||
## Prerequisites and system requirements
|
## Prerequisites and system requirements
|
||||||
|
|
||||||
@ -60,7 +68,7 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
sudo yum install yum-utils
|
sudo yum install yum-utils
|
||||||
```
|
```
|
||||||
|
|
||||||
- Note your distribution and version, and identify the closest entry for it under `https://packages.microsoft.com/config/`.
|
- Note your distribution and version, and identify the closest entry (by major, then minor) for it under `https://packages.microsoft.com/config/`. For instance, RHEL 7.9 is closer to 7.4 than to 8.
|
||||||
|
|
||||||
In the below commands, replace *[distro]* and *[version]* with the information you've identified:
|
In the below commands, replace *[distro]* and *[version]* with the information you've identified:
|
||||||
|
|
||||||
@ -71,7 +79,13 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
sudo yum-config-manager --add-repo=https://packages.microsoft.com/config/[distro]/[version]/[channel].repo
|
sudo yum-config-manager --add-repo=https://packages.microsoft.com/config/[distro]/[version]/[channel].repo
|
||||||
```
|
```
|
||||||
|
|
||||||
For example, if you are running CentOS 7 and wish to deploy MDATP for Linux from the *insiders-fast* channel:
|
For example, if you are running CentOS 7 and wish to deploy MDE for Linux from the *prod* channel:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo yum-config-manager --add-repo=https://packages.microsoft.com/config/centos/7/prod.repo
|
||||||
|
```
|
||||||
|
|
||||||
|
Or if you wish to explore new features on selected devices, you might want to deploy MDE for Linux to *insiders-fast* channel:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo yum-config-manager --add-repo=https://packages.microsoft.com/config/centos/7/insiders-fast.repo
|
sudo yum-config-manager --add-repo=https://packages.microsoft.com/config/centos/7/insiders-fast.repo
|
||||||
@ -91,7 +105,7 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
|
|
||||||
### SLES and variants
|
### SLES and variants
|
||||||
|
|
||||||
- Note your distribution and version, and identify the closest entry for it under `https://packages.microsoft.com/config/`.
|
- Note your distribution and version, and identify the closest entry(by major, then minor) for it under `https://packages.microsoft.com/config/`.
|
||||||
|
|
||||||
In the following commands, replace *[distro]* and *[version]* with the information you've identified:
|
In the following commands, replace *[distro]* and *[version]* with the information you've identified:
|
||||||
|
|
||||||
@ -99,10 +113,10 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
sudo zypper addrepo -c -f -n microsoft-[channel] https://packages.microsoft.com/config/[distro]/[version]/[channel].repo
|
sudo zypper addrepo -c -f -n microsoft-[channel] https://packages.microsoft.com/config/[distro]/[version]/[channel].repo
|
||||||
```
|
```
|
||||||
|
|
||||||
For example, if you are running SLES 12 and wish to deploy MDATP for Linux from the *insiders-fast* channel:
|
For example, if you are running SLES 12 and wish to deploy MDE for Linux from the *prod* channel:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo zypper addrepo -c -f -n microsoft-insiders-fast https://packages.microsoft.com/config/sles/12/insiders-fast.repo
|
sudo zypper addrepo -c -f -n microsoft-prod https://packages.microsoft.com/config/sles/12/prod.repo
|
||||||
```
|
```
|
||||||
|
|
||||||
- Install the Microsoft GPG public key:
|
- Install the Microsoft GPG public key:
|
||||||
@ -125,7 +139,7 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
sudo apt-get install libplist-utils
|
sudo apt-get install libplist-utils
|
||||||
```
|
```
|
||||||
|
|
||||||
- Note your distribution and version, and identify the closest entry for it under `https://packages.microsoft.com/config`.
|
- Note your distribution and version, and identify the closest entry (by major, then minor) for it under `https://packages.microsoft.com/config`.
|
||||||
|
|
||||||
In the below command, replace *[distro]* and *[version]* with the information you've identified:
|
In the below command, replace *[distro]* and *[version]* with the information you've identified:
|
||||||
|
|
||||||
@ -133,10 +147,10 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
curl -o microsoft.list https://packages.microsoft.com/config/[distro]/[version]/[channel].list
|
curl -o microsoft.list https://packages.microsoft.com/config/[distro]/[version]/[channel].list
|
||||||
```
|
```
|
||||||
|
|
||||||
For example, if you are running Ubuntu 18.04 and wish to deploy MDATP for Linux from the *insiders-fast* channel:
|
For example, if you are running Ubuntu 18.04 and wish to deploy MDE for Linux from the *prod* channel:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
curl -o microsoft.list https://packages.microsoft.com/config/ubuntu/18.04/insiders-fast.list
|
curl -o microsoft.list https://packages.microsoft.com/config/ubuntu/18.04/prod.list
|
||||||
```
|
```
|
||||||
|
|
||||||
- Install the repository configuration:
|
- Install the repository configuration:
|
||||||
@ -144,10 +158,10 @@ In order to preview new features and provide early feedback, it is recommended t
|
|||||||
```bash
|
```bash
|
||||||
sudo mv ./microsoft.list /etc/apt/sources.list.d/microsoft-[channel].list
|
sudo mv ./microsoft.list /etc/apt/sources.list.d/microsoft-[channel].list
|
||||||
```
|
```
|
||||||
For example, if you chose *insiders-fast* channel:
|
For example, if you chose *prod* channel:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo mv ./microsoft.list /etc/apt/sources.list.d/microsoft-insiders-fast.list
|
sudo mv ./microsoft.list /etc/apt/sources.list.d/microsoft-prod.list
|
||||||
```
|
```
|
||||||
|
|
||||||
- Install the `gpg` package if not already installed:
|
- Install the `gpg` package if not already installed:
|
||||||
|
@ -80,9 +80,9 @@ There are several ways to uninstall Defender for Endpoint for Linux. If you are
|
|||||||
|
|
||||||
### Manual uninstallation
|
### Manual uninstallation
|
||||||
|
|
||||||
- ```sudo yum remove mdatp``` for RHEL and variants(CentOS and Oracle Linux).
|
- `sudo yum remove mdatp` for RHEL and variants(CentOS and Oracle Linux).
|
||||||
- ```sudo zypper remove mdatp``` for SLES and variants.
|
- `sudo zypper remove mdatp` for SLES and variants.
|
||||||
- ```sudo apt-get purge mdatp``` for Ubuntu and Debian systems.
|
- `sudo apt-get purge mdatp` for Ubuntu and Debian systems.
|
||||||
|
|
||||||
## Configure from the command line
|
## Configure from the command line
|
||||||
|
|
||||||
@ -98,15 +98,15 @@ The following table lists commands for some of the most common scenarios. Run `m
|
|||||||
|
|
||||||
|Group |Scenario |Command |
|
|Group |Scenario |Command |
|
||||||
|----------------------|--------------------------------------------------------|-----------------------------------------------------------------------|
|
|----------------------|--------------------------------------------------------|-----------------------------------------------------------------------|
|
||||||
|Configuration |Turn on/off real-time protection |`mdatp config real-time-protection --value [enabled|disabled]` |
|
|Configuration |Turn on/off real-time protection |`mdatp config real-time-protection --value [enabled\|disabled]` |
|
||||||
|Configuration |Turn on/off cloud protection |`mdatp config cloud --value [enabled|disabled]` |
|
|Configuration |Turn on/off cloud protection |`mdatp config cloud --value [enabled\|disabled]` |
|
||||||
|Configuration |Turn on/off product diagnostics |`mdatp config cloud-diagnostic --value [enabled|disabled]` |
|
|Configuration |Turn on/off product diagnostics |`mdatp config cloud-diagnostic --value [enabled\|disabled]` |
|
||||||
|Configuration |Turn on/off automatic sample submission |`mdatp config cloud-automatic-sample-submission [enabled|disabled]` |
|
|Configuration |Turn on/off automatic sample submission |`mdatp config cloud-automatic-sample-submission [enabled\|disabled]` |
|
||||||
|Configuration |Turn on/off AV passive mode |`mdatp config passive-mode [enabled|disabled]` |
|
|Configuration |Turn on/off AV passive mode |`mdatp config passive-mode --value [enabled\|disabled]` |
|
||||||
|Configuration |Add/remove an antivirus exclusion for a file extension |`mdatp exclusion extension [add|remove] --name [extension]` |
|
|Configuration |Add/remove an antivirus exclusion for a file extension |`mdatp exclusion extension [add\|remove] --name [extension]` |
|
||||||
|Configuration |Add/remove an antivirus exclusion for a file |`mdatp exclusion file [add|remove] --path [path-to-file]` |
|
|Configuration |Add/remove an antivirus exclusion for a file |`mdatp exclusion file [add\|remove] --path [path-to-file]` |
|
||||||
|Configuration |Add/remove an antivirus exclusion for a directory |`mdatp exclusion folder [add|remove] --path [path-to-directory]` |
|
|Configuration |Add/remove an antivirus exclusion for a directory |`mdatp exclusion folder [add\|remove] --path [path-to-directory]` |
|
||||||
|Configuration |Add/remove an antivirus exclusion for a process |`mdatp exclusion process [add|remove] --path [path-to-process]`<br/>`mdatp exclusion process [add|remove] --name [process-name]` |
|
|Configuration |Add/remove an antivirus exclusion for a process |`mdatp exclusion process [add\|remove] --path [path-to-process]`<br/>`mdatp exclusion process [add\|remove] --name [process-name]` |
|
||||||
|Configuration |List all antivirus exclusions |`mdatp exclusion list` |
|
|Configuration |List all antivirus exclusions |`mdatp exclusion list` |
|
||||||
|Configuration |Add a threat name to the allowed list |`mdatp threat allowed add --name [threat-name]` |
|
|Configuration |Add a threat name to the allowed list |`mdatp threat allowed add --name [threat-name]` |
|
||||||
|Configuration |Remove a threat name from the allowed list |`mdatp threat allowed remove --name [threat-name]` |
|
|Configuration |Remove a threat name from the allowed list |`mdatp threat allowed remove --name [threat-name]` |
|
||||||
|
Loading…
x
Reference in New Issue
Block a user