Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • didmos backend connector (provided by DAASI International)
  • LDAP connector (provided by Evolveum)
  • Active Directory LDAP connector (provided by Evolveum)

Overview of configuration parameters

General parameters

Parameter nameDescription
LOG_LEVELLogging level
RECEIVE_QUEUEThe name of the RabbitMQ queue from where the worker gets the requests
RESPONSE_QUEUEThe name of the RabbitMQ queue to which the worker puts the responses
RETRY_TIMEThe time in seconds to wait before retrying an action

RabbitMQ parameters

Parameter nameDescription
RABBITMQ_ADDRESSESRabbitMQ server URL
RABBITMQ_PORTRabbitMQ server port
RABBITMQ_USERNAMERabbitMQ user name
RABBITMQ_PASSWORDRabbitMQ user password

didmos2 backend connector parameters

Parameter nameDescription
RESPONSE_API_URLThe backend REST URL
RESPONSE_USER_NAMEdidmos2 user name for basic authentication
RESPONSE_USER_PASSWORDdidmos2 user password for basic authentication

LDAP/AD LDAP connector parameters (see also https://wiki.evolveum.com)

Parameter nameDescription
LDAP_SERVERLDAP server name
LDAP_PORTLDAP server port
ALLOW_UNTRUSTED_SSL

Whether connector skips certificate validity check against its default truststore (e.g. Java cacerts)
When set to false, connector checks server certificate validity in SSL/TLS mode (recommended)
When set to true, connector does not check server certificate validity. Do not use this option in the production

ENABELED_SECURITY_PROTOCOLS

Set of security protocols that are acceptable for protocol negotiation
Possible values: SSL, SSLv2, SSLv3, TLS, TLSv1, TLSv1.1, TLSv1.2

CONNECT_TIMEOUTTimeout to connect (in milliseconds)
MAX_NUM_ATTEMPTSMaximum number of attempts to retrieve the entry or to re-try the operation
This number is applicable in replicated topology when handling connection failures and re-trying on another server, when following referrals and in similar situations
AUTHENTICATION_TYPE

The authentication mechanism to use
Possible values: simple, SASL-GSSAPI
Default value: simple

BASE_CONTEXTThe base DN that the connector will use if the base DN is not specified explicitly
BIND_DNThe DN of the object to bind to
BIND_PASSWORDBind password
USE_PERMISSIVE_MODIFYUse permissive modify LDAP control for modify operations

Possible values: never, auto, always
Default value: auto

PAGING_STRATEGYSpecifies strategy of using paging mechanisms such as VLV or Simple Paged Results
Possible values: none, auto, spr, vlv
Default value: auto
PW_HASH_ALGORITHMHash the passwords with a specified algorithm before they are sent to the server
UID_ATTRIBUTEName of the attribute which will be used as ICF UID
OPERATIONAL_ATTRIBUTESOperational attributes that apply to all object classes
STRUCTURAL_OBJECT_CLASSIf set to true, adds all additional structural object classes without children to the auxiliary object classes list on the connector

Additional AD and LDAP connector parameters (see also https://wiki.evolveum.com)

Parameter nameDescription
USER_OBJECT_CLASSObject class to use for user accounts. Default: user
GROUP_OBJECT_CLASSObject class to use for user accounts. Default: group
MEMBER_ATTRIBUTEGroup member attribute name. Default: member
GLOBAL_CATALOG_STRATEGY

Strategy of global catalog usage
Do not use global catalog explicitly. The global catalog will only be used when following the referrals

ALLOW_BRUTE_FORCE_SEARCH

If set to true then the connector will try to search all defined servers for an entry if all other attempts fail

RAW_USER_ACCOUNT_CONTROL_ATTRIBUTE

If set to false then the connector will interpret the content of userAccountControl attribute and will decompose it to pseudo-attributes for enabled state, lockout, etc.
If set to true then the connector will NOT do any interpretation and the userAccountControl will be exposed as a simple attribute.

NATIVE_AD_SCHEMA

If set to true, then the connector will use native AD schema definition.
If set to false, connector will use LDAP-like schema definition exposed by the AD server.
Default value: false
EXPERIMENTAL. There may be subtle differences between LDAP schema and AD schema. Not completely tested yet.

TWEAK_SCHEMA

Extend the declared AD schema with tweaks that allow practical usage of the schema.
AD will generally allow any attribute to be set to any object regardless for the schema.
This is often used is practice. E.g. declared AD schema for users and groups does not include samAccountName attribute. But that attribute is needed for users and groups to work correctly. If this configuration property is set to true (which is the default) then the connector will artificially add these attributes to the schema.

INCLUDE_OBJECT_CATEGORY_FILTER

Enables inclusion of explicit object category filter in all searches. Normally the connector would derive search filter only based on the attributes specified in the query. E.g. (&(uid=foo)(cn=bar)).
If includeObjectClassFilter is set to true, then also explicit filter for objectClass and objectCategory will be included.
E.g (&(objectClass=inetOrgPerson)(objectCategory=CN=Person,CN=Schema,CN=Configuration,DC=example,DC=com)(uid=foo)(cn=bar))
Only works if includeObjectClassFilter is enabled and native AD schema is used.
Default value: false.
EXPERIMENTAL. Not completely tested yet.

ADD_DEFAULT_OBJECT_CATEGORY

If set to true then the connector will automatically add default object category to all created objects.
Object category is automatically determined from schema. Only works if native AD schema is enabled.
Default value: false.
EXPERIMENTAL. Not completely tested yet.

FORCE_PASSWORD_CHANGE_AT_NEXT_LOGON

If set to true then the connector will force password change at next log-on every time when the password is changed. If set to false (default) the password change at next log-on will not be forced.

SCRIPT_EXECUTION_MECHANISM

The mechanism that will be used to execute scripts on resource.
The default WinRM mechanism will execute the script by using WinRM client built into the connector. Local strategy means execution on the local machine where the connector is deployed.
Possible values: winrm, local.

Default value: winrm