新しいクライアントの登録

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

事前構築済みのWorkatoコネクターは、ほとんどのビジネスニーズを満たすように設計されています。 ただし、Workatoの事前構築済みコネクターの範囲を超える要件がある場合があります。

新しいクライアントを登録する理由

事前構築済みコネクターのスコープが不十分な場合は、ユースケースを満たすために、関連するスコープを持つカスタムクライアントを登録する必要があります。

これは、OAuth 2.0認証を使用するコネクターにのみ適用されます。 これらのコネクターはOAuth 2.0クライアントを使用して、アカウントに代わってAPIとやり取りし、通常、固定された一連のスコープが関連付けられています。 つまり、コネクターがAPIのすべてのエンドポイントとやり取りできるとは限りません。

Workato接続済みアプリでカスタムクライアントを使用する

カスタムクライアントを使用するには、カスタムコネクターを作成する必要があります。 カスタムクライアント認証情報をHTTPユニバーサルコネクターまたはSDKで使用します。 これにより、カスタムクライアントの追加スコープを、Workatoのプラットフォーム上の他のコネクターとともに使用できます。

コールバックURL

多くのクラウドアプリは認証にOAuth 2.0を使用しています。 OAuth 2.0フローの一部には、コールバックURL(またはリダイレクトURL)が含まれます。 Googleなど一部のクラウドアプリでは、クライアント登録時にこのコールバックURLを登録する必要があります。 このURLの承認が必要になる場合もあります。 これは、アカウントへの不要なアクセスを防止するためのセキュリティ対策です。 コールバックURLを登録しない場合、次のようなエラーが発生することがあります。

400エラー。 リダイレクトURIの不一致400エラー。 リダイレクトURIの不一致

ユニバーサルコールバックURL

データセンターリージョンに関係なく、WorkatoでOAuthフローを完了するには、次のコールバックURLを使用します:

  • プラットフォームコネクターまたはCustom OAuth profileを使用している場合は、コールバックURLを設定します:

    • https://www.workato.com/oauth/callback
  • カスタムコネクターの場合は、カスタムコネクターコードで設定されたURLを使用します:

    • https://www.workato.com/oauth/callbackまたは
    • https://app.workato.com/oauth/callback

ユニバーサルコールバックURLにより、"400エラー。 リダイレクトURIの不一致"の問題を回避できます。

コールバックURLを使用して新しいクライアントを登録する

次の手順は、Google Cloudプラットフォームで新しいクライアントを登録する方法の例です。

1

認証情報を作成>OAuthクライアントIDを選択します。

Google CloudプラットフォームAPI認証情報Google CloudプラットフォームAPI認証情報

2

ウェブアプリケーションを選択し、名前フィールドに使用する名前を入力します。

3

承認済みのリダイレクトURIフィールドにコールバックURLを入力します:

  • プラットフォームコネクターまたはCustom OAuth profileを使用している場合は、コールバックURLをhttps://www.workato.com/oauth/callbackとして設定します。
  • カスタムコネクターの場合は、カスタムコネクターコードで設定されたURLを使用します:
    • https://www.workato.com/oauth/callbackまたは
    • https://app.workato.com/oauth/callback

OAuthクライアントIDを作成OAuthクライアントIDを作成

無効なリダイレクトメッセージ

この手順で、ほとんどのユーザーに無効なリダイレクトメッセージが表示されます。 これを解決するには、承認済みドメインリストを選択します。

無効なリダイレクトURL無効なリダイレクトURL

4

クリック対象: 作成>クライアント認証情報。 OAuth同意画面ページが表示されます。 または、APIとサービス>認証情報>OAuth同意を選択してこのページにアクセスできます。

OAuth同意画面OAuth同意画面

5

Workatoアプリケーション名フィールドに入力します。

アプリケーション名アプリケーション名

6

スコープを追加を選択し、次のスコープを入力します:

  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.user

スコープを追加スコープを追加

7

workato.com承認済みドメインフィールドに入力し、保存をクリックします。

Workato.comを承認Workato.comを承認

8

認証情報を作成>OAuthクライアントIDをクリックします。

Google CloudプラットフォームAPI認証情報Google CloudプラットフォームAPI認証情報

9

ウェブアプリケーションをクリックし、名前フィールドに使用する名前を入力します。

10

https://app.workato.com/oauth/callback承認済みのリダイレクトURIフィールドに入力し、作成をクリックします。

承認済みリダイレクトURL承認済みリダイレクトURL

これで、カスタムクライアントがGoogle Cloudプラットフォームに作成されました。

新しいカスタムクライアント新しいカスタムクライアント

クライアント認証情報の取得

これで、カスタムクライアントをWorkatoに接続する準備が整いました。 カスタムクライアント(例: Workato)を開いて、クライアント認証情報を表示します。 OAuth 2.0認証には、クライアントIDクライアントシークレットが必要です。

クライアント認証情報クライアント認証情報


よく発生する問題

一部のお客様が、以下のスクリーンショットのように、Google Cloudプラットフォームでドメインhttp://www.workato.comの確認に誤って誘導されることがあることを確認しています。

ドメイン確認のリクエストドメイン確認のリクエスト

これは必須の手順ではありません。このページが表示された場合は、APIとサービス認証情報ステップ1)に戻ります。

Last updated: