Ana içeriğe geç
Versiyon: 1.0.8

Settings

API keys, integrations, and preferences at /devicer/settings.

Settings The page has four tabs, each addressable by URL:

TabURL
API Keys/devicer/settings
Config Generator (Appium)/devicer/settings?tab=config
Defaults/devicer/settings?tab=defaults
Quotas & Limits/devicer/settings?tab=quotas

API Keys​

API keys authenticate automation against MobileHub.

Creating a Key​

FieldDescription
TypeAutomation for Appium and WebDriver runs, or User for general API access
NameRequired, for example "CI/CD Pipeline"
DescriptionOptional
Expiration30 days, 90 days, 6 months, 1 year, or never expires
PermissionsFor User keys only

User keys carry an explicit permission set:

PermissionGrants
device:readList and view device details
device:controlStart tests and control devices
session:createCreate new device tests
session:readList and view test details
session:terminateEnd active tests
file:uploadUpload app binaries and other files
file:downloadDownload artifacts and files
Copy the key when it is created

The full key value is shown once, at creation. Afterwards only its prefix is displayed.

Using a Key​

Automation keys are sent as a capability:

{
"df:apiKey": "df_auto_xxxxx"
}

They can also be sent as an X-API-Key header. The Appium hub URL is shown on the tab:

https://api.rabbitqa.com/df/wd/hub

Managing Keys​

Each key card shows the key prefix, its type, when it was created, and when it was last used. Opening a key shows its full details, and a key can be revoked. Revoking is permanent.

Never commit a key

Store keys as secrets in your CI/CD platform. Rotate them periodically, and use separate keys per environment so an incident is contained and auditable.

CLI​

The tab also offers the MobileHub CLI, used for session-specific debug commands from Live Testing. Install it once, authenticate with an API key, and the session's Developer Tools panel gives you the exact command for that session.

Config Generator (Appium)​

The config generator builds a capability set from dropdowns instead of by hand.

  1. Pick the platform — Android or iOS.
  2. Pick the app: from the Catalog or from Distribution (Firebase App Distribution). You can also leave it empty to use an app already on the device.
  3. Pick a version, or take the latest compatible one.
  4. Pick a device, or leave it as any available device.
  5. Optionally enable the accessibility audit API.

The generated capabilities are shown as JSON, together with a runnable code example in Java, Python, Node.js, or cURL. Both can be copied in one step.

Only devices matching the chosen platform are offered, and only app versions compatible with the target are selectable.

See Appium Config for what each capability does.

Defaults​

Defaults apply to newly created interactive sessions. Only administrators can change them.

Apps​

Delete installed app after session automatically uninstalls apps that were installed during a session when the session ends.

Session​

SettingDescription
Default idle timeoutThe idle timeout for new interactive sessions; the maximum is 5 minutes
Company app protection listBundle or package identifiers protected from kill-all operations

The protection list is entered one identifier at a time, or pasted as comma-separated or newline-separated values. Protections inherited from global administrator defaults are shown separately and cannot be removed here. The tab shows the effective list — inherited plus company — that will actually be applied during kill-all and cleanup operations.

Quotas & Limits​

Current consumption and the limits that come with your plan.

SectionContents
StorageCurrent usage against the storage limit
Active TestsConcurrent tests, live tests, and automated tests in progress
Plan LimitsThe ceilings that apply to new work

Plan limits cover the maximum live test duration, the maximum automated test duration, daily reservations, the maximum file size, files per test, and viewers per test.

not

Every value on this tab comes from the plan attached to your company, so the numbers differ between accounts.