Integrations (Admin Guide)

This guide explains how to connect each integration inside the app. You do not need to be technical, but you do need an admin account for each tool.

Before You Start

• Make sure you are an admin in the tool you want to connect.
• Keep a second tab open so you can approve permission prompts.

Google Workspace

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on Google Workspace.
3. Sign in with your Google Workspace admin account.
4. Approve the permissions.
5. Return to InsiderShield and click Sync Now.

What You Get

• MFA status for all users
• Super admin checks
• Recovery email and phone checks
• Suspended account checks

GitHub

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on GitHub.
3. Sign in and choose your organization.
4. Approve permissions.
5. Click Sync Now.

What You Get

• Repository security settings
• Code scanning and secret scanning status
• High risk alerts

AWS

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on AWS.
3. Enter Access Key ID and Secret Access Key.
4. Choose the main region.
5. Click Sync Now.

What You Get

• IAM and MFA checks
• Public bucket checks
• Security group exposure checks
• CloudTrail and GuardDuty status

Slack

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on Slack.
3. Choose your workspace.
4. Approve permissions.
5. Click Sync Now.

What You Get

• Alert delivery to Slack
• Workspace security status

Azure (Microsoft Entra ID)

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on Azure.
3. Sign in with an admin account.
4. Approve permissions.
5. Click Sync Now.

What You Get

• User and group access checks
• MFA and conditional access checks

Okta

Steps

1. Go to Dashboard -> Integrations.
2. Click Connect on Okta.
3. Enter your Okta domain (example: company.okta.com).
4. Sign in and approve.
5. Click Sync Now.

What You Get

• MFA enrollment checks
• User and group access checks
• Policy visibility

Webhooks (Optional)

Use webhooks if you want InsiderShield to notify another system.

Steps

1. Go to Dashboard -> Settings -> Webhooks.
2. Click Add Webhook.
3. Paste your endpoint URL.
4. Choose events.
5. Save and copy the secret.

API Keys (Optional)

Use API keys if another tool needs to read data from InsiderShield.

Steps

1. Go to Dashboard -> Settings -> API Keys.
2. Click Create API Key.
3. Name the key and choose scopes.
4. Copy the key (shown once).

Troubleshooting

• If an integration shows Error, disconnect and reconnect.
• If Sync Now does not show new findings, wait 1-2 minutes and refresh.
• Make sure you are using an admin account for the tool.