デジタル署名の作成と検証

このトピックでは、非対称鍵に基づくデジタル署名の作成と検証について説明します。

デジタル署名は、非対称鍵の秘密鍵部分を使用して作成します。署名の検証は、同じ非対称鍵の公開鍵部分を使用して行います。

始める前に

• デジタル署名を作成するときは、ASYMMETRIC_SIGN を鍵の目的とする鍵を使用する必要があります。鍵の作成には、ASYMMETRIC_SIGN を使用します。

• 署名を検証するには、鍵の作成時に使用された完全なアルゴリズムを知る必要があります。openssl コマンドを使用する以下のコマンドラインの手順については、これらのコマンドにこの情報を渡す必要があります。

• 署名を行うユーザーまたはサービスに、非対称鍵に対する cloudkms.cryptoKeyVersions.useToSign 権限を付与します。Cloud Key Management Service の権限については、権限とロールをご覧ください。

• 署名を検証する場合は、検証に使用する公開鍵をダウンロードするユーザーまたはサービスに、非対称鍵に対する cloudkms.cryptoKeyVersions.viewPublicKey 権限を付与します。

• コマンドラインを使用する場合、OpenSSL をまだインストールしていなければ、ここでインストールしてください。Cloud Shell を使用する場合、OpenSSL はすでにインストールされています。

データとダイジェスト

AsymmetricSign リクエストに指定された入力は、data フィールドや digest フィールドを介して渡すことができます。これらのフィールドは、同時に指定できません。未加工アルゴリズムや Cloud External Key Manager 鍵を使用した署名など、データ フィールドを必要とするアルゴリズムもあります。

未加工アルゴリズム

「未加工」アルゴリズム（RSA_SIGN_RAW_ 接頭辞で識別）は、DigestInfo へのエンコードを省略した PKCS #1 署名のバリアントです。バリアントでは、次のことが行われます。

• ダイジェストは、署名されるメッセージに対して計算されます。
• ダイジェストには、直接 PKCS #1 パディングが適用されます。
• パディングされたダイジェストの署名は、RSA 秘密鍵を使用して計算されます。

こうしたアルゴリズムを使用するには、次のようにします。

• 未加工データは、（ダイジェストの代わりに）data フィールドの一部として提供する必要があります。
• データの長さの上限は、RSA 鍵のサイズよりも 11 バイト少なくします。たとえば、2,048 ビットの RSA 鍵がある PKCS #1 では、最大 245 バイトに署名できます。
• cloudkms.expertRawPKCS1 ロールを適切なユーザーまたはサービスに付与します。Cloud Key Management Service の権限については、権限とロールをご覧ください。

未加工のアルゴリズムを使用すると、事前定義されたアルゴリズムが使用できないダイジェスト タイプに署名することもできます。たとえば、RSA_SIGN_RAW_2048 鍵を使用して、外部で計算済みの SHA-512 PKCS #1 DigestInfo 構造に署名できます。このプロセスでは、標準の RSA_SIGN_PKCS1_2048_SHA512 アルゴリズムと同じ結果が生成されます。

他のハッシュ アルゴリズムの ECDSA サポート

ECDSA 署名アルゴリズムの一般的な形式は次のとおりです。

EC_SIGN_ELLIPTIC_CURVE_[DIGEST_ALGORITHM]

DIGEST_ALGORITHM の値は SHA256、SHA384、または SHA512 です。ハッシュは署名を作成する前に行われるため、これらの署名アルゴリズムは、Keccak などの SHA 以外のダイジェストでも使用できます。Keccak ダイジェストを使用するには、Keccak ハッシュ値を指定し、同じ長さの SHA ダイジェスト アルゴリズムを使用します。たとえば、EC_SIGN_P256_SHA256 アルゴリズムを使用するリクエストで KECCAK256 ダイジェストを使用できます。

署名の作成

gcloud kms asymmetric-sign \
    --version key-version \
    --key key \
    --keyring key-ring \
    --location location \
    --digest-algorithm digest-algorithm \
    --input-file input-file \
    --signature-file signature-file