Skip to content

Commit cd609a5

Browse files
dimav78claude
andcommitted
Add 1Secure SharePoint Online Data Classification setup guide
- Add comprehensive setup guide for SPO Data Classification connector - Include Azure classifier deployment and configuration steps - Add troubleshooting section with common errors and solutions - Update SharePoint Online connector documentation with classifier reference - Replace connector image with updated version showing classification fields - Add proper MDX formatting and sidebar navigation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
1 parent cd19627 commit cd609a5

12 files changed

+30
-21
lines changed
121 KB
Loading

docs/1secure/admin/organizations/sourcesandconnectors/sharepointonline.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ pane is displayed.
5353

5454
**Step 6 –** Click **Next**.
5555

56-
![Choose New Connector %28Step 3 of 3%29 pane](/images/1secure/admin/organizations/sourcesandconnectors/addsourcesharepointonlineconnector.webp)
56+
![Choose New Connector %28Step 3 of 3%29 pane](addconnectorspo.png)
5757

5858
**Step 7 –** The Choose new connector (Step 3 of 3) pane lists three connectors for SharePoint
5959
Online. Specify the following:
@@ -78,6 +78,9 @@ Online. Specify the following:
7878
switch to ON to allow 1Secure to read the documents in order to classify and label them based on
7979
the type of data they contain.
8080

81+
- Establish connection to your Classifier app – See the
82+
[Configure SharePoint Online Classification App](/docs/1secure/configuration/registerconfig/1secure-classifier-setup-guide.md)
83+
topic for additional information.
8184
- Run OCR to improve classification of images (increases processing time) – Toggle this switch
8285
to ON to use Optical Character Recognition (OCR) to scan images for text, which helps to
8386
classify the sensitive data more effectively. Note that this increases the processing time for

docs/1secure/configuration/registerconfig/1secure-classifier-setup-guide.md

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
1-
# 🏷️ 1Secure Classifier Setup Guide
1+
---
2+
title: "Configure SharePoint Online Classification App"
3+
description: "Setup guide for 1Secure SPO Data Classification Connector and Azure classifier deployment"
4+
sidebar_position: 30
5+
---
26

3-
# Create 1Secure SPO Data Classification Connector
7+
# Configure SharePoint Online Classification App
8+
9+
## Create 1Secure SPO Data Classification Connector
410

511
* Log in to 1Secure
612
* Go to Configuration
@@ -9,7 +15,7 @@
915
* Select the SharePoint Online source's Connectors
1016
* Add/Edit SharePoint Online Data Classification
1117

12-
# Deploy and Configure the Classifier in Azure
18+
## Deploy and Configure the Classifier in Azure
1319

1420
* Create new resource group
1521
* Give current user at least: Domain Services Contributor, Contributor, Key Vault Secrets Officer, Key Vault Certificates User, and Role Based Access Control Administrator within resource group
@@ -27,7 +33,7 @@
2733
* Open Settings folder and go to Environment variables
2834
* Paste "default" key into "TextExtraction__ApiKey" value
2935

30-
# Register the Classifier in 1Secure
36+
## Register the Classifier in 1Secure
3137

3238
* In Azure classifier app, go to Overview
3339
* Click on the "Default domain" link and copy the full url (see below)
@@ -55,15 +61,15 @@
5561
* Press Register
5662
* After success, save and swap back to Azure Portal (tab 1)
5763

58-
# Set Up Classifier Link to SPO
64+
## Set Up Classifier Link to SPO
5965

60-
## On Azure Portal (tab 1)
66+
**On Azure Portal (tab 1):**
6167

6268
* Go to `<prefix>`-kv
6369
* Open Objects folder and go to Secrets![](attachments/ac55f3e0-fee7-4318-a86b-58e9899c3a10.png " =1738x283")
6470
* Swap to Azure Portal (tab 2)
6571

66-
## On Azure Portal (tab 2)
72+
**On Azure Portal (tab 2):**
6773

6874
* Open your SharePoint App Registration
6975

@@ -73,32 +79,32 @@
7379

7480
* Copy App Registration tenant ID
7581
* Swap to Azure Portal (tab 1)
76-
* Click on the secret with the name "source-auth-key-{Guid}-__tenant-id__"
82+
* Click on the secret with the name "source-auth-key-\{Guid\}-__tenant-id__"
7783
* Click "+New Version"
7884
* Paste the tenant ID as the secret value
7985
* Click Create\n![](attachments/beabf83e-a591-4914-be74-37cd6755fe25.png " =1510x876")
8086
* Copy App Registration client ID
8187
* Swap to Azure Portal (tab 1)
82-
* Click on the secret with the name "source-auth-key-{Guid}-__client-id__"
88+
* Click on the secret with the name "source-auth-key-\{Guid\}-__client-id__"
8389
* Click "+New Version"
8490
* Paste the client ID as the secret value
8591
* Click Create
8692

8793

88-
\
8994

90-
## On Azure Portal (tab 1)
95+
96+
**On Azure Portal (tab 1):**
9197

9298

9399
![](attachments/2dfd2ba5-c013-43b5-ae8f-c813dda8e9a0.png " =1852x685")
94100

95101
* Go to Certificates
96-
* Click on "sharepoint-auth-{Guid}"
102+
* Click on "sharepoint-auth-\{Guid\}"
97103
* Click on current version
98104
* Click on "Download in CER format"
99105
* Swap to Azure Portal (tab 2)
100106

101-
## On Azure Portal (tab 2)
107+
**On Azure Portal (tab 2):**
102108

103109
* Open Manage folder in App Registration and click Certificates & Secrets
104110
* Go to Certificates
@@ -108,30 +114,30 @@
108114

109115
![](attachments/3b0612ed-6b25-40c4-b091-7a5a73921914.png " =1409x817")
110116

111-
# Troubleshooting
117+
## Troubleshooting
112118

113-
## General Errors
119+
### General Errors
114120

115-
### Classification connector successfully registers but shows status 'New' even after a successful state crawl
121+
**Classification connector successfully registers but shows status 'New' even after a successful state crawl**
116122

117123
* There could be errors in the classifier app - check the Application Insights resource (in the classifier resource group, resource ending in `-ai`) for more detailed errors - use the below section for further troubleshooting steps
118124

119-
## Application Insights Errors
125+
### Application Insights Errors
120126

121-
### No ClientId was specified
127+
**No ClientId was specified**
122128

123129
*(Full error: Microsoft.Graph.ServiceException: Code: generalException Message: An error occurred sending the request. ---> MSAL.NetCore.4.70.2.0.MsalClientException: ErrorCode: no_client_id……)*
124130

125131
* Check that the client ID and tenant ID secrets are set in the KeyVault instance
126132

127-
### The maximum entity size has been reached or exceeded for queue
133+
**The maximum entity size has been reached or exceeded for queue**
128134

129135
* The classifier has been unable to process service bus messages and the queue is now full, the queue can be emptied. The classifications should be processed successfully on the next crawl.
130136
* In the classifier resource group, find the service bus namespace resource (named `<classifier-name>`**-class-sb-core**)
131137
* Open the **state-classification** queue, and click **Service Bus Explorer** in the left-hand side bar
132138
* Click **Peek Mode** and change it to **Receive Mode**, then click **Purge messages**
133139

134-
### Name or service not known
140+
**Name or service not known**
135141

136142
*(Example error: Microsoft.Graph.ServiceException: Code: generalException*\n*Message: An error occurred sending the request.*\n *---> System.AggregateException: Retry failed after 4 tries. Retry settings can be adjusted in ClientOptions.Retry or by configuring a custom retry policy in ClientOptions.RetryPolicy. (Name or service not known (*`<classifier-name>`*-kv:443))*
137143

63.8 KB
Loading
67.6 KB
Loading
54 KB
Loading
68.9 KB
Loading
47.7 KB
Loading
36.2 KB
Loading
36.8 KB
Loading

0 commit comments

Comments
 (0)