FHIRコネクタ > FHIRへの接続 > FHIR接続
  

FHIR接続

FHIRサーバーに接続するようにFHIRの接続プロパティを設定してみましょう。

接続の詳細

次の表に、基本接続プロパティを示します。
プロパティ
説明
接続名
接続の名前。
各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -,
最大長は255文字です。
説明
接続の説明。最大長は4000文字です。
タイプ
FHIR
ランタイム環境
タスクを実行するランタイム環境の名前。Secure Agentを選択します。
ホスト
FHIRサーバーのホスト名またはIPアドレス(ポート番号を含む)。
次の形式で値を入力します。host_nameは、ホスト名またはIPアドレスにできます。
host_name:port_number
HTTPメソッド
要求の送信に使用されるHTTPメソッド。
次のいずれかのHTTP方式を選択します。
  • - HTTP
  • - HTTPS
デフォルトはHTTPです。
接続タイムアウト
サーバーへの接続を試行するときに待機する最大秒数。指定された時間内に接続が成功しない場合はタイムアウトが発生します。
値が0または空白の場合、待機時間は無限です。
デフォルトは30秒です。
キープアライブ
複数のHTTP要求または応答に対して接続を開いたままにするかどうかを示します。
デフォルトはtrueです。
リダイレクトのフォロー
接続の作成時にリダイレクトリンクをたどるかどうかを示します。
デフォルトはtrueです。
接続の再試行
接続に成功しなかった場合に、FHIRサーバーへの接続を再試行する回数。この設定は、最初の接続と接続の切断による再接続の試行の両方に適用されます。
デフォルトは0です。
接続再試行の間隔
接続の再試行ごとに待機する秒数。
例えば、5秒間隔で最大10回の接続を再試行する場合は、[接続の再試行]を10に設定し、[接続再試行の間隔]を5に設定します。
デフォルトは0です。
基本パス
FHIRサーバーの基本パス。APIの最初のURLセグメント。
テスト接続のリソースパス
接続をテストするためにベースパスに追加するリソースパス。
コンテンツタイプ
要求のメディアタイプ。
次のいずれかのオプションを選択します。
  • - application/fhir+xml
  • - application/fhir+json
  • - application/xml
  • - application/json
承認
応答のメディアタイプ。
次のいずれかのオプションを選択します。
  • - application/fhir+xml
  • - application/fhir+json
  • - application/xml
  • - application/json
追加のヘッダー
接続に必要な追加のヘッダー。
ヘッダーをJSON形式で定義します。例:
[{"Name":"Content-Type","Value":"application/fhir+json"},{"Name":"accept","Value":"text/xml"}]
認証タイプ
コネクタがRESTエンドポイントに接続するために使用する必要のある認証方法。
次のいずれかのオプションを使用できます。
デフォルトは[なし]です。
トラストストアのファイルパス
REST APIとの一方向または双方向の安全な接続を確立するためのTLS証明書を含むトラストストアファイルの絶対パス。
トラストストアファイルが.jks形式であることを確認してください。各Secure Agentマシンのランタイム環境で使用可能なディレクトリパスを指定します。
トラストストアのパスワード
SSL証明書を含むトラストストアファイルのパスワード。
キーストアのファイルパス
REST APIとの双方向の安全な接続を確立するために必要なキーと証明書を含むキーストアファイルの絶対パス。
キーストアファイルが.jks形式であることを確認してください。各Secure Agentマシンのランタイム環境で使用可能なディレクトリパスを指定します。
キーストアのパスワード
安全な通信に必要なキーストアファイルのパスワード。
プロキシタイプ
プロキシのタイプ。
以下のいずれかのオプションを選択することができます。
  • - プロキシなし。エージェントレベルまたは接続レベルで設定されたプロキシサーバーをバイパスします。
  • - プラットフォームプロキシ。エージェントレベルで設定したプロキシが考慮されます。
  • - カスタムプロキシ。接続レベルで設定したプロキシが考慮されます。
サーバーレスランタイム環境を使用する場合は適用されません。
プロキシ設定
プロキシサーバーのホスト名またはIPアドレス(ポート番号を含む)。
次の形式で値を入力します。host_nameは、ホスト名またはIPアドレスにできます。
host_name:port_number

認証タイプ

FHIRサーバーにアクセスするための基本認証、OAuth 2.0認証コード、OAuth 2.0クライアント資格情報認証を設定することができます。
必要な認証方法を選択し、認証固有のパラメータを設定します。

基本認証

基本認証には、FHIRサーバーからのユーザー名とパスワードが必要です。
次の表に、標準認証の基本的な接続プロパティとその説明を示します。
プロパティ
説明
認証ユーザーID
Webサービスアプリケーションにログインするためのユーザ名。
認証パスワード
ユーザ名に関連付けられているパスワード。

OAuth 2.0認証コード認証

OAuth 2.0認証コードを使用するようにFHIR接続の認証プロパティを設定します。
認証コードの認証を使用するには、アプリケーションで次のInformaticaリダイレクトURLを登録します。
https://<Informatica cloud hosting facility for your
organization>/ma/proxy/oauthcallback
アクセストークンの有効期限が切れ、応答でエラーコード400、401、または403を受け取った場合、InformaticaリダイレクトURLはエンドポイントに接続して新しいアクセストークンを取得するよう試みます。InformaticaリダイレクトURLは通常、組織のファイアウォールの外側にあることに注意してください。
次の表では、OAuth 2.0認証コードを使用するFHIR接続の認証プロパティについて説明します。
プロパティ
説明
認証トークンURL
アプリケーションで設定されている認証サーバーURL。
アクセストークンURL
アプリケーションで設定されているアクセストークンURL。
クライアントID
アプリケーションのクライアントID。
クライアントシークレット
アプリケーションのクライアントシークレット。
スコープ
APIエンドポイントでカスタムスコープが定義されている場合に、アクセス制御を指定します。スコープ属性はスペースで区切ります。
例: root_readonly root_readwrite manage_app_users
アクセストークンパラメータ
アクセストークンURLで使用する追加パラメータ。パラメータをJSON形式で定義します。
例: [{"Name":"resource","Value":"https://<serverName>"}]
認証コードパラメータ
認証トークンURLで使用する追加パラメータ。パラメータをJSON形式で定義します。
例: [{"Name":"max_age","Value":60},{"Name":"state","Value":"test"}]
クライアント認証
認証のために要求本文または要求ヘッダーのいずれかでクライアントIDとクライアントシークレットを送信するオプションを選択します。
デフォルトは、[本文でクライアント資格情報を送信する]です。
アクセストークン
アクセストークンの値を入力するか、[アクセストークンの生成]をクリックして、アクセストークンの値を指定します。
プロキシサーバー経由でアクセストークンを生成するには、Secure Agent上で未認証のプロキシサーバーを構成します。FHIR接続レベルのプロキシ構成は、アクセストークンの生成時には適用されません。
更新トークン
リフレッシュトークンの値を入力するか、[アクセストークンの生成]をクリックして、リフレッシュトークンの値を指定します。アクセストークンが有効でないか、有効期限切れの場合、Secure Agentは、リフレッシュトークンを使用して新しいアクセストークンを生成します。
リフレッシュトークンが期限切れの場合は、有効なリフレッシュトークンを入力するか、[アクセストークンの生成]をクリックして新しいリフレッシュトークンを生成します。

OAuth 2.0クライアント資格情報認証

OAuth 2.0クライアント資格情報を使用するようにFHIR接続の認証プロパティを設定します。
次の表では、OAuth 2.0クライアント資格情報を使用するFHIR接続の認証プロパティについて説明します。
プロパティ
説明
アクセストークンURL
アプリケーションで設定されているアクセストークンURL。
クライアントID
アプリケーションのクライアントID。
クライアントシークレット
アプリケーションのクライアントシークレット。
スコープ
APIエンドポイントでカスタムスコープが定義されている場合に、アクセス制御を指定します。スコープ属性はスペースで区切ります。
例: root_readonly root_readwrite manage_app_users
アクセストークンパラメータ
アクセストークンURLで使用する追加パラメータ。パラメータをJSON形式で定義します。
例: [{"Name":"resource","Value":"https://<serverName>"}]
クライアント認証
認証のために要求本文または要求ヘッダーのいずれかでクライアントIDとクライアントシークレットを送信するオプションを選択します。
デフォルトは、[本文でクライアント資格情報を送信する]です。
アクセストークン
アクセストークンの値を入力するか、[アクセストークンの生成]をクリックして、アクセストークンの値を指定します。
プロキシサーバー経由でアクセストークンを生成するには、Secure Agent上で未認証のプロキシサーバーを構成します。FHIR接続レベルのプロキシ構成は、アクセストークンの生成時には適用されません。