Search the documentation
Search the documentation...
SplitSecure documentation

On this page

Procedure · 4 steps

Review the audit log

See who changed what in your organization, and forward the events to Slack or email.

Updated

Before you start

  • An Owner or Admin role in the organization. The Auditor role does not see the audit log.
  • A plan (opens in a new tab) that includes the audit log. To forward events, a plan that also includes forwarding.

The audit log records every change to your organization: who made it, when, and whether it succeeded. It covers members, seats, groups, single sign-on, SCIM, service accounts, billing and forwarding itself. An attempt refused for lack of rights is recorded too, as Failed.

Proposals of your Guardian Team, the group of devices that together approve each proposal, and StepAuth requests have their own logs, on their own pages.

Read the log

In the Web App

  1. In the sidebar, click Organization → Audit.

The newest events come first, and more load as you scroll. Each one shows its time, a sentence that says what happened, and a status: Succeeded, Failed or Attempted.

  1. Set From and To.
  2. Click Refresh.

The log filters by date only. Click Details under an event to see and copy its IDs and its Correlation ID.

How long events are kept

Your plan sets how long events are kept. The page says it under the dates: Events are kept for, followed by the period, on your plan, then deleted.

Each event’s deletion date is set when it is written, so a plan that keeps events longer applies to new events only.

The log has no export. To keep events longer than your plan does, forward them.

Forward the events

In the Web App

Forwarding sends each new event to Slack or to an email address, as it happens.

  1. In the sidebar, click Organization → Advanced → Audit forwarding.

  2. Click Create policy.

  3. Fill in the fields.

    Field Value
    Name A name for the policyFor example Security Slack channel
    Destination type Slack webhook, Slack app or Email
    Event scopes One or moreGuardian Team events, Organization events and StepAuth events. All by default
    Enabled OnOff keeps the policy without sending
  4. Fill in the destination’s fields.

    Field Value
    Incoming webhook URL The Slack webhookSlack webhook only. Never shown again after you save
    Channel ID The Slack channel, such as C0123456789Slack app only. Invite the SplitSecure Slack app to the channel with /invite
    Workspace ID The Slack workspaceSlack app only. Connect the workspace under Integrations first
    Recipient email The address that receives the eventsEmail only
    Subject prefix [SplitSecure Audit] by defaultEmail only. Leave it empty for no prefix
  5. Click Create.

There is no test button. Make a harmless change, such as renaming a group, and check that it arrives.

  1. Click the policy’s row.
  2. Under Policy settings, change the name, the scopes or Enabled, then click Save changes.

You cannot change a policy’s webhook URL or recipient. Create a new policy and delete the old one: click Delete, then Delete in the confirmation.

On a plan without the audit log

The audit page shows an upgrade prompt in place of the log. Policies you created before show Paused: not in your plan and send nothing. You can still turn them off or delete them.

Troubleshooting

Issue Solution
Audit is missing from the sidebar You are not an Owner or AdminAsk an administrator to read it for you
Your plan keeps a period of history, so earlier events have been deleted. From is earlier than your plan keepsPick a later date, or forward events to keep them
No Slack workspace connected. Connect it from the Integrations tab. The Slack app is not installed for your organizationClick Open Integrations and connect the workspace
A policy shows Paused: not in your plan Your plan does not include forwardingMove to a plan (opens in a new tab) that includes it
Nothing arrives in Slack The app is not in the channel, or the webhook was revokedRun /invite in the channel, or create a policy with a new webhook

External resources