| Note |
|---|
|
Content of this page applies to Apache Syncope >= 1.1.X |
Syncope can be configured for using either local and remote connector bundles:
- local connector bundles are located somewhere in the same filesystem where the container running Syncope is deployed;
- remote connector bundles are provided via Java or .NET connector server.
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).
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:
| Code Block |
|---|
connid.locations=location1,\
location2,\
...
locationN
|
where each location is the string representation of an URI of the form
| Code Block |
|---|
file:/path/to/directory/
|
for local locations or
| Code Block |
|---|
connid://key@host:port
|
for remote non-SSL connector servers or
| Code Block |
|---|
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.
| Note |
|---|
|
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' . |
| Code Block |
|---|
connid.locations=file:/opt/syncope/bundles/
|
| Code Block |
|---|
connid.locations=connid://sampleKey@windows2008:4554
|
| Code Block |
|---|
connid.locations=file:/opt/syncope/bundles/,\
file:/var/tmp/bundles/,\
connid://sampleKey@windows2008:4554,\
connids://anotherKey@windows2008:4559,\
connids://aThirdKey@linuxbox:9001?trustAllCerts=true
|