Add Member To Groups

Introduction

Before using this valve the LdapClient module must be configured and deployed with matching name as defined in "namespace"

Configuration

Note

Valve name: ActiveDirectoryAddMemberToGroups

Properties

Name	Description	Default	Mandatory	Expanded
namespace	Bind to LdapClient module.	"default"
member_id	User/Member id.
groups_identifier	JsonArray with group objects or group DNs.	"@json:${request.ad_pending_add.all}"
id_property	Property on JSON object that contains the group DN.	"id"

Example

{
  "name": "ActiveDirectoryAddMemberToGroups",
  "config": {
    "namespace": "ldap01",
    "member_id": "${request.selected_ad_id}",
    "id_property": "id",
    "groups_identifier": "@json:${request.ad_pending_add.all}"
  }
}

Example pipe data

{
"selected_ad_id" : "CN=Britt Thomasson,OU=Demo,DC=company,DC=local",
  "ad_pending_add": [
    {
        "id": "CN=AWS administrator,OU=access_review,OU=Governance,OU=IdM_demo,OU=Product_Testing,DC=company,DC=local",
        "description": "Test",
        "cn": "AWS administrator",
        "sAMAccountName": "AWS administrator"
    },
    {
        "id": "CN=Cert Publishers,CN=Users,DC=company,DC=local",
        "description": "Members of this group are permitted to publish certificates to the directory",
        "cn": "Cert Publishers",
        "sAMAccountName": "Cert Publishers"
    }
]
}

Audit

Every successful call publishes changes to the platform audit trail automatically — there is no audit flag to configure. Whether anything is actually recorded depends on whether an Audit module is deployed to consume it.

• object_type group, package_type GroupMembershipAdded
• one change published per group in groups_identifier, each with its own object_id — that group's DN — and a single change, field member, after_value the member's DN (member_id)

[
  { "object_id": "CN=AWS administrator,OU=access_review,OU=Governance,OU=IdM_demo,OU=Product_Testing,DC=company,DC=local", "field": "member", "after_value": "CN=Britt Thomasson,OU=Demo,DC=company,DC=local" },
  { "object_id": "CN=Cert Publishers,CN=Users,DC=company,DC=local", "field": "member", "after_value": "CN=Britt Thomasson,OU=Demo,DC=company,DC=local" }
]

See Audit for how published changes are grouped into events and change packages, and for the built-in UI and REST API to view them.