KAC ハッシュ・署名
リリース予定：済
最新バージョン：1.0
最新バージョンリリース日：2024/11/01
カスタムコネクタJSONダウンロードURL：
https://drive.google.com/uc?export=download&id=1CP9wFhJ0XqcuIsBmrqu5ZYuAIlMZI8PA
仕様・制限事項
KAC のカウントは1リクエストごとに1回カウントアップされます。
アクションによっては、1回の利用であっても分解されるファイルが複数ある場合に複数回の利用回数カウントアップされる場合があります。
サインインに必要な情報
KAC API キー: 寿商会が提供する KAC 専用の API キー
RSA署名を生成
秘密鍵を使用して、RSA暗号化方式でテキストメッセージの署名を生成します。また、ハッシュアルゴリズムとしてSHA256またはSHA512のいずれかを選択することができ、生成された署名の形式もBase64形式またはHEX形式から選ぶことができます。
パラメータ
Message: テキストメッセージ
Private key: 秘密鍵
Hash algorithm: ハッシュアルゴリズム（SHA256またはSHA512）
Encoding: エンコーディング方式（Base64またはHEX）
レスポンス
signature: 生成された署名
HMAC-SHA512署名を生成
秘密鍵を使用して、HMAC-SHA512方式でテキストメッセージの署名を生成します。生成された署名の形式は、Base64形式またはHEX形式から選ぶことができます。
リクエストパラメータ
Message: テキストメッセージ
Private key: 秘密鍵
Encoding: エンコーディング方式（Base64またはHEX）
レスポンスパラメータ
signature: 生成された署名
ECDSA署名を生成
秘密鍵を使用して、ECDSA方式でテキストメッセージの署名を生成します。また、ハッシュアルゴリズムとしてSHA256またはSHA512のいずれかを選択することができ、生成された署名の形式もBase64形式またはHEX形式から選ぶことができます。
パラメータ
Message: テキストメッセージ
Private key: 秘密鍵
Hash algorithm: ハッシュアルゴリズム（SHA256またはSHA512）
Encoding: エンコーディング方式（Base64またはHEX）
レスポンス
signature: 生成された署名
AES-CMAC署名を生成
秘密鍵を使用して、AES-CMAC方式でテキストメッセージの署名を生成します。生成された署名は cmac としてレスポンスに含まれます。
パラメータ
Message: テキストメッセージ
Private key: 秘密鍵
レスポンス
cmac: 生成されたcmacキー
ハッシュを生成
指定されたハッシュアルゴリズムを使用してファイルのハッシュ値を生成します。ハッシュアルゴリズムとしてMD5、SHA256、またはSHA512のいずれかを選択することができ、生成されたハッシュ値の形式はBase64形式またはHEX形式から選ぶことができます。
パラメータ
File url: ファイルのURL
Hash algorithm: ハッシュアルゴリズム（MD5、SHA256、またはSHA512）
Encoding: エンコーディング方式（Base64またはHEX）
レスポンス
hashedFileData: 生成されたハッシュ値
秘密鍵・公開鍵を生成
指定された暗号化方式を使用して秘密鍵と公開鍵のペアを生成します。暗号化方式としてRSA、HMAC、ECDSA、またはAES-CMACのいずれかを選択することができます。
パラメータ
keyType: 鍵を作るタイプ（RSA、HMAC、ECDSA、またはAES-CMAC）
レスポンス
privateKey: 生成された秘密鍵
publicKey: 生成された公開鍵
※暗号化の方式によってレスポンスは "privateKey" だけの場合もあります
RSA署名の検証
公開鍵を使用して、RSA暗号化方式で生成されたテキストメッセージの署名を検証します。検証の際には、署名生成時に使用したハッシュアルゴリズム（SHA256またはSHA512）と署名の形式（Base64形式またはHEX形式）を選択する必要があります。これにより、署名の正当性と元のメッセージの完全性を確認することができます。
パラメータ
Message: テキストメッセージ
hashAlgorithm: ハッシュアルゴリズム（SHA256またはSHA512）
encoding: エンコード方式（Base64またはHEX）
Public key: 公開鍵
Signature: 署名
レスポンス
verified: 検証結果（trueまたはfalse）
HMAC-SHA512署名の検証
秘密鍵を使用して、HMAC-SHA512方式で生成されたテキストメッセージの署名を検証します。検証の際には、署名生成時に使用した署名の形式（Base64形式またはHEX形式）を選択する必要があります。これにより、署名の正当性と元のメッセージの完全性を確認することができます。
パラメータ
Message: テキストメッセージ
encoding: エンコード方式（Base64またはHEX）
Private key: 秘密鍵
Signature: 署名
レスポンス
verified: 検証結果（trueまたはfalse）
ECDSA署名の検証
公開鍵を使用して、ECDSA（楕円曲線デジタル署名アルゴリズム）方式で生成されたテキストメッセージの署名を検証します。検証の際には、署名生成時に使用したハッシュアルゴリズム（SHA256またはSHA512）と署名の形式（Base64形式またはHEX形式）を選択する必要があります。これにより、署名の正当性と元のメッセージの完全性を確認することができます。
パラメータ
Message: テキストメッセージ
hashAlgorithm: ハッシュアルゴリズム（SHA256またはSHA512）
encoding: エンコード方式（Base64またはHEX）
Private key: 秘密鍵
Signature: 署名
レスポンス
verified: 検証結果（trueまたはfalse）
AES-CMACの検証
秘密鍵を使用して、AES-CMAC方式で生成されたテキストメッセージの署名を検証します。これにより、署名の正当性と元のメッセージの完全性を確認することができます。
パラメータ
Message: テキストメッセージ
Private key: 秘密鍵
encoding: エンコード方式（Base64またはHEX）
Cmac: cmac
レスポンス
verified: 検証結果（trueまたはfalse）
ハッシュの検証
指定されたハッシュアルゴリズムを使用して生成されたファイルのハッシュ値を検証します。検証の際には、ハッシュ生成時に使用したハッシュアルゴリズム（MD5、SHA256、またはSHA512）とハッシュ値の形式（Base64形式またはHEX形式）を選択する必要があります。これにより、ハッシュ値の正当性と元のファイルの完全性を確認することができます。
パラメータ
File url: ファイルのURL
storedHash: 取得したハッシュ
Hash algorithm: ハッシュアルゴリズム（MD5、SHA256、またはSHA512）
encoding: エンコード方式（Base64またはHEX）
レスポンス
verified: 検証結果（trueまたはfalse）