Gap detection rules
TAS Integrator evaluates CI/CD environments against 25 integration requirements across six categories. Each rule has a severity level and detection method. These rules help you understand gap assessment results and prioritize remediation.
Rule categories Copy linkLink copied!
| Category | Description |
|---|---|
|
Infrastructure |
Red Hat Trusted Artifact Signer deployment and endpoint availability. |
|
OIDC |
Identity provider configuration for keyless signing. |
|
Signing |
Container image signing setup in CI/CD pipelines. |
|
Verification |
Signature verification setup in CI/CD pipelines. |
|
Policy |
Admission control and governance on Kubernetes or OpenShift. |
|
Supply Chain |
SBOM generation, attestation, and provenance tracking. |
Severity levels Copy linkLink copied!
| Severity | Meaning |
|---|---|
|
Critical |
Blocks Red Hat Trusted Artifact Signer integration. Must be resolved before signing can work. |
|
High |
Significantly impacts security or functionality. Should be resolved before production use. |
|
Medium |
Recommended for production readiness. Can be deferred to later iterations. |
|
Low |
Best practice that improves supply chain security posture. Optional but recommended. |
Infrastructure rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
INFRA-001 |
Critical |
A Red Hat Trusted Artifact Signer instance must be deployed and accessible. |
Deploy Red Hat Trusted Artifact Signer using the OpenShift operator or Ansible collection. See Red Hat Trusted Artifact Signer Deployment Guide. |
|
INFRA-002 |
Critical |
The Fulcio server must be reachable for certificate issuance. |
Verify the Fulcio pod is running. Check route or ingress configuration. Verify network policies allow traffic. |
|
INFRA-003 |
Critical |
The Rekor transparency log must be reachable for log entries. |
Verify the Rekor pod is running. Check route or ingress configuration. |
|
INFRA-004 |
High |
TUF root metadata must be available for cosign initialization. |
Verify the TUF pod is running. Ensure the TUF root has been initialized. |
|
INFRA-005 |
Medium |
The Timestamp Authority should be reachable for RFC 3161 timestamps. |
Verify the TSA pod is running. TSA is optional but recommended for production use. |
|
INFRA-006 |
Critical |
The |
Install |
OIDC rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
OIDC-001 |
Critical |
An OIDC issuer must be configured in Fulcio for identity-based signing. |
Configure the OIDC issuer in the Fulcio configuration and pass it via the |
|
OIDC-002 |
Critical |
An OIDC client ID must match the Fulcio-registered client. |
Set |
|
OIDC-003 |
Critical |
An OIDC identity token must be obtainable in the CI/CD environment. |
Enable OIDC token generation for your CI platform, or configure Keycloak service account credentials. |
|
OIDC-004 |
High |
The OIDC provider’s discovery endpoint must be reachable from the CI runner. |
Check network connectivity, DNS resolution, and TLS trust for the OIDC provider. |
|
OIDC-005 |
Medium |
The OIDC provider type and configuration must be detected to determine token acquisition patterns. For Keycloak providers, client type (public vs confidential) affects the grant type used. |
If client type is unknown, confirm the supported grant type or consult provider metadata. For non-Keycloak providers in Jenkins, consider adding Keycloak/RHBK as a secondary issuer for CI/CD automation. |
Signing rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
SIGN-001 |
Critical |
The CI/CD pipeline must include a container image signing step. |
Add a signing step to the pipeline using the |
|
SIGN-002 |
Critical |
The |
Add |
|
SIGN-003 |
Critical |
The |
Add |
|
SIGN-004 |
High |
Cosign must be initialized with the Red Hat Trusted Artifact Signer TUF root before signing. |
Set the pinned |
|
SIGN-005 |
Medium |
The |
Add |
Verification rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
VERIFY-001 |
High |
The pipeline should include a signature verification step. |
Add a verification step using |
|
VERIFY-002 |
High |
The |
Add |
|
VERIFY-003 |
High |
The |
Add |
|
VERIFY-004 |
Medium |
Verification must use the Red Hat Trusted Artifact Signer trust configuration for private TAS rather than relying on public Sigstore defaults. |
Initialize Cosign with the Red Hat Trusted Artifact Signer TUF mirror and verified root, or pass the Red Hat Trusted Artifact Signer |
Policy rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
POLICY-001 |
Medium |
A policy controller should enforce signature verification on Kubernetes deployments. |
Install the Sigstore policy-controller and create ClusterImagePolicy resources. |
|
POLICY-002 |
Medium |
A ClusterImagePolicy should define which images require signatures and the trusted identities. |
Create a ClusterImagePolicy matching your image registry and signing identity. |
Supply chain rules Copy linkLink copied!
| Rule ID | Severity | Description | Remediation |
|---|---|---|---|
|
SUPPLY-001 |
Low |
The pipeline should generate a Software Bill of Materials (SBOM). |
Add SBOM generation using Syft, Trivy, or a similar tool. |
|
SUPPLY-002 |
Low |
The SBOM should be attached to the container image as an attestation via cosign. |
Add |
|
SUPPLY-003 |
Low |
Build provenance (SLSA) should be attached as an attestation. |
Add SLSA provenance generation and attach via |
Confidence scoring Copy linkLink copied!
Based on gap evaluation results, the scanner computes three confidence scores:
- Detection confidence (40% weight)
- Passed infrastructure and OIDC rules divided by total infrastructure and OIDC rules. This score indicates whether the scanner can detect Red Hat Trusted Artifact Signer endpoints and OIDC configuration.
- Compatibility confidence (30% weight)
- Passed signing and verification rules divided by total signing and verification rules. This score indicates whether your pipelines have the necessary
cosigncommands and configurations. - Overall confidence (30% weight)
- All passed rules (including policy and supply chain) divided by total rules. This score indicates overall readiness for Red Hat Trusted Artifact Signer integration.
Confidence scores are labeled as High (80-100%), Medium (50-79%), or Low (0-49%).