機械翻訳について

できることの確認

アダプタを構築する前に、Rapid Adapter Builderの機能および制限について理解します。

機能

Rapid Adapter Builderには、ビジネス要件をサポートする多数の機能が用意されています。

機能 詳細情報

アウトバウンドおよびインバウンド統合機能

アダプタでは、次のタイプの統合アクティビティがサポートされています:

  • Oracle Integrationから別のアプリケーションへのアウトバウンド統合。

    たとえば、外部API、データ・ソースまたはアプリケーションにリクエストを送信できます。 リクエストでは、リソースを作成、変更、削除または問合せできます。

  • 別のアプリケーションからOracle Integrationへのインバウンド統合。

    たとえば、個人がオーダーを作成したときなど、状態の変更が発生すると、統合の実行が開始されます。

サポートされているAPI
構築するアダプタは、アプリケーションの次のものと統合できます:
  • パブリックREST API
  • プライベートREST API

    接続エージェントを使用して、データ・センターまたはプライベート・クラウドでホストされているAPIと統合できます。

作成とライフサイクル管理

統合で使用するアダプタを自分またはOracleでビルドするかどうかに関係なく、統合の作成とライフサイクル管理は同じです。 たとえば、上位環境に統合をエクスポート、インポートおよびプロモートするタスクは、アダプタの作成者に関係なく同じです。

データ・モデル拡張のサポート

アダプタは、アプリケーションに存在する標準ビジネス・オブジェクトのカスタム属性の動的取得をサポートできます。 したがって、アプリケーションを拡張した場合、統合開発者は、接続の構成時にモデルをリフレッシュし、最新のスキーマを取得できます。

REST APIサービスの起動時のコンテンツ・タイプのサポート

REST APIサービスの起動時の次のコンテンツ・タイプのサポート:

  • application/JSON
  • application/octet-stream
  • multipart/mixed
  • multipart/form-data

webフック・トリガーのサポート
  • イベント・プロデューサ・アプリケーションで特定の状態の変更が発生したときに、統合の自動開始を容易にするwebフック・トリガーの開発。
  • フローのアクティブ化中のwebフック・トリガーの自動および手動登録のサポート。
  • Oracle Integrationに投稿されている、HMACやRSAなどのデジタル署名付きメッセージの検証のサポート。
  • イベント・プロデューサ・アプリケーションがwebフックの整合性を検証できるように、フライト・リクエストをモデル化するためのサポート。
  • イベントのフィルタリングのサポート。

「トリガー定義の更新」を参照してください。

言語サポート

アダプタ定義ドキュメントでは、次のものを定義できます:

  • Cloud Native Computing Foundation (CNCF)の機能
  • JQ式

「サポートされるCNCFおよびjq関数」を参照してください。

CNCFサーバーレス・ワークフロー仕様から構築

アダプタ定義ドキュメントでは、Cloud Native Computing Foundation (CNCF)プロジェクトのサーバーレス・ワークフロー仕様でサポートされている構成のサブセットを使用して、フロー実装をモデル化できます。

ドメイン固有言語パターンを使用する上位関数

Rapid Adapter Builderには、セキュリティ、メッセージ書式変換ドメインなどにドメイン固有の言語パターンを使用する、次の上位の関数が用意されています:

  • カスタムCNCFサーバーレス・ワークフロー機能
  • カスタムJQ関数

「サポートされるCNCFおよびjq関数」を参照してください。

インバウンド同時レート制限

(インバウンドの)同時レート制限に関するサービス制限は、Rapid Adapter Builderベースのアダプタを使用して起動しているエンドポイントにポストされたインバウンド・リクエストに対して自動的に適用されます。

エンドポイント・ユーザー・エクスペリエンスのモデリング

アクションおよびトリガー固有のエンドポイント構成の両方について、アダプタ定義ドキュメント内の様々なタイプのユーザー・インタフェースを宣言的にモデリングします。

「処理定義の更新」を参照してください。

Visual Studio (VS)コードの拡張

Rapid Adapter BuilderのVS Code拡張機能を使用すると、アダプタ開発作業用の統合開発環境(IDE)としてVS Codeを使用できます。

この拡張により、PostmanコレクションまたはOpenAPIドキュメントをアダプタ定義ドキュメントに変換しやすくなります。 さらに、この拡張機能には、ワークスペースの初期化、検証、コード・スニペットなど、その他のいくつかの機能が用意されています。 この拡張機能は、アダプタをシームレスに作成するためにOracle Integrationと統合されます。

「統合開発環境としてのVS Codeの使用」を参照してください。

セキュリティ

Rapid Adapter Builderでは、インバウンド呼出しとアウトバウンド呼出しの両方に対して、セキュリティ・ポリシーの形式で複数の認証メカニズムをネイティブにサポートします。

セキュリティ機能 サポートされているスキーム

アウトバウンド認証

次の認証および認可スキームは、外部エンドポイントおよびAPIに対する認証に管理対象セキュリティ・ポリシーを使用してネイティブにサポートされます:

  • HTTP Basic認証
  • APIキー・ベース認証
  • OCIシグネチャ・バージョン1
  • OAuth 1.0 1-Legged認証
  • OAuthリソース所有者のパスワード資格証明
  • OAuthクライアント資格証明
  • OAuth承認コード
  • OAuth JWTユーザー・アサーション
  • OAuth JWTクライアント・アサーション

アダプタ内の各接続定義は、1つ以上のアウトバウンド認証スキームをサポートできます。 「接続の起動のセキュリティ・ポリシーについて学習」を参照してください。

インバウンド認証

認証および認可スキームおよびデジタル・シグネチャ検証スキームを含む次のスキームは、インバウンド・リクエストの処理に管理対象セキュリティ・ポリシーを使用してネイティブにサポートされます:

  • Basic認証
  • OAuth 2.0アクセス・トークン
  • HMACシグネチャ検証
  • RSAシグネチャ検証
  • JWT検証

アダプタ内の各接続定義は、1つ以上のインバウンド認証スキーマをサポートできます。 「トリガー接続のセキュリティ・ポリシーについて学習」を参照してください。

OAuth認証の拡張

外部OAuthプロバイダ・フローがRFC 6749互換でない場合、次のOAuth認証スキームを拡張できます:

追加のセキュリティ機能

Rapid Adapter Builderを使用して構築するアダプタには、次の機能があります:

  • OCI Vaultでは、接続によって取得される顧客機密情報を自動的に保護します。

  • TLSで保護されたAPIの呼出し(TLS v1.3)

  • 自己署名証明書またはあまり知られていないCA署名証明書を使用して保護されている外部APIの呼出し

  • アダプタにかわって行われたすべてのアウトバウンド・リクエストが、アダプタ定義ドキュメントでアドバタイズされたドメインに対してのみ行われるようにするためのガードレール

  • 502、503および504に対する自動GETの再試行

  • トランスポート・レベル・セキュリティのないクリア・テキストでのリクエストの送信

    デフォルトでは、非SSLサポートは無効になっています

    ノート:

    トランスポート・レベルのセキュリティなしでクリア・テキストでリクエストを送信するアダプタのセキュリティは低くなります。

拡張性

Rapid Adapter Builderは、構築するアダプタの追加動作を接続するためのネイティブ・サポートを提供します。

アダプタ定義ドキュメントには、追加の動作を接続するための次の拡張ポイントが含まれています。

拡張ポイント サポートされる拡張性

入力/出力

処理またはトリガーの入力および出力スキーマを定義できます。 JSONスキーマの静的値を使用するか、フローをコールしてJSONスキーマを動的に決定できます。

アクションの実行
フローのデフォルト実装を(パススルーとして)拡張し、次のようなより複雑なタスクを実行できます:
  • JQおよびCNCF関数を呼び出します。
  • サードパーティへのコールを実行します。
  • メッセージをOracle IntegrationからAPIが想定する形式に変換します。
  • 受信データを照合して、APIが期待する別のフォームにエンリッチします(データを取得するために他のソースへのアクセスが必要になる場合があります)。
同じフローで、拡張ポイントを使用すると、次のタスクを実行できます:
  • レスポンスをよりわかりやすい形式に解析します。
  • 追加データでレスポンスをエンリッチします。
  • Oracle Integrationの統合に必要なフォームにレスポンスを変換します。

トリガー実行
次のタスクを実行できます。
  • 情報の後処理を実行して、統合の次のアクティビティに送信します。
  • webフック・メッセージ・スキーマが入力メッセージ・スキーマと異なるメッセージ(Oracle Integrationで必要)を変換します。

統合のアクティブ化

イベント・プロデューサまたはソース・アプリケーションの特定のイベントのサブスクリプションおよびwebフックの自動登録を許可します。

統合の非アクティブ化

イベント・プロデューサまたはソース・アプリケーションからの特定のイベントのサブスクリプションまたはwebフックの自動登録解除を許可します。

統合の設計中の接続のテスト

拡張ロジックおよびカスタム・ロジックを使用して、デフォルトのping動作を拡張できます。 たとえば、べき等APIをコールして成功を確認します。

「フローを使用したテスト接続動作の実装」を参照してください。

設計時および実行時に承認および認証

デフォルトでは、OAuth-2ポリシーはRFC 6749と互換性があります。 ただし、多くの実装はRFC標準とは異なります。 拡張可能な管理対象セキュリティ・ポリシーにより、一部のセキュリティ・ポリシーを拡張し、1つ以上のステップをオーバーライドできます。

制限事項

アダプタ定義ドキュメントを使用してアダプタを構築し、アダプタに基づいて接続を作成する場合は、制限に注意してください。

領域 制限事項

アダプタ定義ドキュメント

アダプタ定義ドキュメントには、次の制限があります。

  • CNCFサーバーレス・ワークフロー仕様の一部の構成は、アダプタ定義ドキュメントのフローのモデル化ではサポートされていません。

  • JQ式で使用されるJQ関数の一部はサポートされていません。

  • Oracleは、アダプタ定義ドキュメントのバージョン・サポートを提供していません。

    アダプタをOracle Integrationにプッシュした後、アダプタ定義ドキュメントを更新する必要がある場合は、構築する各アダプタの下位互換性を確保する必要があります。

サポートされていない外部エンドポイントおよびAPIのタイプ

Rapid Adapter Builderを使用して構築するアダプタには、次の制限があります:

  • アダプタは次のものとインタフェースできません:

    • SOAP API、gRPC API、GraphQL APIおよびWebSockets。
    • JDBC、AMQP、MQTT、FTPなど、HTTP以外のプロトコルを使用するエンドポイント。

  • アダプタは、リクエストのコンテンツ・タイプとしてアプリケーション/XMLを受け入れるREST APIを使用できません。

    同様に、アダプタは外部APIからアプリケーション/XMLコンテンツ・タイプのレスポンスを受信できません。

  • アダプタは、認可および認証用のカスタム・セキュリティ・スキームを実装できません。

  • アダプタは、同期リクエスト・パターンおよびレスポンス・パターンに基づくトリガーを使用できません。

  • アダプタは、mTLS (双方向SSL)を使用して保護されている外部REST APIをコールできません。

  • アダプタは、統合を開始するトリガーとしてHTTPベースまたはHTTPベース以外のポーリング・メッセージおよびイベントを使用できません。

制限

Rapid Adapter Builderには、いくつかの領域に制限があります。 制限は、リソースの割当てまたは許容量です。 制限は変更できません。

制限カテゴリ: 一般 | スキーマ | 接続およびセキュリティ・ポリシー | トリガー | アクション | アクション・ランタイム | カテゴリ | ランタイムをトリガー | CNCFフロー

一般

リソース 最小必須 最大許容

Rapid Adapter Builderを使用して作成されたアダプタ・バンドルに含めることができるアダプタ定義ドキュメントのサイズ。

0

10MB

Rapid Adapter Builderを使用して作成された、アダプタ・バンドルに含めることができるOpenAPIドキュメントのサイズ。

0

10MB

Rapid Adapter Builderを使用して作成されたアダプタ・バンドルに含めることができるアダプタ・アイコンのサイズ。

0

100 KB

サービス・インスタンス内のRapid Adapter Builderベースのアダプタ

0

10

アダプタに定義されている許容ドメイン

0

ノート: allowedDomainsが0のアダプタは安全ではありません。

10

アダプタ定義ドキュメント内のアダプタに対して定義されたスキーマ

1

100

スキーマ

リソース 最小必須 最大許容

アダプタ定義ドキュメントで定義されたスキーマ

0

500

接続およびセキュリティ・ポリシー

リソース 最小必須 最大許容

トリガー/アクション接続定義内に定義されたセキュリティ・ポリシー

1

6

接続定義内で定義された非表示の接続プロパティを含むプロパティ

0

10

接続定義内に定義されている非表示でない接続プロパティ

0

10

接続定義内で定義された非表示のプロパティを含むセキュリティ・プロパティ

1

10

接続定義内で定義された非表示のプロパティを除外するセキュリティ・プロパティ

0

5

Triggers

リソース 最小必須 最大許容

アダプタ定義ドキュメント内のアダプタに対して定義された静的トリガー

0

100

単一のトリガー内で構成をトリガー

0

20

アダプタ定義ドキュメント内のトリガー内で定義されたWebフック

0

1

アクション

リソース 最小必須 最大許容

アダプタ定義ドキュメント内のアダプタに対して定義された静的アクション

1

100

単一のアクション内のアクション構成

0

20

アクション・ランタイム

リソース 最大許容

Rapid Adapter Builderベースのアダプタから外部エンドポイントに送信できる構造化ペイロードのサイズ

100MB

外部エンドポイントからRapid Adapter Builderベースのアダプタによるレスポンスとして受信できる構造化ペイロードのサイズ

100MB

外部エンドポイントからRapid Adapter Builderベースのアダプタによるレスポンスの一部として受信できるアタッチメントのサイズ

1 GB

カテゴリ

リソース 最小必須 最大許容

定義済カテゴリ

0

10

ランタイムをトリガー

リソース 最大許容

Rapid Adapter Builderベースのアダプタ・エンドポイントで受信できる構造化ペイロードの最大サイズ

100MB

CNCFフロー

リソース 最小必須 最大許容

州内のCloud Native Computing Foundation (CNCF)アクション

1

10

状態のアクション

1

10

フロー内の状態

1

10

アダプタ内で定義されたフロー

1

100

フローが設計時か実行時かに関係なく、任意のフロー内でconnectivity::restを使用して行われたアウトバウンド呼出し(ネットワーク・コール)

0

4