DuoCircle is a mail management system protecting businesses against ransomware, phishing, spoofing, and fraud in email. DuoCircle also provide Spam filtering, email archiving and outbound SMTP. DuoCircle connector can be used to manage Recipient and forward address to support this.
DuoCircle supports REST based APIs. The connector is using these APIs to do the processing. The API authentication is based on the API key. Service Id is the Id corresponding to the service the client is using. This is an optional parameter and is fetched dynamically during connector processing when it is not configured
Functionalities
Provisioning Integration
Data Format |
Export |
Create |
Modify |
Delete |
Trigger |
---|---|---|---|---|---|
Recipient |
Yes |
Yes |
Yes |
Yes |
No |
DuoCircle is a Provisioning only connector. It supports export, lookup and import of Recipients. Recipient alias and forward address can be managed using the sub records from Recipient data format. Paging and filtering is not supported by the API. Filter support is added by processing it at the connector level.
Creating the Connected System in the Admin UI
- Log in to Identity Administration and click the Systems tab.
- On the Connected System View page, click the Add button and select DuoCircle from the Type drop-down list. The Connected System Details page displays the default values:
Only configurations which are specific to DuoCircle is documented below. For an overview of the configuration which are common to all connectors, please refer to our link to “connected systems guide”.
Connection Information | |
Service URL |
The URL of the custom domain.eg: - https://api.duocircle.com |
API key |
Enter the API key obtained from duocircle. |
Service Id |
Service Id is the Id corresponding to the service the client is using. It is optional and fetched dynamically during connector processing. |
Creating the Connected System in the Studio
- Log in to the Workflow and Connectivity Studio and click Connectivity -> Add Systems on the menu bar. The Add Connected Systems window displays.
- Select Salesforce RESTfrom the Type drop-down list. The default values display.
- Enter the required information. Only configurations which are specific to DuoCircle will be documented below. For an overview of the configuration which are common to all connectors, please refer to our link to “connected systems guide”.
Connection Information Service URL
The URL of the custom domain. e.g. - https://api.duocircle.com
API key
Enter the API key obtained from duocircle.
Service Id
Service Id is the Id corresponding to the service the client is using. It is optional and fetched dynamically during connector processing.
Using the Connected System for Provisioning
Perform these procedures to configure the connector:
- Connector Details for Identity
Connector Details for Identity
This table lists values to enter when associating the Identity user with an existing user in the DuoCircle connected system:
Field |
System Attribute |
Example Value |
Account ID |
Id |
468383 |
Login ID |
address |
Using the Connected System for Provisioning
Perform these procedures to configure the connector:
- Configuring for Export
- Configuring for Import
- Connector Details for Provisioning
Note: If the number of records to be processed exceeds one thousand, we recommend configuring the workflow to use bulk mode, which lowers the memory consumption of the system by streaming data to files. Because data is streamed for every task, performance of the workflow execution will be decreased due to increased read-write operations. See the Workflow and Connectivity Studio document for details on how to configure bulk mode.
Configuring for Export
Perform these procedures to configure the connector for data export:
- Configuring the Export Connector
- Configuring the Export Link
From the Workflow and Connectivity Studio, select the DuoCircle User Export workflow listed under the projects folder. If a workflow does not already exist, create an export workflow. See Workflow and Connectivity Studio for details on creating export workflows.
Configuring the Export Connector
- In the Design pane, double-click the export object (the first object after the Start object). The Configure Data Source window displays:
-
From the Configure Plug-In tab, set the properties as required:
Associated Connected System
Select the connected System from the list. The export will be done from this connected system
Data Formats
Select the type of data format to use: Recipient
DeltaExportMode
Select the type of attribute to export if a change takes place (this works in conjunction with ExportMode when DeltaExport is selected):
- OnlyChangedAttributes - Performs a partial export of only the changed attributes from the last time the query was run.
- ChangedAndMandatoryAttributes (default) - Performs a partial export of both changed and mandatory attributes from the last time the query was run. Mandatory attributes are exported whether they have been changed or not.
- AllAttributes - Performs a full export of all attributes that contain a value.
DynamicConnectedSystem
Select the global variable to use as the dynamic connected system name. This works in conjunction with DynamicConnectedSystemOption when GlobalVariable is selected.
DynamicConnectedSystemOption
Select how to control Dynamic System Support (DSS):
- None - There will not be any Dynamic System Support.
- Transaction-SystemName - The value of the Transaction-SystemName attribute in data will be used as the dynamic connected system. The connected system name must be passed as the value of the attribute Transaction-SystemName; if it is missing in data, the operation will fail.
- GlobalVariable - Select a global variable to use as the dynamic connected system name from the property DynamicConnectedSystem.
ExecuteGIGAssociatedTaskAsynchronously
If this property is True, GIG associated tasks will execute asynchronously.
ExportMode
Select the type of data to export:
- FullExport - Exports all attributes
- DeltaExport - Exports changed, mandatory, or all attributes, depending on the DeltaExportMode property setting.
Filter
Specify search criteria to determine the objects to be exported from the DuoCircle Connected System. Use the Set Filter button that becomes active to create a filter. See the Set Filter section for additional information.
MaxResults
Select the maximum number of results to be returned.
GetRecipientById
Option to fetch a recipient details by providing Id.
Set Filter
Setting the filter is a means to narrow the search scope and return specific results.
Element Description Attribute
Select the attribute of the filter. This represents the attribute name for searching the Salesforce REST system.
Comparison
Select the operator value for this filter. Some attributes do not support certain operator values.
AND Condition List
Creates an AND statement comparing selected conditions. If there is more than one condition in this list box, all conditions must be true.
Filter Syntax
Displays the filter syntax used to retrieve entries from the Salesforce REST and to build the export list.
- Using logical AND, generate the complex filter to narrow the search result.
- Click OK when complete to return to the Configure Data Source window.
- (Optional) Select the Attributes Only the standard attributes display:
Modify schema attributes using these buttons.
Element Description Add
Add additional attributes to the list. The Add New attribute dialog displays.
Note: Only attributes that are present in the business Object schema can be added. If they are not in the business Object schema they will be disregarded.
Export
Export the schema list to an XML file.
Import
Imports the schema list from an XML file.
Reset Schema
Resets the schema definition to the default schema pre-packaged with the IDM Suite.
- (Optional) Select the Appearance tab to change how the Connected System object displays in the Design pane.
Click OK and save any changes and return to the Workflow and Connectivity Studio
Configuring the Export Link
-
In the Design pane, double-click the export link between the export object (the first workflow object after the Start object) and the Data Mapper object. The Configure Link window displays:
Description Source Attributes
Select the attribute to export
Selected Attributes
Displays default attributes and those attributes that have been selected from the Source Attributes.
Note: The check boxes are used only for delta export operations. These checked attributes will always be exported whether they were changed or not. Usually, the attributes that are selected as mandatory attributes help in identifying or verifying an entry when completing mapping functions.
Advanced Settings
Displays the Configure Attributes window for configuring advanced settings for attributes. Under the Encrypted column, check the box of any attribute that needs to be encrypted.
- From the Attribute Selection tab, select attributes to export.
- Click Ok to save any changes and return to Workflow and Connectivity Studio
- Deploy the workflow by selecting Deploy New Deployment. See the Workflow and Connectivity Studio documentation for details of deployment options.
- Manage and run the deployed workflow from the AdminUI Server See the “Identity Suite Administration” documentation for details.
Configuring for Import
Perform these procedures to configure the connector for data import:
- Configure the import Connector
- Configure the Import Link
From the Workflow and Connectivity Studio, select the DuoCircle UserAdd, UserModify, or UserDelete workflow listed under the projects folder. If a workflow does not already exist, create an import workflow. See the “Workflow and Connectivity Studio” documentation for details on creating import workflows.
Configuring the Import Connector
- In the design pane, double-click the import object (the last workflow object). The Configure Data Sourcewindow displays:
-
From the Configure Plug-Intab, set these properties as required:
Associated Connected System
Select the connected system from the list. The import operation will be done to this connected system.
Data Formats
Select the type of data format to use: Recipient
DynamicConnectedSystem
Select the global variable to use as the dynamic connected system name. This works in conjunction with the DynamicConnectedSystemOption when GlobalVariable is selected.
DynamicConnectedSystemOption
Select how to control Dynamic System Support (DSS):
- None - There will not be any Dynamic System Support.
- Transaction-SystemName - The value of the Transaction-SystemName attribute in data will be used as the dynamic connected system. The connected system name must be passed as the value of the attribute Transaction-SystemName; if it is missing in data, the operation will fail.
- GlobalVariable - Select a global variable to use as the dynamic connected system name from the property DynamicConnectedSystem.
ExecuteGIGAssociatedTaskAsynchronously.
If this property is True, GIG associated tasks will execute asynchronously
Id
Specify the attribute that contains the value used to uniquely identity the user account ID on the connected system. (ACCOUNT_ID column of the FISC_USER_ACCOUNT table). DuoCircle supports Id as account Id.
loginId
Enter the attribute that contains the value used to uniquely identity the user account login ID on the connected system. (ACCOUNT_USERNAME column of the FISC_USER_ACCOUNT table). DuoCircle supports address as Login Id.
- (Optional) Select the Attributes tab if attributes schema is to be modified.
- (Optional) Select the Appearance tab to change how the Connected System object displays in the Design pane.
- Click OK to save any changes and return to the Workflow and Connectivity Studio window.
Configuring the Import Link
-
In the design pane, double-click the import link between the import link between the Data Mapper object and the import object (the last workflow object). The Configure Link window displays:
Source Attributes
Select the attributes to import.
Check for attribute-level auditing
If auditing is enabled and these attributes below are checked, Provisioning will log all events for auditing purposes.
Select Attributes
Displays default attributes and those attributes that have been selected from the source Attributes.
Note: The default attributes are those that are commonly used to create a new user.
Advanced Settings
Displays the Configure Attributes window for configuring advanced settings for attributes. Under the Encrypted column, check the box of any attribute that needs to be encrypted.
Key Attribute
Select the attribute to be used as the key attribute for status processing and audit.
- From the Attribute Selection tab, select attributes to import.
- (Optional) Select the Appearancetab to change how the link displays in the Design
- Click OKto save any changes and return to the Workflow and Connectivity Studio
- Deploy the workflow by selecting Deploy New Deployment. See the “Workflow and Connectivity Studio”documentation for details of deployment options.
- Manage and run the deployed workflow from the Admin UI Server tab. See the “Identity Suite Administration”documentation for details.
Configuration Details for Provisioning
Connector Supported Data Formats
The items in the Export and Import columns have these meanings:
- Y = Yes (attribute is supported for this operation)
- N = No (attribute is not supported for this operation)
Recipient Data Format
Name |
Type |
Export |
Import |
Description |
Id |
String |
Y |
Y |
Unique Id generated during user creation. This is mandatory when modifying a user. |
address |
String |
Y |
Y |
|
alias->id |
String |
Y |
Y |
|
alias->address |
String |
Y |
Y |
Alias address. Can add multiple alias addresses |
forward->id |
String |
Y |
Y |
|
forward->address |
String |
Y |
Y |
Forwarding address |
forward->status |
Boolean |
Y |
Y |
|
forward->template |
String |
Y |
Y |
|
forward->verified |
String |
Y |
Y |
|
Lookup Data
To lookup data from DuoCircle, use the Data Mapper rule Lookup Data.
- Log in to the Workflow and Connectivity Studio and double-click the Data Mapper object on the Design pane. The Configure Data Mapper window displays.
- Select the Lookup Data rule under the Mapping Rule column, and then click the Source Value. The Configure Lookup window displays.
- Select the DuoCircle system from the Select System drop-down list:
- In the Enter Lookup Prefix field, enter the prefix to be added to the Lookup fields.
- Select the Lookup Type (Recipient) from the drop-down list.
- Select the lookup method By Id or By Filter.
- Selecting By Filter,the next field will change to Filter. Click the Build button to bring up the filter dialog. The Filter usage was explained earlier in section Set Filter.
- Selecting By Idchanges the next field to Id. Click Pick button along it to select the Id value as attribute/variable/literal.
- The next Pickbutton is used to define the attributes to be exported from the lookup.
- Select the Exit as Mapper Task Failed on Lookup Failurecheck box to exit the task with failed status on lookup failure. It will not process the succeeding entries and will ignore the already processed entries and will not return any data. This is selected by default.
- Click OK.