> ## Documentation Index
> Fetch the complete documentation index at: https://docs.endorlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.endorlabs.com/feedback

```json
{
  "path": "/developers-api/cli/commands/sign-artifacts/index",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# artifact sign

> Use the `artifact sign` command to sign container images and build artifacts in the CI pipeline.

export const YamlTable = ({children, data: propData, content}) => {
  const KV_RE = /^([A-Za-z][A-Za-z0-9_()/#\s-]+?):\s*(.+)$/;
  const INLINE_MD_RE = /(\[([^\]]+)\]\(([^)]+)\))|(`([^`]+)`)|(\*\*([^*]+)\*\*)|(\*([^*]+)\*)/g;
  const YES_RE = /^-yes-$/i;
  const NO_RE = /^-no-$/i;
  const LIMITED_RE = /^-(limited|partial)-$/i;
  const NA_RE = /^-(na|none)-$/i;
  const NA2_RE = /^-na2-$/i;
  const SIMPLE_TAG_RE = /(<br\s*\/?>)|(<p\s*\/?>)|(-note-)|(-warning-)/gi;
  const tryParseKV = trimmed => {
    const m = KV_RE.exec(trimmed);
    return m ? {
      key: m[1],
      value: m[2].trim()
    } : null;
  };
  const registerKey = (key, seenKeys, orderedKeys) => {
    if (!seenKeys.has(key)) {
      orderedKeys.push(key);
      seenKeys.add(key);
    }
  };
  const flushEntry = (currentEntry, entries) => {
    if (Object.keys(currentEntry).length > 0) entries.push(currentEntry);
  };
  const parseDashPrefixed = (lines, entries, orderedKeys, seenKeys) => {
    let currentEntry = {};
    let inEntry = false;
    for (const line of lines) {
      const trimmed = line.trim();
      if (trimmed.startsWith('- ')) {
        if (inEntry) entries.push(currentEntry);
        currentEntry = {};
        inEntry = true;
        const kv = tryParseKV(trimmed.substring(2).trim());
        if (kv) {
          registerKey(kv.key, seenKeys, orderedKeys);
          currentEntry[kv.key] = kv.value;
        }
      } else if (inEntry && trimmed !== '') {
        const kv = tryParseKV(trimmed);
        if (kv) {
          registerKey(kv.key, seenKeys, orderedKeys);
          currentEntry[kv.key] = kv.value;
        }
      }
    }
    flushEntry(currentEntry, entries);
  };
  const parseBlankSeparated = (lines, entries, orderedKeys, seenKeys) => {
    let currentEntry = {};
    let inEntry = false;
    for (const line of lines) {
      const trimmed = line.trim();
      if (trimmed === '') {
        if (inEntry) {
          flushEntry(currentEntry, entries);
          currentEntry = {};
          inEntry = false;
        }
        continue;
      }
      const kv = tryParseKV(trimmed);
      if (!kv) continue;
      const isNewEntry = !line.startsWith(' ') && !line.startsWith('\t');
      if (isNewEntry && inEntry && Object.keys(currentEntry).length > 0) {
        entries.push(currentEntry);
        currentEntry = {};
      }
      registerKey(kv.key, seenKeys, orderedKeys);
      currentEntry[kv.key] = kv.value;
      inEntry = true;
    }
    flushEntry(currentEntry, entries);
  };
  const normalizeEntries = (entries, orderedKeys) => entries.map(entry => {
    const filled = {};
    for (const key of orderedKeys) filled[key] = entry[key] || '';
    return filled;
  });
  const parseYamlTableContent = contentStr => {
    if (!contentStr) return [];
    const entries = [];
    const orderedKeys = [];
    const seenKeys = new Set();
    const lines = contentStr.split('\n');
    if (lines.some(line => line.trim().startsWith('- '))) {
      parseDashPrefixed(lines, entries, orderedKeys, seenKeys);
    } else {
      parseBlankSeparated(lines, entries, orderedKeys, seenKeys);
    }
    return normalizeEntries(entries, orderedKeys);
  };
  const processText = text => {
    if (!text) return text;
    const parts = [];
    let keyIndex = 0;
    let lastIndex = 0;
    let match;
    while ((match = INLINE_MD_RE.exec(text)) !== null) {
      if (match.index > lastIndex) parts.push(text.slice(lastIndex, match.index));
      if (match[1]) {
        parts.push(<a key={keyIndex++} href={match[3]}>{match[2]}</a>);
      } else if (match[4]) {
        parts.push(<code key={keyIndex++}>{match[5]}</code>);
      } else if (match[6]) {
        parts.push(<strong key={keyIndex++}>{match[7]}</strong>);
      } else if (match[8]) {
        parts.push(<em key={keyIndex++}>{match[9]}</em>);
      }
      lastIndex = match.index + match[0].length;
    }
    if (lastIndex < text.length) parts.push(text.slice(lastIndex));
    if (parts.length === 0) return text;
    const keyRef = {
      current: keyIndex
    };
    return expandHtmlTags(parts, keyRef);
  };
  const processBadges = text => {
    if (!text || typeof text !== 'string') return text;
    if (YES_RE.test(text)) return <span className="yt-badge-yes" role="img" aria-label="Supported" title="Supported">✓</span>;
    if (NO_RE.test(text)) return <span className="yt-badge-no" role="img" aria-label="Not supported" title="Not supported">✗</span>;
    if (LIMITED_RE.test(text)) return <span className="yt-badge-limited" role="img" aria-label="Partially supported" title="Partially supported">◐</span>;
    if (NA_RE.test(text) || NA2_RE.test(text)) return <span className="yt-sr-only" title="Not applicable">Not applicable</span>;
    return processText(text);
  };
  const cellClassName = text => {
    if (!text || typeof text !== 'string') return undefined;
    if (NA_RE.test(text)) return 'yt-cell-na';
    if (NA2_RE.test(text)) return 'yt-cell-na2';
    return undefined;
  };
  const expandSimpleTags = (str, keyRef) => {
    const result = [];
    let last = 0;
    SIMPLE_TAG_RE.lastIndex = 0;
    let m;
    while ((m = SIMPLE_TAG_RE.exec(str)) !== null) {
      if (m.index > last) result.push(str.slice(last, m.index));
      if (m[1]) {
        result.push(<br key={keyRef.current++} />);
      } else if (m[2]) {
        result.push(<br key={keyRef.current++} />, <br key={keyRef.current++} />);
      } else if (m[3]) {
        result.push(<span key={keyRef.current++} className="yt-badge-note" style={{
          fontWeight: 600
        }}>Note: </span>);
      } else if (m[4]) {
        result.push(<span key={keyRef.current++} className="yt-badge-warning" style={{
          fontWeight: 600
        }}>Warning: </span>);
      }
      last = m.index + m[0].length;
    }
    if (last < str.length) result.push(str.slice(last));
    return result;
  };
  const expandHtmlTags = (chunks, keyRef) => {
    const out = [];
    for (const chunk of chunks) {
      if (typeof chunk === 'string') {
        out.push(...expandSimpleTags(chunk, keyRef));
      } else {
        out.push(chunk);
      }
    }
    return out;
  };
  const extractText = node => {
    if (node === null || node === undefined) return '';
    if (typeof node === 'string') return node;
    if (typeof node === 'number') return String(node);
    if (typeof node === 'boolean') return '';
    if (Array.isArray(node)) return node.map(extractText).join('');
    if (node && typeof node === 'object' && node.type) {
      const props = node.props || ({});
      if (typeof props.children === 'string') return props.children;
      if (props.children) return extractText(props.children);
      return '';
    }
    return String(node || '');
  };
  const [mounted, setMounted] = useState(false);
  useEffect(() => {
    setMounted(true);
  }, []);
  const data = useMemo(() => {
    if (propData) return propData;
    if (content && typeof content === 'string') return parseYamlTableContent(content);
    if (!children) return [];
    if (typeof children === 'string') return parseYamlTableContent(children);
    const childrenArray = Array.isArray(children) ? children : [children];
    return parseYamlTableContent(childrenArray.map(extractText).join('').trim());
  }, [children, propData, content]);
  const columns = useMemo(() => {
    if (!data || data.length === 0) return [];
    const firstRow = data[0];
    if (!firstRow || typeof firstRow !== 'object') return [];
    return Object.keys(firstRow);
  }, [data]);
  if (!mounted) return null;
  if (!data || data.length === 0) return null;
  const rowKey = row => columns.map(c => row[c] || '').join('|');
  return <table>
      <thead>
        <tr>
          {columns.map(col => <th key={col}>{col.replaceAll('_', ' ')}</th>)}
        </tr>
      </thead>
      <tbody>
        {data.map(row => <tr key={rowKey(row)}>
            {columns.map(col => <td key={col} className={cellClassName(row[col])}>{processBadges(row[col])}</td>)}
          </tr>)}
      </tbody>
    </table>;
};

Use the `artifact [ sign \| verify  ]` command to sign and verify container images and other build artifacts.

## Usage

To sign an artifact, use the following command.

```bash theme={null}
endorctl artifact sign --name <artifact> --source-repository-ref <ref> --certificate-oidc-issuer <issuer>
```

To verify a signed artifact, use the following command.

```bash theme={null}
endorctl verify --name <artifact> --certificate-oidc-issuer <issuer>`
```

To revoke a signature, use the following command.

```bash theme={null}
endorctl artifact revoke-signature --name <artifact> --source-repository-ref <ref>
```

## Options

You can use the following flags and environment variables:

For `endorctl artifact sign`

<YamlTable>
  {`


    - Flag: \`name\`
    Environment_Variable: \`ENDOR_ARTIFACT_NAME\`
    Type: string
    Description: Name of the artifact. For example, \`ghcr.io/org/image@sha256:digest\`.

    - Flag: \`build-config-digest\`
    Environment_Variable: \`ENDOR_ARTIFACT_BUILD_CONFIG_DIGEST\`
    Type: string
    Description: Specific version of the top-level build instructions. For example, \`workflow sha\`.

    - Flag: \`build-config-name\`
    Environment_Variable: \`ENDOR_ARTIFACT_BUILD_CONFIG_NAME\`
    Type: string
    Description: Name of the top-level build instructions. For example, \`workflow\`.

    - Flag: \`certificate-oidc-issuer\`
    Environment_Variable: \`ENDOR_ARTIFACT_CERTIFICATE_OIDC_ISSUER\`
    Type: string
    Description: OIDC issuer name from a valid certificate.

    - Flag: \`certificate-identity\`
    Environment_Variable: \`ENDOR_ARTIFACT_CERTIFICATE_IDENTITY\`
    Type: string
    Description: Identity name from a valid certificate.

    - Flag: \`runner-environment\`
    Environment_Variable: \`ENDOR_ARTIFACT_RUNNER_ENVIRONMENT\`
    Type: string
    Description: Name of the hosting platform or self-hosted infrastructure. For example, \`self-hosted\`.

    - Flag: \`source-repository\`
    Environment_Variable: \`ENDOR_ARTIFACT_SOURCE_REPOSITORY\`
    Type: string
    Description: Source repository for the build. For example, \`org/repo\`.

    - Flag: \`source-repository-digest\`
    Environment_Variable: \`ENDOR_ARTIFACT_SOURCE_REPOSITORY_DIGEST\`
    Type: string
    Description: Specific version of the source code for the build. For example, \`commit sha\`.

    - Flag: \`source-repository-owner\`
    Environment_Variable: \`ENDOR_ARTIFACT_SOURCE_REPOSITORY_OWNER\`
    Type: string
    Description: Owner of the source repository for the build. For example, \`my-org\`.

    - Flag: \`source-repository-ref\` (mandatory)
    Environment_Variable: \`ENDOR_ARTIFACT_SOURCE_REPOSITORY_REF\`
    Type: string
    Description: Source repository ref for the build run.


    `}
</YamlTable>

For `endorctl artifact verify`

<YamlTable>
  {`


    - Flag: \`name <name>\`
    Environment_Variable: \`ENDOR_ARTIFACT_NAME\`
    Type: string
    Description: The name of the artifact to verify.

    - Flag: \`certificate-oidc-issuer <issuer>\`
    Environment_Variable: \`ENDOR_ARTIFACT_CERTIFICATE_OIDC_ISSUER\`
    Type: string
    Description: OIDC certificate issuer used to verify the artifact.


    `}
</YamlTable>

For `endorctl artifact [revoke-signature]`

<YamlTable>
  {`


    - Flag: \`name\`
    Environment_Variable: \`ENDOR_ARTIFACT_NAME\`
    Type: string
    Description: The name of the artifact whose signature you want to revoke.

    - Flag: \`source-repository-ref\` (mandatory)
    Environment_Variable: \`ENDOR_ARTIFACT_SOURCE_REPOSITORY_REF\`
    Type: string
    Description: Reference to the source repository of the artifact.


    `}
</YamlTable>