Product UpdatesStatus PageWorkato Academy
English
日本語
Get a trial
API platform
APIセキュリティ
認証

JSON Web Token（JWT） ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

JSON Web Token（JWT）を使用して、API platformを通じて公開されたレシピを呼び出すAPIクライアントを認証できます。 JWTは、静的な認証情報に代わる安全で柔軟な方法を提供し、内部ツールやサードパーティサービスなどのシステムが署名付きトークンで認証できるようにします。

Workatoは、RSA（公開/秘密鍵）とHMAC（共有シークレット）の両方の署名方法をサポートしています。 認証するには、クライアントがWorkato APIキーでトークンに署名します。 プラットフォームはトークンを検証して、エンドポイントへのアクセスを承認します。

JWTはRFC 7519仕様で定義されています。

サポートされている署名方法 ​

Workatoは2つの署名方法をサポートしています:

署名方法説明
RSA（公開鍵）推奨。 非対称キーペアを使用します。 クライアントは秘密鍵でトークンに署名し、公開鍵をWorkatoに登録します。
HMAC（非推奨）対称共有シークレットを使用します。 クライアントとWorkatoは同じ256ビットのシークレット文字列を使用します。

APIクライアントのJWT認証を設定 ​

JWT認証を設定して安全なAPIアクセスを有効にするには、次の手順を実行します:

  1. APIクライアントを作成
  2. 認証を設定
  3. APIキーの作成
  4. JSON Web Tokenを生成

APIクライアントを作成 ​

新しいクライアントを追加して設定するには、次の手順を実行します:

1
APIクライアントの追加
1

プラットフォーム＞API platformに移動します。

2

クライアントタブを選択します。

3

+ Add new clientをクリックします。

新規クライアントを追加新規クライアントを追加

2
クライアント詳細の設定
1

クライアントの名前を入力します。 クライアントの会社名や部門名など、わかりやすい識別子を使用します。

クライアント詳細のセットアップクライアント詳細のセットアップ

2

クライアントの説明を入力します。

3

クライアントロゴをアップロードします。 JPG/PNG画像をドラッグアンドドロップするか、Upload from deviceをクリックしてファイルを選択します。 このロゴは、ポータル内でクライアントを視覚的に識別します。

4

ポータルアクセスを有効にするには、クライアントにポータルへのアクセスを許可トグルを有効にします。 これにより、公開済みのAPIコレクションを参照し、APIキーを管理する権限がクライアントに付与されます。 クライアントがテストまたは社内目的でAPIトークンのみを必要とする場合は、トグルを無効のままにできます。

5

ポータルの認証方法に基づいて、クライアントの識別情報を入力します:

6

次へをクリックしてアクセス設定を定義画面に進み、クライアントのAPIアクセスを設定します。

3
アクセス設定の定義
1

認証方法としてJSON Web Tokenを選択します。

2

任意です。 相互TLS（mTLS）を適用をオンにして、SSLハンドシェイク中にクライアントが有効な証明書を提示することを必須にします。 これにより、双方向認証が強制されます。 詳細については、mTLS認証ガイドを参照してください。

注：この設定は、ワークスペースにカスタムドメインを設定している場合にのみ表示されます。

3

API collections to includeドロップダウンメニューを使用して、1つ以上のAPIコレクションを選択します。 これにより、クライアントがポータルでアクセスおよび呼び出しできるAPIが定義されます。 APIアクセスを付与する前にディスカバリーを許可するため、コレクションなしでクライアントを作成することもできます。

4

任意です。 クライアントのAPI利用状況を制御するために、ポリシーを割り当てます。 ポリシーでは、レート制限や利用状況クォータなどのルールを定義します。

5

次へをクリックします。

認証を設定 ​

トークン検証に必要なセキュリティ認証情報を設定するには、次の手順を実行します:

1

署名方法を選択します:

  • RSA (公開鍵)（推奨）
  • HMAC (非推奨)

署名方法を選択署名方法を選択

2

選択した署名方法に基づいて、以下の該当する設定手順に従います:

3

次へをクリックしてクライアントを作成します。

ポータルアクセスが有効になっている場合、Workatoはクライアントのメールアドレスに招待メールを送信します。 APIコレクションや認証方法へのアクセスなどの権限は、クライアントレベルで設定されます。

APIキーの作成 ​

APIキーを生成するには、次の手順を実行します。 クライアントは、このキーをJWTのkid（キーID）クレームとして含める必要があります。 プラットフォームはこの値を使用して、クライアントとその署名方法を特定し検証します。

1

API platform > Clientsに移動し、クライアントを選択して、API keysタブに移動します。

2

+ Create API keyをクリックします。

APIキーの作成APIキーの作成

3

キーを識別するためのAPI key nameを入力します。

新しいAPIキーの設定新しいAPIキーの設定

4

任意です。 リクエストを特定のIPアドレスに制限するには、Allowed IPsを追加します。 複数のIPを許可するには、カンマで区切るか、範囲を定義します。

5

任意です。 特定のIPアドレスからのリクエストを防ぐには、Blocked IPsを追加します。 ブロックされたIPは許可されたIPより優先されます。 たとえば、IPアドレス123.456.123.456を許可リストに追加していてもブロックした場合、このIPアドレスからポータルにアクセスしようとするユーザーはアクセスを拒否されます。

6

GenerateをクリックしてAPIキーを作成します。 Workatoに認証トークンが表示されます。 このトークンは再表示されないため、安全に保存してください。 このトークンを紛失した場合は、更新するか新しいAPIキーを作成する必要があります。

APIキーの生成APIキーの生成

JSON Web Tokenを生成 ​

JWTヘッダーにAPIキーをkid（キーID）クレームとして含めるJWTを作成し、署名します:

json
{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "<YOUR-API-KEY>"
}

APIリクエストを開始するクライアントには、JWTに正しく署名する責任があります。 プラットフォームは、認証とアクセスのためにこのトークンを検証します。

代替クレーム

この例では、Workato APIキーがkidクレームとしてヘッダーに含まれています。 一部のIDプロバイダーでは、kidクレームが制限される場合があります。 この場合、トークンのペイロードセクションで、次のいずれかのクレームの下にAPIキーを含めることができます: https://www.workato.com/sub、workato_sub、またはsub。

ユースケースでこれらのクレームが他の目的に使用されている場合は、カスタムクレームを使用してアクセスプロファイルキーを保持できます。 代替クレームの詳細。

APIキーを含むJWTを生成して署名するには、次の手順を実行します:

1

JSON Web Tokenを生成するには、jwt.ioに移動します。

2

JWT Encoderタブをクリックします。

3

IDプロバイダーを使用して、サポートされているクレームのいずれかにAPIキーが埋め込まれたJWTを発行することもできます。 詳細については、JWT Workatoクレームを参照してください。

Last updated: