コンテンツにスキップ
Sophos XG シリーズのハードウェアアプライアンスは、2025年 3月 31日にサポート終了 (EOL) となります。XG から XGS への移行に関しては、こちらをクリックしてください。

API リクエストの送信

Web ブラウザ、お使いのエンドポイントまたはファイアウォールの Linux コマンドラインインターフェース、または Postman などのアプリケーションを使って、API リクエストを送信できます。

Postman または Linux コマンドラインを使って API リクエストを送信する例を以下に示します。

Postman アプリケーションから API リクエストを送信するには、次の手順に従います。

  1. コレクション」のプラスボタンをクリックして、新しいコレクションを作成します。

    新しい Postman コレクションを追加する。

  2. コレクションの「Add a request」をクリックします。

    コレクションに新しいリクエストを追加する。

  3. New Request」で、次の構文を使用してファイアウォールの詳細を入力します。

    https://<ファイアウォールの IP アドレスまたはホスト名>:<ファイアウォールのポート>/webconsole/APIController
    

    Postman でリクエストを送信する。

  4. Body」をクリックし、「form-data」を選択します。

    Postman の Body と form-data。

  5. Key」に reqxml と入力します。

  6. Value」に、リクエストを送信する構文を次の例のように指定します。

    <Request>
        <Login>
            <Username><管理者のユーザー名></Username>
            <Password><管理者のパスワード></Password>
        </Login>
        <Set operation="add">
            <IPHost>
                <Name>IPaddress</Name>
                <IPFamily>IPv4</IPFamily>
                <HostType>IP</HostType>
                <IPAddress>1.1.1.1</IPAddress>
            </IPHost>
        </Set>
    </Request>
    
  7. 送信」をクリックします。

Linux エンドポイントまたはファイアウォールのコマンドラインから API リクエストを送信するには、次の手順に従います。

  1. メモ帳などのテキストエディタを開き、送信するペイロードを入力します。

    IP ホストを取得するリクエストの例を以下に示します。

    <Request>
        <Login>
            <Username>Jane</Username>
            <Password>PQR@!xyz</Password>
        </Login>
        <Get>
            <IPHost>
            </IPHost>
        </Get>
    </Request>
    
  2. ペイロードファイルを、.xml という拡張子で保存します。

  3. 次の構文に従ってペイロードを送信します。
curl -k https://<ファイアウォールの IP アドレスまたはホスト名>:<ファイアウォールのポート>/webconsole/APIController -F "reqxml=<{payload file.xml}"

curl -k https://172.16.16.16:4444/webconsole/APIController -F "reqxml=<FileXYZ.xml"