GetJWT

概要

この関数で、ユーザは JSON Web トークン (JWTs) を作成できます。キーを使用して JWT ペイロードのハッシュが作成されます。ハッシュは検証を可能にするために JWT コンテンツに含まれます。JWT ペイロードは暗号化されません。

GetJWT() とその対の関数 GetJWTByKeyName() の違いは、最初のパラメーターです。GetJWT() の最初のパラメーターは、呼び出し元が任意の方法で直接指定するキー文字列です。たとえば、キー文字列は暗号化してデータエクステンションに保存されます。

構文

1string GetJWT(string key, string algorithm, string jsonPayload)

関数のプロパティ

序数	型		説明
1	string	必須	キー文字列。
2	string	必須	`HS256`、`HS384`、または `HS512` の JWT 標準ハッシュアルゴリズムの名前。
3	string	必須	ペイロード。通常は名前-値のペアを使用する JSON オブジェクト。ペイロードは暗号化されません。

使用状況

この関数は JWT 文字列を返します。関数の構文が無効な場合、パーサーは InvalidFunctionException をスローします。無効なパラメーター値を使用しているなど、関数呼び出しが無効な場合、パーサーは FunctionExecutionException をスローし、内部例外に詳細を含めます。

コードの例

1%%[
2VAR @JWT
3VAR @JSON
4VAR @HREF
5SET @JSON = '{
6 "first_name": "First",
7 "last_name": "Last",
8 "email": "someone@salesforce.com",
9 "campaign_id": "1234"
10}'
11SET @JWT = GetJWT("0123456789abcdef0123456789abcdef", "HS256", @JSON)
12SET @HREF = CONCAT("https://someurl?sign=",@JWT)
13]%%
14<p>
15<a href="%%=V(@HREF)=%%">GetJWT JWT</a>
16</p>

出力例

出力はこの例のような JWT です。

1eyJhmGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ew0KICJmaXJzdF9uYW1lLjogIkZpcnN0IiwNCiAibGFzdF9uYW1lIjogIkxhc3QiLA0KICJlbWFpbCI6ICJzb12lb25lQHNhbGVzZm9yY2UuY29tIiwNCiAiY2FtcGFpZ25faWQiOiAiMTIzNCINCn0.E3kvEPx4m2O8COec4GQstpm-34Tgj6ako6EccmHfNec