SOAP認証

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

WorkatoのSOAPコネクターは、専用ログインオペレーションに加えて、さまざまなWebサービス認証タイプをサポートしています。 コネクションを設定するときに認証を設定します。

認証タイプ

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

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

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

  • パラメーター名: 入力メッセージ内のパラメーターの大文字と小文字を区別するパス。 SOAP入力メッセージのルートレベル部分は通常、サブパラメーターを持つオブジェクトであり、parameters.usernameまたはparameters.passwordのようにドットで連結する必要があることに注意してください
  • パラメーター値: user1またはpassword123などの入力パラメーターの値

APIキーWebサービスにはAPIキーが必要です。

  • APIキー: APIキーの値。
  • APIキーの場所: APIキーが配置されている場所: ヘッダー、Cookie、またはクエリパラメーター。
  • APIキーの名前: カスタムAPIキー名。 デフォルト: ヘッダーにはX-API-Key、CookieにはX-API-KEY、クエリパラメーターにはapi_key

NTLMWebサービスにはNT LAN Managerによる認証が必要です。

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

カスタムHTTPヘッダーWebサービスには、通常のユーザー名とパスワードまたはAPIキーに加えて、追加のヘッダーが必要です。

専用ログインオペレーション

専用ログインオペレーションが必要専用ログインオペレーションが必要

SOAPコネクションを設定するときに、専用ログインオペレーションが必要かどうかを指定できます。 ログイン操作は認証情報を検証し、サービスとの以降のやり取りに使用する認証トークンまたはセッション識別子を取得します。 ほとんどのSOAPコネクションでは必要ありません。

専用ログインを必須にするには、Require dedicated login operationフィールドをYesに設定し、次のフィールドを設定します:

フィールド説明
ログインバインディングログインオペレーション用のSOAPバインディングの名前。

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

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

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

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

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

Last updated: