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

API リクエストの送信

ブラウザ、ファイアウォールや、管理者エンドポイントの Linux コマンドラインインターフェース、Postman などのアプリケーションを使って、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><管理者のユーザー名></Username>
            <Password><管理者のパスワード></Password>
        </Login>
        <Get>
            <IPHost>
            </IPHost>
        </Get>
    </Request>
    
  2. ペイロードファイルを、.xml という拡張子で保存します。

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

その他のリソース