IF Commons GitHub

governance/connectors

Written to: 3 requirements: 3 proved, 0 partly, 0 failing, 0 with no test recorded. 0002-identity-connectors FR-001, 0002-identity-connectors FR-002, 0002-identity-connectors FR-003

The governance of the three connectors as data (0002-identity-connectors FR-001 to FR-003): the system each reads, the one scope it asks for (read only, named), the hosts its transport may reach, its cadence, and the posture policies in the vocabulary of GRC, whose control identifiers are the consumer's to attach. Nothing here reaches a network: each connector is a function of the answers a read port gives.

import { ENTRA_POLICIES } from "./connectors.ts";
ENTRA_POLICIES.length > 0; // true

Source: commons/integrations-identity/src/governance/connectors.ts

3 of 20 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.

governance.GovernanceErrortypeno test imports it
type GovernanceError = { readonly kind: "id"; readonly what: string };

Why a governance cannot be made.

governance.GRAPH_HOSTconstno test imports it
const GRAPH_HOST: "graph.microsoft.com"

The host of Microsoft Graph and the host the application's token is asked from.

governance.LOGIN_HOSTconstno test imports it
const LOGIN_HOST: "login.microsoftonline.com"

The host of the token service of Microsoft's identity platform.

governance.GOOGLE_HOSTconstno test imports it
const GOOGLE_HOST: "admin.googleapis.com"

The host of Google's Admin SDK.

governance.entraGovernancefunctionno test imports it
function entraGovernance(tenant: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of a Microsoft Entra tenant: it reads the authentication-method registrations, the conditional access policies and the organization's name, with the read-only application permissions Reports.Read.All, Policy.Read.All and Organization.Read.All.

governance.intuneGovernancefunctionno test imports it
function intuneGovernance(tenant: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of Microsoft Intune's managed devices, with the read-only application permission DeviceManagementManagedDevices.Read.All.

governance.googleWorkspaceGovernancefunctionno test imports it
function googleWorkspaceGovernance(domain: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of a Google Workspace domain's users, with the read-only scope admin.directory.user.readonly of a service account that acts for a named administrator.

governance.ENTRA_POLICIESconstno test imports it
const ENTRA_POLICIES: readonly PosturePolicy[]

The posture policies of an Entra tenant.

governance.INTUNE_POLICIESconstno test imports it
const INTUNE_POLICIES: readonly PosturePolicy[]

The posture policies of Intune's managed devices.

governance.GOOGLE_POLICIESconstno test imports it
const GOOGLE_POLICIES: readonly PosturePolicy[]

The posture policies of a Google Workspace domain.

GovernanceErrortypeno test imports it
type GovernanceError = { readonly kind: "id"; readonly what: string };

Why a governance cannot be made.

GRAPH_HOSTconstno test imports it
const GRAPH_HOST: "graph.microsoft.com"

The host of Microsoft Graph and the host the application's token is asked from.

LOGIN_HOSTconstno test imports it
const LOGIN_HOST: "login.microsoftonline.com"

The host of the token service of Microsoft's identity platform.

GOOGLE_HOSTconstno test imports it
const GOOGLE_HOST: "admin.googleapis.com"

The host of Google's Admin SDK.

entraGovernancefunction
function entraGovernance(tenant: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of a Microsoft Entra tenant: it reads the authentication-method registrations, the conditional access policies and the organization's name, with the read-only application permissions Reports.Read.All, Policy.Read.All and Organization.Read.All.

Imported by 6 tests of the run (6 passed, 0 failed): the library's results

intuneGovernancefunction
function intuneGovernance(tenant: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of Microsoft Intune's managed devices, with the read-only application permission DeviceManagementManagedDevices.Read.All.

Imported by 6 tests of the run (6 passed, 0 failed): the library's results

googleWorkspaceGovernancefunction
function googleWorkspaceGovernance(domain: string): Result<ConnectorGovernance, GovernanceError>

The governance of the connector of a Google Workspace domain's users, with the read-only scope admin.directory.user.readonly of a service account that acts for a named administrator.

Imported by 6 tests of the run (6 passed, 0 failed): the library's results

ENTRA_POLICIESconstno test imports it
const ENTRA_POLICIES: readonly PosturePolicy[]

The posture policies of an Entra tenant.

INTUNE_POLICIESconstno test imports it
const INTUNE_POLICIES: readonly PosturePolicy[]

The posture policies of Intune's managed devices.

GOOGLE_POLICIESconstno test imports it
const GOOGLE_POLICIES: readonly PosturePolicy[]

The posture policies of a Google Workspace domain.

Titles, headings, exports, tables, columns and requirements. Esc closes.