Runbook: ACT-CreateADUser.ps1

📘 Description

Creates a new user account in the customer’s Active Directory environment.
This runbook supports both minimum-data onboarding and full HR-rich provisioning.

SymphonyDesk automatically handles:

• AD connection
• User attribute stamping
• Optional manager assignment
• Jira comments & workflow transitions
• Detailed logging for audit and job history

---

🧩 Required Parameters

Name	Description	Example
DisplayName	The user’s display name	"John Doe"
UPN	UserPrincipalName	"john.doe@contoso.com"

---

🪄 Optional Parameters

These fields are applied only if provided in the Jira payload.

Name	Description	Example
FirstName	First name	"John"
LastName	Last name	"Doe"
Department	Department	"Finance"
Title	Job title	"Analyst"
Office	Office location	"HQ – Floor 4"
ManagerUPN	Manager’s UPN	"manager@contoso.com"

---

📤 Webhook JSON Example

{
  "customer": "Contoso",
  "runbook": "ACT-CreateADUser.ps1",
  "issue_key": "{{issue.key}}",
  "params": {
    "DisplayName": "{{issue.fields.customfield_10200}}",
    "UPN": "{{issue.fields.customfield_10201}}",
    "FirstName": "{{issue.fields.customfield_10202}}",
    "LastName": "{{issue.fields.customfield_10203}}",
    "Department": "{{issue.fields.customfield_10204}}",
    "Title": "{{issue.fields.customfield_10205}}",
    "Office": "{{issue.fields.customfield_10206}}",
    "ManagerUPN": "{{issue.fields.customfield_10207}}"
  }
}

---

📥 Response (Success)

{
  "job_id": "job-237abcd",
  "status": "success",
  "output": "AD user created successfully"
}

---

📥 Response (Error)

{
  "job_id": "job-237abcd",
  "status": "error",
  "message": "Manager not found",
  "raw": "Get-ADUser : Cannot find user..."
}

---

🗃 Requirements

• Runner connectivity to domain controller
• SymphonyDesk customer config containing:
• "DomainController"
• "DefaultOU"
• Required modules: ActiveDirectory
• Jira credentials configured in secrets.json

---

🏗 Version History

Version	Date	Notes
1.0	2025-01-01	Initial release
1.1	2025-01-15	Added Jira comments & transitions