JWT Workato claim
IDプロバイダーは、複数のアプリケーションへの検証済みアクセスを維持するプロセスを効率化します。 エンドユーザーはidentity providerで認証するだけで済みます。 その後、エンドユーザーは追加の認証情報セットを覚える必要なく、複数のアプリケーションやサービスにアクセスできます。 たとえば、IDプロバイダーはJSON Web Tokens(JWT)を発行し、エンドユーザーがWorkato API platformで認証済みリクエストを実行できるようにします。
Identity providerがエンドユーザーにJWTを発行し、エンドユーザーはそれを使用してWorkato API platformへの検証済みアクセスを取得
標準準拠の代替手段
identity providerがアプリケーションのWorkato発行API keyをclaimとして埋め込めない場合は、代わりにカスタム検証を使用してください。 カスタム検証では、受信トークンをアプリケーションで定義したクレームおよびスコープルールと照合するため、IdPはWorkato固有のクレームを追加する必要がありません。
受信リクエストを受け取ると、WorkatoはJWTで有効なAPI keyを確認します。 これは、そのリクエストが有効なアプリケーションから送信されていることを判断するために行われます。 有効なtokenが見つからない場合、APIリクエストは401 Unauthorizedエラーを返します。
Workatoは次のJWT claimを順番に検査します。 Workatoは空でない最初のclaimを識別し、そのclaim値を既知のアプリケーションの内部リストと比較します。 tokenが検証されない場合、APIリクエストは401 Unauthorizedエラーを返します。 それ以外の場合、有効なAPI keyが見つかると、APIリクエストは成功します。
API keyのデフォルトclaim
| 優先度 | 部分 | JWTクレーム | 説明 |
|---|---|---|---|
| 1番目 | payload | https://www.workato.com/sub | これはnamespace claimです。 一意の名前を使用するため、このclaimがidentity providersによって制限される可能性は低くなります。 |
| 2番目 | payload | workato_sub | 上記のclaimsが空の場合、Workatoはこのclaimを検査します。 |
| 3番目 | payload | sub | これはJWTのsubjectを表します。 一部のidentity providersではこのJWT claimが予約されているため、ここではWorkato API keyを使用できません。 上記のclaimsが空の場合、Workatoはこのclaimを検査します。 |
| 4番目 | header | kid | これはheader claimです。 上記のclaimsが空の場合、Workatoはこのclaimを検査します。 |
ユースケースでこれらのclaimが他の目的に使用されている場合、カスタムclaimを使用してAPI keyを保持できます。
詳細設定
適用する予約済みclaims
この複数選択入力では、適用する予約済みclaimsを選択できます。 ここで選択した各claimがJWT内に存在することをAPI platformが確認します。 たとえば、expを選択すると、有効期間が制限されたトークンのみがAPIへのアクセスに使用されるようになります。
iss claimに許可される発行者
Reserved claims to enforceでissが選択されている場合、この追加入力が提供されます。 ここでは、許可されるiss値のリストを指定できます。 すべてのiss値を受け入れるには、このフィールドを空白のままにします。
API keyのカスタムclaim
デフォルトの4つのAPI key claimすべてが他の目的で使用されている場合、カスタムclaimを使用してJWT内にAPI keyを保持できます。 このカスタムclaimは、アプリケーションの高度な暗号化設定で指定する必要があります。
最終更新日: