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

Этот управляемый коннектор был представлен в Elastic 8.14.0 в качестве управляемой службы в Elastic Cloud.

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

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

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

Вы можете использовать Elasticsearch API для создания коннекторов для создания нового нативного коннектора Microsoft Teams.

Например:

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-microsoft_teams-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from Microsoft Teams",
  "service_type": "microsoft_teams",
  "is_native": true
}

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

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

Если вы уже знакомы с принципом работы коннекторов, вы также можете использовать API коннекторов.

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

Для подключения к Microsoft Teams необходимо создать приложение и сервисный принцип в Azure Active Directory, которые могут получить доступ к ресурсам. Следуйте этим шагам:

После завершения используйте следующие параметры конфигурации для настройки коннектора.

Необходимы следующие поля конфигурации:

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

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

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

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

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

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

См. Известные проблемы для списка известных проблем для всех коннекторов.

См. Поиск и устранение неисправностей.

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

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

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

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

Например:

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-microsoft_teams-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from Microsoft Teams",
  "service_type": "microsoft_teams"
}

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

Чтобы использовать этот коннектор как самостоятельный коннектор, воспользуйтесь плиткой Microsoft Teams из списка коннекторов в работе с настроенными коннекторами.

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

Для подключения к Microsoft Teams необходимо создать приложение и службу-принципал Azure Active Directory, которые могут получить доступ к ресурсам. Следуйте этим шагам:

После завершения используйте следующие параметры конфигурации для настройки коннектора.

Необходимы следующие поля конфигурации:

Вы можете развернуть коннектор Microsoft Teams в качестве самостоятельного коннектора с использованием 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: microsoft_teams
    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 образы в официальном репозитории.

Обратитесь к извлечению содержимого.

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

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

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

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

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

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

Для выполнения тестирования от начала до конца для коннектора Teams выполните следующую команду:

$ make ftest NAME=microsoft_teams

Для более быстрых тестов добавьте флаг DATA_SIZE=small:

make ftest NAME=microsoft_teams DATA_SIZE=small

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

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

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