Getting started

Connect your first data source

Connect GitHub, AWS, or your identity provider so evidence starts collecting automatically.

RolesViewerEditorAdminRoute/data-sourcesShown toAll organizations

What it is

A data source is a read-only connection to a system you already run. Once connected, Noru syncs it on a schedule and turns what it finds into evidence, assets, identities, and findings, each mapped to the controls it supports. That is where most control coverage comes from, so the first connector is the step that changes the dashboard most. The wizard requires one before Finish; this page helps you choose it and shows where its output lands.

Anyone can open the Data Sources page; connecting, syncing, and disconnecting need an editor or admin.

Where to find it

Data Sources
The Data Sources page listing available connectors with connected ones markedThe Data Sources page listing available connectors with connected ones marked
The Data Sources page. Connected sources show their last sync.

Key actions

Pick the first connector

ConnectorBest first choice whenWhat arrivesGuide
GitHubEngineering runs on GitHubRepository settings, branch protection, access, review evidenceGitHub
Amazon Web ServicesProduction runs on AWSAssets, account and security configuration, findingsAWS
Google WorkspaceGoogle is your identity providerPersonnel identities, MFA status, admin settingsGoogle Workspace
Microsoft Entra ID (Azure AD)Microsoft is your identity providerPersonnel identities, MFA status, directory configurationMicrosoft Entra ID

If you can only do one this week, connect the identity provider: it feeds the Personnel step of the readiness plan, which most frameworks weight heavily. Engineering teams often start with GitHub because it takes a minute and produces evidence on the first sync.

Connect a source

On Data Sources, find the provider and start the connection.
Authorise Noru. OAuth providers such as GitHub and Google Workspace open the provider's consent screen; credential-based providers ask for a key or role in the connect dialog.
Choose the sync frequency: Hourly, Daily, Weekly, or Monthly.
Wait for the first sync. The source's row shows when it last ran.
The connect dialog for a provider with the sync frequency optionsThe connect dialog for a provider with the sync frequency options
The connect dialog. Provider pages list the exact scopes each one asks for.

The provider pages under Data sources describe what each connector asks for, what it collects, and what it never reads.

Find what the sync produced

OutputWhere it landsHow to spot it
EvidenceEvidence vaultThe Integration column and the Source filter
AssetsAssetsThe Source column and filter; discovered assets carry an External ID
IdentitiesPersonnel directoryRows synced from the identity provider
FindingsSecurity findingsFindings from cloud and scanning providers
Control coverageControlsThe Coverage column rises as evidence qualifies
The evidence vault with the Integration column showing rows from a connected sourceThe evidence vault with the Integration column showing rows from a connected source
Automatic evidence in the vault after the first sync.

The dashboard's 1. Critical Systems Scan Findings step reads the same data; Rescan Systems there triggers a fresh pass.

Statuses and fields

Sync frequencyUse it for
HourlySystems that change all day, such as cloud accounts during a migration
DailyThe default choice for repositories and identity providers
WeeklyStable systems where a week's lag is acceptable
MonthlySources you connect for an annual snapshot

Tips and gotchas

Connect with a service account or a dedicated admin identity, not a personal login. When that person leaves, the connection would break with them.

Coverage lags the sync

Evidence appears in the vault as soon as the sync finishes, but control coverage is recomputed afterwards. If a control still shows old coverage a few minutes after a sync, refresh; see Control status and coverage.

Disconnecting a source stops new syncs, so the automatic evidence it produced stops refreshing and will eventually expire, dropping coverage on the controls it fed. Read the provider page before disconnecting a source that feeds implemented controls.

What Noru does not do

Noru reads; it does not change settings in the connected system, create resources, or remediate findings. Connecting a system does not make it compliant, and evidence from a sync is a snapshot of configuration, not a judgement about whether that configuration is right for you. Noru also does not collect anything a provider page lists as not collected, and it does not sync outside the frequency you set except when you trigger a sync by hand.

Last updated on