Torii Plugin for Steampipe

Use SQL to query users, applications, contracts, roles, audit logs, and more from Torii SaaS management platform.

• Get started →
• Community: Join #steampipe on Slack →
• Get involved: Issues

Quick start

Install

Install the plugin with Steampipe:

steampipe plugin install ghcr.io/vthiery/torii

Configure

Copy the sample config and set your API key:

cp config/torii.spc ~/.steampipe/config/torii.spc

Edit ~/.steampipe/config/torii.spc:

connection "torii" {
  plugin  = "ghcr.io/vthiery/torii"

  # API key for authenticating with the Torii API.
  # Obtain your API key from Torii: Settings → Security → API Keys.
  # api_key = "YOUR_API_KEY"
}

Run a query

steampipe query

List all active users:

select
  id,
  first_name,
  last_name,
  email,
  role
from
  torii_user
where
  lifecycle_status = 'active';

Tables

Table	Description
torii_user	List users in your Torii organization.
torii_app	List applications discovered or managed in your Torii organization.
torii_app_user	List users of a specific application.
torii_contract	List software contracts managed in your Torii organization.
torii_role	List roles defined in your Torii organization.
torii_audit_log	List admin audit log events.

Development

Prerequisites

• Steampipe
• Golang

Build and Install

make install

Configure the plugin:

cp config/torii.spc ~/.steampipe/config/torii.spc
vi ~/.steampipe/config/torii.spc

Testing

Run a smoke query against every table:

make test

The test script (scripts/test_tables.sh) builds the plugin, queries each table, and reports pass/fail/skip.

Further reading

• Writing plugins
• Torii API reference