Skip to content

Fall back to local ca.json edit when --ca-url is unset - #1706

Open
vulragrag-star wants to merge 1 commit into
smallstep:masterfrom
vulragrag-star:fix/1705-provisioner-add-ca-config-offline
Open

vulragrag-star wants to merge 1 commit into
smallstep:masterfrom
vulragrag-star:fix/1705-provisioner-add-ca-config-offline

Conversation

@vulragrag-star

Copy link
Copy Markdown

Name of feature:

Pain or issue this feature alleviates:

step ca provisioner add|update|remove --ca-config ca.json (no --ca-url) fails with a required --ca-url / --root error even when the config file exists. That breaks the documented offline / bootstrap workflow (see EXAMPLES in add.go and the public docs).

Why is this important to the project (if not answered above):

Restores pre-v0.23.1 behavior for local ca.json edits when no CA URL is supplied, while keeping the existing remote admin-API probe when --ca-url is set.

Is there documentation on how to use this feature? If so, where?

Existing docs/examples already show --ca-config without --ca-url; this makes the CLI match them again.

In what environments or workflows is this feature supported?

Local offline edits of an existing ca.json via --ca-config without a reachable CA.

In what environments or workflows is this feature explicitly NOT supported (if any)?

When --ca-url is set, behavior is unchanged (remote probe first, then local fallback on network / not-implemented errors).

Supporting links/other PRs/issues:

Fixes #1705


Summary

When NewUnauthenticatedAdminClient fails because --ca-url/--root are missing, and --ca-config points at an existing file, fall back to the local caConfigClient path instead of returning the required-flag error.

Test plan

When `step ca provisioner add|update|remove` is given an existing
`--ca-config` file but no `--ca-url`, edit the config locally instead of
failing with a required `--ca-url`/`--root` error. Restores the documented
offline bootstrap workflow broken since v0.23.1.

Fixes smallstep#1705
@CLAassistant

CLAassistant commented Sep 16, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@github-actions github-actions Bot added the needs triage Waiting for discussion / prioritization by team label Sep 16, 2026
@vulragrag-star

Copy link
Copy Markdown
Author

I have read the Contributor License Agreement (CLA) and hereby sign the CLA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs triage Waiting for discussion / prioritization by team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: step ca provisioner add --ca-config requires --ca-url/--root even for purely local/offline edits

3 participants