Before you connect
- Sign in to Flare and use a GitHub account that owns the organization.
- Your organization must use GitHub Enterprise Cloud on github.com with organization audit API access. GitHub Free/Team organizations, Enterprise Server and dedicated
ghe.comdomains are outside this connector. - Install Flare Audit Log, published by tryflare-ai, with organization Administration: read. No repository contents or write permissions are requested.
- An organization can be linked to only one Flare account at a time. Use the same Flare account when reconnecting.
Connect an organization
- Open Connectors → GitHub → Open GitHub audit report.
- Choose Connect a GitHub organization and select an organization you own in GitHub.
- Review the App’s read-only organization permission, then install it or select the existing installation.
- Complete the GitHub authorization step when redirected. Flare verifies your access to the installation and performs a minimal owner audit-access check before saving the connection.
- Back in Flare, confirm that the expected organization appears in the Organization selector.
Choose a completed UTC window
- Select an active organization.
- Enter Start (UTC) and End (UTC). The interval must be in the past, no longer than 24 hours, and within the last 180 days.
- Alternatively, choose Use last hour, Use last 6 hours or Use last 24 hours. Presets end one minute before you select them. The populated bounds stay fixed until you edit them or choose another preset.
- Choose Run report and check the returned UTC window before interpreting findings.
Read coverage before findings
Normalized counts events Flare could interpret as valid evidence. Quarantined counts records it could not trust as normalized evidence. Unsupported actions can count toward coverage without producing a finding. “No supported change finding” can therefore appear even when events were observed.
Investigate findings
The results use the same two-pane investigation layout as other Flare sources. Findings appear on the left, ordered by review priority. Expand a finding to inspect its timestamp, exact GitHub source ID and evidence caveat inline, using the same expand/collapse interaction as other sources. Audit coverage appears above the findings. The right pane contains a compact summary and predefined investigation guidance, with controls for verification steps, coverage and analysis limits. On narrow screens, findings and guidance stack vertically; section links let you move between them. Use Change window to return to the organization and time controls. This clears the displayed report without fetching again. The GitHub demo uses the same layout with fictional sample logs. Connected reports show source IDs rather than raw payloads, and have no AI chat or anomaly scores.Supported observations
Flare reports only what the supplied event fields support. Missing transition fields do not establish the direction of a change.
Review priority is a triage aid, not an anomaly score or a verdict of malicious intent. For example, an App update does not establish which settings changed, and installation or expanded access does not prove the App read repository data. Compare the finding with the original GitHub audit record and your approved change records. The source ID is a citation identifier, not a link to a saved Flare report.
Data handling and exclusions
Flare stores the installation ID, organization ID and name, the owning Flare account, verification time and connection status. GitHub user and installation tokens are transient. Audit events are not sent to an AI provider. Raw event payloads and findings are not saved; the report is lost when you leave or refresh the page, and changing the organization or window clears the displayed result. There is no report history, automatic monitoring, schedule, deploy-webhook run, upload, baseline, numeric anomaly score or follow-up chat for this source. Git operations such as clone, fetch and push, repository contents, personal security logs and enterprise-wide audit streams are excluded. GitHub Actions integrations are separate from this report.Reconnect, disconnect and revoke access
- Reconnect: choose Connect a GitHub organization from the same Flare account and complete verification again. Restore the GitHub installation and required organization access first if they were removed.
- Disconnect from Flare: removes the selected connection mapping in Flare. It does not uninstall the App in GitHub.
- Revoke provider access: an organization owner must uninstall Flare Audit Log in GitHub’s organization installation settings. Flare may continue to display the saved connection until a later access check fails; a saved connection is not proof the installation still has access.