tigergate-dspm-scanner, which you deploy in your own
environment with Terraform. TigerGate never holds a role or a credential in your cloud: you apply the module with your
own credentials, and the scanner runs on its own identity.
| Environment | Runs on | Queue and state | Guide |
|---|---|---|---|
| AWS | ECS Fargate (or an EC2 Auto Scaling group) | SQS and DynamoDB | Deploy on AWS |
| Azure | Container Apps Jobs with a managed identity | Storage queues and Table storage | Deploy on Azure |
| Google Cloud | Cloud Run Jobs with a keyless service account | Pub/Sub and Firestore | Deploy on Google Cloud |
| On-prem | A container started by a systemd timer on your Linux host | SQLite on the host | Deploy on-prem |
The onboarding wizard
Go to DSPM → Deployments → Add deployment and choose AWS account, Azure subscription, Google Cloud project or On-prem. The wizard has five steps:- Scan policy. What the scanner may read, exactly as the module grants it. It is read-only.
- Account & network. The account, subscription, project or site name; the regions; the TigerGate region; the network; the profile, the schedule (weekly by default), maximum workers and whether to share masked samples (on by default). Selecting Create deployment and enrollment token creates the deployment.
- Terraform. The enrollment token (shown once), the organization API key, and the generated
main.tf,terraform.tfvarsand apply commands, with links to the module archive and its checksums. - Register & preflight. Waits for the scanner to register, then shows each preflight check with its fix.
- First run. The first run’s progress, report chunks and errors, with Run now.
Two credentials
Every call the scanner makes to TigerGate carries two credentials:- The organization API key (
tg_...) in theX-API-Keyheader. It authenticates your organization. - The enrollment token (
tgdspm_...) on the first call, which the scanner exchanges once for a scanner credential of its own. It binds the call to one deployment.
The organization API key
The key is required on every platform. In the wizard’s Terraform step you can:- Create a key. Name it and select Create key. The value is shown once and filled into
terraform.tfvars. - Paste a key you already have. TigerGate keeps only a hash, so an existing key’s value cannot be shown again.
- Use a secret. Tick the option to keep the key out of Terraform state and give the secret that holds it:
tigergate_api_key_secret_arnon AWS,tigergate_api_key_key_vault_secret_idon Azure,tigergate_api_key_secret_idon Google Cloud, orapi-key.envon the on-prem host.
The enrollment token
Each deployment has its own token. It works once: after the scanner registers, the token is spent and the scanner uses its own credential. TigerGate stores only hashes of both. To replace a lost or rejected credential, select Re-register on the deployment, which mints a new token, and put the token in place: the scanner registers again on its next run. See The scanner credential is rejected.Terraform modules
The modules are published for each scanner version athttps://releases.tigergate.dev/dspm/<version>/:
| File | Content |
|---|---|
tigergate-dspm-aws.zip, -azure.zip, -gcp.zip, -onprem.zip, -test-data.zip | One module each. The URL works directly as a Terraform source. |
tigergate-dspm-terraform.zip | Every module in one archive. |
tigergate-dspm-inaccount.yaml | The AWS CloudFormation template. |
SHA256SUMS | Checksums of the files above. |
https://releases.tigergate.dev/dspm/latest/ serves the current release under the same names. Pin a version for
production. To verify a download, run this in the directory that holds the downloaded files:
Several clouds in one configuration
Theexamples/multi-cloud configuration in the bundle deploys AWS, Azure and Google Cloud together. Create one
deployment per cloud in the console first, so each has its own enrollment token, then:
multi-cloud.tfvars holds the non-secret inputs: tigergate_api_url, aws_vpc_id, aws_subnet_ids,
azure_subscription_id and gcp_project_id. One API key serves the three deployments.
Deployment status
The Deployments page shows one status per deployment:| Status | Meaning |
|---|---|
| Not registered | The deployment exists, but the scanner has not registered yet. |
| Registered | The scanner registered; no run has finished yet. |
| Healthy | Scanning on schedule, or a run is in progress. |
| Degraded | The last run finished with store errors, or a preflight check warned. Scanning works, with gaps. |
| Failing | A preflight check failed, the last run failed, or TigerGate refused the scanner. |
| Stale | No call from the scanner for 45 minutes: three missed ticks. |
| Revoked | The deployment was revoked. Its scanner credential no longer works. |
| Scanner not deployed | A cloud account connected to TigerGate has no in-account scanner, so nothing reads its data. Open it to start the wizard for that account. |