Versions Compared

Version Old Version 13 New Version 14
Changes made by

Alex Barth

Alex Barth

Saved on

Key

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

Components

The request string for a delegation request must be a JSON string that adheres to the following information:

PropertyValueRequiredDetails
TimestampWhen to process the request

Yes

Must be an ISO 8601 extended format date and time in UTC and may be set to a value in the future to schedule the request.
  • Example: 2024-01-02T03:04:05.006Z
TypeThe type of requestYesMust be a string with the following value: Delegation
ActionAction for the requestYesMust be one of the following approved verbs: Add, Remove
PathOU targetted by the requestYes

Must be an OU under the

department's

Department OU of the department.

  • Example: OU=Test-Computers,OU=TEST,OU=Departments,DC=austin,DC=utexas,DC=edu
PrincipalAD group in the delegationYes

Must be an Active Directory security group.

  • Example: TEST-ComputerRenamers
  • Example: TEST-GroupMemberManagers
DelegationPermissions for requestYes

Must be one of the standard delegations (see: Delegations Available in Austin Active Directory) and must not contain any white space.

  • Example: Set the value to ComputerRename for the "Computer Rename" delegation
  • Example: Set the value to GroupMembership for the "Group Membership" delegation
RequestedByUser submitting the requestYes

Must be the department administrator submitting the request. Validated against the

Department's

Administrators group for the department.

  • Example: TEST-Administrators
RequestedForEID requesting the delegationYesMust be the EID of the user who requested the delegation. Validated against active EIDs in Active Directory.
NotesAdditional informationNoText field to store information about the delegation request.


Examples

The following JSON string 

Code Block
{
	"Timestamp":"2024-03-01T12:00:00.000Z",
	"Type":"Delegation",
	"Action":"Add",
	"Path":"OU=Test-Delegation,OU=ALEX,OU=Departments,DC=austin,DC=utexas,DC=edu",
	"Principal":"ALEX-Accounts",
	"Delegation":"Group",
	"RequestedBy":"ALEX-barthag",
	"RequestedFor":"barthag",
	"Notes":"This is a test delegation"
}