CERTMONGER(1)

πŸ’… CERTMONGER(1) β€” the local-getcert page, bestie edition

okay so this is the manual for local-getcert, living in the General Commands Manual section. yes it's filed under CERTMONGER(1) but the actual name of the thing is local-getcert. close enough, we move ✨


🌸 NAME 🌸

local-getcert β€” that's the one, that's the girl πŸ’–


✨ SYNOPSIS ✨

here's how you summon her, fr fr:

local-getcert request [options]
local-getcert resubmit [options]
local-getcert start-tracking [options]
local-getcert status [options]
local-getcert stop-tracking [options]
local-getcert list [options]
local-getcert list-cas [options]
local-getcert refresh-cas [options]

πŸ¦‹ DESCRIPTION πŸ¦‹

so. the local-getcert tool slides into the DMs of a org.fedorahosted.certmonger service, and it does it on behalf of the invoking user. that's the whole vibe: you ask, the service does. πŸ’…

what can you ask it for? glad you asked, bestie:

  • you can ask the service to begin enrollment, and optionally generate a key pair to use while it's at it
  • you can ask the service to begin monitoring a certificate at a location you specify, watching for expiration β€” and optionally refresh it when expiration gets close, like a girl who checks her calendar πŸ‘‘
  • you can ask it to list the set of certificates the service is already monitoring
  • or you can ask it to list the set of CAs the service is capable of using

and if you give it no command at all as the first command-line argument? she'll just print short usage information for each of its functions. helpful queen. 🫢

ngl, the important bit: local-getcert behaves identically to the generic getcert tool when it is used with the -c local option. same girl, different name tag.

also!! certmonger supports retrieving the list of current and previously-used local CA certificates. if you wanna know how to use the -F and -a options to say where those certificates should be stored, go read getcert-request(1) and getcert-resubmit(1). iykyk πŸ“š


πŸ’€ BUGS πŸ’€

found a bug? not me ignoring it πŸ™ˆ please file tickets for any that you find at:

https://fedorahosted.org/certmonger/


🌈 SEE ALSO 🌈

the whole friend group, in order, no cap:


and that's the page!! πŸŽ€ this whole thing comes from the certmonger Manual, dated June 7, 2014. iconic date, iconic docs, slay. periodt πŸ’…βœ¨