Docs · Getting started & concepts
Getting started
Service URLs
| Role | URL |
|---|---|
| API | https://api.liminalkeys.com |
| Console | https://console.liminalkeys.com (use ?signup=1 for a new workspace) |
Operator path
-
Open Console
Open
Console sign-up
(
console.liminalkeys.com/?signup=1) and sign in with Microsoft work or school, Google, Apple, or Sign in with email code when shown on Console. GitHub is not offered. New users create a free beta workspace themselves — no invite or operator ticket required. - Prepare an identity Import a PKCS#12 into custody or generate a CSR, complete it with the issued certificate, then create policy rules (subjects, optional confirmation) and Apply policy.
- Issue an enrollment code Create a short-lived enrollment code for the Mac that will sign. Treat it as a secret.
- Install Liminal Keys for Mac Contractors can download without Console sign-in from www.liminalkeys.com/download/mac/. Admins can also use Download Liminal Keys for Mac (or copy the contractor install link) on Console Overview.
-
Enroll the Mac
In Liminal Keys for Mac, set API URL to
https://api.liminalkeys.com, paste the code, enroll, and refresh identities. For build agents and CI, use the headless Host CLI instead — see CI & pipelines. -
Approve the Mac signing extension and sign
Allow the Liminal signing extension when macOS prompts. Sign with
codesignor Xcode as usual (on-Mac confirmation prompts are coming soon).
Headless enroll
Build Macs and long-lived self-hosted runners use the bundled Host CLI (after installing from download/mac). Always set the production API URL explicitly:
export LIMINAL_KEYS_API_BASE_URL=https://api.liminalkeys.com
export LIMINAL_KEYS_ENROLLMENT_CODE='…from Console Devices…'
liminal-keys enroll --json
liminal-keys refresh --json
Ephemeral GitHub Actions CI uses OIDC and
LiminalKeys/liminal-keys-ci-sample/sign@v1 — not enrollment codes. Start from the
public sample
Quickstart
or CI & pipelines.
Next (concepts):
Console ·
Security
App & code signing:
macOS agent ·
CI & pipelines
AI agent signing:
AI agents & MCP