# SOAP認証

WorkatoのSOAPコネクターは、認証タイプに加えて、専用のログイン操作を含むさまざまなWebサービスの認証をサポートしています。接続の設定時に認証を構成します。

# 認証タイプ

認証タイプ 説明
None Webサービスは認証を必要としません。
基本認証 Webサービスはユーザー名とパスワードを必要とします。
WS-Securityユーザー資格情報 WebサービスはUsernameTokenとパスワードを必要とします。

  • パスワードをダイジェストとして送信する: Webサービスがパスワードをダイジェスト(パスワードとタイムスタンプのハッシュ)として送信する場合は、はいを選択します。

メッセージパラメータ Webサービスの認証構造は、認証パラメータを検証するにはパラメータに依存します。

  • パラメータ名: 入力メッセージ内のパラメータの大文字と小文字を区別するパス。SOAP入力メッセージのルートレベルのパーツは、通常、サブパラメータを持つオブジェクトであり、ドットで連結する必要があります。たとえば、parameters.usernameparameters.passwordなどです。
  • パラメータ値: 入力パラメータの値、たとえばuser1password123などです。

APIキー WebサービスはAPIキーを必要とします。

  • APIキー: APIキーの値。
  • APIキーの場所: APIキーの場所。ヘッダー、クッキー、またはクエリパラメータ内にあるかを指定します。
  • APIキーの名前: カスタムAPIキーの名前。デフォルトはヘッダーの場合はX-API-Key、クッキーの場合はX-API-KEY、クエリパラメータの場合はapi_keyです。

NTLM WebサービスはNT LAN Managerを介した認証を必要とします。

  • ユーザー名: 認証に使用するNTLMユーザー名(ドメインなし)。たとえば、domain\userではなくuserを入力します。
  • パスワード: NTLMパスワード。
  • NTLMドメイン: 認証を行うドメイン。
  • NTLMワークステーション: 認証リクエストの発生元となるワークステーション。このマシンのコンピュータ名です。

カスタムHTTPヘッダー Webサービスは、通常のユーザー名とパスワードまたはAPIキー以外の追加のヘッダーを必要とします。

# 専用のログイン操作

専用のログイン操作が必要です 専用のログイン操作が必要です

SOAP接続を構成する際に、専用のログイン操作が必要かどうかを指定できます。ログイン操作は資格情報を検証し、サービスとの後続のやり取りに使用する認証トークンまたはセッション識別子を取得します。ほとんどのSOAP接続では、これは必要ありません。

専用のログインを要求する場合は、専用のログイン操作が必要かどうかフィールドをはいに設定し、以下のフィールドを構成します。

フィールド 説明
ログインバインディング ログイン操作のためのSOAPバインディングの名前。

バインディング名を見つけるには、WSDLファイルでログイン操作を持つバインディングを特定します。たとえば、<wsdl:binding name="MyServiceBinding">では、バインディング名はMyServiceBindingです。名前は大文字と小文字を区別することに注意してください。

ログイン操作 認証トークンまたはサービスとの後続のやり取りに使用するセッション識別子を取得するための操作の名前。

操作名を見つけるには、WSDLファイルのバインディングで定義されたログイン操作を特定します。たとえば、<wsdl:operation name="login">では、操作名はloginです。名前は大文字と小文字を区別することに注意してください。

ログイン結果の処理方法 ログイン操作の結果を後続の操作で使用する方法を指定します。通常、フィールドマッピングが必要です。次のオプションのいずれかを選択します。

  • フィールドを後続の操作にマッピング: この操作から取得した認証トークンまたはセッション識別子を後続の操作の入力として使用します。フィールドを「マップ」するには、どの出力フィールドがどの入力フィールドに対応するかを指定する必要があります。
  • HTTPクッキーを処理: 後続の操作と一緒に送信されるセッションクッキーを要求します。


Last updated: 2024/2/13 16:59:53