ベストプラクティス:APIコネクターまたはコネクタービルダーの選択 | Okta

Okta Workflowsには、現時点でコネクターカタログに含まれないアプリケーションと統合するためのオプションが2つ用意されています。1つはAPIコネクター機能で、もう1つはコネクタービルダーを使った独自コネクターの作成です。

背景

APIコネクターカードは、ほとんどのサービスへのAPI呼び出しを作成するための軽量なソリューションをお客様に提供します。資格情報はセキュアに保存されます。カードは、基本、OAuth 2.0認証コード、OAuth 2.0クライアント資格情報、またはカスタム認証のいずれかを使って認証ヘッダーを作成します。「APIコネクターカードを使った認証」を参照してください。

コネクタービルダーは、Workflowsプラットフォーム上でコネクターを作成するためのノーコード開発ツールです。事前に作成されたその他任意のコネクターと同様に使用できるように、これらのコネクターを作成、テストし、テナントにデプロイします。「コネクタービルダー」を参照してください。

ユースケース

接続用に選択するオプションは、ユーザーケースによって異なります。

  • 使用するたびに応答の本文が手動で解析されるため、APIコネクターは非反復的なAPI呼び出しで最適に機能します。解析の繰り返しを回避するために、ヘルパーフローが同一APIリクエストの反復呼び出しを処理できます。ただし、ヘルパーフローは組織の計画に合わせて定義されるフロー制限に対してカウントされます。「フロー制限」を参照してください。

  • コネクタービルダーは、コンパイルされた製品によく似たエンドユーザーエクスペリエンスを提供します。コネクタービルダーを使ってコネクターを作成する際にAPIを呼び出して、応答を複数のフローで利用できるドラッグアンドドロップ出力として利用できます。これは、一部のコネクターユーザーが直接API呼び出しの使用に慣れていない場合に便利です。

    コネクタービルダーは、標準以外の認証メカニズムを使用する場合(サービスが追加のパラメーターを必要とする場合や、クライアント資格情報付与タイプを使用する場合など)にも便利です。

    レビューとコネクターカタログでの公開のために、コネクタービルダーを使って作成したコネクターをOINに送信できます。「コネクタービルダーからの提出」を参照してください。コネクタービルダーを使ったその他の接続の例については、「コネクター」を参照してください。

制限事項

APIコネクターが含まれるフローをエクスポートおよびインポートできます。コネクタービルダーを使って作成したコネクターが含まれるフローは、コネクターの作成場所と同じテナントで使用する必要があります。これは、Okta org間(たとえば、プレビューorgと本番orgの間)で移動できます。開発を始める前に、コネクターの正しい宛先を選択することが重要です。

関連項目

コネクタービルダー

APIコネクターカードを使った認証