Marketo Connector

Configure the Marketo Connector

Reconcile Users With a Marketo Leads Database

The Marketo connector lets you reconcile IDM users (including managed users and users who have registered through a social identity provider) with a Marketo leads database. To set up reconciliation to a Marketo database, copy the following sample mapping file to your project's conf directory:

/path/to/openidm/samples/example-configurations/marketo/sync.json

This file sets up a mapping from the managed user repository to Marketo user accounts. The file includes transformations for user accounts registered through Facebook and LinkedIn. You can use these transformations as a basis for transformations from other social identity providers.

If you have an existing mapping configuration, add the content of this sample sync.json to your existing mapping.

The sample mapping restricts reconciliation to users who have accepted the marketing preferences with the following validSource script:

"validSource" : {
    "type" : "text/javascript",
    "globals" : {
        "preferences" : [
            "marketing"
        ]
    },
    "file" : "ui/preferenceCheck.js"
}

When a user registers with IDM, they can choose to accept this condition. As a regular user, they can also select (or deselect) the condition in the End User UI by logging into IDM at http://localhost:8080/, and selecting Preferences.

If a user deselects the marketing preference after their account has been reconciled to Marketo, the next reconciliation run will remove the account from the Marketo database.

For more information on how preferences work in a mapping, see "Configure User Preferences".

Implementation Specifics

For PATCH requests, a connector can potentially add, remove, or replace an attribute value. The Marketo connector does not implement the add or remove operations, so a PATCH request always replaces the entire attribute value with the new value.

OpenICF Interfaces Implemented by the Marketo Connector

The Marketo Connector implements the following OpenICF interfaces.

Marketo Connector Configuration

The Marketo Connector has the following configurable properties.

Configuration properties

Property	Type	Default	Encrypted [a]	Required [b]
customSensitiveConfiguration	GuardedString	null
Custom Sensitive Configuration script for Groovy ConfigSlurper
customConfiguration	String	null
Custom Configuration script for Groovy ConfigSlurper
instance	String	null
The Marketo-assigned FQDN for your instance
clientId	String	null
Your OAuth2 client ID
clientSecret	GuardedString	null
Your OAuth2 client secret
leadFields	String	null
Comma-delimited list of lead fields to fetch; Leave empty for default set
partitionName	String	null
Name of the partition in which to create and update leads; May be left empty
listName	String	null
Name of the Marketo static list the connector will use to manage leads
accessToken	String	null
The access token for the application
tokenExpiration	Long	null
The expiration token for the application
[a] Indicates whether the property value is considered confidential, and therefore encrypted in OpenIDM. [b] A list of operations in this column indicates that the property is required for those operations.

Operation Script Files

Property	Type	Default	Encrypted [a]	Required [b]
createScriptFileName	String	CreateMarketo.groovy		Create
The name of the file used to perform the CREATE operation.
customizerScriptFileName	String	null
The script used to customize some function of the connector. Read the documentation for more details.
authenticateScriptFileName	String	null		Authenticate
The name of the file used to perform the AUTHENTICATE operation.
scriptOnResourceScriptFileName	String	null		Script On Resource
The name of the file used to perform the RUNSCRIPTONRESOURCE operation.
deleteScriptFileName	String	DeleteMarketo.groovy		Delete
The name of the file used to perform the DELETE operation.
resolveUsernameScriptFileName	String	null		Resolve Username
The name of the file used to perform the RESOLVE_USERNAME operation.
searchScriptFileName	String	SearchMarketo.groovy		Get Search
The name of the file used to perform the SEARCH operation.
updateScriptFileName	String	UpdateMarketo.groovy		Update
The name of the file used to perform the UPDATE operation.
schemaScriptFileName	String	SchemaMarketo.groovy		Schema
The name of the file used to perform the SCHEMA operation.
testScriptFileName	String	TestMarketo.groovy		Test
The name of the file used to perform the TEST operation.
syncScriptFileName	String	null		Sync
The name of the file used to perform the SYNC operation.
[a] Indicates whether the property value is considered confidential, and therefore encrypted in OpenIDM. [b] A list of operations in this column indicates that the property is required for those operations.

Groovy Engine configuration

Property	Type	Default	Encrypted [a]	Required [b]
targetDirectory	File	null
Directory into which to write classes.
warningLevel	int	1
Warning Level of the compiler
scriptExtensions	String[]	['groovy']
Gets the extensions used to find groovy files
minimumRecompilationInterval	int	100
Sets the minimum of time after a script can be recompiled.
scriptBaseClass	String	null
Base class name for scripts (must derive from Script)
scriptRoots	String[]	null
The root folder to load the scripts from. If the value is null or empty the classpath value is used.
tolerance	int	10
The error tolerance, which is the number of non-fatal errors (per unit) that should be tolerated before compilation is aborted.
debug	boolean	false
If true, debugging code should be activated
classpath	String[]	[]
Classpath for use during compilation.
disabledGlobalASTTransformations	String[]	null
Sets a list of global AST transformations which should not be loaded even if they are defined in META-INF/org.codehaus.groovy.transform.ASTTransformation files. By default, none is disabled.
verbose	boolean	false
If true, the compiler should produce action information
sourceEncoding	String	UTF-8
Encoding for source files
recompileGroovySource	boolean	false
If set to true recompilation is enabled
[a] Indicates whether the property value is considered confidential, and therefore encrypted in OpenIDM. [b] A list of operations in this column indicates that the property is required for those operations.