Skip to content

Commit

Permalink
Merge pull request #958 from yoshiakinoro/yoshiakinoro-patch-1
Browse files Browse the repository at this point in the history
Yoshiakinoro patch about TLS 1.2 enforcement for Microsoft Entra Connect
  • Loading branch information
akhiraka authored Sep 20, 2024
2 parents 78b592f + 80670e2 commit a3a7c9a
Show file tree
Hide file tree
Showing 8 changed files with 83 additions and 0 deletions.
83 changes: 83 additions & 0 deletions articles/azure-active-directory-connect/azure-ad-connect-2-3-20.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: Microsoft Entra Connect 2.3.20 のインストール・アップグレードに失敗する際の対応方法について
date: 2024-09-18 12:00
tags:
- Microsoft Entra ID
- Microsoft Entra Connect
- TLS 1.2
---
# Microsoft Entra Connect 2.3.20 のインストール・アップグレードに失敗する際の対応方法について
こんにちは、Azure & Identity サポート チームの野呂です。
Microsoft Entra Connect 2.3.20 のインストール・アップグレードに失敗する、またはアップグレード後に同期に失敗するお問い合わせを多数お寄せいただいております。
本記事では、これらの一般的な原因と対処方法をご紹介します。

## 事象について
Microsoft Entra Connect 2.3.20 のインストール・アップグレードを試みた際に、エラーが出力され、インストール・アップグレードに失敗します。
もしくは、インストール・アップグレードには成功しますが、その後の同期処理に失敗します。
以下に、問題が発生した場合に出力される可能性のあるエラー例をお伝えします。

### インストール時・アップグレード時のエラー
インストールを試みた際に、インストール ウィザードの構成画面にて、"An error occurred executing Configure AAD Sync task: An error occurred while sending the request." のエラーが表示されインストールに失敗する事象が確認されております。

インストール時のエラー画面例:

![](./azure-ad-connect-2-3-20/MEC_InstallError.png)

また、アップグレードを試みた際に、インストール ウィザードの資格情報入力画面にて、正しい権限を持つ有効なアカウントを入力したのにも関わらず、エラーが出力される事象が発生するとのお問い合わせを多数お寄せいただいております。

アップグレード時のエラー画面例:

![](./azure-ad-connect-2-3-20/MEC_UpgradeError.jpg)

### アップグレード後の同期エラー
アップグレード以降の同期サイクルにおいて、Microsoft Entra ID のコネクタにおける Import 処理や Export 処理が、"no-start-ma" や "stopped-extension-dll-exeption", "stopped-server" などが記録されて失敗する事象を確認しています。

Synchronization Service Manager の例:

![](./azure-ad-connect-2-3-20/SynchronizationServiceManager.png)

システム イベント ログの例:

![](./azure-ad-connect-2-3-20/SystemEventLog.png)

アプリケーション イベント ログの例:

![](./azure-ad-connect-2-3-20/ApplicationEventLog.png)


## 原因
Microsoft Entra Connect と Microsoft Entra ID の間で TLS 1.2 にて通信を行えていない事がエラー発生の原因です。

Microsoft Entra Connect のバージョン 1.2.65.0 以降では、 Microsoft Entra ID との通信に対して TLS 1.2 のみの使用が完全にサポートされております。
また、Microsoft Entra Connect 2.3.20 では、導入サーバーにて、レジストリに TLS 1.2 を登録して明示的に有効化することがインストールの要件となっております。

## 対応方法
Microsoft Entra Connect 2.3.20 のインストール・アップグレードを行う前に、導入サーバーにて、レジストリに TLS 1.2 を有効化する値を登録して明示的に有効化する必要がございます。
以下に、TLS 1.2 のレジストリ登録状況の確認方法とTLS 1.2 のレジストリ登録方法を記載いたします。

### TLS 1.2 のレジストリ登録状況の確認方法
1. Microsoft Entra Connect を導入するサーバーで PowerShell を管理者権限で開き、下記のドキュメントに記載された [TLS 1.2 をチェックするための PowerShell スクリプト] を実行し、TLS 1.2 のレジストリ登録状況を確認します。
(スクリプトを実行した結果、Value が Not Found となっている場合は、TLS 1.2 用のレジストリが構成されていないと判断可能です)
Title : Microsoft Entra Connect に対する TLS 1.2 の強制 | TLS 1.2 をチェックするための PowerShell スクリプト
URL : https://learn.microsoft.com/ja-jp/entra/identity/hybrid/connect/reference-connect-tls-enforcement#powershell-script-to-check-tls-12

TLS 1.2 が構成されていないことを示す出力の例:

![](./azure-ad-connect-2-3-20/TLS12_Disabled.png)

適切な TLS 1.2 構成を示す出力の例:

![](./azure-ad-connect-2-3-20/TLS12_Enabled.png)


### TLS 1.2 のレジストリ登録方法
1. 下記のドキュメントに記載された [TLS 1.2 を有効にする PowerShell スクリプト] を実行し、レジストリに TLS 1.2 を登録して明示的に有効化します。
Title : Microsoft Entra Connect に対する TLS 1.2 の強制 | TLS 1.2 を有効にする PowerShell スクリプト
URL : https://learn.microsoft.com/ja-jp/entra/identity/hybrid/connect/reference-connect-tls-enforcement#powershell-script-to-enable-tls-12

2. 導入サーバーを再起動します。

これらのレジストリを登録することにより、これまで .Net Framework アプリケーションが TLS 1.2 以外を用いて通信を行っていた場合には TLS 1.2 を用いて通信を行うようになります。
一般的には TLS 1.2 が推奨されており、 TLS 1.2 を用いて通信を行うことに問題はございませんが、もし問題が生じた際にはこれらのレジストリを削除頂いた上で、再度再起動頂くことで元の状態に戻すことが可能です。

TLS 1.2 のレジストリを設定後も同期が行えない、インストールが行えない場合には弊社サポートまでお問い合わせください。
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a3a7c9a

Please sign in to comment.