Skip to content

Commit

Permalink
Merge pull request #1652 from MicrosoftDocs/main
Browse files Browse the repository at this point in the history
Publish main to live, Monday 10:30 AM PST, 12/16
  • Loading branch information
Ruchika-mittal01 authored Dec 16, 2024
2 parents 2b76211 + 3c601a5 commit 228e60a
Show file tree
Hide file tree
Showing 5 changed files with 44 additions and 9 deletions.
15 changes: 12 additions & 3 deletions MicrosoftSearch/connectors-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,15 +75,24 @@ You can connect to the following data sources by using connectors created by Mic
* [Confluence On-premises](confluence-onpremises-connector.md)
* [CSV](csv-connector.md)
* [Custom connector](/graph/custom-connector-sdk-sample-overview)
* [Enterprise websites](enterprise-web-connector.md)
* [Enterprise websites cloud](enterprise-web-connector.md)
* [Enterprise websites on-premises](enterprise-web-connector-onprem.md)
* [File share](fileshare-connector.md)
* [GitHub](github-connector.md)
* [Google Drive](google-drive-connector.md)
* [Jira Cloud](jira-connector.md)
* [MediaWiki](mediawiki-connector.md)
* [File share](fileshare-connector.md)
* [Oracle SQL](OracleSQL-connector.md)
* [Salesforce](salesforce-connector.md)
* [PostgreSQL](postgresql-connector.md)
* [Salesforce CRM](salesforce-connector.md)
* [Salesforce Knowledge](salesforce-knowledge-connector.md)
* [ServiceNow Knowledge](servicenow-knowledge-connector.md)
* [ServiceNow Catalog](servicenow-catalog-connector.md)
* [ServiceNow Tickets](servicenow-tickets-connector.md)
* [SharePoint Server](sharepoint-server-connector.md)
* [Stack Overflow](stack-overflow-connector.md)
* [WordPress.org (on-prem)](wordpress-onprem-connector.md)
* [Zendesk Help Center](zendesk-help-center-connector.md)

The [Microsoft Graph connectors gallery](https://www.microsoft.com/microsoft-search/connectors) contains a brief description of each of these connectors. If you're ready to connect one of these data sources to your tenant, be sure to read the [Setup overview](configure-connector.md) and any other articles in the setup connectors by Microsoft section that apply to your data source.

Expand Down
4 changes: 2 additions & 2 deletions MicrosoftSearch/github-connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,9 +67,9 @@ This article is for Microsoft 365 administrators or anyone who configures, runs,

| Category | Permission | Permission Level |
| ------------ | ------------ | ------------ |
| Account Permissions | Email addresses | Read-only |
| Repository Permissions | Metadata | Read-only |
| Repository Permissions | Contents | Read-only |
| Repository Permissions | Metadata | Read-only |
| Account Permissions | Email addresses | 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)
Expand Down
2 changes: 1 addition & 1 deletion MicrosoftSearch/postgresql-connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The PostgreSQL Microsoft Graph connector allows your organization to index recor
This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors a PostgreSQL Graph connector.

>[!NOTE]
>The PostgreSQL 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).
>The PostgreSQL connector is in preview. If you wish to get access to try it, you need to enable [Targeted Release](/microsoft-365/admin/manage/release-options-in-office-365?view=o365-worldwide#set-up-the-release-option-in-the-admin-center) ring for your Admin account.
## Capabilities
- Index records from your PostgreSQL database using a SQL query.
Expand Down
30 changes: 28 additions & 2 deletions MicrosoftSearch/salesforce-knowledge-connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,34 @@ This documentation is for Microsoft 365 administrators or anyone who configures,
- The connector doesn't support ACLs (access control lists). All the data indexed using the Salesforce Knowledge connector is visible to all Microsoft 365 users in your tenant, accessible through Microsoft Search or Copilot.

## Prerequisites
- You must be a search admin for your organization's Microsoft 365 tenant.
- To create a new connection, use your organization’s Salesforce Knowledge Instance URL. This URL is the specific web address used to access and interact with Salesforce Knowledge's API services for data retrieval, which usually looks like `https://[COMPANY_NAME].my.salesforce.com`.
To connect to your Salesforce instance, you need your Salesforce instance URL, the client ID, and the client secret for OAuth 2.0 authentication. The following steps explain how you or your Salesforce administrator can get this information from your Salesforce account:

- Log in to your Salesforce instance and go to Setup
- Navigate to Apps -> App Manager.
- Select **New connected app**.
- Complete the API section as follows:
- Select the checkbox for **Enable Oauth settings**.
- Specify the Callback URL as: For **M365 Enterprise**: `https://gcs.office.com/v1.0/admin/oauth/callback`, for **M365 Government**: `https://gcsgcc.office.com/v1.0/admin/oauth/callback`
- Select these required OAuth scopes.
- Access and manage your data (API).
- Perform requests on your behalf at any time (refresh_token, offline_access).
- Select the checkbox for **Require secret for web server flow**.
- Save the app.
> [!div class="mx-imgBorder"]
> [![Screenshot that shows API section in Salesforce instance after admin has entered all required configurations listed above.](media/salesforce-connector/sf1.png)](media/salesforce-connector/sf1.png#lightbox)
- Copy the consumer key and the consumer secret. This information is used as the client ID and the client secret when you configure the connection settings for your Salesforce Knowledge Microsoft Graph connector in the Microsoft 365 admin portal.
> [!div class="mx-imgBorder"]
> [![Screenshot that shows results returned by API section in Salesforce instance after admin has submitted all required configurations. Consumer Key is at top of left column and Consumer Secret is at top of right column.](media/salesforce-connector/clientsecret.png)](media/salesforce-connector/clientsecret.png#lightbox)
- Before closing your Salesforce instance, follow these steps to ensure that refresh tokens don't expire:
- Go to Apps -> App Manager.
- Find the app you created and select the drop-down on the right. Select **Manage**.
- Select **edit policies**.
- For the refresh token policy, select **Refresh token is valid until revoked**.
> [!div class="mx-imgBorder"]
> [![Screenshot that shows select the Refresh Token Policy named "Refresh token is valid until revoked ".](media/salesforce-connector/oauthpolicies.png)](media/salesforce-connector/oauthpolicies.png#lightbox)
You can now use the [Microsoft 365 Admin Center](https://admin.microsoft.com/) to complete the rest of the setup process for your Salesforce Knowledge Graph connector.

## Get Started

Expand Down
2 changes: 1 addition & 1 deletion MicrosoftSearch/zendesk-help-center-connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ The Zendesk Help Center Graph connector allows your organization to index articl
This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors a Zendesk Help Center Graph connector.

>[!NOTE]
>The Zendesk Help Center 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).
>The Zendesk Help Center connector is in public preview. If you wish to get access to try it, you need to enable [Targeted Release](/microsoft-365/admin/manage/release-options-in-office-365?view=o365-worldwide#set-up-the-release-option-in-the-admin-center) ring for your Admin account.
## Capabilities
- Index Help Center articles
Expand Down

0 comments on commit 228e60a

Please sign in to comment.