
すべての接続が独自のスクリプトになるとき
ほとんどの企業は、自社で運用していないサービスに依存しています。CRM、運送会社や3PL物流プロバイダー、税務プラットフォーム、KYC・AMLスクリーニング、SaaSツールです。それぞれに独自のAPI、制限、障害の仕方があります。
一つずつ接続していくと、誰も全体を理解していない点と点のスクリプト群になります。パートナーがAPIを変更し、夜間にメッセージが失われ、最初の兆候は顧客からの苦情です。
変わること
スクリプトの網ではなく一つのレイヤー
システムが一つの統制されたレイヤーを通じてイベントを公開・受信するため、パートナーの追加ですべてのシステムに手を入れる必要がありません。
失われず、重複しない
冪等な書き込み、バックオフ付き再試行、デッドレターキューにより、障害は失われるのではなく捕捉・再処理されます。
すべてのフローを可視化
パートナーごとのトレース、エラー率、レイテンシー。どのパートナーがどう失敗したかを示すアラート付き。
提供内容
APIゲートウェイ
公開するAPIのための一つの統制された玄関。認証、レート制限、クォータ、バージョニング、利用分析。
イベントメッシュとエンタープライズサービスバス
イベントメッシュは、システムや拠点間でリアルタイムにイベントをルーティングするブローカーのネットワークです。既存環境がエンタープライズサービスバス(ESB)で動いている場合は、その設計・拡張も行います。
BPMNワークフロー自動化
オンボーディングや承認など、システムと人をまたぐプロセスをBPMN(Business Process Model and Notation)でモデル化し、ワークフローエンジンで実行します。
サードパーティ・エコシステムのコネクター
CRM、3PL物流、税務、KYC・AMLプロバイダー向けに、REST、SOAP、Webhook、またはiPaaS(Integration Platform as a Service)によるコネクターを提供します。
API契約とバージョニング
各インターフェースのOpenAPIまたはWSDL定義。フィールドルール、エラーコード、制限、パートナーの変更を吸収するポリシーを含みます。
IDとシークレット
OpenID ConnectまたはSAMLによるシングルサインオン、OAuth 2.0によるサービスアクセス、スコープとローテーションを備えたシークレット保管庫の認証情報。
信頼性と監視
冪等キー、再試行、デッドレターキュー、すべての例外に対する人の運用経路、パートナーごとのダッシュボードとアラート。
私たちの進め方
棚卸し
依存するシステムとパートナー、それぞれが必要とするデータ、現在見られる障害を洗い出します。
レイヤーを設計
API契約を書き、フローごとに直接呼び出し、イベント、ESB、連携プラットフォームのいずれかを選びます。
コネクターを構築
各コネクターを、エラー処理、重複防止、ログ記録を最初から備えて構築します。
各パートナーとテスト
各パートナーのテスト環境で、障害ケースを含む契約テストとエンドツーエンドシナリオを実行します。
安全にリリース
段階的にリリースし、新しい経路が実証されるまで旧経路を利用可能に保ちます。
運用と適応
エラー率とデッドレターを監視し、パートナーがAPIを変更したらコネクターを適応させます。
横にスクロールすると図全体を確認できます。
ERPから外部パートナーへ:一つのプラットフォーム、多数の相手
業務イベントはERPを一度だけ出て、連携プラットフォームが各パートナーの期待する形式で届けます。コールバックも同じ経路で戻ります。再試行しても失敗するメッセージはデッドレターキューに入り、ペイロードを添えたアラートが上がります。
- 主要フロー
- 非同期
- 例外経路
9ステップのフロー
フローを順に示す
- ERPから連携プラットフォームへ:業務イベント、REST · OData · webhook経由(主要フロー)。
- 連携プラットフォームからCRMへ:顧客と注文、REST/JSON経由(主要フロー)。
- 連携プラットフォームから物流と運送会社へ:出荷の予約、REST/JSON経由(主要フロー)。
- 物流と運送会社から連携プラットフォームへ:追跡イベント、webhook経由(非同期)。
- 連携プラットフォームから電子インボイス・税務プラットフォームへ:クリアリング用の請求書、SOAP/XML · REST経由(主要フロー)。
- 連携プラットフォームからKYC・本人確認プロバイダーへ:本人確認、REST/JSON経由(主要フロー)。
- KYC・本人確認プロバイダーから連携プラットフォームへ:確認結果、webhook経由(非同期)。
- 連携プラットフォームからデッドレターキューとアラートへ:再試行後も失敗。デッドレターキューへ(例外経路)。
- デッドレターキューとアラートからサポートチームへ:ペイロードとエラー付きのアラート(例外経路)。
プロトコル、プラットフォーム、標準
すでに連携プラットフォームをお持ちの場合は、その上に構築します。製品名の記載は、そのベンダーとのパートナーシップを意味しません。
- データと分析
- Apache Kafka
- 連携
- REST
- SOAP
- GraphQL
- Webhooks
- OpenAPI
- MuleSoft
- Boomi
- Azure Logic Apps
- Apache Camel
- RabbitMQ
- IDとアクセス
- OAuth 2.0
- OpenID Connect
- SAML 2.0
- SCIM
- Keycloak
- Microsoft Entra ID
- 医療標準
- HL7 v2
- HL7 FHIR
本番での実績
湾岸協力会議(GCC)のティア1銀行・地域複合企業向けに、Apache Kafka上のイベント駆動ミドルウェアメッシュを構築しました。SAP S/4HANAを銀行・税務当局に接続し、シークレットはHashiCorp Vaultに保持しています。
始め方
パートナーとフローのリストが明確な場合は直接提案に進みます。文書化されていない既存連携の網はBrownfield Diagnostic Bridgeから始まります。
今後の流れ
事前コンサルティングセッション
無料の30分オンライン事前相談です。目標、システム、制約を伺います。
準備状況レビュー
無料の48時間準備状況レビューで、プリンシパルアーキテクトがプロジェクトを6項目のDefinition of Readyに照らして確認し、適切なトラックを提案します。
トラックの選択
スコープが確定したプロジェクトには、拘束力のある提案書を3–5営業日以内にお渡しします。構想段階のプロジェクトはBlueprint Studioから始まります。稼働中のシステムに障害がある場合、文書化されていない場合、連携が必要な場合は、1–2週間の診断から始まります。Blueprint Studioと診断はそれぞれ固定料金で、提案書に記載します。
5段階での提供
体制の立ち上げ、ライブ実演を伴うスプリント、連携と堅牢化、受け入れと本番稼働、そしてマネージドサービス。ローンチ後は保証期間と、その後の任意のサポート・保守が待っています。
よくある質問
連携プラットフォームとカスタムコードのどちらを使うべきですか。
接続数と、誰が運用するかによります。MuleSoft、Boomi、Azure Logic Appsなどの連携プラットフォームは、既製のコネクター、マッピング、監視を一か所で提供しますが、ライセンス費用がかかります。カスタムサービスは完全な制御とライセンス不要を提供しますが、保守するコードが増えます。お客様のケースで両者を比較します。
ESBとイベントメッシュの違いは何ですか。
エンタープライズサービスバスは、中央ハブを通じてメッセージをルーティング・変換します。イベントメッシュは、接続されたブローカーのネットワークを通じてイベントを分散し、異なるクラウドや拠点のシステムが直接公開・購読します。多くの環境は移行期間中に両方を運用します。
パートナーのAPIが停止したらどうなりますか。
一時的な理由で失敗したリクエストは、待ち時間を増やしながら再試行します。すべての書き込みに冪等キーが付くため、再試行で注文や請求書が二重に作られることはありません。それでも失敗するメッセージは、ペイロードとエラーとともにデッドレターキューへ送られます。アラートがチームに届き、パートナーが復旧した後にメッセージを再処理します。
APIのバージョン変更にどう対応しますか。
公開するAPIはバージョン管理し、旧バージョンを合意期間中稼働させ、利用者に変更を伝えます。呼び出すAPIは、各パートナーの非推奨通知を追い、サンドボックスで新バージョンをテストします。契約テストにより、告知のない変更が本番に届く前に検出します。
当社のIDプロバイダーを接続できますか。
はい。Microsoft Entra IDやKeycloakなどのプロバイダーを通じて、OpenID ConnectまたはSAML 2.0によるシングルサインオンを追加します。アプリケーションが対応する場合はSCIMでユーザーをプロビジョニングします。アクセスの付与と削除は、お客様のIDプロバイダーを唯一の場所として行います。
レート制限にはどう対処しますか。
各パートナーが公表する制限を前提に設計します。APIが許す場合はリクエストをバッチ化し、ほとんど変わらないデータをキャッシュし、定期ジョブを分散し、制限に近づいたらバックオフします。監視により、各フローが制限にどれだけ近いかを示します。
構築の準備はできていますか。提案をお求めください
要件またはRFPをお送りください。当社のアーキテクトが検証し、拘束力のある固定スコープの提案をお返しします。
今後の流れ
準備状況レビュー
無料の48時間準備状況レビューで、プリンシパルアーキテクトがプロジェクトを6項目のDefinition of Readyに照らして確認し、適切なトラックを提案します。
拘束力のある提案書
アーキテクチャ検証の後、マイルストーン、アーキテクチャ、チーム体制、SLAを含む、拘束力のある固定スコープの提案書を3–5営業日以内にお渡しします。ご要望があれば、要件をお知らせいただく前に秘密保持契約(NDA)を締結します。
立ち上げ
ご契約後、当社のエンジニアリングポッドが契約締結から5–10営業日以内にスプリント0を開始します。
5段階での提供
体制の立ち上げ、ライブ実演を伴うスプリント、連携と堅牢化、受け入れと本番稼働、そしてマネージドサービス。ローンチ後は保証期間と、その後の任意のサポート・保守が待っています。
