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 です。