Update User Federation

Update the requested user federation configuration. This operation expects full object for updation. Missing parameters will be set to default values. Parameter "id" is read only.

Request

URI

PUT

https://{api_host}/tcsa.host.com/tcsa/api/auth-management/v1/user-federations/{id}

COPY

Path Parameters

string

Required

User federation configuration unique id.

Request Body

UserFederation of type(s) application/json

Optional

Show optional properties

{
    "id": "c3046544-3dd4-4cc4-b3bf-0383088dd99f",
    "vendor": "AD",
    "username_ldap_attribute": "cn",
    "rdn_ldap_attribute": "uid",
    "uuid_ldap_attribute": "uid",
    "user_object_classes": "inetOrgPerson, organizationalPerson",
    "connection_url": "http://<ip:port>",
    "users_dn": "ou=users,dc=tco,dc=com",
    "bind_dn": "ou=users",
    "bind_credential": "string",
    "mapper": [
        {
            "id": "c36fcf2c-ce24-4bae-beda-8161d4eb2883",
            "ldap_attribute": "cn",
            "name": "my-mapper"
        }
    ]
}

{
    "id": "c3046544-3dd4-4cc4-b3bf-0383088dd99f",
    "name": "my-ldap-config",
    "enabled": true,
    "priority": 1,
    "import_enabled": true,
    "edit_mode": "READ_ONLY",
    "sync_registration": false,
    "vendor": "AD",
    "username_ldap_attribute": "cn",
    "rdn_ldap_attribute": "uid",
    "uuid_ldap_attribute": "uid",
    "user_object_classes": "inetOrgPerson, organizationalPerson",
    "connection_url": "http://<ip:port>",
    "users_dn": "ou=users,dc=tco,dc=com",
    "bind_type": "simple",
    "bind_dn": "ou=users",
    "bind_credential": "string",
    "advanced": {
        "start_tls": true
    },
    "mapper": [
        {
            "id": "c36fcf2c-ce24-4bae-beda-8161d4eb2883",
            "ldap_attribute": "cn",
            "name": "my-mapper"
        }
    ]
}

string

Required

The id of user-federation configuration.

string

name

Optional

Name of the user-federation configuration

boolean

enabled

Optional

If provider is disabled, it will not be considered for queries and imported users will be disabled and read-only until the provider is enabled again. The values could be true or false. The default is true

integer

priority

Optional

Priority of provider when doing a user lookup. Lower first.

boolean

import_enabled

Optional

If true, users will imported into keycloak DB and configured by the sync policies. The values could be true or false. The default is true

string

edit_mode

Optional

There are 3 possible values, READ_ONLY,WRITABLE and UNSYNCED. READ_ONLY is read-only ldap store. WRITABLE means data will be synced back to the LDAP on demand and UNSYNCED means user data will be imported but not synced back to LDAP. DEFAULT is "READ_ONLY".

boolean

sync_registration

Optional

Should newly created user will be created with LDAP store. Priority effect which provider is chosen to sync new user. The setting is applied only for WRITABLE edit mode.

string

vendor

Required

LDAP vendor (provider). For Active Directory use 'AD' and for 'Redhat directory server' use 'rhds'.

string

username_ldap_attribute

Required

Name of LDAP attribute which is mapped as keycloak user name. For many LDAP server vendor it can be uid. For active directory it can be sAMAccountName" or cn. The attribute should be filed for all user records you want to import from LDAP to keycloak.

string

rdn_ldap_attribute

Required

The name of attribute which is used as RDN(top attribute) of typical user DN. Usually its same as LDAP Username attribute, however its not required. For example for Active directory its common to use 'cn' as RDN attribute when username attribute might be 'sAMAccountName'.

string

uuid_ldap_attribute

Required

Name of the LDAP attribute which is used as unique object identifier for objects in LDAP.

string

user_object_classes

Required

All values of LDAP Object class attribute for users in LDAP divided by comma.

string

connection_url

Required

Connection url to your ldap server.