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
- 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.
01
Choose events
Subscribe only to the event names the workflow needs. The workspace event list shows the names in use.Event catalog02
Register destination
Confirm authentication, scopes, network, and delivery ownership.Connector configuration03
Verify delivery
Validate the HMAC signature before processing the payload.Webhook secret04
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.
GitHub Actions
Gate releases with evaluation results before code or model changes ship.
- Category
- Release automation
- Readiness
- GA
// 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.
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.
01
Select events
Name the events and payload fields the destination requires.
Subscription scope
02
Configure access
Confirm credentials, permissions, network, and owner.
Connector configuration
03
Verify delivery
Send a test delivery, then check the signature, retries, and duplicate handling.
Integration test receipt
04
Approve operation
Record retention, support, rollback, and the next review date.
Operating handoff