SOAP 送信ポートを構成する方法
SOAP 送信ポートは、プログラムから、または BizTalk Server 管理コンソールを使用して構成できます。
プログラムから SOAP 送信ポートを構成する方法
BizTalk エクスプローラー オブジェクト モデルは、TransportTypeData の読み取り/書き込みプロパティを持つ ITransportInfo という名前の送信ポート用のアダプター固有のインターフェイスを公開します。 このプロパティでは、名前と値の組の XML 文字列の形式で SOAP 送信ポートの構成プロパティ バッグを指定できます。 BizTalk エクスプローラー オブジェクト モデルでこのプロパティを設定するには、最初に ITransportInfo インターフェイスの OutboundTransportLocation プロパティを設定する必要があることに注意してください。
ITransportInfo インターフェイスの TransportTypeData プロパティは必要ありません。 このプロパティを設定しない場合、アダプタでは、次の表に記載されている SOAP 送信ポートの構成の既定値が使用されます。
次の表に、SOAP 送信ポートの BizTalk エクスプローラー オブジェクト モデルで設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 |
|---|---|---|
| URI | String | 展開サーバーの Web サービスを含んでいる仮想ディレクトリです。 |
| ユーザー名 | String | 対象の Web サービスにアクセスするために指定するユーザー名です。 既定値: 空白 |
| パスワード | String | サーバーでの認証に使用するユーザーのパスワード。 既定値: 空白 |
| ClientCertificate | String | SSL クライアント証明書の拇印です。 既定値: 空白 |
| AffiliateApplicationName | String | チケットをクライアントの資格情報と引き換えるために使用する SSO アプリケーションの名前です。 AffiliateApplicationName は、ユーザー名とパスワードのペアに相互に排他的です。 既定値: 空白 |
| UseProxy | Boolean | SOAP 送信ポートで、対象の Web サービスへのアクセスにプロキシ サーバーを使用するかどうかを示します。 プロキシ サーバーはすべての SOAP 送信ポートで共有できます。 既定値: False |
| ProxyAddress | String | Web サービスの呼び出しに使用する HTTP プロキシのアドレスです。 既定値: 空白 |
| ProxyPort | Integer | Web サービスの呼び出しに使用する HTTP プロキシのポートです。 既定値: 空白 |
| ProxyUsername | String | プロキシに使用するユーザー名です。 既定値: 空白 |
| ProxyPassword | String | プロキシに使用するパスワードです。 既定値: 空白 |
次のコード例は、上記のプロパティの設定に使用する形式を示しています。
<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 送信ポートの変数を構成するには
BizTalk Server管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 詳細については、「 送信ポートを作成する方法」を参照してください。 すべての送信ポート オプションを構成し、[全般] タブの [トランスポート] セクションで [種類] オプションに SOAP を指定します。
[全般] タブの [種類] の横にある [トランスポート] セクションで、[構成] をクリックします。
[ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、次の操作を行います。
プロパティ 目的 Web サービス URL 呼び出す Web サービスのアドレスを指定します。 メモ： 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。 認証 呼び出している Web サービスで使用される認証方法を示します。
オプション:
- 匿名。 既定の設定。
- 基本的な。 SOAP 接続は、ユーザー名とパスワードをプレーンテキストで送信します。
- ダイジェスト。 SOAP 接続は、暗号化された形式でパスワードを送信します。
- Ntlm。 ユーザー名とパスワードはどちらも SOAP 接続経由で送信されます。 SOAP アダプタは常に、SOAP 送信アダプタがこの認証の種類に対して実行するプロセスの資格情報を使用します。資格情報 使用する資格情報の種類を指定します。
[認証の種類] が [基本] または [ダイジェスト] の場合にのみ使用できます。
オプション:
- シングル サインオンを使用しない
ユーザー名
移行先サーバーでの認証に使用するユーザー名。 [認証の種類] プロパティが [匿名] または [NTLM] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Enterprise Single Sign-On が使用されていない場合、このプロパティには値が必要です。
最小長: 0
最大長: 256
パスワード
接続先のサーバーで認証に使用するパスワードを指定します。 [認証の種類] プロパティが [匿名] または [NTLM] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Single Sign-On が使用されていない場合、このプロパティには値が必要です。
最小長: 0
最大長: 256
- シングル サインオンを使用する
接続先のサーバーでの認証でクライアントの資格情報を取得する際に、シングル サインオンを使用するかどうかを指定します。
[関連アプリケーション]
シングル サインオンに使用する関連アプリケーションを指定します。 この一覧の設定の詳細については、「 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[ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ プロキシ ] タブで、次の操作を行います。
プロパティ 目的 [ハンドラの既定のプロキシ構成を使用する] 送信ポートのプロキシ ハンドラの構成を指定します。 true の場合、ポートはハンドラー レベルで指定されたプロキシ設定を使用します。 False に設定されている場合、送信アダプタが送信ポートで指定されたプロキシ情報を使用します。
既定値の設定は true です。[プロキシを使用しない] SOAP 送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。 [プロキシを使用する] SOAP 送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。 プロキシ サーバーはすべての SOAP 送信ポートで共有できます。 サーバー プロキシ サーバーの名前を指定します。
このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256ポート SOAP 送信ハンドラーが使用するポートを指定します。
このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。
既定値: 80
型: 長整数
最小値: 0
最大値: 65535 注: 値 0 を指定すると、既定値 (ポート 80) が使用されます。ユーザー名 認証に使用するユーザー名を指定します。 Windows 統合認証を使用する場合、ユーザー名にはドメイン domain \username が含まれます。 基本認証またはダイジェスト認証を使用する場合、ユーザー名には domain\ は含まれません。
このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256パスワード 認証に使用するパスワードを指定します。
このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256[ SOAP トランスポートのプロパティ ] ダイアログ ボックスの [ Web サービス ] タブで、次の操作を行います。
プロパティ 目的 [オーケストレーション Web ポート] [ 全般 ] タブに一覧表示されている Web サービス URL で公開されている Web サービスを使用するように指定します。
これが既定の設定です。[アセンブリ名] Web サービスのプロキシを含んでいるアセンブリの名前を指定します。 アセンブリを検索する参照ボタンをクリックして、このフィールドを設定できます。 アセンブリを選択すると、このボックスにアセンブリの完全修飾名が設定されます。 メモ： 指定したアセンブリは、実行時にすべての BizTalk サーバーに存在する必要があります。 型名 呼び出す Web メソッドを含むクラスの名前を指定します。 このクラスは、アセンブリに含まれている型の一覧から選択できます。 メソッド名 リスト ボックスに表示されているいずれかのメソッドを指定するか、[後で指定する] を選択します。 [後で指定する] を選択した場合は、パイプライン コンポーネントなど、他の方法で Web メソッドを設定する必要があります。 このシナリオでは、Web メソッドを Soap Adapter MethodName コンテキスト プロパティに書き込む必要があります。 SOAP 1.2 SOAP 1.2 プロトコルをサポートするプロキシ コードを生成する場合に指定します。 このオプションをオフのままにした場合は、SOAP 1.1 準拠のプロキシ コードが生成されます。
既定値: クリア済み[ OK] を クリックし、もう一度 [OK] を クリックして設定を保存します。