Skip to main content
The authtoken acts with the permissions of the technician it belongs to, so generate it as a technician who is delegated the Active Directory actions you plan to run. Your ADManager Plus server must be reachable from StackOne over HTTPS.

​
Find your Server URL

Your Server URL is the address of your self-hosted ADManager Plus web console.

  • Copy it from your browser address bar while signed in to ADManager Plus, keeping only the protocol, host and port.
  • Paste it into the Server URL field in StackOne Hub, without a trailing slash, /api/v2 or /RestAPI.
  • Format: https://{hostname}:{port}
  • Example: https://admanager.example.com:8443
  • The Native Webhook URL field is filled in by StackOne and is only needed if you send webhook events from ADManager Plus.

​
Generating an authtoken

An authtoken lets StackOne call the ADManager Plus REST API on behalf of a technician.

1

Open My Account

Sign in to the ADManager Plus web console at your Server URL, then click the profile icon in the top-right corner and select My Account.

The ADManager Plus profile menu with the profile icon and the My Account option highlighted
2

Open Active Authtokens

In the My Account window, open the Active Authtokens tab and click Generate Authtoken.

The Active Authtokens tab of My Account with the Generate Authtoken button highlighted
3

Fill in the authtoken details

Complete the Generate New Authtoken form.

  • Authtoken Name: StackOne Integration
  • Leave Scope set to All actions, or choose a scope that covers every action you plan to use.
  • Set Expiration Time to how long StackOne should keep access. When the authtoken expires, StackOne can no longer connect until you generate a new one.
  • Click Generate Authtoken.
The Generate New Authtoken form with the Authtoken Name, Scope, Expiration Time fields and the Generate Authtoken button highlighted
4

Copy the authtoken

Click Copy to Clipboard and paste the value into the Authtoken field in StackOne Hub.

  • Store it securely for use later. The Active Authtokens list shows only the authtoken name, not its value.
  • Authtokens can be used for impersonating a help desk technician and should therefore be kept confidential.
The generated authtoken with its value hidden and the Copy to Clipboard button highlighted

​
Enabling REST API access

ADManager Plus only accepts API calls when REST API access is enabled.

1

Check the Rest API settings

Navigate to Admin > System Settings > Integrations > Rest API.

  • Make sure Enable API Access is switched on.
  • To return or filter on more user attributes, such as logon times, click the configuration icon in the List AD Users row and enable the response and search columns you need. Repeat for the other APIs as required.
  • The Rest API Usage counter shows how many API calls are left in the current period.
The Rest API settings page with the Enable API Access toggle and the List AD Users configuration icon highlighted

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Server URL
  • Authtoken
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.

​
Next Steps

Webhooks setup

Configure receiving Events for AD Manager into StackOne.