Skip to main content

Check the iOS/iPadOS App Portal Version on Your Server

Legacy IPA workflow. This article applies to the older IPA-delivered iOS/iPadOS App Portal. Beginning with FileWave 15.3.0, iOS/iPadOS Kiosk moved to the App Store version distributed through Apple Apps and Books (VPP). Use this procedure only when troubleshooting an older IPA-based environment.

What

Use the FileWave Server Kiosk status endpoint to confirm which App Portal version the server has installed and which version it considers current for iOS and iPadOS devices.

When/Why

After a FileWave upgrade, the server may receive a newer iOS/iPadOS App Portal package through the automatic update process. Check the status endpoint when you need to verify the installed, latest, and available package versions.

How

In FileWave Central, open Assistants > Manage Administrators, select an administrator account with the required server access, and copy an application token. Preserve the complete token, including any trailing = character.

image.png

Replace the masked example token in each command with the copied token and your-server.example.com with your FileWave Server DNS name.

Protect the application token. Treat it as a secret, do not paste it into tickets or shared notes, and remove it from shell history after troubleshooting.

Here is a command you can run in Terminal.app on a macOS system or any system that has curl installed:

curl -H "Authorization: ezk5ODxxxmE0OyyyyyyyOX0=" https://your-server.example.com/filewave/api/kiosk/internal/kiosk-status

Here is a PowerShell example of the same command:

# Define the URL to make the request
$url = "https://your-server.example.com/filewave/api/kiosk/internal/kiosk-status"

# Define the headers, including the Authorization token
$headers = @{
    "Authorization" = "YOUR_APPLICATION_TOKEN"
}

# Use Invoke-WebRequest to make the GET request with headers
$response = Invoke-WebRequest -Uri $url -Headers $headers -Method Get

# Output the content of the response
$response.Content

The JSON response reports the installed package, the latest package, and the available versions. The older sample below shows the response structure; version numbers and package URLs on your server will differ.

{"installed":{"ipa_url":"https://fw-kiosk-v2-ipas.filewave.cloud/15.3.1/App_Portal_15.3.1.ipa","ipa_md5":"81628b83dad72e274ef93ea031db1484","build_date":"2024-03-27T20:08:49.192563Z","bundle_version":"15.3.1"},"latest":{"ipa_url":"https://fw-kiosk-v2-ipas.filewave.cloud/15.3.1/App_Portal_15.3.1.ipa","ipa_md5":"81628b83dad72e274ef93ea031db1484","build_date":"2024-03-27T20:08:49.192563Z","bundle_version":"15.3.1"},"available_versions":["15.3.1"]}%