JSON Web トークン

JSON Web トークンのフローアクションを設定して、JSON Web トークンに署名したり、検証したり、デコードしたりする方法を学びます。

このJSON Web トークンアクションの一覧を使うと、フロー内で JWT を生成、検証、デコードできます。

​

JWT Vault Connection を設定する

JWT Vault Connection で、JSON Web トークンのフローで使用する Vault 接続の設定方法をご確認ください。

​

JSON Web トークンに署名する

JSON Web トークンを生成します。

​

入力設定

パラメータ	説明
ペイロード	エンコードするデータです。OpenID 標準に従った形式にすることを推奨します。
サブジェクト	JWT の subject を示します。
発行者	JWT を発行した主体を示します。
audience	JWT の想定される受信者を示します。例: admin.your_domain.com
有効期限	JWT を処理のために受け付けてはならなくなる時刻を示します。

​

出力オブジェクト

プロパティ	型	説明
token	String	JSON Web トークンの文字列。

​

出力オブジェクトの例

{
  "token": "eyJhbGciOiJIUzI1N..."
}

​

JSON Web トークンをデコード

指定されたJSON Web トークンをデコードします。

​

入力設定

パラメータ	説明
トークン (必須)	デコード対象の JSON Web トークン文字列。

​

出力オブジェクト

プロパティ	型	説明
payload	オブジェクト	デコード後の有効な JSON Web トークンの内容

​

出力オブジェクトの例

{
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "1234567890",
    "name": "John Doe",
    "iat": 1516239022
  },
  "signature": "SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

​

Verify JSON Web トークン

JSON Web トークンのデータを検証し、改ざんされていないことを確認することで、その真正性を保証します。

​

入力設定

パラメータ	説明
Token (必須)	検証するJSON Web トークン文字列。
発行者	検証するJWTの発行者。
Audience	検証するJWTの想定受信者である audience。

​

出力オブジェクト

プロパティ	型	説明
valid	ブール値	JWT の署名が有効かどうかに応じて、true または false を返します。
cause	文字列	valid プロパティが false の場合に、メッセージが表示されます。
payload	オブジェクト	デコード済みで有効な JSON Web トークンの内容です。

​

出力オブジェクトの例

{
  "valid": true,
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "1234567890",
    "name": "Jane Doe",
    "iat": 1516239022
  },
  "signature": "SflKxwRJSMe..."
}

{
  "valid": false,
  "cause": "INVALID_SIGNATURE"
}