Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

5.7 KB
Raw Blame
---
title: "Code signing"
sidebarTitle: "Overview"
description: "Sign software artifacts with managed code-signing certificates, central approval, and a full audit trail."
---

Code Signing is where teams digitally sign software, such as JARs, container images, Windows installers, Android APKs, Linux packages, and scripts. Teams sign through any tool that supports PKCS#11, with Windows `signtool`, or with the [Sign API](/api-reference/endpoints/code-signing/signers/sign), and Infisical records every signing operation in an audit trail.

<CardGroup cols={2}>
  <Card title="Signers" icon="pen-tool" href="/documentation/platform/pki/code-signing/signers">
    Create signing identities and choose who can sign with each one.
  </Card>
  <Card title="Approvals" icon="check-check" href="/documentation/platform/pki/code-signing/approvals">
    Require approval before someone can sign, with limits on how many signatures and for how long.
  </Card>
  <Card title="Signing tools" icon="wrench" href="/documentation/platform/pki/guides/code-signing/jarsigner">
    Sign with jarsigner, apksigner, osslsigncode, cosign, OpenSSL, or GPG.
  </Card>
  <Card title="PKCS#11 module" icon="cpu" href="/documentation/platform/pki/code-signing/pkcs11-module">
    Connect standard signing tools to your signers.
  </Card>
  <Card title="Windows KSP" icon="windows" iconType="brands" href="/documentation/platform/pki/code-signing/windows-ksp">
    Sign Windows executables, DLLs, and MSIs with signtool.
  </Card>
</CardGroup>

Each **Signer** represents a single signing identity, like `mobile-app-prod`, `firmware-release`, or `ci-staging-builds`. Product Admins create Signers, attach a code-signing certificate, and assign team members. Teams then operate independently within their assigned Signers.

## What's in a signer?

<CardGroup cols={2}>
  <Card title="Certificate" icon="award">
    The X.509 code-signing certificate the Signer uses, backed by an internal or external CA.
  </Card>
  <Card title="Members" icon="users">
    Team members with Administrator, Operator, or Auditor roles on this Signer.
  </Card>
  <Card title="Approval policy" icon="check-check">
    Optional review workflow before signatures are produced.
  </Card>
  <Card title="Activity" icon="history">
    Audit trail of every successful, failed, and denied signing operation.
  </Card>
</CardGroup>

## How a signing operation flows

```mermaid
sequenceDiagram
    participant Tool as Signing tool<br/>(jarsigner / cosign / ...)
    participant PKCS as PKCS#11 Module
    participant Infisical as Infisical
    participant CA as Certificate Authority

    Note over Infisical,CA: Once, when the Signer is created
    Infisical->>CA: Request code-signing cert
    CA-->>Infisical: Certificate

    Note over Tool,Infisical: Per signing operation
    Tool->>PKCS: Sign artifact
    PKCS->>Infisical: POST /signers/{id}/sign
    Infisical->>Infisical: Check access
    Infisical->>Infisical: Sign
    Infisical-->>PKCS: Signature
    PKCS-->>Tool: Signature attached to artifact
```

1. A Product Admin creates a [Signer](/documentation/platform/pki/code-signing/signers) and picks the CA that issues its certificate.
2. The Admin adds [members](/documentation/platform/pki/code-signing/signers#signer-roles) (users, machine identities, or groups) and picks a role for each.
3. Optionally, the Admin attaches an [approval policy](/documentation/platform/pki/code-signing/approvals) so signing requires sign-off.
4. Operators sign through the [PKCS#11 module](/documentation/platform/pki/code-signing/pkcs11-module), the [Windows KSP](/documentation/platform/pki/code-signing/windows-ksp) (`signtool`), or the [Sign API](/api-reference/endpoints/code-signing/signers/sign). Infisical produces the signature and records an audit entry on the Signer.

## Signer roles

Members are assigned to Signers with one of three roles:

| Role | Capabilities |
|------|--------------|
| **Administrator** | Full control: edit settings, manage members, edit the approval policy, pre-approve signing, sign, export the certificate. |
| **Operator** | Sign artifacts and submit signing requests. Can't change settings or members. |
| **Auditor** | Read-only: view members, activity, and the audit log. Can't sign. |

## FAQ

<AccordionGroup>
  <Accordion title="How is this different from handing out a .pfx or .p12 file?">
    When you distribute a key file, anyone with a copy can sign anything for the lifetime of the certificate, and you can't take that copy back. With a Signer, you can disable signing, revoke active access, or remove a member at any time, and that change takes effect immediately.
  </Accordion>
  <Accordion title="Do I have to require approval for every signature?">
    No. A Signer can have no approval policy, in which case any member with sign rights can sign immediately and you still get a full audit trail. Approvals are optional and most useful for production releases or compliance-sensitive workloads.
  </Accordion>
</AccordionGroup>

## What's next?

<CardGroup cols={2}>
  <Card title="Create a Signer" icon="pen-tool" href="/documentation/platform/pki/code-signing/signers#create-a-signer">
    The 4-step wizard.
  </Card>
  <Card title="Add an approval policy" icon="check-check" href="/documentation/platform/pki/code-signing/approvals#configure-the-approval-policy">
    Require sign-off and cap per-approval limits.
  </Card>
  <Card title="Install the PKCS#11 module" icon="plug" href="/documentation/platform/pki/code-signing/pkcs11-module#installation">
    Hook up your signing tools.
  </Card>
  <Card title="Sign your first JAR" icon="java" iconType="brands" href="/documentation/platform/pki/guides/code-signing/jarsigner">
    End-to-end walkthrough.
  </Card>
</CardGroup>