PenaDevops/mkcert
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Split off advanced options docs

Browse Source
This commit is contained in:
Filippo Valsorda 2019-02-02 14:55:55 -05:00
parent 50b8c9f09f
commit 821679b01f
2 changed files with 51 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -119,6 +119,17 @@ mkcert supports the following root stores:
## Advanced topics ## Advanced topics
### Advanced options
```
-cert-file FILE, -key-file FILE, -p12-file FILE
Customize the output paths.
-pkcs12
Generate a ".p12" PKCS #12 file, also know as a ".pfx" file,
containing certificate and key for legacy applications.
```
### Mobile devices ### Mobile devices
For the certificates to be trusted on mobile devices, you will have to install the root CA. It's the `rootCA.pem` file in the folder printed by `mkcert -CAROOT`. For the certificates to be trusted on mobile devices, you will have to install the root CA. It's the `rootCA.pem` file in the folder printed by `mkcert -CAROOT`.

58
main.go
View File

@ -20,7 +20,7 @@ import (
"golang.org/x/net/idna" "golang.org/x/net/idna"
) )
const usage = `Usage of mkcert: const shortUsage = `Usage of mkcert:
$ mkcert -install $ mkcert -install
Install the local CA in the system trust store. Install the local CA in the system trust store.
@ -31,32 +31,54 @@ const usage = `Usage of mkcert:
$ mkcert example.com myapp.dev localhost 127.0.0.1 ::1 $ mkcert example.com myapp.dev localhost 127.0.0.1 ::1
Generate "example.com+4.pem" and "example.com+4-key.pem". Generate "example.com+4.pem" and "example.com+4-key.pem".
$ mkcert "*.example.com" $ mkcert "*.example.it"
Generate "_wildcard.example.com.pem" and "_wildcard.example.com-key.pem". Generate "_wildcard.example.it.pem" and "_wildcard.example.it-key.pem".
$ mkcert -pkcs12 example.com
Generate "example.com.p12" instead of a PEM file.
$ mkcert -uninstall $ mkcert -uninstall
Uninstall the local CA (but do not delete it). Uninstall the local CA (but do not delete it).
Use -cert-file, -key-file and -p12-file to customize the output paths. `
const advancedUsage = `Advanced options:
-cert-file FILE, -key-file FILE, -p12-file FILE
Customize the output paths.
-pkcs12
Generate a ".p12" PKCS #12 file, also know as a ".pfx" file,
containing certificate and key for legacy applications.
-CAROOT
Print the CA certificate and key storage location.
$CAROOT (environment variable)
Set the CA certificate and key storage location. (This allows
maintaining multiple local CAs in parallel.)
Change the CA certificate and key storage location by setting $CAROOT,
print it with "mkcert -CAROOT".
` `
func main() { func main() {
log.SetFlags(0) log.SetFlags(0)
var installFlag = flag.Bool("install", false, "install the local root CA in the system trust store") var (
var uninstallFlag = flag.Bool("uninstall", false, "uninstall the local root CA from the system trust store") installFlag = flag.Bool("install", false, "")
var pkcs12Flag = flag.Bool("pkcs12", false, "generate PKCS#12 instead of PEM") uninstallFlag = flag.Bool("uninstall", false, "")
var carootFlag = flag.Bool("CAROOT", false, "print the CAROOT path") pkcs12Flag = flag.Bool("pkcs12", false, "")
var certFileFlag = flag.String("cert-file", "", "output certificate file path") helpFlag = flag.Bool("help", false, "")
var keyFileFlag = flag.String("key-file", "", "output key file path") carootFlag = flag.Bool("CAROOT", false, "")
var p12FileFlag = flag.String("p12-file", "", "output PKCS#12 file path") certFileFlag = flag.String("cert-file", "", "")
flag.Usage = func() { fmt.Fprintf(flag.CommandLine.Output(), usage) } keyFileFlag = flag.String("key-file", "", "")
p12FileFlag = flag.String("p12-file", "", "")
)
flag.Usage = func() {
fmt.Fprintf(flag.CommandLine.Output(), shortUsage)
fmt.Fprintln(flag.CommandLine.Output(), `For more options, run "mkcert -help".`)
}
flag.Parse() flag.Parse()
if *helpFlag {
fmt.Fprintf(flag.CommandLine.Output(), shortUsage)
fmt.Fprintf(flag.CommandLine.Output(), advancedUsage)
return
}
if *carootFlag { if *carootFlag {
if *installFlag || *uninstallFlag { if *installFlag || *uninstallFlag {
log.Fatalln("ERROR: you can't set -[un]install and -CAROOT at the same time") log.Fatalln("ERROR: you can't set -[un]install and -CAROOT at the same time")
@ -127,7 +149,7 @@ func (m *mkcert) Run(args []string) {
} }
if len(args) == 0 { if len(args) == 0 {
log.Printf("\n%s", usage) flag.Usage()
return return
} }