在HTTP Proxy下部署Microsoft Entra Connect及Health Agents

博主：小蓝
发布时间：2024 年 10 月 31 日
11 次浏览
暂无评论
4922字数
分类： Linux 技术杂烩

# 在HTTP Proxy环境下部署Microsoft Entra Connect及Health Agents 📘

## 一、引言 🌟

在企业网络环境中，**Microsoft Entra Connect**（前身为Azure AD Connect）是将本地Active Directory与Microsoft Entra ID（Azure AD）同步的关键工具。然而，在使用**HTTP Proxy**（**HTTP代理**）环境下，部署Entra Connect和Health Agents需要进行额外的配置。本文将详细介绍如何在HTTP Proxy环境中成功部署Microsoft Entra Connect及其健康代理（Health Agents）。

## 二、了解HTTP Proxy环境 🧐

### 1. **什么是HTTP Proxy？**

**HTTP Proxy**是一种网络代理服务器，充当客户端与服务器之间的中介，帮助管理网络请求和响应。它可以用于：

- **网络安全控制**：过滤不良内容、阻止恶意网站。
- **网络性能优化**：缓存常用资源，加速访问速度。
- **网络监控和审计**：记录用户的网络活动。

### 2. **对Entra Connect的影响**

在HTTP Proxy环境下，Entra Connect需要正确配置代理设置，才能与Microsoft Entra ID通信，实现目录同步和健康监控。

## 三、部署前的准备工作 🛠️

### 1. **系统要求**

- **操作系统**：Windows Server 2016及以上版本。
- **网络连接**：能够访问互联网，且通过HTTP Proxy进行网络通信。

### 2. **所需权限**

- **本地管理员权限**：安装和配置软件所需。
- **Azure全局管理员权限**：用于配置Microsoft Entra ID相关设置。

## 四、配置HTTP Proxy设置 🌐

### 1. **为系统设置代理**

在服务器上，全局设置HTTP Proxy，确保所有应用程序都能使用代理访问互联网。

#### **步骤：**

1. 打开**控制面板**，选择**Internet选项**。
2. 在**连接**选项卡，点击**局域网设置**。
3. 勾选**为LAN使用代理服务器**，输入代理服务器的地址和端口。
4. 勾选**不适用于本地地址**，点击**确定**。

### 2. **配置环境变量**

某些服务需要通过系统环境变量来读取代理设置。

#### **步骤：**

1. 右键**此电脑**，选择**属性**。
2. 点击**高级系统设置**，然后点击**环境变量**。
3. 在**系统变量**中，点击**新建**，添加以下变量：

- **变量名**：`HTTP_PROXY`
   - **变量值**：`http://proxy_address:port`
4. 同样，添加 `HTTPS_PROXY`变量：

- **变量名**：`HTTPS_PROXY`
   - **变量值**：`http://proxy_address:port`

**解释**：这些环境变量告诉系统和应用程序使用指定的HTTP Proxy进行网络通信。

## 五、安装Microsoft Entra Connect 📥

### 1. **下载安装包**

从微软官方网站下载最新版本的**Microsoft Entra Connect**安装包。

### 2. **运行安装程序**

双击安装包，启动安装向导。

### 3. **接受许可协议**

阅读并接受软件许可条款，点击**继续**。

### 4. **选择安装类型**

选择**自定义安装**，以便在后续步骤中配置高级选项。

### 5. **配置用户选项**

在**可选功能**页面，勾选**启用健康代理（Enable Health Agent）**。

### 6. **配置代理设置**

在安装向导中，会提示配置**代理设置**。

#### **步骤：**

1. 在**代理配置**页面，勾选**通过代理服务器连接互联网**。
2. 输入代理服务器的**地址**和**端口**。
3. 如果代理需要身份验证，输入**用户名**和**密码**。

### 7. **验证连接**

安装程序将测试与Microsoft Entra ID的连接，确保代理配置正确。

### 8. **完成安装**

按照提示完成后续配置，包括选择同步选项、选择OU等，直至安装完成。

## 六、配置Microsoft Entra Connect Health Agents 🩺

### 1. **了解Health Agents**

**Health Agents**用于监控Entra Connect的运行状态，提供健康报告和警报。

### 2. **代理配置**

Health Agents需要单独配置代理设置。

#### **方法一：使用PowerShell配置**

1. 以管理员身份打开**PowerShell**。
2. 导入Health Agent模块：

```powershell
   Import-Module "C:\Program Files\Microsoft Azure AD Connect Health Sync\Microsoft.AzureADConnect.Health.SyncClientInstall.psd1"
   ```

**解释**：导入Health Agent的PowerShell模块，方便后续配置。
3. 配置代理：

```powershell
   Set-AzureADConnectHealthProxySettings -ProxyAddress "http://proxy_address:port" -ProxyUserName "domain\username" -ProxyPassword "password"
   ```

**解释**：

- `Set-AzureADConnectHealthProxySettings`：设置Health Agent的代理配置。
   - `-ProxyAddress`：指定代理服务器的地址和端口。
   - `-ProxyUserName`：代理身份验证的用户名（如需）。
   - `-ProxyPassword`：代理身份验证的密码（如需）。

#### **方法二：修改配置文件**

1. 打开配置文件：

```
   C:\ProgramData\Microsoft\Azure AD Connect Health\Config\MonitoringAgentService.exe.config
   ```
2. 在 `<configuration>`节点内，添加以下内容：

```xml
   <system.net>
     <defaultProxy useDefaultCredentials="true">
       <proxy proxyaddress="http://proxy_address:port" bypassonlocal="True" />
     </defaultProxy>
   </system.net>
   ```

**解释**：

- `<defaultProxy>`：配置默认的代理设置。
   - `useDefaultCredentials="true"`：使用当前用户的凭据进行身份验证。
   - `proxyaddress`：指定代理服务器的地址和端口。
   - `bypassonlocal="True"`：本地地址不通过代理。
3. 保存文件，重启Health Agent服务：

```powershell
   Restart-Service AzureADConnectHealthSyncMonitor
   ```

**解释**：`Restart-Service`命令用于重启指定的服务，使配置生效。

## 七、验证配置是否成功 ✅

### 1. **检查同步状态**

打开**Microsoft Entra Connect**，查看同步状态是否正常。

### 2. **查看健康状态**

### 3. **网络连接测试**

使用PowerShell测试网络连接：

```powershell
Test-NetConnection -ComputerName "enterpriseregistration.windows.net" -Port 443
```

**解释**：`Test-NetConnection`命令测试到指定服务器和端口的连接，确保代理配置后网络通信正常。

## 八、常见问题及解决方案 🛠️

### 1. **代理身份验证失败**

**解决方案**：

- 确认代理用户名和密码是否正确。
- 如果代理不支持NTLM身份验证，需配置基本身份验证。

### 2. **无法连接到Microsoft Entra ID**

**解决方案**：

- 检查防火墙设置，确保允许HTTPS流量通过。
- 确认代理服务器允许访问所需的微软域名。

### 3. **Health Agent无法发送数据**

**解决方案**：

- 确认Health Agent的代理配置是否正确。
- 检查服务状态，确保Health Agent服务正在运行。

## 九、相关网络端口和域名 🌐

### 1. **必要的网络端口**

| **协议**  | **端口** | **用途**           |
| --------------- | -------------- | ------------------------ |
| **HTTPS** | **443**  | 与Microsoft Entra ID通信 |

### 2. **需要访问的域名列表**

- `login.microsoftonline.com`
- `enterpriseregistration.windows.net`
- `graph.windows.net`
- `*.servicebus.windows.net`

**注意**：代理服务器应允许对以上域名的访问。

## 十、总结 🏁

在HTTP Proxy环境下部署**Microsoft Entra Connect**及其**Health Agents**需要进行额外的代理配置。通过正确设置系统代理、环境变量，以及在安装过程中配置代理信息，可以确保Entra Connect与Microsoft Entra ID的正常通信。同时，配置Health Agents的代理设置，确保健康监控数据能够上传到云端。

---

通过本文的指导，您应该能够在HTTP Proxy环境中成功部署和配置Microsoft Entra Connect及Health Agents，确保企业目录同步和健康监控的正常运行。🚀

---

**重要提示**：在实际部署过程中，务必遵循企业的安全策略和网络规范，确保网络通信的安全性和合规性。🌟

蓝易云是一家专注于香港及国内数据中心服务的提供商，提供高质量的服务器租用和云计算服务、包括免备案香港服务器、香港CN2、美国服务器、海外高防服务器、国内高防服务器、香港VPS等。致力于为用户提供稳定,快速的网络连接和优质的客户体验。

最后修改：2024 年 10 月 31 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

在HTTP Proxy下部署Microsoft Entra Connect及Health Agents

小蓝 • 2024 年 10 月 31 日

# 在HTTP Proxy环境下部署Microsoft Entra Connect及Health Agents 📘

## 一、引言 🌟

## 二、了解HTTP Proxy环境 🧐

### 1. **什么是HTTP Proxy？**

**HTTP Proxy**是一种网络代理服务器，充当客户端与服务器之间的中介，帮助管理网络请求和响应。它可以用于：

### 2. **对Entra Connect的影响**

在HTTP Proxy环境下，Entra Connect需要正确配置代理设置，才能与Microsoft Entra ID通信，实现目录同步和健康监控。

## 三、部署前的准备工作 🛠️

### 1. **系统要求**

- **操作系统**：Windows Server 2016及以上版本。
- **网络连接**：能够访问互联网，且通过HTTP Proxy进行网络通信。

### 2. **所需权限**

- **本地管理员权限**：安装和配置软件所需。
- **Azure全局管理员权限**：用于配置Microsoft Entra ID相关设置。

## 四、配置HTTP Proxy设置 🌐

### 1. **为系统设置代理**

在服务器上，全局设置HTTP Proxy，确保所有应用程序都能使用代理访问互联网。

#### **步骤：**

### 2. **配置环境变量**

某些服务需要通过系统环境变量来读取代理设置。

#### **步骤：**

1. 右键**此电脑**，选择**属性**。
2. 点击**高级系统设置**，然后点击**环境变量**。
3. 在**系统变量**中，点击**新建**，添加以下变量：

- **变量名**：`HTTP_PROXY`
   - **变量值**：`http://proxy_address:port`
4. 同样，添加 `HTTPS_PROXY`变量：

- **变量名**：`HTTPS_PROXY`
   - **变量值**：`http://proxy_address:port`

**解释**：这些环境变量告诉系统和应用程序使用指定的HTTP Proxy进行网络通信。

## 五、安装Microsoft Entra Connect 📥

### 1. **下载安装包**

从微软官方网站下载最新版本的**Microsoft Entra Connect**安装包。

### 2. **运行安装程序**

双击安装包，启动安装向导。

### 3. **接受许可协议**

阅读并接受软件许可条款，点击**继续**。

### 4. **选择安装类型**

选择**自定义安装**，以便在后续步骤中配置高级选项。

### 5. **配置用户选项**

在**可选功能**页面，勾选**启用健康代理（Enable Health Agent）**。

### 6. **配置代理设置**

在安装向导中，会提示配置**代理设置**。

#### **步骤：**

### 7. **验证连接**

安装程序将测试与Microsoft Entra ID的连接，确保代理配置正确。

### 8. **完成安装**

按照提示完成后续配置，包括选择同步选项、选择OU等，直至安装完成。

## 六、配置Microsoft Entra Connect Health Agents 🩺

### 1. **了解Health Agents**

**Health Agents**用于监控Entra Connect的运行状态，提供健康报告和警报。

### 2. **代理配置**

Health Agents需要单独配置代理设置。

#### **方法一：使用PowerShell配置**

1. 以管理员身份打开**PowerShell**。
2. 导入Health Agent模块：

```powershell
   Import-Module "C:\Program Files\Microsoft Azure AD Connect Health Sync\Microsoft.AzureADConnect.Health.SyncClientInstall.psd1"
   ```

**解释**：导入Health Agent的PowerShell模块，方便后续配置。
3. 配置代理：

```powershell
   Set-AzureADConnectHealthProxySettings -ProxyAddress "http://proxy_address:port" -ProxyUserName "domain\username" -ProxyPassword "password"
   ```

**解释**：

#### **方法二：修改配置文件**

1. 打开配置文件：

```
   C:\ProgramData\Microsoft\Azure AD Connect Health\Config\MonitoringAgentService.exe.config
   ```
2. 在 `<configuration>`节点内，添加以下内容：

```xml
   <system.net>
     <defaultProxy useDefaultCredentials="true">
       <proxy proxyaddress="http://proxy_address:port" bypassonlocal="True" />
     </defaultProxy>
   </system.net>
   ```

**解释**：

```powershell
   Restart-Service AzureADConnectHealthSyncMonitor
   ```

**解释**：`Restart-Service`命令用于重启指定的服务，使配置生效。

## 七、验证配置是否成功 ✅

### 1. **检查同步状态**

打开**Microsoft Entra Connect**，查看同步状态是否正常。

### 2. **查看健康状态**

### 3. **网络连接测试**

使用PowerShell测试网络连接：

```powershell
Test-NetConnection -ComputerName "enterpriseregistration.windows.net" -Port 443
```

**解释**：`Test-NetConnection`命令测试到指定服务器和端口的连接，确保代理配置后网络通信正常。

## 八、常见问题及解决方案 🛠️

### 1. **代理身份验证失败**

**解决方案**：

- 确认代理用户名和密码是否正确。
- 如果代理不支持NTLM身份验证，需配置基本身份验证。

### 2. **无法连接到Microsoft Entra ID**

**解决方案**：

- 检查防火墙设置，确保允许HTTPS流量通过。
- 确认代理服务器允许访问所需的微软域名。

### 3. **Health Agent无法发送数据**

**解决方案**：

- 确认Health Agent的代理配置是否正确。
- 检查服务状态，确保Health Agent服务正在运行。

## 九、相关网络端口和域名 🌐

### 1. **必要的网络端口**

| **协议**  | **端口** | **用途**           |
| --------------- | -------------- | ------------------------ |
| **HTTPS** | **443**  | 与Microsoft Entra ID通信 |

### 2. **需要访问的域名列表**

- `login.microsoftonline.com`
- `enterpriseregistration.windows.net`
- `graph.windows.net`
- `*.servicebus.windows.net`

**注意**：代理服务器应允许对以上域名的访问。

## 十、总结 🏁

---

通过本文的指导，您应该能够在HTTP Proxy环境中成功部署和配置Microsoft Entra Connect及Health Agents，确保企业目录同步和健康监控的正常运行。🚀

---

**重要提示**：在实际部署过程中，务必遵循企业的安全策略和网络规范，确保网络通信的安全性和合规性。🌟

在HTTP Proxy下部署Microsoft Entra Connect及Health Agents

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

微信视频号视频下载工具WeChatVideoDownloader

Win11系统优化工具-Windows11一键设置

Windows微软常用运行库合集一键安装

【电脑软件】Google翻译修复工具

Windows版Kangle安装教程及安装包

Linux系统中/etc/passwd文件的深入解读

tomcat安装、部署JSPGOU项目、Tomcat多实例

蓝易云对比：香港与台湾服务器，哪个更快？

深入Linux中UDP网络通信机制编程探索

不用备案的cdn服务器有哪些优势

在HTTP Proxy下部署Microsoft Entra Connect及Health Agents

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

在HTTP Proxy下部署Microsoft Entra Connect及Health Agents

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款