Managing WebIF Credentials

Every OScam instance exposes a built-in web interface (the WebIF) that is protected by a username and password. MyOsicam lets you store those credentials in the panel — encrypted at rest — so you can manage them centrally without editing configuration files on each server by hand.

What WebIF credentials are used for

The OScam WebIF is the monitoring and runtime-control interface built into OScam itself. It runs as a small HTTP server on each OScam instance, typically on a dedicated port. The panel uses the stored credentials to:

• Display the WebIF’s reachability status for each install.
• Trigger live reloads (for example, after writing user changes) via the WebIF’s reload endpoint.

Note

WebIF credentials stored in the panel are used by the panel to communicate with OScam’s built-in web interface. They are separate from your panel login credentials.

Where to manage WebIF credentials

WebIF credentials are stored per-install, not per-user. You manage them on the OSCam Installs screen:

1. Log in to the panel.
2. In the left sidebar, click OSCam Installs.
3. Find the install you want to update and click Edit in the Actions column.
4. In the edit modal, locate the WebIF credential fields.
5. Enter or update the WebIF username and password.
6. Click Save.

How credentials are stored

WebIF credentials are stored encrypted in the panel database. The panel uses its built-in encryption service (ext-openssl) to encrypt the values before writing them to the database and decrypts them only when it needs to make a request to the WebIF.

Caution

Plain-text credentials are never written to the database or logged. If you need to rotate a WebIF password, update it in OScam’s configuration directly and then update the stored value in the panel to match.

Verifying WebIF connectivity

After saving credentials, the panel will attempt to reach the WebIF on the next sync cycle. The install list shows each install’s runtime status, which reflects whether the WebIF is reachable with the stored credentials.

If the install shows as unreachable or the WebIF status is stale:

1. Confirm that OScam is running on the server (systemctl status oscam or equivalent).
2. Confirm that the WebIF port is open and the correct port number is registered in the panel (the HTTP Port column on the OSCam Installs screen).
3. Confirm that the username and password match the values configured in oscam.conf (httpuser and httppwd settings).

Rotating WebIF credentials

To rotate the WebIF password:

1. Update httpuser and httppwd in oscam.conf on the server and restart or reload OScam.
2. Open OSCam Installs in the panel, find the install, and click Edit.
3. Enter the new username and password in the WebIF credential fields.
4. Click Save.

The panel will start using the new credentials on the next communication with the WebIF.

Related pages

• Managing OScam Users — add and manage subscriber accounts in oscam.user.
• Fleet View — overview of all installs and their runtime status.
• Troubleshooting / FAQ — common issues with WebIF connectivity.