Script-based authorization
Last updated
Last updated
Script-based authorization is an Enterprise edition feature
If you'd like to make dynamic authorization decisions, outside the static ACL model, you can utilize a PowerShell script to do this.
Access Manager can call a script that contains a function called Get-AuthorizationResponse
that takes a user, computer, and logger as input parameters. From there you can make a decision on what the user should be allowed or denied access to, or choose to not make an authorization decision at all.
Access Manager uses the response you provide to create a dynamic ACL for the user, and includes it in the access evaluation of all applicable targets.
You can use the Write-Information, Write-Warning, Write-Verbose cmdlets to write to the AMS log file and document your authorization decisions. Note that if you use Write-Error, or if an exception is thrown and not handled, the authorization evaluation for the entire access request will fail.
Be aware of performance when writing external authorization scripts. From the user's perspective, they will be waiting in the browser while the access evaluation takes place. If you have a slow script, or lots of scripts, this wait time may seem excessive.
Scripts that take longer than 30 seconds to complete will be terminated by Access Manager, and the user's authorization request will fail.
$user
objectThe user object has the following properties you can access
Property Name | Type | Description |
---|---|---|
| string | The value of the description field in active directory, if present |
| string | The display name of the user |
| string | The DN of the user from Active Directory |
| string | The user's email address (e.g. |
| string | The user's given name |
| Guid | The object GUID from the directory object |
| string | The NT4-style name of the user (e.g. |
| string | The samAccountName of the user (e.g. |
| string | The Security Identifier of the user (e.g. |
| string | The user's surname |
| string | The user's UPN (e.g. |
$computer
objectThe computer object has the following properties you can access
Property Name | Type | Description |
---|---|---|
| string | The value of the description field in active directory, if present |
| string | The display name of the computer |
| string | The user's email address (e.g. |
| string | The identifier that represents the authority ID that manages the computer |
| string | An identifier, specific to the authority type, that uniquely represents the computer object |
|
| The type of authority that manages the computer |
| string | The fully qualified name of the computer. (e.g. |
| string | The name of the computer (e.g. |
| string | The computer's unique AMS object ID |
If the computer is an Active Directory-joined computer, then the following additional properties may be available
Property Name | Type | Description |
---|---|---|
| string | The DN of the user from Active Directory |
| Guid | The object GUID from the directory object |
| string | The NT4-style name of the computer (e.g. |
| string | The samAccountName of the computer (e.g. |
| string | The Security Identifier of the computer (e.g. |