SkyWay Admin Auth Token

This page has not been translated yet.

SkyWay Admin Auth Tokenは、SkyWay Channel APIやSkyWay Recording APIなどのアプリケーションの管理者（サーバー）用APIを利用する際に必要な、認証のためのトークンです。

トークン検証の際、ペイロードに記載された有効期限確認が行われます。

本トークンをクライアントアプリケーションに提供しないよう注意してください。管理者（サーバー）用APIを利用されてしまう恐れがあります。

形式

SkyWay Admin Auth TokenはJWT形式です。

ペイロード部は以下の通りです。

クレーム	必須	形式	説明
iat	✔️	UNIX タイムスタンプ	トークンが発行された日時
jti	✔️	string (UUID v4)	トークンのユニークな id
exp	✔️	UNIX タイムスタンプ	このトークンが無効になる時間を表すタイムスタンプ
appId	✔️	string（UUID v4）	アプリケーションID

例

{
    "iat": 1706754878,
    "jti": "ba51311f-599d-47ca-a51d-df371fa750e7",
    "exp": 1706854878,
    "appId": "ac8adbc8-a2ff-4c41-9f5e-fdaed5e1e65e"
}

作成方法の例

Node.jsでの作成方法を以下に示します。

const jwt = require("jsonwebtoken");
const crypto = require("crypto");

const payload = {
  iat: Date.now() / 1000,
  jti: crypto.randomUUID(),
  exp: Date.now() / 1000 + 60 * 60 * 24 * 7,
  appId: "アプリケーションIDを記載します",
};

const SECRET_KEY = "シークレットキーを記載します";
const token = jwt.sign(payload, SECRET_KEY);
console.log(token)