Overview
After installing the connector, you need to activate it with an activation token from your dashboard. This process links the connector to your organization and generates a permanent API key for ongoing authentication.Activation tokens are valid for 15 minutes and can only be used once.
Generate Activation Token
1
Navigate to Connectors
In your ScaleHouse dashboard, go to Audit Intelligence → Connectors.
2
Click Activate
Click the “Activate Connector” button.
3
Copy Token
A modal will appear with your activation token. Click “Copy” to copy it to your clipboard.
4
Note Expiration
The token expires in 15 minutes. If it expires, generate a new one.
Activate Connector
1
Open Connector
Right-click the ScaleHouse connector icon in your system tray and select “Configure”.
2
Paste Token
Paste the activation token into the “Activation Token” field.
3
Click Activate
Click the “Activate” button.
4
Wait for Confirmation
The connector will communicate with the ScaleHouse API to activate. This usually takes 2-5 seconds.
5
Verify Status
Check your dashboard to confirm the connector shows as “Active”.
What Happens During Activation
Token Validation
Token Validation
The connector sends the activation token to the ScaleHouse API for validation.
API Key Generation
API Key Generation
Upon successful validation, the API generates a permanent API key for the connector.
Connector Registration
Connector Registration
The connector is registered to your organization and location.
Initial Sync
Initial Sync
The connector begins syncing audit logs immediately after activation.
Troubleshooting
Token expired
Token expired
Solution: Generate a new activation token from your dashboard.
Token already used
Token already used
Solution: Each token can only be used once. Generate a new token if you need to reactivate.
Network error during activation
Network error during activation
Possible causes:
- No internet connection
- Firewall blocking connection
- ScaleHouse API temporarily unavailable
- Check your internet connection
- Verify firewall allows outbound HTTPS connections
- Wait a few minutes and try again
Connector shows 'Pending' after activation
Connector shows 'Pending' after activation
Solution:
- Wait 30 seconds for status to update
- Right-click connector icon → “Refresh Status”
- Check connector logs:
C:\ProgramData\ScaleHouse\logs\
Reactivating a Connector
If you need to reactivate a connector (e.g., after uninstalling and reinstalling):1
Generate New Token
Follow the steps above to generate a new activation token.
2
Open Configuration
Open the connector configuration window.
3
Paste Token
Paste the new activation token.
4
Activate
Click “Activate” to link the connector to your account again.
Reactivating a connector will create a new connector record in your dashboard. The old connector will be marked as inactive.
Next Steps
Configure Database
Set up database connection
Verify Connection
Verify connector is working
