The content below is for Apache Syncope <= 1.2 - for later versions the Reference Guide is available.

Syncope can be configured for using either local and remote connector bundles:

While local connector bundles feature an easy setup, remote connector bundles allow enhanced deployment scenarios and are particularly useful when it is needed to deal with architectural security constraints or when a connector bundle requires to run on a specific platform OS (say MS Windows) while Syncope is deployed on another platform OS (say GNU/Linux).

connid.properties

This file (located at core/src/main/resources/connid.properties) holds the configuration for defining which ConnId locations (either local and remote) Syncope will be able to deal with.

The format is quite straightforward:

connid.locations=location1,\
location2,\
...
locationN

where each location is the string representation of an URI of the form

file:/path/to/directory/

for local locations or

connid://key@host:port

for remote non-SSL connector servers or

connids://key@host:port[?trustAllcerts=true]

for remote SSL connector servers, with optional flag to disable certificate check. Refer to Connid for how to work with Java or .NET connector servers.

Key value must be reported as non-encrypted cleartext.
Any special character in the key value (e.g. any character which needs URL encoding) must be reported using its encoded representation: for example '@` becomes '%40' .

Some examples

Single local location

connid.locations=file:/opt/syncope/bundles/

Single remote location

connid.locations=connid://sampleKey@windows2008:4554

Multiple locations

connid.locations=file:/opt/syncope/bundles/,\
file:/var/tmp/bundles/,\
connid://sampleKey@windows2008:4554,\
connids://anotherKey@windows2008:4559,\
connids://aThirdKey@linuxbox:9001?trustAllCerts=true