diff --git a/playbooks/AD_LDAP_Account_Unlocking.json b/playbooks/AD_LDAP_Account_Unlocking.json new file mode 100644 index 0000000000..b4d24741b4 --- /dev/null +++ b/playbooks/AD_LDAP_Account_Unlocking.json @@ -0,0 +1,279 @@ +{ + "blockly": false, + "blockly_xml": "", + "category": "Account Unlocking", + "coa": { + "data": { + "description": "Accepts user name that needs to be unlocked in Microsoft LDAP Active Directory. Generates an observable output based on the status of account unlocking or enabling.", + "edges": [ + { + "id": "port_0_to_port_2", + "sourceNode": "0", + "sourcePort": "0_out", + "targetNode": "2", + "targetPort": "2_in" + }, + { + "conditions": [ + { + "index": 0 + } + ], + "id": "port_2_to_port_3", + "sourceNode": "2", + "sourcePort": "2_out", + "targetNode": "3", + "targetPort": "3_in" + }, + { + "id": "port_4_to_port_1", + "sourceNode": "4", + "sourcePort": "4_out", + "targetNode": "1", + "targetPort": "1_in" + }, + { + "id": "port_3_to_port_5", + "sourceNode": "3", + "sourcePort": "3_out", + "targetNode": "5", + "targetPort": "5_in" + }, + { + "conditions": [ + { + "index": 0 + } + ], + "id": "port_5_to_port_4", + "sourceNode": "5", + "sourcePort": "5_out", + "targetNode": "4", + "targetPort": "4_in" + } + ], + "hash": "fa54af4718791760fe2785872ae29512a7d81b01", + "nodes": { + "0": { + "data": { + "advanced": { + "join": [] + }, + "functionName": "on_start", + "id": "0", + "type": "start" + }, + "errors": {}, + "id": "0", + "type": "start", + "warnings": {}, + "x": 20, + "y": 0 + }, + "1": { + "data": { + "advanced": { + "join": [] + }, + "functionName": "on_finish", + "id": "1", + "type": "end" + }, + "errors": {}, + "id": "1", + "type": "end", + "warnings": {}, + "x": 19.999999999999986, + "y": 864 + }, + "2": { + "data": { + "advanced": { + "customName": "username filter", + "customNameId": 0, + "delimiter": ",", + "delimiter_enabled": true, + "description": "Filter user name inputs to route inputs to appropriate actions.", + "join": [], + "note": "Filter user name inputs to route inputs to appropriate actions." + }, + "conditions": [ + { + "comparisons": [ + { + "conditionIndex": 0, + "op": "!=", + "param": "playbook_input:user", + "value": "" + } + ], + "conditionIndex": 0, + "customName": "filter_username_check", + "logic": "and" + } + ], + "functionId": 1, + "functionName": "username_filter", + "id": "2", + "type": "filter" + }, + "errors": {}, + "id": "2", + "type": "filter", + "warnings": {}, + "x": 60, + "y": 140 + }, + "3": { + "data": { + "action": "unlock account", + "actionType": "generic", + "advanced": { + "customName": "unlock user account", + "customNameId": 0, + "delayTime": 0, + "description": "Unlock user account from filtered playbook inputs.", + "join": [], + "note": "Unlock user account from filtered playbook inputs." + }, + "connector": "AD LDAP", + "connectorConfigs": [ + "microsoft ad ldap" + ], + "connectorId": "a5730e5d-a396-4695-92c2-35ff391aaf45", + "connectorVersion": "v1", + "functionId": 1, + "functionName": "unlock_user_account", + "id": "3", + "parameters": { + "use_samaccountname": true, + "user": "filtered-data:username_filter:condition_1:playbook_input:user" + }, + "requiredParameters": [ + { + "data_type": "string", + "default": false, + "field": "user" + } + ], + "type": "action" + }, + "errors": {}, + "id": "3", + "type": "action", + "warnings": {}, + "x": 0, + "y": 328 + }, + "4": { + "data": { + "advanced": { + "customName": "username observables", + "customNameId": 0, + "description": "Format a normalized output for each user.", + "join": [], + "note": "Format a normalized output for each user." + }, + "functionId": 1, + "functionName": "username_observables", + "id": "4", + "inputParameters": [ + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.parameter.user", + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.parameter.use_samaccountname", + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.data.*.user_dn", + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.status", + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.message", + "filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.data.*.starting_status" + ], + "outputVariables": [ + "observable_array" + ], + "type": "code" + }, + "errors": {}, + "id": "4", + "type": "code", + "userCode": "\n # Write your custom code here...\n username_observables__observable_array = []\n \n for user, sam_account, user_dn, status, msg, prev_status in zip(filtered_result_0_parameter_user, filtered_result_0_parameter_use_samaccountname, filtered_result_0_data___user_dn, filtered_result_0_status, filtered_result_0_message, filtered_result_0_data___starting_status):\n user_acc_status = {\n \"type\": \"Microsoft AD LDAP user name\",\n \"value\": user,\n \"message\": msg,\n \"status\": status\n }\n \n username_observables__observable_array.append(user_acc_status)\n #phantom.debug(username_observables__observable_array)\n", + "warnings": {}, + "x": 0, + "y": 680 + }, + "5": { + "data": { + "advanced": { + "customName": "filter unlock account", + "customNameId": 0, + "delimiter": ",", + "delimiter_enabled": true, + "description": "filter check if the user is unlocked successfully.", + "join": [], + "note": "filter check if the user is unlocked successfully." + }, + "conditions": [ + { + "comparisons": [ + { + "conditionIndex": 0, + "op": "==", + "param": "unlock_user_account:action_result.status", + "value": "success" + } + ], + "conditionIndex": 0, + "customName": "unlock_success", + "logic": "and" + } + ], + "functionId": 2, + "functionName": "filter_unlock_account", + "id": "5", + "type": "filter" + }, + "errors": {}, + "id": "5", + "type": "filter", + "warnings": {}, + "x": 60, + "y": 500 + } + }, + "notes": "Inputs: users\nInteractions: Microsoft AD LDAP\nActions: Unlock Account\nOutputs: observables" + }, + "input_spec": [ + { + "contains": [ + "user name" + ], + "description": "A user name provided to be enabled - AD LDAP", + "name": "user" + } + ], + "output_spec": [ + { + "contains": [], + "datapaths": [ + "username_observables:custom_function:observable_array" + ], + "deduplicate": false, + "description": "An array of observable dictionaries ", + "metadata": {}, + "name": "observable" + } + ], + "playbook_type": "data", + "python_version": "3", + "schema": "5.0.10", + "version": "6.0.1.123902" + }, + "create_time": "2023-06-22T14:53:39.397912+00:00", + "draft_mode": false, + "labels": [ + "*" + ], + "tags": [ + "user", + "microsoft_ad_ldap", + "D3-AL", + "enable_account" + ] +} \ No newline at end of file diff --git a/playbooks/AD_LDAP_Account_Unlocking.png b/playbooks/AD_LDAP_Account_Unlocking.png new file mode 100644 index 0000000000..92a894de2d Binary files /dev/null and b/playbooks/AD_LDAP_Account_Unlocking.png differ diff --git a/playbooks/AD_LDAP_Account_Unlocking.py b/playbooks/AD_LDAP_Account_Unlocking.py new file mode 100644 index 0000000000..aed8f5958c --- /dev/null +++ b/playbooks/AD_LDAP_Account_Unlocking.py @@ -0,0 +1,172 @@ +""" +Accepts user name that needs to be unlocked in Microsoft LDAP Active Directory. Generates an observable output based on the status of account unlocking or enabling. +""" + + +import phantom.rules as phantom +import json +from datetime import datetime, timedelta + + +@phantom.playbook_block() +def on_start(container): + phantom.debug('on_start() called') + + # call 'username_filter' block + username_filter(container=container) + + return + +@phantom.playbook_block() +def username_filter(action=None, success=None, container=None, results=None, handle=None, filtered_artifacts=None, filtered_results=None, custom_function=None, **kwargs): + phantom.debug("username_filter() called") + + ################################################################################ + # Filter user name inputs to route inputs to appropriate actions. + ################################################################################ + + # collect filtered artifact ids and results for 'if' condition 1 + matched_artifacts_1, matched_results_1 = phantom.condition( + container=container, + conditions=[ + ["playbook_input:user", "!=", ""] + ], + name="username_filter:condition_1", + delimiter=",") + + # call connected blocks if filtered artifacts or results + if matched_artifacts_1 or matched_results_1: + unlock_user_account(action=action, success=success, container=container, results=results, handle=handle, filtered_artifacts=matched_artifacts_1, filtered_results=matched_results_1) + + return + + +@phantom.playbook_block() +def unlock_user_account(action=None, success=None, container=None, results=None, handle=None, filtered_artifacts=None, filtered_results=None, custom_function=None, **kwargs): + phantom.debug("unlock_user_account() called") + + # phantom.debug('Action: {0} {1}'.format(action['name'], ('SUCCEEDED' if success else 'FAILED'))) + + ################################################################################ + # Unlock user account from filtered playbook inputs. + ################################################################################ + + filtered_input_0_user = phantom.collect2(container=container, datapath=["filtered-data:username_filter:condition_1:playbook_input:user"]) + + parameters = [] + + # build parameters list for 'unlock_user_account' call + for filtered_input_0_user_item in filtered_input_0_user: + if filtered_input_0_user_item[0] is not None: + parameters.append({ + "use_samaccountname": True, + "user": filtered_input_0_user_item[0], + }) + + ################################################################################ + ## Custom Code Start + ################################################################################ + + # Write your custom code here... + + ################################################################################ + ## Custom Code End + ################################################################################ + + phantom.act("unlock account", parameters=parameters, name="unlock_user_account", assets=["microsoft ad ldap"], callback=filter_unlock_account) + + return + + +@phantom.playbook_block() +def username_observables(action=None, success=None, container=None, results=None, handle=None, filtered_artifacts=None, filtered_results=None, custom_function=None, **kwargs): + phantom.debug("username_observables() called") + + ################################################################################ + # Format a normalized output for each user. + ################################################################################ + + filtered_result_0_data_filter_unlock_account = phantom.collect2(container=container, datapath=["filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.parameter.user","filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.parameter.use_samaccountname","filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.data.*.user_dn","filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.status","filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.message","filtered-data:filter_unlock_account:condition_1:unlock_user_account:action_result.data.*.starting_status"]) + + filtered_result_0_parameter_user = [item[0] for item in filtered_result_0_data_filter_unlock_account] + filtered_result_0_parameter_use_samaccountname = [item[1] for item in filtered_result_0_data_filter_unlock_account] + filtered_result_0_data___user_dn = [item[2] for item in filtered_result_0_data_filter_unlock_account] + filtered_result_0_status = [item[3] for item in filtered_result_0_data_filter_unlock_account] + filtered_result_0_message = [item[4] for item in filtered_result_0_data_filter_unlock_account] + filtered_result_0_data___starting_status = [item[5] for item in filtered_result_0_data_filter_unlock_account] + + username_observables__observable_array = None + + ################################################################################ + ## Custom Code Start + ################################################################################ + + # Write your custom code here... + username_observables__observable_array = [] + + for user, sam_account, user_dn, status, msg, prev_status in zip(filtered_result_0_parameter_user, filtered_result_0_parameter_use_samaccountname, filtered_result_0_data___user_dn, filtered_result_0_status, filtered_result_0_message, filtered_result_0_data___starting_status): + user_acc_status = { + "type": "Microsoft AD LDAP user name", + "value": user, + "message": msg, + "status": status + } + + username_observables__observable_array.append(user_acc_status) + #phantom.debug(username_observables__observable_array) + ################################################################################ + ## Custom Code End + ################################################################################ + + phantom.save_run_data(key="username_observables:observable_array", value=json.dumps(username_observables__observable_array)) + + return + + +@phantom.playbook_block() +def filter_unlock_account(action=None, success=None, container=None, results=None, handle=None, filtered_artifacts=None, filtered_results=None, custom_function=None, **kwargs): + phantom.debug("filter_unlock_account() called") + + ################################################################################ + # filter check if the user is unlocked successfully. + ################################################################################ + + # collect filtered artifact ids and results for 'if' condition 1 + matched_artifacts_1, matched_results_1 = phantom.condition( + container=container, + conditions=[ + ["unlock_user_account:action_result.status", "==", "success"] + ], + name="filter_unlock_account:condition_1", + delimiter=",") + + # call connected blocks if filtered artifacts or results + if matched_artifacts_1 or matched_results_1: + username_observables(action=action, success=success, container=container, results=results, handle=handle, filtered_artifacts=matched_artifacts_1, filtered_results=matched_results_1) + + return + + +@phantom.playbook_block() +def on_finish(container, summary): + phantom.debug("on_finish() called") + + username_observables__observable_array = json.loads(_ if (_ := phantom.get_run_data(key="username_observables:observable_array")) != "" else "null") # pylint: disable=used-before-assignment + + output = { + "observable": username_observables__observable_array, + } + + ################################################################################ + ## Custom Code Start + ################################################################################ + + # Write your custom code here... + + ################################################################################ + ## Custom Code End + ################################################################################ + + phantom.save_playbook_output_data(output=output) + + return \ No newline at end of file diff --git a/playbooks/AD_LDAP_Account_Unlocking.yml b/playbooks/AD_LDAP_Account_Unlocking.yml new file mode 100644 index 0000000000..a8f286268d --- /dev/null +++ b/playbooks/AD_LDAP_Account_Unlocking.yml @@ -0,0 +1,23 @@ +name: AD LDAP Account Unlocking +id: e6f96caf-61ac-4ced-aabc-ba9b19bd9e1f +version: 1 +date: '2023-06-21' +author: Lou Stella, Splunk +type: Investigation +description: "Accepts user, to be unlocked using Microsoft AD LDAP connector. This playbook produces a normalized observable output for each user." +playbook: AD_LDAP_Account_Locking +how_to_implement: This input playbook requires the Microsoft AD LDAP connector to be configured. It is designed to work in conjunction with the Active Directory Restore Accounts playbook or other playbooks in the same style. +references: [] +app_list: + - AD LDAP +tags: + platform_tags: + - user + - microsoft_ad_ldap + - D3-AL + - enable_account + playbook_type: Input + vpe_type: Modern + playbook_fields: [] + product: + - Splunk SOAR