1.9. Quarkus CLI コマンドと開発用認証局

• 自己署名証明書: この証明書は、それを使用する同じエンティティーによって署名されたものです。デフォルトでは信頼されません。このタイプの証明書は、通常、認証局 (CA) が利用できない場合や、簡単なセットアップが必要な場合に使用されます。実稼働環境には適しておらず、開発目的でのみ使用する必要があります。
• CA 署名証明書: この証明書は、信頼できるエンティティーである証明書 CA によって署名されたものです。この証明書はデフォルトで信頼されており、実稼働環境での標準的な選択肢です。

前提条件

• 開発用 CA の生成

  1. Quarkus 開発用 CA をインストールしたら、信頼済み証明書を生成します。この証明書は Quarkus 開発用 CA によって署名され、システムによって信頼されます。

     quarkus tls generate-certificate --name my-cert

     このコマンドは、Quarkus 開発用 CA によって署名された証明書を生成します。開発用 CA は、適切にインストールまたはインポートされた場合にシステムによって信頼されます。

     証明書は ./.certs/ に保存されます。次の 2 つのファイルが生成されます。

• $NAME-keystore.p12: 秘密鍵と証明書が含まれています。パスワードで保護されています。

• $NAME-truststore.p12: テスト用などにトラストストアとして使用できる CA 証明書が含まれています。

  以下に示すその他のオプションも利用できます。

  Usage: tls generate-certificate [-hrV] [-c=<cn>] [-d=<directory>]
         -n=<name> [-p=<password>]
  Generate a TLS certificate with the Quarkus Dev CA if available.
    -c, --cn=<cn>       The common name of the certificate. Default is 'localhost'
    -d, --directory=<directory>
                        The directory in which the certificates will be created.
                          Default is `.certs`
    -n, --name=<name>   Name of the certificate. It will be used as file name and
                          alias in the keystore
    -p, --password=<password>
                        The password of the keystore. Default is 'password'
    -r, --renew         Whether existing certificates will need to be replaced

  証明書を生成するときに .env ファイルも生成されます。これにより、Quarkus 開発モードがこれらの証明書を認識するようになります。

  1. アプリケーションを開発モードで実行して、これらの証明書を使用します。

     ./mvnw quarkus:dev
     ...
     INFO  [io.quarkus] (Quarkus Main Thread) demo 1.0.0-SNAPSHOT on JVM (powered by Quarkus 999-SNAPSHOT) started in 1.286s. Listening on: http://localhost:8080 and https://localhost:8443

  2. HTTPS (https://localhost:8443/q/dev) を使用するか、curl リクエストを発行して Dev UI を開きます。

     curl https://localhost:8443/hello
     Hello from Quarkus REST%

     重要

     Quarkus 開発用 CA がインストールされていない場合、Quarkus は自己署名証明書を生成します。