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
- 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.
- Set From and To.
- 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.
In the sidebar, click Organization → Advanced → Audit forwarding.
Click Create policy.
Fill in the fields.
Field Value Name A name for the policyFor example Security Slack channelDestination 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 NoteA Slack app policy posts one message per proposal and updates it as the votes come in. An Email policy threads the messages of one proposal together.
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/inviteWorkspace 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 prefixClick Create.
There is no test button. Make a harmless change, such as renaming a group, and check that it arrives.
- Click the policy’s row.
- 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
- Slack: Sending messages using incoming webhooks (opens in a new tab): Slack incoming webhooks
- SplitSecure plans (opens in a new tab): See the plans and their limits