• ホーム
• コンテンツライブラリ
• 管理者ドキュメント
• インラインフック

インラインフック

インライン フックは、miniOrange からカスタム コード/外部サービス/アプリケーションへの発信呼び出しであり、miniOrange プロセス フロー全体でトリガーされます。これらは、カスタム機能をシームレスに統合するように設計されています。特に、miniOrange は SSO 応答をインライン フックにのみ送信するため、カスタム コードでこの応答を変更してから miniOrange に返すことができます。これらのフックは同期呼び出しを利用し、外部サービスからの応答を受信するまで、フックを開始した miniOrange プロセスを一時的に停止します。

このカスタム コードは、インターネットにアクセス可能なエンドポイントを持つ Web サービスとして実装する必要があります。miniOrange の外部のシステムでホストする必要があります。miniOrange は、カスタム コードに送信される要求とカスタム コードからの応答の REST API 契約を定義します。

miniOrangeインラインフックの設定手順

• に行く ワークフロー > インラインフック.



• ソフトウェアの制限をクリック 新しいフックを追加.



• ノーザンダイバー社の アプリ ドロップダウンで、インライン フックを呼び出すアプリを選択します。



• インライン フックを作成するには、次の詳細が必要です。
  • インラインフックURL: 統合する外部サービスによって提供されるエンドポイントの URL。この URL は、miniorange が HTTP リクエストを送信する場所です。
  • HTTPリクエスト: miniOrange は、インライン フック エンドポイントに送信する HTTP リクエストを構築します。このリクエストには通常、インライン フック サービスに必要なリクエスト メソッド (POST、GET、PUT、DELETE)、ヘッダー、および本文が含まれます。リクエスト メソッドとヘッダーは、インライン フックの特定の要件によって異なる場合があります。
  • 認証： miniOrange のインライン フックは、miniOrange とカスタム コード間の通信を保護するために認証メカニズムに依存しています。3 つのオプションの詳細は次のとおりです。
    • 基本認証： これは、ユーザー名とパスワードの組み合わせを提供するシンプルな認証方法です。miniOrange は、この情報を Base64 エンコードして、インライン フック エンドポイントへのすべてのリクエストの Authorization ヘッダーに送信します。外部サービスは、ヘッダーをデコードしてユーザー名とパスワードを検証し、承認されたアクセスを確実に行える必要があります。
    • HTTP ヘッダー: この方法は、基本認証に比べて柔軟性とセキュリティが向上します。miniOrange インライン フック構成で、カスタム ヘッダー名 (例: X-Api-Key) と対応するシークレット値を定義します。miniOrange は、エンドポイントへのすべてのリクエストにこのヘッダーとシークレット値を含めます。コードでは、このヘッダーの存在を確認し、承認のためにシークレット値を検証する必要があります。
    • 認証なし: このオプションは認証手順をスキップします。miniOrange は資格情報なしでインライン フック エンドポイントにリクエストを送信します。



• 詳しくはこちら 送信.