|
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 | +--- |
2 | 6 |
|
3 | | -# Create 1Secure SPO Data Classification Connector |
| 7 | +# Configure SharePoint Online Classification App |
| 8 | + |
| 9 | +## Create 1Secure SPO Data Classification Connector |
4 | 10 |
|
5 | 11 | * Log in to 1Secure |
6 | 12 | * Go to Configuration |
|
9 | 15 | * Select the SharePoint Online source's Connectors |
10 | 16 | * Add/Edit SharePoint Online Data Classification |
11 | 17 |
|
12 | | -# Deploy and Configure the Classifier in Azure |
| 18 | +## Deploy and Configure the Classifier in Azure |
13 | 19 |
|
14 | 20 | * Create new resource group |
15 | 21 | * 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 | 33 | * Open Settings folder and go to Environment variables |
28 | 34 | * Paste "default" key into "TextExtraction__ApiKey" value |
29 | 35 |
|
30 | | -# Register the Classifier in 1Secure |
| 36 | +## Register the Classifier in 1Secure |
31 | 37 |
|
32 | 38 | * In Azure classifier app, go to Overview |
33 | 39 | * Click on the "Default domain" link and copy the full url (see below) |
|
55 | 61 | * Press Register |
56 | 62 | * After success, save and swap back to Azure Portal (tab 1) |
57 | 63 |
|
58 | | -# Set Up Classifier Link to SPO |
| 64 | +## Set Up Classifier Link to SPO |
59 | 65 |
|
60 | | -## On Azure Portal (tab 1) |
| 66 | +**On Azure Portal (tab 1):** |
61 | 67 |
|
62 | 68 | * Go to `<prefix>`-kv |
63 | 69 | * Open Objects folder and go to Secrets |
64 | 70 | * Swap to Azure Portal (tab 2) |
65 | 71 |
|
66 | | -## On Azure Portal (tab 2) |
| 72 | +**On Azure Portal (tab 2):** |
67 | 73 |
|
68 | 74 | * Open your SharePoint App Registration |
69 | 75 |
|
|
73 | 79 |
|
74 | 80 | * Copy App Registration tenant ID |
75 | 81 | * 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__" |
77 | 83 | * Click "+New Version" |
78 | 84 | * Paste the tenant ID as the secret value |
79 | 85 | * Click Create\n |
80 | 86 | * Copy App Registration client ID |
81 | 87 | * 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__" |
83 | 89 | * Click "+New Version" |
84 | 90 | * Paste the client ID as the secret value |
85 | 91 | * Click Create |
86 | 92 |
|
87 | 93 |
|
88 | | -\ |
89 | 94 |
|
90 | | -## On Azure Portal (tab 1) |
| 95 | + |
| 96 | +**On Azure Portal (tab 1):** |
91 | 97 |
|
92 | 98 |
|
93 | 99 |  |
94 | 100 |
|
95 | 101 | * Go to Certificates |
96 | | -* Click on "sharepoint-auth-{Guid}" |
| 102 | +* Click on "sharepoint-auth-\{Guid\}" |
97 | 103 | * Click on current version |
98 | 104 | * Click on "Download in CER format" |
99 | 105 | * Swap to Azure Portal (tab 2) |
100 | 106 |
|
101 | | -## On Azure Portal (tab 2) |
| 107 | +**On Azure Portal (tab 2):** |
102 | 108 |
|
103 | 109 | * Open Manage folder in App Registration and click Certificates & Secrets |
104 | 110 | * Go to Certificates |
|
108 | 114 |
|
109 | 115 |  |
110 | 116 |
|
111 | | -# Troubleshooting |
| 117 | +## Troubleshooting |
112 | 118 |
|
113 | | -## General Errors |
| 119 | +### General Errors |
114 | 120 |
|
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** |
116 | 122 |
|
117 | 123 | * 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 |
118 | 124 |
|
119 | | -## Application Insights Errors |
| 125 | +### Application Insights Errors |
120 | 126 |
|
121 | | -### No ClientId was specified |
| 127 | +**No ClientId was specified** |
122 | 128 |
|
123 | 129 | *(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……)* |
124 | 130 |
|
125 | 131 | * Check that the client ID and tenant ID secrets are set in the KeyVault instance |
126 | 132 |
|
127 | | -### The maximum entity size has been reached or exceeded for queue |
| 133 | +**The maximum entity size has been reached or exceeded for queue** |
128 | 134 |
|
129 | 135 | * 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. |
130 | 136 | * In the classifier resource group, find the service bus namespace resource (named `<classifier-name>`**-class-sb-core**) |
131 | 137 | * Open the **state-classification** queue, and click **Service Bus Explorer** in the left-hand side bar |
132 | 138 | * Click **Peek Mode** and change it to **Receive Mode**, then click **Purge messages** |
133 | 139 |
|
134 | | -### Name or service not known |
| 140 | +**Name or service not known** |
135 | 141 |
|
136 | 142 | *(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))* |
137 | 143 |
|
|
0 commit comments