Skip to content

Set up Wi-Fi with Postman

This tutorial explains how to use Postman to configure Wi-Fi through Redfish API.


Prerequisites

If you're using the ERMI module, please ensure the DIP switch is configured correctly.

alt text


Step 1: Create a Redfish Session

Request
- Method: POST
- URL: redfish/v1/SessionService/Sessions

Body:

{
  "UserName": "admin",
  "Password": "admin"
}

Response:

{
  "SessionToken": "458942610",
  ...
}

Copy the SessionToken value and assign it to the variable apiKey for all subsequent requests.

alt text


Step 2: Retrieve Wi-Fi Configuration

Request
- Method: GET
- URL: redfish/v1/Managers/BMC/WirelessInterfaces/WiFi

Response Example:

{
  "Id": "WiFi",
  "Enabled": false,
  "Status": { "State": "Enabled", "Health": "OK" }
}

If "Enabled": false, proceed to Step 3.

alt text


Step 3: Enable the Wi-Fi Interface

Request
- Method: PATCH
- URL: redfish/v1/Managers/BMC/WirelessInterfaces/WiFi

Body:

{
  "Enabled": true
}

Expected Response:

204 No Content

Re-run Step 2 to confirm "Enabled": true.

alt text


Step 4: Scan for Available Wi-Fi Networks

Request
- Method: POST
- URL: redfish/v1/Managers/BMC/Oem/ERMI/WirelessInterfaces/WiFi/Actions/ScanNetworks

Body: none

Response Example:

{
  "SSID": "YourNetwork",
  "SignalStrength": -55,
  "Security": "[WPA2-PSK-CCMP][ESS]"
}

Identify the SSID you want to connect to.

alt text


Step 5: Connect to a Wi-Fi Network

Request
- Method: POST
- URL: redfish/v1/Managers/BMC/Oem/ERMI/WirelessInterfaces/WiFi/Actions/Connect

Body:

{
  "SSID": "YourNetwork",
  "Passphrase": "YourPassword"
}

Response Example:

{
  "SignalStrength": -55,
  "SSID": "YourNetwork",
  "IPAddress": "172.20.10.2"
}

If an IP address appears, the Wi-Fi is successfully connected.

alt text


Your ERMI device should now be connected to Wi-Fi successfully via Postman!