AuraOne / Developers / Integrations

Connect AuraOne to the systems your team already uses.

Connectors and signed webhooks for release automation, data systems, incident response, and observability.

Filter by category to inspect connector capabilities, event delivery schemas, and SDK registry lookups.

At a glance

Connector catalog

Current availability
Catalog
9 connectors
GA
5 connectors
Beta
4 connectors
Categories
5 operating groups
Delivery
HMAC signed

Operating trace

The signature keeps the source event connected.

Native connectors and raw webhooks use the same operating trace.

  1. 01

    Choose events

    Subscribe only to the event names the workflow needs. The workspace event list shows the names in use.Event catalog
  2. 02

    Register destination

    Confirm authentication, scopes, network, and delivery ownership.Connector configuration
  3. 03

    Verify delivery

    Validate the HMAC signature before processing the payload.Webhook secret
  4. 04

    Retain receipt

    Archive the event, destination result, retry state, and linked evidence.Downstream receipt

Connector catalog

Filter by the system that receives the event.

Select a connector to inspect its readiness, requirements, and registry lookup.

Selected connector

GitHub Actions

GA

Gate releases with evaluation results before code or model changes ship.

Category
Release automation
Readiness
GA
registry-lookup.ts
// Query your organization's registered connectors and health status:
const entries = await client.integrations.listRegistry({
  search: "GitHub Actions",
});
const health = await client.integrations.getHealth({ detailed: true });

Raw webhook

Verify the signature before routing the event.

The handler rejects an unverified payload, then routes the event only after origin and message integrity are established.

webhook-handler.tsHMAC verification
import { createHmac, timingSafeEqual } from "node:crypto"; import express from "express"; const app = express(); const TOLERANCE_MS = 5 * 60 * 1000; function header(headers, name) { const value = headers[name]; return Array.isArray(value) ? value[0] : value; } export function verifyAuraOneWebhook(rawBody, headers, secret, now = Date.now()) { // Tenant webhooks: X-Webhook-Signature + X-Webhook-Timestamp (seconds). // Robotics delivery events: x-auraone-signature "sha256=..." + // x-auraone-timestamp (milliseconds). const signature = header(headers, "x-webhook-signature") ?? header(headers, "x-auraone-signature"); const timestamp = header(headers, "x-webhook-timestamp") ?? header(headers, "x-auraone-timestamp"); if (!secret || !signature || !timestamp || !/^\d+$/.test(timestamp)) return false; const sentAt = timestamp.length > 11 ? Number(timestamp) : Number(timestamp) * 1000; if (Math.abs(now - sentAt) > TOLERANCE_MS) return false; const provided = signature.startsWith("sha256=") ? signature.slice(7) : signature; if (!/^[0-9a-f]{64}$/i.test(provided)) return false; const expected = createHmac("sha256", secret) .update(`${timestamp}.`) .update(rawBody) .digest(); const received = Buffer.from(provided, "hex"); // timingSafeEqual throws on unequal lengths, so guard first. return received.length === expected.length && timingSafeEqual(received, expected); } // Verify the raw bytes, not a re-serialized object. app.post( "/webhooks/auraone", express.raw({ type: "application/json" }), (req, res) => { const secret = process.env.AURAONE_WEBHOOK_SECRET ?? ""; if (!verifyAuraOneWebhook(req.body, req.headers, secret)) { return res.status(401).end(); } const event = JSON.parse(req.body.toString("utf8")); res.status(200).json({ received: true, type: event.type ?? null }); }, );
import { createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
const TOLERANCE_MS = 5 * 60 * 1000;

function header(headers, name) {
  const value = headers[name];
  return Array.isArray(value) ? value[0] : value;
}

export function verifyAuraOneWebhook(rawBody, headers, secret, now = Date.now()) {
  // Tenant webhooks: X-Webhook-Signature + X-Webhook-Timestamp (seconds).
  // Robotics delivery events: x-auraone-signature "sha256=..." +
  // x-auraone-timestamp (milliseconds).
  const signature =
    header(headers, "x-webhook-signature") ?? header(headers, "x-auraone-signature");
  const timestamp =
    header(headers, "x-webhook-timestamp") ?? header(headers, "x-auraone-timestamp");
  if (!secret || !signature || !timestamp || !/^\d+$/.test(timestamp)) return false;

  const sentAt = timestamp.length > 11 ? Number(timestamp) : Number(timestamp) * 1000;
  if (Math.abs(now - sentAt) > TOLERANCE_MS) return false;

  const provided = signature.startsWith("sha256=") ? signature.slice(7) : signature;
  if (!/^[0-9a-f]{64}$/i.test(provided)) return false;

  const expected = createHmac("sha256", secret)
    .update(`${timestamp}.`)
    .update(rawBody)
    .digest();
  const received = Buffer.from(provided, "hex");
  // timingSafeEqual throws on unequal lengths, so guard first.
  return received.length === expected.length && timingSafeEqual(received, expected);
}

// Verify the raw bytes, not a re-serialized object.
app.post(
  "/webhooks/auraone",
  express.raw({ type: "application/json" }),
  (req, res) => {
    const secret = process.env.AURAONE_WEBHOOK_SECRET ?? "";
    if (!verifyAuraOneWebhook(req.body, req.headers, secret)) {
      return res.status(401).end();
    }
    const event = JSON.parse(req.body.toString("utf8"));
    res.status(200).json({ received: true, type: event.type ?? null });
  },
);

A connector is ready only when the receipt is inspectable.

Keep the configuration, the delivery, and the failure handling connected.

  1. 01

    Select events

    Name the events and payload fields the destination requires.

    Subscription scope

  2. 02

    Configure access

    Confirm credentials, permissions, network, and owner.

    Connector configuration

  3. 03

    Verify delivery

    Send a test delivery, then check the signature, retries, and duplicate handling.

    Integration test receipt

  4. 04

    Approve operation

    Record retention, support, rollback, and the next review date.

    Operating handoff