Back to Docs

GitHub App Integration

Collect repository metadata signals from your GitHub repositories.Repository signals only. No code analysis or runtime testing.

Quick Start

  1. 1
    Install the GitHub App

    Visit the GitHub Marketplace and install HAIEC Control Signals on your repositories.

  2. 2
    Select Repositories

    Choose which repositories HAIEC should monitor for control signals.

  3. 3
    Open a Pull Request

    HAIEC automatically posts attestation readiness comments on new PRs.

Evidence Signals Collected

HAIEC collects 10 deterministic metadata signals from your repository. These are repository configuration signals, not security or compliance assessments:

Branch Protection

Verifies main branch has protection rules enabled

Code Review Required

Checks if PRs require at least one approval

Dependabot Enabled

Confirms automated dependency updates are active

Security Policy

Looks for SECURITY.md file in repository

License File

Verifies LICENSE file exists

CI/CD Pipeline

Checks for GitHub Actions workflows

Code Scanning

Verifies CodeQL or similar scanning is enabled

Secret Scanning

Confirms secret scanning is active

Signed Commits

Checks for commit signature verification

README Documentation

Verifies README.md exists with content

Pull Request Comments

When you open a pull request, HAIEC posts a comment showing your attestation readiness:

HAIEC Attestation Readiness: -- → 70 (+70)
HAIEC collects repository metadata signals. For full security analysis, use the HAIEC web dashboard.
Missing Evidence:
  • - SOC2 CC6.1 - Branch protection not enabled
  • - SOC2 CC7.1 - Dependabot not enabled
[Resolve in HAIEC][View Trust Artifact]

Trust Artifacts & Badges

After completing a compliance assessment, you receive a verifiable trust artifact with an embeddable badge.

Embedding Badges

Add this to your README.md:

[![HAIEC SOC2](https://haiec.com/api/badge/SOC2-abc12345.svg)](https://haiec.com/artifact/SOC2-abc12345)
Preview:
HAIECSOC2EVIDENCE READY

Permissions Required

HAIEC requests minimal permissions to function:

PermissionAccessPurpose
ContentsReadRead SECURITY.md, LICENSE, README
Pull RequestsRead & WritePost attestation comments
MetadataReadRepository information

What HAIEC Does NOT Do

  • We do NOT read, store, or analyze your source code
  • We do NOT have write access to your code or branches
  • We do NOT calculate compliance scores or make compliance determinations
  • We do NOT share your data with third parties

Support

Related