🛡️ A private certificate authority (X.509 & SSH) & ACME server for secure automated certificate management, so you can use TLS everywhere & SSO for SSH.
Find a file
Mariano Cano 750e9ee2f8 Attempt to fix TestBootstrapClientServerRotation
This change attempts to fix the test TestBootstrapClientServerRotation.
Due to the backdate, the renew options get too large, causing
continuous renewals, and random errors. After experimenting with
different options, truncating durations to seconds have shown better
results than rounding or just use the plain time.
2022-03-28 14:55:40 -07:00
.github Change go version to 1.17 and 1.18 2022-03-28 14:55:39 -07:00
acme Fix PR comment and add tests for ACME prerequisites checker 2022-03-03 13:00:20 +01:00
api scep: minor cleanup (#867) 2022-03-28 14:55:40 -07:00
authority Pass in the resource name regardless of if its a VM or managed identity 2022-03-28 14:55:40 -07:00
autocert Use REAMDE.md suggested in code review. 2019-06-18 17:11:29 -07:00
ca Attempt to fix TestBootstrapClientServerRotation 2022-03-28 14:55:40 -07:00
cas Fix deprecation of grpc.WithInsecure option 2022-01-21 16:17:40 +01:00
cmd add --context flag to step-ca command (#851) 2022-03-28 14:55:40 -07:00
commands add --context flag to step-ca command (#851) 2022-03-28 14:55:40 -07:00
db Add test case for ACME Revoke to Authority 2021-12-02 17:11:36 +01:00
debian [action] debian rules syntax 2021-04-13 16:53:30 -07:00
docker Make the default provisioner name optional; change DNS names variable name 2021-08-18 13:37:58 -07:00
docs Merge branch 'master' into hs/acme-eab 2021-12-09 13:58:40 +01:00
errs Fix broken test due to linter fix 2022-02-03 12:43:53 -08:00
examples Added some example ansible configs (#813) 2022-02-02 18:54:55 +01:00
kms Fix typo. 2021-12-17 10:55:23 -08:00
logging Log successful /health requests at Trace lvl 2021-03-09 14:52:13 +00:00
make [action] sign and push sigs for multi-arch docker containers w/ cosign 2021-09-01 12:43:59 -07:00
monitoring ca-component -> certificates 2018-10-31 21:36:01 -07:00
pki Create the db directory on step ca init 2022-01-12 12:35:37 -08:00
scep scep: remove Interface and the dependency to pkg/errors (#872) 2022-03-28 14:55:40 -07:00
scripts install-step-ra.sh: Properly quote the RA DNS names in ca.json 2021-10-19 16:14:41 -07:00
server Use Golang's default keep-alive. 2021-10-15 14:12:43 -07:00
systemd Fixes #757 2021-11-23 18:12:31 -08:00
templates update commented template names to match reality 2021-11-17 21:42:53 -08:00
.dockerignore Remove dockerignore files that are in the repo. 2021-04-13 18:24:02 -07:00
.gitattributes Added version operability for git archive tarball (non git repo) 2019-02-21 14:51:03 -08:00
.gitignore git: ignore .envrc files 2022-03-14 13:18:44 +02:00
.golangci.yml Pin golangci-lint to v1.43.0 and fix issues 2021-11-13 01:30:03 +01:00
.goreleaser.yml Add armv5 build for (cloud|aws)kms 2022-03-28 14:55:39 -07:00
.VERSION Added version operability for git archive tarball (non git repo) 2019-02-21 14:51:03 -08:00
.version.sh Added version operability for git archive tarball (non git repo) 2019-02-21 14:51:03 -08:00
CHANGELOG.md Change golang to Go 2022-03-28 14:55:39 -07:00
cosign.pub [action] use cosign to sign over goreleaser artifacts 2021-08-30 16:53:47 -07:00
go.mod Send current provisioner on PostCertificate 2022-03-21 19:24:05 -07:00
go.sum Send current provisioner on PostCertificate 2022-03-21 19:24:05 -07:00
icon.png Commit icons. 2019-06-12 16:22:39 -07:00
icon.svg Commit icons. 2019-06-12 16:22:39 -07:00
LICENSE Add full version of the license. 2020-05-26 12:21:09 -07:00
Makefile Fix a few more linter warnings and remove GOFLAGS from make lint 2021-10-08 15:26:01 -04:00
README.md Star gif 2021-12-07 10:02:44 -08:00

Step Certificates

step-ca is an online certificate authority for secure, automated certificate management. It's the server counterpart to the step CLI tool.

You can use it to:

  • Issue X.509 certificates for your internal infrastructure:
    • HTTPS certificates that work in browsers (RFC5280 and CA/Browser Forum compliance)
    • TLS certificates for VMs, containers, APIs, mobile clients, database connections, printers, wifi networks, toaster ovens...
    • Client certificates to enable mutual TLS (mTLS) in your infra. mTLS is an optional feature in TLS where both client and server authenticate each other. Why add the complexity of a VPN when you can safely use mTLS over the public internet?
  • Issue SSH certificates:
    • For people, in exchange for single sign-on ID tokens
    • For hosts, in exchange for cloud instance identity documents
  • Easily automate certificate management:

Whatever your use case, step-ca is easy to use and hard to misuse, thanks to safe, sane defaults.


Don't want to run your own CA? To get up and running quickly, or as an alternative to running your own step-ca server, consider creating a free hosted smallstep Certificate Manager authority.


Questions? Find us in Discussions or Join our Discord.

Website | Documentation | Installation | Getting Started | Contributor's Guide

GitHub release Go Report Card Build Status License CLA assistant

GitHub stars Twitter followers

star us

Features

🦾 A fast, stable, flexible private CA

Setting up a public key infrastructure (PKI) is out of reach for many small teams. step-ca makes it easier.

⚙️ Many ways to automate

There are several ways to authorize a request with the CA and establish a chain of trust that suits your flow.

You can issue certificates in exchange for:

🏔 Your own private ACME server

ACME is the protocol used by Let's Encrypt to automate the issuance of HTTPS certificates. It's super easy to issue certificates to any ACMEv2 (RFC8555) client.

👩🏽‍💻 An online SSH Certificate Authority

  • Delegate SSH authentication to step-ca by using SSH certificates instead of public keys and authorized_keys files
  • For user certificates, connect SSH to your single sign-on provider, to improve security with short-lived certificates and MFA (or other security policies) via any OAuth OIDC provider.
  • For host certificates, improve security, eliminate TOFU warnings, and set up automated host certificate renewal.

🤓 A general purpose PKI tool, via step CLI integration

Installation

See our installation docs here.

Documentation

Documentation can be found in a handful of different places:

  1. On the web at https://smallstep.com/docs/step-ca.

  2. On the command line with step help ca xxx where xxx is the subcommand you are interested in. Ex: step help ca provisioner list.

  3. In your browser, by running step help --http=:8080 ca from the command line and visiting http://localhost:8080.

  4. The docs folder is being deprecated, but it still has some documentation and tutorials.

Feedback?