GetJWTByKeyName
この関数で、ユーザは JSON Web トークン (JWTs) を作成できます。キーを使用して JWT ペイロードのハッシュが作成されます。ハッシュは検証を可能にするために JWT コンテンツに含まれます。JWT ペイロードは暗号化されません。
GetJWTByKeyName() とその対の関数 GetJWT() の違いは、最初のパラメーターです。GetJWTByKeyName() の最初パラメーターは、MID (ClientID) の CustomerKey 値と一致するキー名です。この関数形式を使用すると、その MID に属する対称キーが取得されます。
| 序数 | 型 | 説明 | |
|---|---|---|---|
| 1 | string | 必須 | MID の CustomerKey 値と一致するキー名。 |
| 2 | string | 必須 | HS256、HS384、または HS512 の JWT 標準ハッシュアルゴリズムの名前。 |
| 3 | string | 必須 | ペイロード。通常は名前-値のペアを使用する JSON オブジェクト。ペイロードは暗号化されません。 |
GetJWTByKeyName() 関数でサポートされるのは、MC M&J 公開キー管理システムからキーのカスタマーキー値に基づく対称キーの取得です。
GetJWTByKeyName() とその対の関数 GetJWT() はどちらも、UTF-8 を使用してキー文字列をキーのバイト配列に変換します。Base16、Base64、ASCII 文字のキー文字列がサポートされます。この範囲外のキー文字列がサポートされる保証はありません。
この関数は JWT 文字列を返します。関数の構文が無効な場合、パーサーは InvalidFunctionException をスローします。無効なパラメーター値を使用しているなど、関数呼び出しが無効な場合、パーサーは FunctionExecutionException をスローし、内部例外に詳細を含めます。
出力はこの例のような JWT です。