# WS-Federation інтеграції

{% hint style="info" %}
Ця інтеграція забезпечує автентифікацію для Exchange Outlook Web Application (OWA) та Exchange Admin Center (EAC), які виступають як провайдери послуг (SP), через сервер Hideez як постачальник ідентифікації (IdP).
{% endhint %}

<figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FKGtYh8ZFev3U9wybzbdP%2Fhes-owa.png?alt=media&#x26;token=d72de9b5-dab5-4c28-9dbd-dc7037bea0c3" alt=""><figcaption></figcaption></figure>

## **Крок 1: Налаштування інтеграції для Exchange OWA у Hideez Server**

1. **Увійдіть до Hideez Server як адміністратор.**
2. **Перейдіть до налаштувань WS Federation:**
   * Зайдіть у **Налаштування → Параметри WS Federation section.**
3. **Додайте Exchange OWA як провайдера послуг:**

   * Натисніть **Додати постачальника послуг.**
   * Заповніть наступні дані:
     * **Ім'я:** OWA
     * **WT-Realm:** `https://{owa-url}` (наприклад, `https://mail.example.com/owa/`)
     * **Reply URL:** `https://{owa-url}` (наприклад, `https://mail.example.com/owa/`)
     * У нашому випадку:`https://exch.lab.hideez.com/owa/`
   * Натисніть **Додати**.

   <div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2F0QsanLi1t5QrMlUMZUhg%2Fimage.png?alt=media&#x26;token=2e89e6ca-2b3a-4913-b79c-dacc89ff61b5" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FsEaccedShOHRuXGpdlsS%2Fimage.png?alt=media&#x26;token=f15950b4-2861-4184-8c27-876b42e8c954" alt=""><figcaption></figcaption></figure></div>
4. **Отримайте деталі IdP:**

   * Натисніть **Деталі** для нового провайдера послуг.
   * Завантажте сертифікат підпису IdP.
   * Скопіюйте URL WS Federation IdP.

   <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FEELmRvbanQkZ0uq1t1a0%2Fimage.png?alt=media&#x26;token=2f4f0f59-f23a-4729-b1f1-34a9edae018f" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Залиште вкладку WS Federation відкритою з отриманими значеннями (URL IdP WS Federation та сертифікат).
{% endhint %}

## **Крок 2: Налаштування інтеграції для Exchange Admin Center (EAC) у Hideez Server**

1. **Додайте Exchange Admin Center (EAC) як провайдера послуг:**

   * Натисніть **Додати постачальника послуг**.
   * Заповніть наступні дані:
     * **Ім'я:** `ECP`
     * **WT-Realm:** `https://{ecp-url}` (наприклад, `https://mail.example.com/ecp/`)
     * **Reply URL:** `https://{ecp-url}` (наприклад, ⁣ `https://mail.example.com/ecp/`)
   * У нашому випадку: `https://exch.lab.hideez.com/ecp/`
   * Натисніть **Add**.

   <div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2F0QsanLi1t5QrMlUMZUhg%2Fimage.png?alt=media&#x26;token=2e89e6ca-2b3a-4913-b79c-dacc89ff61b5" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2F5avOIIgobsoy7J9mIDFz%2Fimage.png?alt=media&#x26;token=6b50d91c-3c8e-4a2a-9062-6e34b25d4e00" alt=""><figcaption></figcaption></figure></div>
2. **Отримайте деталі IdP:**

   * Натисніть **Details** для нового провайдера послуг.
   * Завантажте сертифікат підпису IdP.
   * Скопіюйте URL WS Federation IdP.

   <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FREIEQoJeHJPIP2RvdmYK%2Fimage.png?alt=media&#x26;token=94ac3ce9-eacd-4d7d-8dea-5e8505794203" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Залиште вкладку WS Federation відкритою з отриманими значеннями (URL IdP WS Federation та сертифікат).
{% endhint %}

## **Крок 3: Налаштування автентифікації для Exchange OWA через Hideez Server**

### **1. Встановіть сертифікат на сервері Exchange для OWA:**

* Відкрийте консоль MMC на сервері Exchange:
  * Натисніть **Win + R**, введіть **mmc** і натисніть Enter.
* У консолі MMC перейдіть до **File → Add/Remove Snap-in**.
* Виберіть **Certificates** зі списку, натисніть **Add**.
* Виберіть **Computer account → Local Computer → Finish → OK**.

<div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FY6jdzZyIZMCW3h9CYu6g%2Fimage.png?alt=media&#x26;token=0035db1f-815b-4505-b6f1-0150511ea5b5" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FjoLTp0tpnVhH4IM8Edwp%2Fimage.png?alt=media&#x26;token=9458c102-9c86-4abb-9a47-677cb2bf66e1" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FCFsGbVaEITHxGXxzS33Y%2Fimage.png?alt=media&#x26;token=09216144-8f09-4f65-a816-bffae5519a99" alt=""><figcaption></figcaption></figure></div>

* Перейдіть до:
  * **Certificates (Local Computer) → Trusted Root Certification Authorities → Certificates**.
* Клацніть правою кнопкою миші на **Certificates → All Tasks → Import**.
* Виконайте імпорт сертифіката:
  * Виберіть завантажений сертифікат `ws-fed-signing-owa.cer` і помістіть його до сховища **Trusted Root Certification Authorities**
* Натисніть **Next** → **Finish**.

  <div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FGEkCFL5AkFFPXlFAzr4R%2Fimage.png?alt=media&#x26;token=656cbe4c-2947-43c3-9536-1f46908e850a" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FQUEtmAIdkMs3cR7l8Cwo%2Fimage.png?alt=media&#x26;token=da5e2f90-c285-4656-a410-dc2791b3c585" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FSzOujC6bYXuPgYmZDc8V%2Fimage.png?alt=media&#x26;token=c975928f-9f19-4e87-beb7-d6fbeb1e6c2e" alt=""><figcaption></figcaption></figure></div>

  <div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FuLe1d6PdeO6XQzY2nNAy%2Fimage.png?alt=media&#x26;token=ea0493bf-feca-4649-920f-8a6b07f2fd35" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FVXZAHTk9KQu7fFv8yh6i%2Fimage.png?alt=media&#x26;token=f99b7740-ea84-4511-a45a-354fa0450908" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2Fr0F9MjdXdORFxpFWwwPP%2Fimage.png?alt=media&#x26;token=959dc20a-86e4-4b18-a618-b6b0d523cd3e" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FqL8T3MP7PDx5ECc85HOX%2Fimage.png?alt=media&#x26;token=318c0bed-c920-4dd8-99dd-18d58e4de72f" alt=""><figcaption></figcaption></figure></div>

### **2. Виконайте команди в Exchange Management Shell для OWA:**

{% code overflow="wrap" %}

```powershell
Set-OrganizationConfig -AdfsIssuer "{Hideez WS Fed URL}" -AdfsAudienceUris "{OWA Base URL}" -AdfsSignCertificateThumbprint {Hideez Cert Thumbprint}
```

{% endcode %}

* **{OWA Base URL}:** URL OWA, наприклад, `https://mail.example.com/owa/.`
* **{Hideez WS Fed URL}:** URL IdP WS Federation.
* **{Hideez Cert Thumbprint}:** Thumbprint сертифіката IdP.
* **Приклад:**

  <pre class="language-powershell" data-overflow="wrap"><code class="lang-powershell">Set-OrganizationConfig -AdfsIssuer "https://dev.hideez.com/wsfed" -AdfsAudienceUris "https://exch.lab.hideez.com/owa/" -AdfsSignCertificateThumbprint d80e7aa3d27ac800fb2d5fa7c08748a73d924cd2

  </code></pre>

## **Крок 4: Налаштування автентифікації для EAC через Hideez Server**

### **1. Встановіть сертифікат на сервері Exchange для EAC:**

* Відкрийте консоль MMC на сервері Exchange:
  * Натисніть **Win + R**, введіть **mmc** і натисніть Enter.
* У консолі MMC перейдіть до **File → Add/Remove Snap-in**.
* Виберіть **Certificates** зі списку, натисніть **Add**.
* Виберіть **Computer account → Local Computer → Finish → OK**.

<div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FY6jdzZyIZMCW3h9CYu6g%2Fimage.png?alt=media&#x26;token=0035db1f-815b-4505-b6f1-0150511ea5b5" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FjoLTp0tpnVhH4IM8Edwp%2Fimage.png?alt=media&#x26;token=9458c102-9c86-4abb-9a47-677cb2bf66e1" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FCFsGbVaEITHxGXxzS33Y%2Fimage.png?alt=media&#x26;token=09216144-8f09-4f65-a816-bffae5519a99" alt=""><figcaption></figcaption></figure></div>

* Перейдіть до:
  * **Certificates (Local Computer) → Trusted Root Certification Authorities → Certificates**.
* Клацніть правою кнопкою миші на **Certificates → All Tasks → Import**.
* Виконайте імпорт сертифікату:
  * Виберіть завантажений сертифікат `ws-fed-signing-ecp.cer` і помістіть його до сховища **Trusted Root Certification Authorities**
* Натисніть **Next** → **Finish**.

<div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FGEkCFL5AkFFPXlFAzr4R%2Fimage.png?alt=media&#x26;token=656cbe4c-2947-43c3-9536-1f46908e850a" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FQUEtmAIdkMs3cR7l8Cwo%2Fimage.png?alt=media&#x26;token=da5e2f90-c285-4656-a410-dc2791b3c585" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FSzOujC6bYXuPgYmZDc8V%2Fimage.png?alt=media&#x26;token=c975928f-9f19-4e87-beb7-d6fbeb1e6c2e" alt=""><figcaption></figcaption></figure></div>

<div><figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FqnVPFcxoL9aum4EzjTN0%2Fimage.png?alt=media&#x26;token=cc508246-489c-4b96-88cc-88d9b988ae79" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FEOqKlc2NZyr5TAEqio2i%2Fimage.png?alt=media&#x26;token=8f2afa91-6502-439c-9608-23b95bec621c" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FP9TRhXBds5bNsFJmSS0U%2Fimage.png?alt=media&#x26;token=3ad96ea7-0603-47b9-b78c-e6d513b53ae4" alt=""><figcaption></figcaption></figure> <figure><img src="https://769097311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpKRXTYXEkPs85kZZW5MX%2Fuploads%2FvtXfx39WoF3WHxRnALf7%2Fimage.png?alt=media&#x26;token=0aaf102a-3f3e-4cc1-a307-85c6a2896d90" alt=""><figcaption></figcaption></figure></div>

### **2. Виконайте команди в Exchange Management Shell для EAC**

* Відкрийте **Exchange Management Shell** на сервері Exchange і Виконайте команду для налаштування автентифікації EAC:

{% code overflow="wrap" %}

```powershell
Set-OrganizationConfig -AdfsIssuer "{Hideez WS Fed URL}" -AdfsAudienceUris "{ECP Base URL}" -AdfsSignCertificateThumbprint {Hideez Cert Thumbprint}
```

{% endcode %}

* **{ECP Base URL}**: базовий URL для EAC (наприклад, `https://mail.example.com/ecp/`).
* **{Hideez WS Fed URL}**: URL WS Federation IdP (наприклад, `https://dev.hideez.com/wsfed`).
* **{Hideez Cert Thumbprint}**: Thumbprint сертифіката IdP, завантаженого раніше.

**Приклад команди:**

{% code overflow="wrap" %}

```powershell
Set-OrganizationConfig -AdfsIssuer "https://dev.hideez.com/wsfed" -AdfsAudienceUris "https://exch.lab.hideez.com/ecp/" -AdfsSignCertificateThumbprint 3e04c68e71a591de637d0d21dcfd8e6f4b843684
```

{% endcode %}

{% hint style="info" %}
Якщо вам необхідно одночасно налаштувати Outlook Web Application (OWA) і Exchange Admin Center (EAC), ви можете скористатися наступною командою:

{% code overflow="wrap" %}

```powershell
Set-OrganizationConfig -AdfsIssuer "{Hideez WS Fed URL}" -AdfsAudienceUris "{OWA Base URL}","{ECP Base URL}" -AdfsSignCertificateThumbprint {Hideez Cert Thumbprint}
```

{% endcode %}

#### Пояснення параметрів команди:

* **{Hideez WS Fed URL}**: URL точки доступу Hideez WS Federation, яка виконує роль постачальника ідентифікації (IdP) для автентифікації.
* **{OWA Base URL}**: Базовий URL для сервісу Outlook Web Application (OWA) як постачальника послуг (SP), наприклад: `https://mail.example.com/owa/`.
* **{ECP Base URL}**: Базовий URL для сервісу Exchange Admin Center (EAC) як постачальника послуг (SP), наприклад: `https://mail.example.com/ecp/`.
* **{Hideez Cert Thumbprint}**: Відбиток сертифіката підпису Hideez, встановленого на сервері Exchange, який використовується для встановлення довірчих відносин.

#### Приклад:

{% code overflow="wrap" %}

```powershell
Set-OrganizationConfig -AdfsIssuer "https://dev.hideez.com/wsfed" -AdfsAudienceUris "https://exch.lab.hideez.com/owa/","https://exch.lab.hideez.com/ecp/" -AdfsSignCertificateThumbprint d80e7aa3d27ac800fb2d5fa7c08748a73d924cd2
```

{% endcode %}
{% endhint %}

## **Крок 5: Налаштування віртуальних директорій**

1. **Виконайте команду для OWA:**

   <pre class="language-powershell" data-overflow="wrap"><code class="lang-powershell">Get-OwaVirtualDirectory | Set-OwaVirtualDirectory -AdfsAuthentication $true -BasicAuthentication $false -DigestAuthentication $false -FormsAuthentication $false -WindowsAuthentication $false
   </code></pre>
2. **Виконайте команду для EAC:**

   <pre class="language-powershell" data-overflow="wrap"><code class="lang-powershell">Get-EcpVirtualDirectory | Set-EcpVirtualDirectory -AdfsAuthentication $true -BasicAuthentication $false -DigestAuthentication $false -FormsAuthentication $false -WindowsAuthentication $false
   </code></pre>

## **Крок 6: Перезапуск Internet Information Services (IIS)**

```powershell
net stop was /y
net start w3svc
```
