Справочник по коннектору Elastic Outlook

Это подключение доступно в виде управляемого подключения (управляемая служба) в Elastic Cloud.

Это подключение совместимо с версиями Elastic 8.13.0+.

Чтобы использовать это подключение, выполните все требования к управляемым подключениям.

Чтобы создать новое подключение Outlook:

Для дополнительных операций см. Пользовательский интерфейс подключений в Kibana.

Вы можете использовать Elasticsearch API для создания подключения для создания нового подключения к Outlook.

Например:

resp = client.connector.put(
    connector_id="my-{service-name-stub}-connector",
    index_name="my-elasticsearch-index",
    name="Content synced from {service-name}",
    service_type="{service-name-stub}",
    is_native=True,
)
print(resp)

const response = await client.connector.put({
  connector_id: "my-{service-name-stub}-connector",
  index_name: "my-elasticsearch-index",
  name: "Content synced from {service-name}",
  service_type: "{service-name-stub}",
  is_native: true,
});
console.log(response);

PUT _connector/my-outlook-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from Outlook",
  "service_type": "outlook",
  "is_native": true
}

Подробную информацию обо всех доступных API для подключения см. в документации API Elasticsearch.

Чтобы использовать это подключение как управляемое подключение в Elastic Cloud, воспользуйтесь рабочим процессом Подключения в пользовательском интерфейсе Kibana.

Чтобы создать новое подключение Outlook:

Для дополнительных операций см. Пользовательский интерфейс подключений в Kibana.

Подключение Outlook поддерживает как облачные (Office365 Outlook), так и локальные (Exchange Server) платформы.

Для подключения к Exchange Server подключение извлекает пользователей Active Directory с помощью библиотеки python ldap3.

Для интеграции с подключением Outlook с помощью Azure, выполните следующие шаги для создания и настройки приложения Azure:

Теперь вы можете использовать полученные Client ID, Tenant ID и Client Secret для настройки подключения Outlook.

См. Извлечение содержимого.

Подключение синхронизирует следующие объекты и сущности:

По умолчанию для всех коннекторов поддерживаются полные синхронизации.

Этот коннектор также поддерживает инкрементальные синхронизации.

Безопасность на уровне документов (DLS) позволяет ограничить доступ к документам на основе разрешений пользователя. Обратитесь к настройкам на этой странице, чтобы узнать, как включить DLS для этого коннектора.

Основные правила синхронизации одинаковы для всех коннекторов и доступны по умолчанию.

Расширенные правила синхронизации недоступны для этого коннектора в текущей версии.

Примечание: Конечное тестирование недоступно в текущей версии коннектора.

В настоящее время для этого коннектора нет известных проблем. Обратитесь к Известным проблемам для получения списка известных проблем для всех коннекторов.

См. Устранение неполадок.

См. Безопасность.

Этот коннектор написан на Python с использованием фреймворка Elastic connector.

Просмотреть исходный код этого коннектора (ветка 8.17, совместимая с Elastic 8.17).

Этот коннектор доступен как самостоятельный самостоятельный коннектор. Для использования этого коннектора выполните все предварительные требования к самостоятельному коннектору.

Чтобы создать новый коннектор Outlook:

Вы можете использовать Elasticsearch API создания коннектора, чтобы создать новый самостоятельный коннектор Outlook с самостоятельным управлением.

Например:

resp = client.connector.put(
    connector_id="my-{service-name-stub}-connector",
    index_name="my-elasticsearch-index",
    name="Content synced from {service-name}",
    service_type="{service-name-stub}",
)
print(resp)

const response = await client.connector.put({
  connector_id: "my-{service-name-stub}-connector",
  index_name: "my-elasticsearch-index",
  name: "Content synced from {service-name}",
  service_type: "{service-name-stub}",
});
console.log(response);

PUT _connector/my-outlook-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from Outlook",
  "service_type": "outlook"
}

Подробные сведения обо всех доступных API коннекторов см. в документации API Elasticsearch.

Для использования этого коннектора как самостоятельного коннектора используйте плитку Outlook из списка коннекторов ИЛИ рабочие процессы настроенного коннектора.

Дополнительные операции см. в Пользовательском интерфейсе коннекторов в Kibana.

Коннектор Outlook поддерживает как облачные (Office365 Outlook), так и локальные (Exchange Server) платформы.

Для подключения к серверу Exchange коннектор извлекает пользователей Active Directory с помощью библиотеки Python ldap3.

Для интеграции с коннектором Outlook с помощью Azure выполните эти шаги для создания и настройки приложения Azure:

Теперь вы можете использовать идентификатор клиента, идентификатор клиента и секрет клиента, которые вы записали, для настройки коннектора Outlook.

Примечание: Эта настройка применима только для Outlook Server.

Вы можете развернуть коннектор Outlook как самостоятельный коннектор с помощью Docker. Следуйте этим инструкциям.

curl https://raw.githubusercontent.com/elastic/connectors/main/config.yml.example --output ~/connectors-config/config.yml

# When connecting to your cloud deployment you should edit the host value
elasticsearch.host: http://host.docker.internal:9200
elasticsearch.api_key: <ELASTICSEARCH_API_KEY>

connectors:
  -
    connector_id: <CONNECTOR_ID_FROM_KIBANA>
    service_type: outlook
    api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead

docker run \
-v ~/connectors-config:/config \
--network "elastic" \
--tty \
--rm \
docker.elastic.co/enterprise-search/elastic-connectors:8.17.3 \
/app/bin/elastic-ingest \
-c /config/config.yml

Дополнительные сведения см. в DOCKER.md в репозитории elastic/connectors.

Найдите все доступные Docker-образы в официальном реестре.

См. извлечение содержимого.

Коннектор синхронизирует следующие объекты и сущности:

Полные синхронизации поддерживаются по умолчанию для всех коннекторов.

Этот коннектор также поддерживает инкрементные синхронизации.

Безопасность на уровне документа (DLS) позволяет ограничивать доступ к документам на основе разрешений пользователя. Обратитесь к настройкам на этой странице, чтобы включить DLS для этого коннектора.

Основные правила синхронизации одинаковы для всех коннекторов и доступны по умолчанию.

Расширенные правила синхронизации недоступны для этого коннектора в текущей версии.

Примечание: Конечные тесты недоступны в текущей версии коннектора.

В настоящее время для этого коннектора нет известных проблем. Обратитесь к Известным проблемам для получения списка известных проблем для всех коннекторов.

См. Отладку.

См. Безопасность.

Этот коннектор входит в фреймворк коннекторов Elastic.

Просмотреть исходный код этого коннектора (ветка 8.17, совместимая с Elastic 8.17).