The One Identity ManagerREST API allows you to run any script that is stored inside of the One Identity Manager database.
NOTE: The authenticated user must be entitled to use the Allow the starting of arbitrary scripts from the frontend (Common_StartScripts) program function in order to run a script.
To run a script, use the URL <baseURL>/api/script/{name}.
|
HTTP method |
URI |
Body |
|---|---|---|
|
Put |
<BaseURL>/api/script/{name} |
{ "parameters": [ "Parameter value"], "base": "XObjectKey", "value": "Sample value", "returnRawResult": true } |
|
Parameter |
Description |
Parameter type |
Data type |
|---|---|---|---|
|
name |
Script name (required). |
path |
string |
|
parameters |
Script parameters. |
body |
object[] |
|
base |
Object key of base object. |
body |
string |
|
value |
Content of the value variable in the script. |
body |
object |
|
returnRawResult |
Allow to return the raw object or string as result. |
body |
boolean |
ScriptParameters {
parameters (object, optional),
base (string, optional): Object key of base object,
value (object, optional): Content of the Value variable in the script
}
ScriptResult {
result (object, optional): Return value of the script,
value (object, optional): Content of the Value variable in the script
}
https://<Hostname>/AppServer/api/script/QER_GetWebBaseURL
{}
{
"result": "https://<Hostname>/IdentityManager/"
}
https://<Hostname>/AppServer/api/script/VI_AE_BuildCentralAccount
{
"parameters": [
"f79c30fd-87bb-4958-a812-0683ddcac7c9",
"Adams",
"David"
]
}
{
"result": "DAVIDA"
}
https://<Hostname>/AppServer/api/script/VI_AE_BuildCentralAccount
{
"parameters": [
"f79c30fd-87bb-4958-a812-0683ddcac7c9",
"Adams",
"David"
],
"returnRawResult": true
}
{
"result": "DAVIDA"
}
# Construct auth json
$authdata = @{AuthString="Module=DialogUser;User=<user name>;Password="}
$authJson = ConvertTo-Json $authdata -Depth 2
# Login (important, pass the NAME for your session variable in -SessionVariable)
Invoke-RestMethod -Uri "https://<Hostname>/AppServer/auth/apphost" -Body $authJson.ToString() -Method Post -UseDefaultCredentials -Headers @{Accept="application/json"} -SessionVariable wsession -ContentType "application/json"
# Do stuff (always pass -WebSession and use the variable you NAMED in the previous step)
# Sample 1: Load collection using Post method
$body = @{where="LastName like 'B%'";orderBy="LastName ASC, FirstName DESC"} | ConvertTo-Json
Invoke-RestMethod -Uri "https://<Hostname>/AppServer/api/entities/Person?loadType=ForeignDisplays" -WebSession $wsession -Method Post -Body $body -ContentType application/json
# Sample 2: Create a new object and return URI of new object
$body = @{values=@{FirstName="Jeremia";LastName="Bodewell";IsExternal=1;BirthDate="1993-05-14";Gender=1}} | ConvertTo-Json
$newURI = (Invoke-RestMethod -Uri "https://<Hostname>/AppServer/api/entity/Person" -WebSession $wsession -Method Post -Body $body -ContentType application/json).uri
# Sample 3: Get all properties for new object
(Invoke-RestMethod -Uri $newURI -WebSession $wsession -Method Get -ContentType application/json).Values
# Sample 4: Update the new object
$body=@{values=@{LastName="Garibaldi";IsExternal=0;ExitDate="2021-12-16T14:24:32.424Z";PersonalTitle="Administration (EMEA)"}} | ConvertTo-Json
Invoke-RestMethod -Uri $NewURI -WebSession $wsession -Method Put -Body $body -ContentType application/json
# Sample 5: Delete the new object
Invoke-RestMethod -Uri $NewURI -WebSession $wsession -Method Delete -ContentType application/json
# Logout
Invoke-RestMethod -Uri "https://<Hostname>/AppServer/auth/logout" -WebSession $wsession -Method Post -ContentType "application/json"
© 2024 One Identity LLC. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center
