Page History
The
Azure Identity Connector can be configured using the Rest API.
The following pages describe the necessary objects to be created:
- Connection
- Connector
- Seed
Bellow are the examples of how to create the Connection and the Seed. For the Connector please check this page.
| title | On this page |
|---|
Credentials
Configure the Credentials to be used by the Connection object when using the Aspire REST API.
Connection
Configure the Connection to be used by the Azure Identity Connector when using the Aspire REST API.
Connector
Configure the Azure Identity Connector properties when using the Aspire REST API.
Seed
Configure the Seed for the different Azure Identity Connectors when using the Aspire REST API.
Create Connection
| Field | Optional | Default | Multiple | Notes | Example |
|---|---|---|---|---|---|
| type | No | - | No | The value must be "filesystem". | "filesystem" |
| description | No | - | No | Name of the connection object. | "MyFileSystemConnection" |
| throttlePolicy | Yes | - | No | Id of the throttle policy that applies to this connection object. | "f5587cee-9116-4011-b3a9-6b235b333a1b" |
| routingPolicies | Yes | [ ] | Yes | The ids of the routing policies that this connection will use. | ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"] |
| properties | No | - | No | Configuration object | |
| url | No | - | No | Path of the base directory to crawl. All the seeds will be prefixed with this value to form the full path. All the seeds will be prefixed with this value to form the full path | "C:\\Directory" |
| ignoreSymLinks | Yes | false | No | If enabled symbolic links will not be processed and links in the root items will cause an error. | true / false |
| stopOnScanError | Yes | true | No | If enabled, the crawl will stop if there is an error on the scan phase. | true / false |
| indexContainers | Yes | false | No | Enable to index the directories. | true / false |
| scanRecursively | Yes | true | No | Enable to scan discovered directories recursively. | true / false |
| include | Yes | [ ] | Yes | Patterns to match against document URL, if any of them match, the document will be included in the crawl. | [ ".*pdf$", ".*docx$" ] |
| exclude | Yes | [ ] | Yes | Patterns to match against document URL, if any of them match, the document will be excluded from the crawl. | [ ".*png$", ".*jpeg$" ] |
| scanExcludedItems | Yes | false | No | Enable to force the scan of excluded directories, so child items within the scope can be found. | true / false |
| staticAcl | Yes | [ ] | Yes | Static ACL configuration object | |
| name | No | - | No | Name of the static ACL. | "group1" |
| domain | Yes | "" | No | Domain of the static ACL. | "testDomain" |
| entity | Yes | "user" | No | Entity (user / group) represented by the static ACL. | "user" / "group" |
| access | Yes | "allow" | No | Access (allow / deny) granted by the ACL. | "allow" / "deny" |
Example
| Saga_json | ||
|---|---|---|
| ||
{
"type": "filesystem",
"description": "FileSystem Test Connector",
"properties": {
"url": "C:\\Directory",
"ignoreSymLinks": true,
"stopOnScanError": true,
"indexContainers": true,
"scanExcludedItems": true,
"ignoreSymLinks": true,
"includes": ".*\\.txt",
"excludes": ".*\\.png",
"staticAcl": [{
"name": "test-user",
"domain": "test-domain",
"entity": "user",
"access": "allow"
}, {
"name": "test-group",
"domain": "",
"entity": "group",
"access": "deny"
}
]
}
} |
Update connection
| Field | Optional | Default | Multiple | Notes | Example |
|---|---|---|---|---|---|
| id | No | - | No | Id of the connection to update | "89d6632a-a296-426c-adb0-d442adcab4b0", |
| type | No | - | No | The value must be "filesystem". | "filesystem" |
| description | Yes | - | No | Name of the connection object. | "MyFileSystemConnection" |
| throttlePolicy | Yes | - | No | Id of the throttle policy that applies to this connection object. | "f5587cee-9116-4011-b3a9-6b235b333a1b" |
| routingPolicies | Yes | [ ] | Yes | The ids of the routing policies that this connection will use. | ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"] |
| properties | No | - | No | Configuration object | |
| url | No | - | No | Path of the base directory to crawl. All the seeds will be prefixed with this value to form the full path. All seeds will be prefixed with this value to form the full path | "C:\\Directory" |
| ignoreSymLinks | Yes | false | No | If enabled symbolic links will not be processed and links in the root items will cause an error. | true / false |
| stopOnScanError | Yes | true | No | If enabled, the crawl will stop if there is an error on the scan phase. | true / false |
| indexContainers | Yes | false | No | Enable to index the directories. | true / false |
| scanRecursively | Yes | true | No | Enable to scan discovered items recursively. | true / false |
| include | Yes | [ ] | Yes | Patterns to match against document URL, if any of them match, the document will be included in the crawl. | [ ".*pdf$", ".*docx$" ] |
| exclude | Yes | [ ] | Yes | Patterns to match against document URL, if any of them match, the document will be excluded from the crawl. | [ ".*png$", ".*jpeg$" ] |
| scanExcludedItems | Yes | false | No | Enable to force the scan of excluded directories, so child items within the scope can be found. | true / false |
| staticAcl | Yes | [ ] | Yes | Static ACL configuration object | |
| name | No | - | No | Name of the static ACL. | "group1" |
| domain | Yes | "" | No | Domain of the static ACL. | "testDomain" |
| entity | Yes | "user" | No | Entity (user / group) represented by the static ACL. | "user" / "group" |
| access | Yes | "allow" | No | Access (allow / deny) granted by the ACL. | "allow" / "deny" |
Example
| Saga_json | ||
|---|---|---|
| ||
{
"id": "89d6632a-a296-426c-adb0-d442adcab4b0",
"type": "filesystem",
"description": "FileSystem Test Connector",
"properties": {
"url": "C:\\Directory",
"ignoreSymLinks": true,
"stopOnScanError": true,
"indexContainers": true,
"scanRecursively": true,
"scanExcludedItems": true,
"includes": ".*\\.txt",
"excludes": ".*\\.png",
"staticAcl": [{
"name": "test-user",
"domain": "test-domain",
"entity": "user",
"access": "allow"
}, {
"name": "test-group",
"domain": "",
"entity": "group",
"access": "deny"
}
]
}
} |
Create Seed
| Field | Optional | Default | Multiple | Notes | Example |
|---|---|---|---|---|---|
| seed | No | - | No | The subdirectory to crawl. This value will be appended to the url of the connection. | "directory" |
| type | No | - | No | The value must be "filesystem". | "filesystem" |
| description | No | - | No | Name of the seed object. | "MyFileSystemConnection" |
| connector | No | - | No | The id of the connector to be used with this seed. The connector type must match the seed type. | "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31" |
| connection | No | - | No | The id of the connection to be used with this seed. The connection type must match the seed type. | "602d3700-28dd-4a6a-8b51-e4a663fe9ee6" |
| workflows | Yes | [ ] | Yes | The ids of the workflows that will be executed for the documents crawled. | ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"] |
| throttlePolicy | Yes | - | No | Id of the throttle policy that applies to this connection object. | "f5587cee-9116-4011-b3a9-6b235b333a1b" |
| routingPolicies | Yes | [ ] | Yes | The ids of the routing policies that this seed will use. | ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"] |
| tags | Yes | [ ] | Yes | The tags of the seed. | ["tag1", "tag2"] |
Example
| Saga_json | ||
|---|---|---|
| ||
{
"type": "filesystem",
"seed": "directory",
"connector": "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31",
"description": "FileSystem_Test_Seed",
"throttlePolicy": "6b8b5f23-fc77-47a1-9b58-106577162e7b",
"routingPolicies": ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"],
"connection": "602d3700-28dd-4a6a-8b51-e4a663fe9ee6",
"workflows": ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"],
"tags": ["tag1", "tag2"],
"properties": {
"seed": "directory"
}
} |
Update Seed
| Field | Optional | Default | Multiple | Notes | Example |
|---|---|---|---|---|---|
| id | No | - | No | Id of the seed to update. | "2f287669-d163-4e35-ad17-6bbfe9df3778" |
| seed | Yes | - | No | The subdirectory to crawl. This value will be appended to the url of the connection. | "directory" |
| description | Yes | - | No | Name of the seed object. | "MyFileSystemConnection" |
| connector | Yes | - | No | The id of the connector to be used with this seed. The connector type must match the seed type. | "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31" |
| connection | Yes | - | No | The id of the connection to be used with this seed. The connection type must match the seed type. | "602d3700-28dd-4a6a-8b51-e4a663fe9ee6" |
| workflows | Yes | [ ] | Yes | The ids of the workflows that will be executed for the documents crawled. | ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"] |
| workflows.add | Yes | [ ] | Yes | The ids of the workflows to add. | ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"] |
| workflows.remove | Yes | [ ] | Yes | The ids of the workflows to remove. | ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"] |
| throttlePolicy | Yes | - | No | Id of the throttle policy that applies to this connection object. | "f5587cee-9116-4011-b3a9-6b235b333a1b" |
| routingPolicies | Yes | [ ] | Yes | The ids of the routing policies that this seed will use. | ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"] |
| routingPolicies.add | Yes | [ ] | Yes | The ids of the routingPolicies to add. | ["b4d2579f-1a0a-4a8b-9fd4-d42780003b36"] |
| routingPolicies.remove | Yes | [ ] | Yes | The ids of the routingPolicies to remove. | ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7"] |
| tags | Yes | [ ] | Yes | The tags of the seed. These can be used to filter the seed | ["tag1", "tag3"] |
| tags.add | Yes | [ ] | Yes | The tags to add | ["tag4"] |
| tags.remove | Yes | [ ] | Yes | The tags to remove | ["tag2"] |
Example
| Saga_json | ||
|---|---|---|
| ||
{
"id": "2f287669-d163-4e35-ad17-6bbfe9df3778",
"type": "filesystem",
"seed": "directory",
"connector": "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31",
"description": "FileSystem_Test_Seed",
"throttlePolicy": "6b8b5f23-fc77-47a1-9b58-106577162e7b",
"routingPolicies": ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"],
"connection": "602d3700-28dd-4a6a-8b51-e4a663fe9ee6",
"workflows": ["b255e950-1dac-46dc-8f86-1238b2fbdf27", "f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"],
"tags": ["tag", "tag2"],
"properties": {
"seed": "directory"
}
} |
Overview
Content Tools