コネクタービルダーからの提出
概要
作成したOkta WorkflowsConnectorは、レビューと公開のためにOkta Integration Network(OIN)に提出できます。コネクターがOINに公開されると、パブリックマーケットプレイスでの視認性を得ることができます。コネクタービルダーを使って作成された任意のコネクターを、Oktaのその他のお客様が表示・デプロイできるようになります。
コネクターをOINに提出すると、公開に必要なOktaの品質保証基準が満たされていることを確認するためのレビュープロセスが必要になります。一般公開されるコネクターは、次の目標を満たしている必要があります。
-
コネクタービルダーのベストプラクティスに従って開発されている
-
Okta Workflowsプラットフォームのパフォーマンスにマイナスの影響を与えない
-
Custom API Actionカードを含め、各アクションカードのヘルプトピックを含んでいる
-
提供されるヘルプドキュメントに従って想定どおりに実行される
OINチームは、提出されたコネクターをベストエフォートでレビューします。コネクターの提出に関するSLA(サービスレベル合意)はありません。コネクターが提出されると、OINチームは提出者に連絡をとり、レビューおよび公開プロセスの推定タイムフレームを伝えます。
公開が承認されると、Oktaはコネクターをプレビューセルにデプロイし、1週間のトライアル期間後に本番セルにデプロイします。
検証
OINチームは、評価の一環として、提出が公式アカウントから行われると想定します。このアカウントは、関連するプラットフォームとコネクターで使用されるすべてのAPIに合法的にアクセスできる必要があります。このアカウントは、直接、または会社の子会社や請負業者を通じて会社に関連付けることができます。
アカウントが(通常はメールドメインを経由して)会社と明確に関連付けられていないを場合、OINチームはコネクターに一致するドメインまたは会社の特定の所有者からのメールを通じて証拠をリクエストします。
要件
コネクターの提出時に、OINのテストプロセス用に次の項目を提供する必要があります。
サポートの連絡先
アクティブにモニタリングされる、カスタマーサポート用のメールアドレスを提供します。このメールアドレスは、OINカタログエントリの一部として公開されます。
エスカレーションの連絡先
エスカレーションの連絡先アドレスも提供する必要があります。テストプロセス中に問題が発生した場合、または公開後のコネクターに問題があった場合に、OINチームはこのアドレスを使用します。このエスカレーション用メールアドレスは公開されません。
ドキュメント
コネクターの適正使用と構成について説明したテクニカルドキュメントを用意する必要があります。「コネクタービルダー提出ドキュメント」を参照してください。
Oktaは、コネクターのドキュメントをホスティングしないため、提出者側のドメインまたは一般公開されているサードパーティサイトにドキュメントを用意する必要があります。レビュープロセス中は、このコンテンツを非公開とし、Oktaがコネクターを公開する際にドキュメントが公開されるようにOINチームと調整することができます。
テスト環境
OINチームには、コネクターをテストするための有効なアカウントまたはテナントが必要です。このテストテナントには、コネクターを適切に評価するためのサンプルデータが十分に用意されている必要があります。たとえば、テストコネクターがページ分けを使用するのであれば、コネクターが複数ページのデータを返せるだけの十分なサンプルが必要になります。
テストデータには一切の個人識別情報(PII)を含めることができません。実名またはハンドルネームのプロファイルデータを使用しないでください。
テスト用に提供される資格情報には、コネクターが実装するエンドポイントのテストに必要なすべての権限が必要です。
テストガイダンス
次の項目も提供する必要があります。
-
フローで実行されるアクションの詳細を示すテストケースのリスト。具体的な要件については、「コネクタービルダーの送信テスト」を参照してください。
-
テストフローのコピー(フォルダーファイルとしてエクスポート)。
-
コネクターに関連する任意のAPIドキュメントへのリンク。OINチームが、テスト用に提供される資格情報を使ってこれらのAPIドキュメントにアクセスできる限り、このドキュメントは公開、非公開のどちらでも構いません。
関連項目
コネクタービルダーの送信テスト