Skip to content

Commit

Permalink
Merge branch 'main' into gc-setup-rchanda
Browse files Browse the repository at this point in the history
  • Loading branch information
rchanda1392 authored Nov 26, 2024
2 parents 481e8a3 + 49f98f2 commit 6a0e550
Show file tree
Hide file tree
Showing 18 changed files with 307 additions and 111 deletions.
155 changes: 104 additions & 51 deletions MicrosoftSearch/azure-devops-wiki-connector.md

Large diffs are not rendered by default.

3 changes: 3 additions & 0 deletions MicrosoftSearch/connectors-gallery.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@ The following connectors are under collaboration & communications.
|Microsoft Entra ID (formerly known as Azure Active Directory)|Rhein Insights|Enterprise search connector for indexing Entra ID. It can serve as a profile search, also for Azure B2C profiles, or as a source for early-binding security trimming. Comes with full sets of profile metadata and indexes all user-group relationships. For more information, see [Microsoft Entra ID](https://www.rheininsights.com/en/connectors/entra-id.php).|
|Azure DevOps|Microsoft|Allows your organization to search for work items in your Azure DevOps instance. For more information, see [Azure DevOps Microsoft Graph connector](/MicrosoftSearch/azure-devops-connector).|
|Box|Accenture|Box connector crawls content from a Box repository. The connector retrieves the supported elements using the RESTful API (Content API Basics 2.0 version); for authentication, it uses Box API (that uses OAuth 2). Each file is submitted with its metadata (size, location, last accessed, etc.). Updates are discovered automatically. For more information, see [Box connector](https://contentanalytics.digital.accenture.com/display/aspire40/Box++Connector).|
|CB Insights|CB Insights|Integrate CB Insights’ proprietary data and insights directly into Microsoft Copilot to instantly generate unique insights across all Microsoft 365 applications. Access data for public and private companies like funding events, business relationships, predictive outlook, and more. The CBI connector allows you to research, analyze, and share trusted, data-backed insights to bet on the right markets, source the right companies, and stay ahead of competitors. All teams across an organization can benefit from the connector — from sales, to IT, to finance — to help make informed, data-driven decisions. For more information, see [CB Insights connector](https://www.cbinsights.com/copilot-connector/).|
|Deltek|BA Insight|BA Insight's Deltek Vision connector honors the security of the source system and provides both full and incremental crawls so that users have the latest information available to them all the time. It indexes content from Deltek Vision into Azure, SharePoint Online, or SharePoint 2016/2013, surfacing it through BA Insight’s SmartHub to provide users with integrated search results. For more information, see [Deltek connector](https://www.bainsight.com/connectors/deltek-connector-sharepoint-azure-elasticsearch/).|
|Elite/3E|BA Insight|BA Insight’s Elite connector provides a single point of access for lawyers to access firm content and knowledge in line with Elite content using Microsoft Search. For more information, see [Elite/3E connector](https://www.bainsight.com/connectors/elite-connector-sharepoint-azure-elasticsearch/).|
|Symantec Enterprise Vault|Raytion| Secure enterprise search connector for reliably indexing content from Symantec Enterprise Vault and intelligently searching it with Microsoft Graph. It robustly indexes archived data, such as e-mails, attachments, files, calendar items, and contacts from Enterprise Vault in near real-time. The connector fully supports Symantec Enterprise Vault’s authentication models Basic, NTLM, and Kerberos authentication. For more information, see [Symantec Enterprise Vault connector](https://www.raytion.com/connectors/raytion-enterprise-vault-connector-2).|
Expand Down Expand Up @@ -123,6 +124,7 @@ The following connectors are under content management systems.
|LegalKEY|BA Insight|Securely indexes both the full text and metadata of client and matter records in LegalKEY into the Microsoft search engine, enabling a single searchable result set across content from multiple repositories. It allows organizations to tap into the wealth of information accessible within LegalKEY, SharePoint, and other repositories, making that data instantly actionable to users through search. For more information, see [LegalKEY connector](https://www.bainsight.com/connectors/legalkey-connector-sharepoint-azure-elasticsearch/).|
|Lotus Notes Databases|BA Insight|With BA Insight's IBM Notes Database connector, users have the ability to find content stored in Notes databases using Microsoft Search. Security defined within IBM Notes is automatically reflected in the search experience, which ensures that users see content for which they're authorized. Ultimately, users can find everything they need in one place. For more information, see [Lotus Notes Databases connector](https://www.bainsight.com/connectors/ibm-lotus-notes-connector-sharepoint-azure-elasticsearch/).|
|Lucid|Lucid Software|Find the Lucid document you need without leaving Microsoft 365. Microsoft admins can connect Lucid with Microsoft Graph connectors to surface Lucid documents right in Microsoft 365, plus set user permissions so that documents stay secure. For more information, see [Lucid connector](https://lucid.co/marketplace/0953d9f2/microsoft-graph-connector).|
|LumApps|LumApps|Empowers employees with seamless access to knowledge and resources across both LumApps and Microsoft 365. By leveraging LumApps, Microsoft 365 Copilot seamlessly integrates information from LumApps' intranet, news, and community posts with Microsoft 365 data like SharePoint documents and Teams conversations. It allows employees to get comprehensive answers, and collaborate more effectively, all within their familiar Microsoft 365 environment. For more information, see [LumApps connector](https://www.lumapps.com/platform/integrations/microsoft-365).|
|MediaPlatform PrimeTime|BA Insight|BA Insight’s MediaPlatform PrimeTime indexing connector makes it possible to make the content accessible to users via an organization’s enterprise search platform, combining the connector with BA Insight’s SmartHub. The BA Insight MediaPlatform PrimeTime connector retrieves information about channels and videos from MediaPlatform PrimeTime and indexes them via Microsoft Search. For more information, see [MediaPlatform PrimeTime connector](https://www.bainsight.com/connectors/mediaplatform-primetime-connector-sharepoint-azure-elasticsearch/).|
|MediaWiki|Microsoft|Enables your organization to search knowledge-based articles on sites it creates with MediaWiki. For more information, see [MediaWiki Microsoft Graph connector](/MicrosoftSearch/mediawiki-connector).|
|MediaWiki|Raytion|Secure enterprise search connector for reliably indexing content from MediaWiki and intelligently searching it with Microsoft Graph. It robustly indexes pages, discussion pages, and attachments from MediaWiki instances in near real-time. The connector fully supports MediaWiki’s built-in permission model, and MediaWiki installations based on Entra ID and other directory services. For more information, see [MediaWiki connector](https://www.raytion.com/connectors/raytion-mediawiki-connector).|
Expand Down Expand Up @@ -156,6 +158,7 @@ The following connectors are under content management systems.
|SharePoint Online|Rhein Insights|Enables the Enterprise search and Microsoft 365 connector for indexing Microsoft SharePoint Online. Reliably indexes all SharePoint sites, pages, lists, list items, and documents also in multi-geo scenarios. Comes with full metadata sets, advanced processing pipelines, document preview integrations, and full support for SharePoint Online's permission model. For more information, see [SharePoint Online connector](https://contentanalytics.digital.accenture.com/display/aspire40/SharePoint+Online+Connector).|
|Sitecore|BA Insight|BA Insight's Sitecore connector honors the security of the source system and provides both full and incremental crawls so the users have the latest information available to them all the time. For more information, see [Sitecore connector](https://www.bainsight.com/connectors/sitecore-connector-sharepoint-azure-elasticsearch/).|
|Sitecore|Raytion|Secure enterprise search connector for reliably indexing content from Sitecore and intelligently searching it with Microsoft Graph. It robustly indexes pages and attachments, and further generates document types in near real-time. The connector fully supports Sitecore’s permission model and the user and group management in the associated Entra ID. For more information, see [Sitecore connector](https://www.raytion.com/connectors/raytion-sitecore-connector).|
|S&P Global|S&P Global|Empowers clients by integrating S&P Global data directly into their Office 365 environment. This seamless integration allows users to access and surface critical S&P Global content within their familiar Microsoft tools like Copilot, SharePoint, Outlook, and Teams. The connector provides direct links to the wealth of information available on S&P Global platforms, enhancing productivity and decision-making by bringing data to your fingertips. The first datasets to be made available will be Commodity Insights Research datasets in early 2025. For more information, see [S&P Global connector](https://www.marketplace.spglobal.com/en/solutions/microsoft-graph-connector-(6a8b56b9-4c0c-4ddc-85ed-21a4648ee569)).|
|Veritas Enterprise Vault (Symantec eVault)|BA Insight|BA Insight's Veritas Enterprise Vault connector honors the security of the source system and provides full and incremental crawls. Hence, the users have the latest information available to them all the time. For more information, see [Veritas Enterprise Vault (Symantec eVault) connector](https://www.bainsight.com/connectors/enterprise-vault-connector-sharepoint-azure-elasticsearch/).|
|West km|BA Insight|The BA Insight West km connector supports search across transaction and litigation documents, including the creation of custom search results pages. For more information, see [West km connector](https://www.bainsight.com/connectors/westkm-connector-sharepoint-azure-elasticsearch/).|
|Xerox DocuShare|BA Insight|Users of BA Insight's Xerox DocuShare connector are able to search for the content housed in DocuShare repositories directly from within Microsoft Search, eliminating the need to perform multiple searches to locate needed content. For more information, see [Xerox DocuShare connector](https://www.bainsight.com/connectors/docushare-connector-sharepoint-azure-elasticsearch/).|
Expand Down
8 changes: 5 additions & 3 deletions MicrosoftSearch/create-search-results-pages.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: "Create a custom search results page in SharePoint Online"
ms.author: bstucker
author: bstuck
manager: bstuck
ms.author: misvenso
author: wobba
manager: wobba
ms.audience: Admin
ms.topic: article
ms.service: mssearch
Expand All @@ -18,6 +18,8 @@ One way to customize the search experience in SharePoint is to create a custom s
>[!NOTE]
> To make changes to the default Microsoft Search results page that is
available by default, please see [Customize the search results page](customize-search-page.md).
>
> A custom redirect URL pointing to the result page provided by Microsoft Search at `_layouts/15/search.aspx` is an unsupported scenario. SharePoint will navigate to `_layouts/15/search.aspx` with the needed parameters based on search box configuration.
With a custom results page, you can create a new page that can be used to control the layout and design of search results to support your organization's needs. You can use any built-in web parts, open-source search web parts from SharePoint Patterns and Practices community, and any custom web parts that you have developed using SharePoint Framework.

Expand Down
2 changes: 1 addition & 1 deletion MicrosoftSearch/edge-shortcuts.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ manager: kellis
ms.audience: Admin
ms.topic: article
ms.service: mssearch
localization_priority: Normal
ms.localizationpriority: Medium
ms.date: 03/15/2022
search.appverid:
- BFB160
Expand Down
121 changes: 121 additions & 0 deletions MicrosoftSearch/github-connector.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
---
title: "GitHub Graph connector for Microsoft Search and Copilot"
ms.author: efgilboa
author: vivg
manager: igala
audience: Admin
ms.audience: Admin
ms.topic: article
ms.service: mssearch
ms.localizationpriority: medium
search.appverid:
- BFB160
- MET150
- MOE150
description: "Set up the GitHub Microsoft Graph connector for Microsoft Search and Microsoft 365 Copilot"
ms.date: 11/11/2024
---

# GitHub Microsoft Graph connector (Preview)

The GitHub Graph Connector allows you to index content from GitHub repositories, making it easily searchable within the Microsoft 365 ecosystem. This connector is ideal for organizations that use GitHub for documentation, project files, or content management. By integrating GitHub data with Microsoft Search, users can access relevant content directly within Microsoft 365 applications, streamlining workflows and reducing the need to switch between platforms.

This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors a GitHub Graph connector.

>[!NOTE]
>The GitHub Graph connector is in preview. If you wish to get early access to try it, sign up using [this form](https://forms.office.com/r/JniPmK5bzm).
## Capabilities
- Index GitHub repositories and markdown files to make project documentation accessible in Microsoft 365.
- Enable end users to ask questions in Copilot related to project documentation and technical guides.
- How do I set up Project Alpha?
- Where can I find the deployment instructions?
- What is the architecture overview for this project?
- Summarize key sections in project documentation for quick reference
- Use [Semantic search in Copilot](semantic-index-for-copilot.md) to enable users to find relevant content based on keywords, personal preferences, and social connections.

## Limitations
- Only repository metadata and markdown files are indexed. Other GitHub entities such as issues, pull requests, and comments aren't indexed.
- Only markdown files up to 1 MB in size are supported. Larger files aren't indexed.

## Prerequisites
- You must be the **search admin** for your organization's Microsoft 365 tenant.
- You must have an active GitHub account where you have access to all the repositories you intend to index.

a. For personal repositories, you must be one of:
- A repository owner
- A repository collaborator

b. For organization-owned repositories, you must be one of:
- An outside collaborator
- An organization member as a direct collaborator
- An organization member with access through team memberships
- An organization member with access through default organization permissions
- An organization owner.
- You must have a personal access token (PAT). To learn more about the personal access tokens, see [Managing your personal access tokens - GitHub Docs](https://docs.github.com/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
- Your personal access token must have access to all repositories you want to index and must be granted the permission listed below.

For classic token:

| Category | Permission | Remarks |
| ------------ | ------------ | ------------ |
| Repo | All | Full control of private repositories |
| User | read:user | Read ALL user profile data |
| User | read:email | Access user email addresses (read-only) |

For the fine-grained token:

| Category | Permission | Permission Level |
| ------------ | ------------ | ------------ |
| Account Permissions | Email addresses | Read-only |
| Repository Permissions | Metadata | Read-only |
| Repository Permissions | Contents | Read-only |

- If you have organization-owned repositories, follow these extra steps:
- The organization administrator needs to allow access via personal access tokens. For instructions, see [Setting a personal access token policy for your organization - GitHub Docs](https://docs.github.com/organizations/managing-programmatic-access-to-your-organization/setting-a-personal-access-token-policy-for-your-organization#restricting-access-by-personal-access-tokens)
- If you're using fine-grained tokens, select the organization as the resource owner.

## Get Started

### 1. Display name
A display name is used to identify each citation in Copilot, helping users easily recognize the associated file or item. Display name also signifies trusted content. Display name is also used as a [content source filter](/MicrosoftSearch/custom-filters#content-source-filters). A default value is present for this field, but you can customize it to a name that users in your organization recognize.

### 2. Authentication Type

To authenticate and sync content from GitHub:<br>

1. **Authentication type** <br>
Choose the "Basic" option

2. **Personal Access Token (PAT)** <br>
Use your personal access token in place of a password. The repositories available for indexing depends on the access granted by your token.

## Custom Setup

Custom setup is for those admins who want to edit the default values for settings listed. Once you click on the "Custom Setup" option, you see three more tabs - Users, Content, and Sync.

### Users

**Access Permissions**

The GitHub connector supports search permissions visible to **Everyone** with access to this data source. For Everyone, indexed data appears in the search results for all users.
For identity transformation, refer to the [Map your non-Azure AD Identities | Microsoft Learn](map-non-aad.md).

### Content

Choose the repositories and file types (initially markdown files and other non-code documentation) you wish to make searchable.

**Manage Properties**

Here, you can add or remove available properties from your GitHub data source, assign a schema to the property (define whether a property is searchable, queryable, retrievable, or refinable), change the semantic label and add an alias to the property.

### Sync

The refresh interval determines how often your data is synced between the data source and the Graph connector index. There are two types of refresh intervals - full crawl and incremental crawl. For more information, see [refresh settings](configure-connector.md#step-8-refresh-settings).

You can change the default values of refresh interval from here if you want to.

## Troubleshooting
After publishing your connection, you can review the status under the **Data Sources** tab in the [admin center](https://admin.microsoft.com). To learn how to make updates and deletions, see [Manage your connector](manage-connector.md).

If you have issues or want to provide feedback, contact [Microsoft Graph | Support](https://developer.microsoft.com/en-us/graph/support).
2 changes: 1 addition & 1 deletion MicrosoftSearch/manage-access-files-sites.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ manager: kellis
ms.audience: Admin
ms.topic: article
ms.service: mssearch
localization_priority: Normal
ms.localizationpriority: Medium
search.appverid:
- BFB160
- MET150
Expand Down
2 changes: 1 addition & 1 deletion MicrosoftSearch/manage-search-schema.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ audience: Admin
ms.audience: Admin
ms.topic: article
ms.service: mssearch
localization_priority: Normal
ms.localizationpriority: Medium
search.appverid:
- BFB160
- MET150
Expand Down
Binary file added MicrosoftSearch/media/ado-wiki-content-tab.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added MicrosoftSearch/media/ado-wiki-create-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added MicrosoftSearch/media/ado-wiki-sync-tab.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added MicrosoftSearch/media/ado-wiki-users-tab.png
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.
2 changes: 1 addition & 1 deletion MicrosoftSearch/select-work-school-search-experience.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ manager: bstucker
ms.audience: Admin
ms.topic: article
ms.service: mssearch
localization_priority: Normal
ms.localizationpriority: Medium
ms.date: 03/15/2022
search.appverid:
- BFB160
Expand Down
Loading

0 comments on commit 6a0e550

Please sign in to comment.