Grouper AssetSonar external system
See also: AssetSonar provisioner.
The AssetSonar provisioner connects through a standard WsBearerToken external system (the generic web service connection), configured to send AssetSonar's plain token header. There is no AssetSonar-specific external system type.
Configuration
Create a WsBearerToken external system in the Grouper UI, then pick it as the provisioner's assetSonarExternalSystemConfigId:
grouper.wsBearerToken.myAssetSonar.endpoint = https://school.assetsonar.com
grouper.wsBearerToken.myAssetSonar.httpAuthnType = bearerToken
grouper.wsBearerToken.myAssetSonar.accessTokenPassword = <REST API token>
grouper.wsBearerToken.myAssetSonar.httpHeader = token
grouper.wsBearerToken.myAssetSonar.prependBearerTokenPrefix = false
grouper.wsBearerToken.myAssetSonar.testUrlSuffix = /members.api
grouper.wsBearerToken.myAssetSonar.testUrlResponseBodyRegex = ^.*status.*$Property | Value | Notes |
|---|---|---|
endpoint | tenant root url | The provisioner appends |
accessTokenPassword | REST API token | Encrypted at rest and masked in the UI. |
httpHeader |
| AssetSonar does not use |
prependBearerTokenPrefix |
| AssetSonar wants the bare token, no |
testUrlSuffix, testUrlResponseBodyRegex |
| The test button: a 200 with a member list (every member has a |
delayAfterEachCallInMs | optional | Pause after every call (reads and writes) if the tenant returns 502s under load. |
The access tier role ids are provisioner properties (assetSonarStaffUserRoleId, assetSonarAgentRoleId, assetSonarAdministratorRoleId), not part of the connection. See the provisioner page.
Obtaining the token
In AssetSonar: "Settings" -> "Add Ons" -> "API Integration". Enable it and generate an access token. The token acts as the member it belongs to; prefer the least-privileged member that can create and update members over an Administrator.
Security
The token can create and deactivate any member; treat it as a tenant-wide credential and rotate it if exposed.
AssetSonar also offers SCIM, but the provisioner does not use it (SCIM only sees login-capable members), so no SCIM credential is configured.
History
Before GRP-7433 (v7) this was a custom AssetSonar external system (grouper.assetSonarConnector.<id>.*) with an apiToken property. To migrate: create the WsBearerToken external system above with the same id, move the three role ids to the provisioner, run the test button, and delete the old grouper.assetSonarConnector.* properties.