次の方法で共有

SOAP 送信ポートを構成する方法

SOAP 送信ポートは、プログラムまたは BizTalk Server 管理コンソールを使用して構成できます。

SOAP 送信ポートをプログラムで構成する方法

BizTalk Explorer オブジェクト モデルは、TransportTypeData の読み取り/書き込みプロパティを持つ ITransportInfo という名前の送信ポート用のアダプター固有のインターフェイスを公開します。 このプロパティは、XML 文字列の名前と値のペアの形式で SOAP 送信ポート構成プロパティ バッグを受け入れます。 BizTalk Explorer オブジェクト モデルでこのプロパティを設定するには、最初に ITransportInfo インターフェイスの OutboundTransportLocation プロパティを設定する必要があります。

ITransportInfo インターフェイスの TransportTypeData プロパティは必要ありません。 設定されていない場合、次の表に示すように、アダプターは SOAP 送信ポート構成の既定値を使用します。

次の表に、SOAP 送信ポート用に BizTalk Explorer オブジェクト モデルで設定できる構成プロパティを示します。

プロパティ名 タイプ 説明
URI 糸 デプロイ サーバー上の Web サービスを含む仮想ディレクトリ。
ユーザー名 糸 ターゲット Web サービスにアクセスするために指定するユーザー名。

既定値: 空白
パスワード 糸 サーバーでの認証に使用するユーザー パスワード。

既定値: 空白
ClientCertificate 糸 クライアント SSL 証明書の拇印。

既定値: 空白
AffiliateApplicationName 糸 クライアント資格情報のチケットの引き換えに使用する SSO アプリケーションの名前。

AffiliateApplicationName は、ユーザー名とパスワードのペアと相互に排他的です。

既定値: 空白
UseProxy の ボーリアン SOAP 送信ポートがプロキシ サーバーを使用してターゲット Web サービスにアクセスするかどうかを示します。 プロキシ サーバーは、すべての SOAP 送信ポートで共有できます。

既定値: False
ProxyAddress 糸 Web サービス呼び出しに使用する HTTP プロキシのアドレス。

既定値: 空白
ProxyPort 整数 Web サービス呼び出しに使用する HTTP プロキシのポート。

既定値: 空白
ProxyUsername 糸 プロキシに使用するユーザー名。

既定値: 空白
ProxyPassword 糸 プロキシに使用するパスワード。

既定値: 空白

次のコードは、これらのプロパティの設定に使用する形式を示しています。

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>

BizTalk Server 管理コンソールで SOAP 送信ポートを構成する方法

BIZTalk Server 管理コンソールで SOAP 送信ポート アダプター変数を設定できます。 送信ポートのプロパティが設定されていない場合は、BizTalk Server 管理コンソールで設定された既定の送信ハンドラー値が使用されます。

SOAP 送信ポートの変数を構成するには

  1. BizTalk Server 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 詳細については、「 送信ポートを作成する方法」を参照してください。 すべての送信ポート オプションを構成し、[全般] タブの [トランスポート] セクションの [種類] オプションに SOAP を指定します。

  2. [全般] タブの [種類] の横にある [トランスポート] セクションで、[構成] をクリックします。

  3. [ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、次の操作を行います。

    これを使用する 目的
    Web サービス URL 呼び出す Web サービスのアドレスを指定します。 手記： 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
    認証 呼び出す Web サービスによって使用される認証方法を示します。

    オプション:

    - アノニマス。 既定の設定。
    - 基本的な。 SOAP 接続は、ユーザー名とパスワードをプレーン テキストで送信します。
    - ダイジェスト。 SOAP 接続は、暗号化された形式でパスワードを送信します。
    - NTLM . ユーザー名もパスワードも SOAP 接続経由では送信されません。 SOAP アダプターは、この認証の種類に対して SOAP 送信アダプターを実行するプロセスの資格情報を常に使用します。
    資格情報 使用する資格情報の種類を指定します。

    認証の種類が Basic または Digest の場合にのみ使用できます。

    オプション:

    - シングル サインオンを使用しない
    ユーザー名
    移行先サーバーでの認証に使用するユーザー名。 [認証の種類] プロパティが [匿名] または [NTLM] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Enterprise Single Sign-On が使用されていない場合、このプロパティには値が必要です。
    最小長: 0
    最大長: 256
    パスワード
    移行先サーバーでの認証に使用するパスワード。 [認証の種類] プロパティが [匿名] または [NTLM] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Single Sign-On が使用されていない場合、このプロパティには値が必要です。
    最小長: 0
    最大長: 256
    - シングル サインオンを使用する
    単一 Sign-On を使用して、移行先サーバーでの認証用のクライアント資格情報を取得するかどうかを指定します。
    関連アプリケーション
    シングル サインオンに使用する関連アプリケーションを指定します。 この一覧の設定の詳細については、「 SSO 関連アプリケーション」を参照してください。
    最小長: 0
    最大長: 256
    クライアント証明書の拇印 接続の確立に使用するクライアント証明書の拇印を指定します。

    例: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    最小長: 0

    最大長: 59

  4. [ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ プロキシ ] タブで、次の操作を行います。

    これを使用する 目的
    ハンドラーの既定のプロキシ構成を使用する 送信ポート プロキシ ハンドラーの構成を指定します。 true の場合、ポートはハンドラー レベルで指定されたプロキシ設定を使用します。 false の場合、送信アダプターは送信ポートで指定されたプロキシ情報を使用します。

    既定の設定は true です。
    プロキシを使用しない SOAP 送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。
    [プロキシを使用する] SOAP 送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。 プロキシ サーバーは、すべての SOAP 送信ポートで共有できます。
    サーバー プロキシ サーバーの名前を指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256
    ポート SOAP 送信ハンドラーが使用するポートを指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    既定値: 80

    型: Long

    最小値: 0

    最大値: 65535 注: 値 0 を指定すると、既定値 (ポート 80) が使用されます。
    ユーザー名 認証に使用するユーザー名を指定します。 Windows 統合認証を使用する場合、ユーザー名にはドメイン、 ___domain\username が含まれます。 基本認証またはダイジェスト認証を使用する場合、ユーザー名に ドメインは含まれません。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256
    パスワード 認証に使用するパスワードを指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256

  5. [ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ Web サービス ] タブで、次の操作を行います。

    これを使用する 目的
    オーケストレーション Web ポート [ 全般 ] タブに一覧表示されている Web サービス URL で公開されている Web サービスを使用するように指定します。

    これが既定の設定です。
    アセンブリ名 Web サービス プロキシを含むアセンブリの名前を指定します。 このフィールドは、参照ボタンをクリックしてアセンブリを検索することで設定できます。 アセンブリを選択すると、このボックスにアセンブリの完全修飾名が設定されます。 手記： 指定したアセンブリは、実行時にすべての BizTalk Server に存在する必要があります。
    型名 呼び出す Web メソッドを含むクラスの名前を指定します。 これは、アセンブリに含まれる型の一覧から選択できます。
    メソッド名 リスト ボックスでいずれかのメソッドを指定するか、[後で指定] オプションを選択します。 [後で指定する] オプションを選択した場合は、パイプライン コンポーネントなどの他の方法で Web メソッドを設定する必要があります。 このシナリオでは、Web メソッドを Soap Adapter MethodName コンテキスト プロパティに書き込む必要があります。
    SOAP 1.2 SOAP 1.2 プロトコルをサポートするプロキシ コードを生成するように指定します。 このオプションをオフのままにすると、SOAP 1.1 準拠のプロキシ コードが生成されます。

    既定値: クリア

  6. [ OK] を クリックし、もう一度 [OK] を クリックして設定を保存します。

こちらもご覧ください

Web サービスの公開