APIクライアントへの切り替え

2023年1月11日に、WorkatoはAPIクライアント認証に移行します。従来のAPIキーはUIからアクセスできなくなります。

Workatoは、予定された非推奨化の前に、Workato APIのすべての使用をAPIクライアント認証に切り替えることをお勧めします。認証にAPIクライアントを使用する方法について詳しく学びましょう。

従来のAPIキーの非推奨化

従来のAPIキーは2024年1月1日までサポートされ、その後は非推奨化されます。従来のAPIキーを使用して認証されたすべてのAPIリクエストは、この時点以降は拒否されるようになります。

これは私に影響しますか？

この更新は、2023年1月11日より前に作成されたワークスペースにのみ影響します。

2023年1月11日以降に作成されたワークスペースは、この更新の影響を受けません。これらのワークスペースには従来のAPIクライアントやクライアントロールはありません。

従来のAPIキーを引き続き使用できますか？

現在、APIキーとメールによる認証を使用しているアプリケーションは引き続き動作します。Workatoは、従来の認証方法を2024年1月1日までサポートします。

ただし、従来のAPIキーはもはや表示できなくなります。これは、トークンのセキュリティに関する業界の標準に合致しています。Workato APIを使用して新しい自動化を作成するには、新しいAPIトークンを作成するか、APIトークンを再生成してください。

Workato APIでAPIクライアントを使用するように始めましょう。

従来のAPIキーを管理できる場所はどこですか

従来のAPIキーはワークスペースアクセス (opens new window)（EUデータセンター (opens new window)の場合）に移動されます。同じ権限を持つ従来のAPIクライアントとクライアントロールが作成されます。

• APIクライアント

• 名前: 移行済みAPIクライアント

  このクライアントを動作させるAPIトークンが従来のAPIキーです。このクライアントには以下のクライアントロールが割り当てられます。

• クライアントロール

• 名前: 管理者

環境を持つワークスペースの場合

環境を持つワークスペースでは、各環境ごとに別々のAPIクライアントが作成されます。

移行済みAPIクライアント - {環境名}

APIクライアントへの移行

移行済みのAPIクライアントは再生成できないため、新しいAPIトークンを作成する必要があります。新しいAPIクライアントとクライアントロールを作成するから始めましょう。新しいAPIトークンを使用するリクエストは、Authorization: Bearerヘッダーではなくx-user-tokenとx-user-emailヘッダーで送信されます。

従来のAPIキーとメールを使用するカスタムコネクタ（埋め込みコネクタやアクセラレータからのコネクタなど）については、サポートチームに連絡してサポートを受けるようにしてください。これらのコネクタの改善は、新しいAPIクライアント認証をサポートするためにリリースされます。

移行済みの従来のAPIキーの削除

従来の移行済みAPIクライアントを削除すると、このAPIクライアントへのアクセスがすぐに削除されます。

これにより、従来のAPIキーとメールを使用しているすべてのアプリケーションへのアクセスが取り消されます。

従来のAPIクライアントの削除

APIトークンを削除すると、従来のAPIキーとメールによる認証を使用しているすべてのアプリケーションへのアクセスがすぐに取り消されます。

Workatoは、将来の使用のために新しいAPIトークンを作成して配布することをお勧めします。